[ Laravel 5.2 文档 ] 数据库 -- 起步

1、简介

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

• MySQL
• Postgres
• SQLite
• SQL Server

配置

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

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

读/写连接

有时候你希望使用一个数据库连接做查询，另一个数据库连接做插入、 更新和删除，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'    => '',],

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

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

2、运行原生 SQL 查询

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

运行 Select 查询

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

<?phpnamespace 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;}

使用命名绑定

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

$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方法，该方法对查询日志和调试非常有用，你可以在服务提供者中注册查询监听器：

<?phpnamespace 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();});

手动使用事务

如果你想要手动开始事务从而对回滚和提交有一个完整的控制，可以使用 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();