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')->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": "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 的预加载。