1、简介
Laravel让连接多种数据库以及对数据库进行查询变得非常简单,不论使用原生 SQL、还是查询构建器,还是 Eloquent ORM。目前,Laravel 支持四种类型的数据库系统:
- MySQL
- Postgres
- SQLite
- SQL Server
配置
Laravel 让连接数据库和运行查询都变得非常简单。应用的数据库配置位于 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' => '', ],
注意我们在配置数组中新增了两个键: read
和 write
,这两个键都对应一个包含单个键“host”的数组,读/写连接的其它数据库配置选项都共用 mysql
的主数组配置。
如果我们想要覆盖主数组中的配置,只需要将相应配置项放到 read
和 write
数组中即可。在本例中, 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
, delete
和 statement
。
运行 Select 查询
运行一个最基本的查询,可以使用 DB
门面的 select
方法:
<?php namespace App\Http\Controllers; use Illuminate\Support\Facades\DB; use App\Http\Controllers\Controller; class UserController extends Controller { /** * Show a list of all of the application's users. * * @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 { /** * Bootstrap any application services. * * @return void */ public function boot() { DB::listen(function ($query) { // $query->sql // $query->bindings // $query->time }); } /** * Register the service provider. * * @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 的事务。