星期日, 2017-05-07 10:06 — adminshiping1

查询构造器

介绍

数据库查询构造器 (query builder) 提供方便、流畅的接口，用来建立及执行数据库查找语法。在你的应用程序里面，它可以被使用在大部分的数据库操作，而且它在所有支持的数据库系统上都可以执行。

注意: Laravel 查询构造器使用 PDO 参数绑定，以保护应用程序免于 SQL 注入，因此传入的参数不需额外转义特殊字符。

Selects

从数据表中取得所有的数据列

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

foreach ($users as $user)
{
    var_dump($user->name);
}

从数据表中分块查找数据列

DB::table('users')->chunk(100, function($users)
{
    foreach ($users as $user)
    {
        //
    }
});

通过在 闭包 中返回 false 来停止处理接下来的数据列：

DB::table('users')->chunk(100, function($users)
{
    //

    return false;
});

从数据表中取得单一数据列

$user = DB::table('users')->where('name', 'John')->first();

var_dump($user->name);

从数据表中取得单一数据列的单一字段

$name = DB::table('users')->where('name', 'John')->pluck('name');

取得单一字段值的列表

$roles = DB::table('roles')->lists('title');

这个方法将会返回数据表 role 的 title 字段值的数组。你也可以通过下面的方法，为返回的数组指定自定义键值。

$roles = DB::table('roles')->lists('title', 'name');

指定查询子句 (Select Clause)

$users = DB::table('users')->select('name', 'email')->get();

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

$users = DB::table('users')->select('name as user_name')->get();

增加查询子句到现有的查询中

$query = DB::table('users')->select('name');

$users = $query->addSelect('age')->get();

使用 where 及运算符

$users = DB::table('users')->where('votes', '>', 100)->get();

「or」语法

$users = DB::table('users')
                    ->where('votes', '>', 100)
                    ->orWhere('name', 'John')
                    ->get();

使用 Where Between

$users = DB::table('users')
                    ->whereBetween('votes', [1, 100])->get();

使用 Where Not Between

$users = DB::table('users')
                    ->whereNotBetween('votes', [1, 100])->get();

使用 Where In 与数组

$users = DB::table('users')
                    ->whereIn('id', [1, 2, 3])->get();

$users = DB::table('users')
                    ->whereNotIn('id', [1, 2, 3])->get();

使用 Where Null 找有未配置的值的数据

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

Dynamic Where Clauses

You may even use "dynamic" where statements to fluently build where statements using magic methods:

$admin = DB::table('users')->whereId(1)->first();

$john = DB::table('users')
                    ->whereIdAndEmail(2, 'john@doe.com')
                    ->first();

$jane = DB::table('users')
                    ->whereNameOrAge('Jane', 22)
                    ->first();

排序(Order By)、分群(Group By) 及 Having

$users = DB::table('users')
                    ->orderBy('name', 'desc')
                    ->groupBy('count')
                    ->having('count', '>', 100)
                    ->get();

偏移(Offset) 及限制(Limit)

$users = DB::table('users')->skip(10)->take(5)->get();

Joins

查询构造器也可以使用 join 语法，看看下面的例子：

基本的 Join 语法

DB::table('users')
            ->join('contacts', 'users.id', '=', 'contacts.user_id')
            ->join('orders', 'users.id', '=', 'orders.user_id')
            ->select('users.id', 'contacts.phone', 'orders.price')
            ->get();

Left Join 语法

DB::table('users')
        ->leftJoin('posts', 'users.id', '=', 'posts.user_id')
        ->get();

你也可以指定更高级的 join 子句：

DB::table('users')
        ->join('contacts', function($join)
        {
            $join->on('users.id', '=', 'contacts.user_id')->orOn(...);
        })
        ->get();

如果你想在你的 join 中使用 where 型式的子句，你可以在 join 子句里使用 where 或 orWhere 方法。下面的方法将会比较 contacts 数据表中的 user_id 的数值，而不是比较两个字段。

DB::table('users')
        ->join('contacts', function($join)
        {
            $join->on('users.id', '=', 'contacts.user_id')
                 ->where('contacts.user_id', '>', 5);
        })
        ->get();

高级 Wheres

群组化参数

有些时候你需要更高级的 where 子句，如「where exists」或嵌套的群组化参数。Laravel 的查询构造器也可以处理这样的情况：

DB::table('users')
            ->where('name', '=', 'John')
            ->orWhere(function($query)
            {
                $query->where('votes', '>', 100)
                      ->where('title', '<>', 'Admin');
            })
            ->get();

