Laravel 的 查询生成器 提供了一个强大、流畅的界面，用于在 PHP 中构建 SQL 查询。它允许您以富有表现力的、类似 SQL 的语法与数据库交互，同时抽象出大部分复杂性。

我们将演练 Laravel 应用程序中的典型用例，使用查询生成器执行各种任务，例如选择、插入、更新和删除数据。

第 1 步：设置 Laravel 项目

如果您没有 Laravel 项目，您可以按如下方式设置一个：

composer create-project --prefer-dist laravel/laravel laravel-query-builder
cd laravel-query-builder
php artisan serve

确保在 .env 文件中设置数据库配置：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password

运行迁移以创建默认表：

php artisan migrate

第 2 步：在控制器中使用查询生成器

让我们创建一个控制器来演示查询生成器的用法：

php artisan make:controller UserController

使用以下代码编辑UserController.php：

get();

        return response()->json($users);
    }

    // Insert a new user
    public function store(Request $request)
    {
        // Step 4: Insert a new user
        DB::table('users')->insert([
            'name' => $request->name,
            'email' => $request->email,
            'password' => bcrypt($request->password),
        ]);

        return response()->json(['message' => 'User created successfully!']);
    }

    // Update an existing user
    public function update(Request $request, $id)
    {
        // Step 5: Update user by ID
        DB::table('users')
            ->where('id', $id)
            ->update([
                'name' => $request->name,
                'email' => $request->email,
            ]);

        return response()->json(['message' => 'User updated successfully!']);
    }

    // Delete a user
    public function destroy($id)
    {
        // Step 6: Delete user by ID
        DB::table('users')->where('id', $id)->delete();

        return response()->json(['message' => 'User deleted successfully!']);
    }
}

第 3 步：检索数据

使用查询生成器从用户表中选择所有行：

$users = DB::table('users')->get();

• 描述：
  • DB::table('users') 方法以 users 表为目标。
  • get() 方法检索该表中的所有记录。

响应示例：

[
    {
        "id": 1,
        "name": "John Doe",
        "email": "[email protected]"
    },
    {
        "id": 2,
        "name": "Jane Doe",
        "email": "[email protected]"
    }
]

第四步：插入数据

使用查询生成器插入新用户：

DB::table('users')->insert([
    'name' => 'Alice',
    'email' => '[email protected]',
    'password' => bcrypt('password123'),
]);

• 描述：
  • insert() 方法将新行插入到 users 表中。
  • 数据作为关联数组传递，其中键与列名称匹配。

这会将新用户添加到用户表中。

第5步：更新数据

要更新现有记录，请使用 update():

DB::table('users')
    ->where('id', 1)
    ->update([
        'name' => 'John Smith',
        'email' => '[email protected]'
    ]);

• 描述：
  • where() 子句选择 id = 1 的行。
  • update() 方法修改所选行的姓名和电子邮件字段。

这将更新用户表中 ID 为 1 的用户。

第6步：删除数据

要从数据库中删除记录，请使用delete():

DB::table('users')->where('id', 2)->delete();

• 描述：
  • where()子句指定选择ID为2的用户的条件。
  • delete() 方法从表中删除匹配的行。

这将删除 ID 为 2 的用户。

第 7 步：使用查询生成器进行过滤

您可以链接其他方法来过滤数据或向查询添加条件。

示例：检索具有特定条件的用户

$users = DB::table('users')
    ->where('email', 'like', '%example.com%')
    ->orderBy('name', 'asc')
    ->get();

• 描述：
  • where() 子句添加一个条件，获取电子邮件包含 example.com 的用户。
  • orderBy() 方法按名称升序对用户进行排序。

第8步：分页

Laravel 的查询生成器可以轻松对结果进行分页。

$users = DB::table('users')->paginate(10);

• 描述：
  • paginate() 方法将结果分成几页，每页显示 10 个结果。

第9步：交易

使用数据库事务来确保多个查询执行成功。如果一个查询失败，所有更改都会回滚。

DB::transaction(function () {
    DB::table('users')->insert([
        'name' => 'John Doe',
        'email' => '[email protected]',
        'password' => bcrypt('password123')
    ]);

    DB::table('orders')->insert([
        'user_id' => 1,
        'order_total' => 500
    ]);
});

• 描述：
  • transaction() 方法确保用户和订单表插入均成功执行。如果其中一个失败，两个操作都将回滚。

第 10 步：原始查询

如果您需要运行原始 SQL，Laravel 的查询生成器允许这样做：

$users = DB::select('SELECT * FROM users WHERE id = ?', [1]);

• 描述：
  • select() 方法可用于执行原始 SQL 查询。
  • 它使用准备好的语句（？）来保证安全，防止 SQL 注入。

结论

Laravel 的查询生成器提供了一种强大且灵活的方式与数据库交互，抽象了大部分 SQL 复杂性。通过分解每个部分——检索、插入、更新、删除、过滤等等——您可以以干净、有组织的方式轻松管理数据库交互。

此示例提供了查询生成器的基本指南。随着应用程序的增长，您可以使用更高级的功能，例如连接、子查询和 Eloquent 的预加载。