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：

<?php namespace apphttpcontrollers;

use illuminatesupportfacadesdb;
use illuminatehttprequest;

class usercontroller extends controller
{
    // fetching all users from the users table
    public function index()
    {
        // step 3: select all users
        $users = db::table('users')-&gt;get();

        return response()-&gt;json($users);
    }

    // insert a new user
    public function store(request $request)
    {
        // step 4: insert a new user
        db::table('users')-&gt;insert([
            'name' =&gt; $request-&gt;name,
            'email' =&gt; $request-&gt;email,
            'password' =&gt; bcrypt($request-&gt;password),
        ]);

        return response()-&gt;json(['message' =&gt; 'user created successfully!']);
    }

    // update an existing user
    public function update(request $request, $id)
    {
        // step 5: update user by id
        db::table('users')
            -&gt;where('id', $id)
            -&gt;update([
                'name' =&gt; $request-&gt;name,
                'email' =&gt; $request-&gt;email,
            ]);

        return response()-&gt;json(['message' =&gt; 'user updated successfully!']);
    }

    // delete a user
    public function destroy($id)
    {
        // step 6: delete user by id
        db::table('users')-&gt;where('id', $id)-&gt;delete();

        return response()-&gt;json(['message' =&gt; 'user deleted successfully!']);
    }
}

---

第 3 步：检索数据

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

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

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

响应示例：

[
    {
        "id": 1,
        "name": "john doe",
        "email": "john@example.com"
    },
    {
        "id": 2,
        "name": "jane doe",
        "email": "jane@example.com"
    }
]

---

第四步：插入数据

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

db::table('users')->insert([
    'name' => 'alice',
    'email' => 'alice@example.com',
    'password' => bcrypt('password123'),
]);

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

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

---

第5步：更新数据

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

db::table('users')
    ->where('id', 1)
    ->update([
        'name' => 'john smith',
        'email' => 'johnsmith@example.com'
    ]);

• 描述：
  • 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' => 'john@example.com',
        'password' => bcrypt('password123')
    ]);

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

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

---

第 10 步：原始查询

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

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

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

---

结论

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

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

以上就是Laravel 入门：查询生成器初学者指南的详细内容，更多请关注php中文网其它相关文章！