上面的查找语法会产生下方的 SQL：

select * from users where name = 'John' or (votes > 100 and title <> 'Admin')

Exists 语法

DB::table('users')
            ->whereExists(function($query)
            {
                $query->select(DB::raw(1))
                      ->from('orders')
                      ->whereRaw('orders.user_id = users.id');
            })
            ->get();

上面的查找语法会产生下方的 SQL：

select * from users
where exists (
    select 1 from orders where orders.user_id = users.id
)

聚合

查找产生器也提供各式各样的聚合方法，如 count、max、min、avg 及 sum。

使用聚合方法

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

$price = DB::table('orders')->max('price');

$price = DB::table('orders')->min('price');

$price = DB::table('orders')->avg('price');

$total = DB::table('users')->sum('votes');

原生表达式

有些时候你需要使用原生表达式在查找语句里，这样的表达式会成为字串插入至查找，因此要小心勿建立任何 SQL 注入点。要建立原生表达式，你可以使用 DB::raw 方法：

使用原生表达式

$users = DB::table('users')
                     ->select(DB::raw('count(*) as user_count, status'))
                     ->where('status', '<>', 1)
                     ->groupBy('status')
                     ->get();

添加

添加数据进数据表

DB::table('users')->insert(
    ['email' => 'john@example.com', 'votes' => 0]
);

添加自动递增 (Auto-Incrementing) ID 的数据至数据表

如果数据表有自动递增的ID，可以使用 insertGetId 添加数据并返回该 ID：

$id = DB::table('users')->insertGetId(
    ['email' => 'john@example.com', 'votes' => 0]
);

注意: 当使用 PostgreSQL 时，insertGetId 方法会预期自动增加的字段是以「id」为命名。

添加多个数据进数据表

DB::table('users')->insert([
    ['email' => 'taylor@example.com', 'votes' => 0],
    ['email' => 'dayle@example.com', 'votes' => 0]
]);

更新

更新数据表中的数据

DB::table('users')
            ->where('id', 1)
            ->update(['votes' => 1]);

自增或自减一个字段的值

DB::table('users')->increment('votes');

DB::table('users')->increment('votes', 5);

DB::table('users')->decrement('votes');

DB::table('users')->decrement('votes', 5);

也能够同时指定其他要更新的字段：

DB::table('users')->increment('votes', 1, ['name' => 'John']);

删除

删除数据表中的数据

DB::table('users')->where('votes', '<', 100)->delete();

删除数据表中的所有数据

DB::table('users')->delete();

清空数据表

DB::table('users')->truncate();

Unions

查询构造器也提供一个快速的方法去「合并 (union)」两个查找的结果：

$first = DB::table('users')->whereNull('first_name');

$users = DB::table('users')->whereNull('last_name')->union($first)->get();

unionAll 方法也可以使用，它与 union 方法的使用方式一样。

悲观锁定 (Pessimistic Locking)

查询构造器提供了少数函数协助你在 SELECT 语句中做到「悲观锁定」。

想要在 SELECT 语句中加上「Shard lock」，只要在查找语句中使用 sharedLock 函数：

DB::table('users')->where('votes', '>', 100)->sharedLock()->get();

要在 select 语法中使用「锁住更新(lock for update)」时，你可以使用 lockForUpdate 方法：

DB::table('users')->where('votes', '>', 100)->lockForUpdate()->get();


来自 https://docs.golaravel.com/docs/5.0/queries/

普通分类:

laravel

搜索表单

用户登录

You are here

查询构造器

查询构造器

从数据表中取得所有的数据列

从数据表中分块查找数据列

从数据表中取得单一数据列

从数据表中取得单一数据列的单一字段

取得单一字段值的列表

指定查询子句 (Select Clause)

增加查询子句到现有的查询中

使用 where 及运算符

「or」语法

使用 Where Between

使用 Where Not Between

使用 Where In 与数组

使用 Where Null 找有未配置的值的数据

Dynamic Where Clauses

排序(Order By)、分群(Group By) 及 Having

偏移(Offset) 及 限制(Limit)

基本的 Join 语法

Left Join 语法

群组化参数

Exists 语法

使用聚合方法

使用原生表达式

添加数据进数据表

添加自动递增 (Auto-Incrementing) ID 的数据至数据表

添加多个数据进数据表

更新数据表中的数据

自增或自减一个字段的值

删除数据表中的数据

删除数据表中的所有数据

清空数据表

友情链接

偏移(Offset) 及限制(Limit)