[ Laravel 5.1 文档 ] 数据库 —— 起步

1、简介

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

  • MySQL
  • Postgres
  • SQLite
  • SQL Server

1.1 配置

Laravel让连接数据库和运行查询都变得非常简单。应用的数据库配置位于config/database.php。在该文件中你可以定义所有的数据库连接,并指定哪个连接是默认连接。该文件中提供了所有支持数据库系统的配置示例。

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

1.1.1 读/写连接

有时候你希望使用一个数据库连接做查询,另一个数据库连接做插入、更新和删除,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数组中的设置。

2、运行原生SQL查询

一旦你配置好数据库连接后,就可以使用DB门面来运行查询。DB门面为每种查询提供了相应方法:selectupdateinsertdelete, 和statement

2.1 运行Select查询

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

<?php

namespace App\Http\Controllers;

use 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;
}

2.2 使用命名绑定

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

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

2.3 运行插入语句

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

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

2.4 运行更新语句

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

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

2.5 运行删除语句

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

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

2.6 运行一个通用语句

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

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

2.7 监听查询事件

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

<?php

namespace App\Providers;

use DB;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider{
    /**
     * 启动所有应用服务
     *
     * @return void
     */
    public function boot()
    {
        DB::listen(function($sql, $bindings, $time) {
            //
        });
    }

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

3、数据库事务

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

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

3.1 手动使用事务

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

DB::beginTransaction();

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

DB::rollBack();

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

DB::commit();

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

4、使用多个数据库连接

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

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

你还可以通过连接实例上的getPdo方法底层原生的PDO实例:

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

扩展阅读:实例教程 —— 使用DB门面对数据库进行操作

学院君 has written 639 articles

资深PHP工程师,Laravel学院院长

23 thoughts on “[ Laravel 5.1 文档 ] 数据库 —— 起步

  1. duyisu says:

    DB::listen(function($sql, $bindings, $time) {
    //
    });
    这个函数写了报错

    “message”: “Missing argument 2 for App\\Providers\\AppServiceProvider::App\\Providers\\{closure}()”,
    “status_code”: 500,
    “debug”: {
    “line”: 18,
    “file”: “F:\\LaraveAPIDemo\\app\\Providers\\AppServiceProvider.php”,
    “class”: “ErrorException”,

  2. 宝宝今年要瘦啦!😎 says:

    我在控制器里面写了一个循环,不停的读取数据库,有数据更新时就返回更新的内容,半小时左右之后数据库就会显示数据库连接过多而崩掉。请问是因为每次读取数据库连接的时候就会创建新的连接吗?有什么办法能释放连接吗?

    1. 任思祥 says:

      我刚从网上下载了5.1的包也包含vendor ,调试的时候是默认的错误提示信息,我看到网上的http://wenda.golaravel.com/question/231 的调试挺好用的,大哥可知道他是怎么搞的嘛?

  3. 冰冷的糖 says:

    按照这个读写配置用不了啊,
    配置后
    DB::select(‘select * from fb_migrations’)
    PDO直接报SQLSTATE[HY000] [2002]错误了
    如果不分读写,两个数据库都可以操作

      1. 冰冷的糖 says:

        1、服务器的数据库主从也配置好了,测试无问题
        2、在laravel中单独配置两台中任意一台,测试无任何问题,但分主从时候就出现链接数据库错误
        in Connector.php line 50
        at PDO->__construct(‘mysql:host=196.168.0.99;dbname=test’, ‘xxx’, ‘123456’, array(‘0’, ‘2’, ‘0’, false, ‘0’)) in Connector.php line 50
        3、链接数据库错误后查看报错信息表示是在new PDO时出错的,但根据日志将new PDO时候的所有参数复制在自己写的PDO测试文件中,完全无任何问题,可以操作

  4. tcc says:

    数据库事务 DB::transaction(function () {
    DB::table(‘users’)->update([‘votes’ => 1]);
    DB::table(‘posts’)->delete();
    });
    是在一段代码中,比如一个function里面 使用吗?

发表评论

标记为*的字段是必填项(邮箱地址不会被公开)

你可以使用这些HTML 标签和属性: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>