数据库快速入门
简介
Laravel 让连接不同数据库以及对数据库进行增删改查操作变得非常简单,不论使用原生 SQL、还是查询构建器,还是 Eloquent ORM。目前,Laravel 支持四种类型的数据库系统:
- MySQL 5.6+
- Postgres 9.4+
- SQLite 3.8.8+
- SQL Server 2017+
配置
应用的数据库配置位于 config/database.php
。在该文件中我们可以定义所有的数据库连接,并指定哪个连接是默认连接。该文件中提供了所有支持数据库系统的配置示例。
默认情况下,Laravel 使用 MySQL 作为数据库引擎,并且示例配置已经为 Laravel Homestead 环境做好了设置(意思是说,如果你是用 Homestead 作为开发环境的话,就可以实现零配置使用),当然,你也可以按照需要为本地的数据库修改该配置
SQLite 配置
在项目根目录下使用 touch database/database.sqlite
命令创建好新的 SQLite 数据库之后,就可以使用数据库绝对路径配置环境变量指向这个新创建的数据库:
DB_CONNECTION=sqlite
DB_DATABASE=/absolute/path/to/database.sqlite
要启用 SQLite 连接的外键约束,需要设置 DB_FOREIGN_KEYS
环境变量值为 true:
DB_FOREIGN_KEYS=true
使用 URL 进行配置
通常,数据库连接都是使用多个配置值来完成配置,比如 host、database、username、password 等等,每个配置值在 .env 中都有对应的环境变量。这意味着当我们在生产服务器配置数据库连接信息时,需要管理多个环境变量。
有些数据库管理服务提供商如 Heroku 会提供包含所有数据库连接信息的单个"URL"字符串,比如下面这样:
mysql://root:password@127.0.0.1/forge?charset=UTF-8
这些 URL 通常遵循如下标准格式:
driver://username:password@host:port/database?options
为了方便,Laravel 也提供了对这种以 URL 作为数据库连接配置信息的支持。如果 url(对应的环境变量是 DATABASE_URL) 配置项存在,则会被用于解析数据库连接和认证信息。
读写分离
有时候我们希望使用一个数据库连接做查询,另一个数据库连接做插入、更新和删除,Laravel 中实现这种读写分离非常简单,不管你用的是原生 SQL,还是查询构建器,还是 Eloquent ORM,只要配置正确,合适的连接总是会被使用。
想要知道如何配置读/写连接,可以参考下面这个例子:
'mysql' => [
'read' => [
'host' => [
'192.168.1.1',
],
],
'write' => [
'host' => [
'192.168.1.2',
],
],
'sticky' => true,
'driver' => 'mysql',
'database' => 'database',
'username' => 'root',
'password' => '',
'charset' => 'utf8mb4',
'collation' => 'utf8mb4_unicode_ci',
'prefix' => '',
],
注意我们在配置数组中新增了三个键:read
、write
和 sticky
,read 和 write 这两个键对应值都有一个包含单个键“host”的数组,而其所映射的 IP 值分别就是读连接和写连接,读/写连接的其它数据库配置项都共用 mysql 的主数组配置。
如果我们想要覆盖主数组中的配置,只需要将相应配置项放到 read 和 write 数组中即可。在本例中,192.168.1.1 将被用作“读”连接,而 192.168.1.2 将被用作“写”连接。两个数据库连接的凭证(用户名/密码)、前缀、字符集以及其它配置将会共享 mysql 数组中的设置,同理,如果不一样的话,分别在 read 或 write 数组中单独配置即可。
sticky 项
sticky 项是一个可选的配置值,可用于在当前请求生命周期内允许立即读取写入数据库的记录。如果 sticky 选项被启用并且一个"写"操作在当前生命周期内发生,则后续所有"读"操作都会使用这个"写"连接(前提是同一个请求生命周期内),这样就可以确保同一个请求生命周期内写入的数据都可以立即被读取到,从而避免主从延迟导致的数据不一致,是否启用这一功能取决于你。
使用多个数据库连接
使用多个数据库连接的时候,可以通过 DB Facade 上的 connection 方法访问不同连接。传递给 connection
方法的 name
对应配置文件 config/database.php
中设置的某个连接:
$users = DB::connection('read')->select(...);
甚至还可以指定数据库和连接名,使用 :: 分隔:
$users = DB::connection('mysql::read')->select(...);
我们还可以使用连接实例上的 getPdo 方法访问底层原生的 PDO 实例:
$pdo = DB::connection('read')->getPdo();
运行原生 SQL 查询
配置好数据库连接后,就可以使用 DB Facade来运行查询。DB Facade 种操作提供了相应方法:select
, update
, insert
, delete
和 statement
。
运行 Select 查询
运行一个最基本的查询,可以使用 DB Facade的 select 方法:
<?php
namespace App\Http\Controllers;
use App\Http\Controllers\Controller;
use Illuminate\Support\Facades\DB;
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 Facade的 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 Facade的 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
{
/**
* Register any application services.
*
* @return void
*/
public function register()
{
//
}
/**
* Bootstrap any application services.
*
* @return void
*/
public function boot()
{
DB::listen(function ($query) {
// $query->sql
// $query->bindings
// $query->time
});
}
}
数据库事务
想要在一个数据库事务中运行一连串操作,可以使用 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 Facade 的 beginTransaction
方法:
DB::beginTransaction();
我们可以通过 rollBack
方法回滚事务:
DB::rollBack();
最后,我们可以通过 commit 方法提交事务:
DB::commit();
注意:使用 DB Facade 的事务方法还可以用于控制查询构建器和 Eloquent ORM 的事务。