快速入门


1、简介

Laravel 让连接多种数据库以及对数据库进行查询变得非常简单,不论使用原生 SQL、还是查询构建器,还是 Eloquent ORM。目前,Laravel 支持四种类型的数据库系统:

  • MySQL
  • Postgres
  • SQLite
  • SQL Server

配置

应用的数据库配置位于 config/database.php。在该文件中你可以定义所有的数据库连接,并指定哪个连接是默认连接。该文件中提供了所有支持数据库系统的配置示例。

默认情况下,Laravel 示例环境配置已经为 Laravel Homestead 做好了设置,当然,你也可以按照需要为本地的数据库修改该配置。

SQLite 配置

使用 touch database/database.sqlite 命令创建好新的 SQLite 数据库之后,就可以使用数据库绝对路径配置环境变量指向这个新创建的数据库:

DB_CONNECTION=sqlite
DB_DATABASE=/absolute/path/to/database.sqlite

SQL Server 配置

Laravel 开箱支持 SQL Server,不过,你需要为数据库添加连接配置到配置文件 config/database.php

'sqlsrv' => [
    'driver' => 'sqlsrv',
    'host' => env('DB_HOST', 'localhost'),
    'database' => env('DB_DATABASE', 'forge'),
    'username' => env('DB_USERNAME', 'forge'),
    'password' => env('DB_PASSWORD', ''),
    'charset' => 'utf8',
    'prefix' => '',
],

读写分离

有时候你希望使用一个数据库连接做查询,另一个数据库连接做插入、更新和删除,Laravel 使得这种读写分离变得轻而易举,不管你用的是原生 SQL,还是查询构建器,还是 Eloquent ORM,合适的连接总是会被使用。

想要知道如何配置读/写连接,让我们看看下面这个例子:

'mysql' => [
    'read' => [
        'host' => '192.168.1.1',
    ],
    'write' => [
        'host' => '196.168.1.2'
    ],
    'driver'    => 'mysql',
    'database'  => 'database',
    'username'  => 'root',
    'password'  => '',
    'charset'   => 'utf8',
    'collation' => 'utf8_unicode_ci',
    'prefix'    => '',
],

注意我们在配置数组中新增了两个键:readwrite,这两个键都对应一个包含单个键“host”的数组,读/写连接的其它数据库配置选项都共用 mysql 的主数组配置。

如果我们想要覆盖主数组中的配置,只需要将相应配置项放到 readwrite 数组中即可。在本例中,192.168.1.1 将被用作“读”连接,而 192.168.1.2 将被用作“写”连接。两个数据库连接的凭证(用户名/密码)、前缀、字符集以及其它配置将会共享 mysql 数组中的设置。

多个数据库连接

使用多个数据库连接的时候,可以通过 DB 门面上的 connection 方法访问每个连接。传递给 connection 方法的 name 对应配置文件 config/database.php 中列出的某个连接:

$users = DB::connection('foo')->select(...);

你还可以使用连接实例上的 getPdo 方法访问底层原生的 PDO 实例:

$pdo = DB::connection()->getPdo();

2、运行原生 SQL 查询

配置好数据库连接后,就可以使用 DB 门面来运行查询。DB 门面为每种操作提供了相应方法:select, update, insert, deletestatement

运行 Select 查询

运行一个最基本的查询,可以使用 DB 门面的select 方法:

<?php

namespace App\Http\Controllers;

use Illuminate\Support\Facades\DB;
use App\Http\Controllers\Controller;

class UserController extends Controller
{
    /**
     * 展示应用的用户列表.
     *
     * @return Response
     */
    public function index()
    {
        $users = DB::select('select * from users where active = ?', [1]);

        return view('user.index', ['users' => $users]);
    }
}

传递给 select 方法的第一个参数是原生的SQL语句,第二个参数需要绑定到查询的参数绑定,通常,这些都是 where 子句约束中的值。参数绑定可以避免 SQL 注入攻击。

select 方法以数组的形式返回结果集,数组中的每一个结果都是一个 PHP StdClass 对象,从而允许你像下面这样访问结果值:

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

使用命名绑定

除了使用 ? 占位符来代表参数绑定外,还可以使用命名绑定来执行查询:

$results = DB::select('select * from users where id = :id', ['id' => 1]);

运行插入语句

使用 DB 门面的 insert 方法执行插入语句。和 select 一样,该方法将原生 SQL 语句作为第一个参数,将绑定作为第二个参数:

DB::insert('insert into users (id, name) values (?, ?)', [1, 'Dayle']);

运行更新语句

update 方法用于更新数据库中已存在的记录,该方法返回受更新语句影响的行数:

$affected = DB::update('update users set votes = 100 where name = ?', ['John']);

运行删除语句

delete 方法用于删除数据库中已存在的记录,和 update 一样,该语句返回被删除的行数:

$deleted = DB::delete('delete from users');

运行一个通用语句

有些数据库语句不返回任何值,对于这种类型的操作,可以使用 DB 门面的 statement 方法:

DB::statement('drop table users');

监听查询事件

如果你想要获取应用中每次 SQL 语句的执行,可以使用 listen 方法,该方法对查询日志和调试非常有用,你可以在服务提供者中注册查询监听器:

<?php

namespace App\Providers;

use Illuminate\Support\Facades\DB;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    /**
     * 启动应用服务.
     *
     * @return void
     * @translator laravelacademy.org
     */
    public function boot()
    {
        DB::listen(function ($query) {
            // $query->sql
            // $query->bindings
            // $query->time
        });
    }

    /**
     * 注册服务提供者.
     *
     * @return void
     */
    public function register()
    {
        //
    }
}

3、数据库事务

想要在一个数据库事务中运行一连串操作,可以使用 DB 门面的 transaction 方法,如果事务闭包中抛出异常,事务将会自动回滚。如果闭包执行成功,事务将会自动提交。使用transaction 方法时不需要手动回滚或提交:

DB::transaction(function () {
    DB::table('users')->update(['votes' => 1]);
    DB::table('posts')->delete();
});

处理死锁

transaction 方法接收一个可选参数作为第二个参数,用于定义死锁发生时事务的最大重试次数。如果尝试次数超出指定值,会抛出异常:

DB::transaction(function () {
    DB::table('users')->update(['votes' => 1]);

    DB::table('posts')->delete();
}, 5);

手动使用事务

如果你想要手动开始事务从而对回滚和提交有一个完整的控制,可以使用 DB 门面的beginTransaction 方法:

DB::beginTransaction();

你可以通过 rollBack 方法回滚事务:

DB::rollBack();

最后,你可以通过 commit 方法提交事务:

DB::commit();
注意:使用 DB 门面的事务方法还可以用于控制查询构建器Eloquent ORM 的事务。

点赞 取消点赞 收藏 取消收藏

<< 上一篇: 任务调度

>> 下一篇: 查询构建器