# 数据库 —— 起步
## 1、简介
Laravel让连接多种数据库、还是查询构建器，还是Eloquent ORM。目前，Laravel支持四种类型的数据库系统：
* MySQL
* Postgres
* SQLite
* SQL Server
### 1.1 配置
Laravel让连接数据库和运行查询都变得非常简单。应用的数据库配置位于`config/database.php`。在该文件中你可以定义所有的数据库连接，并指定哪个连接是默认连接。该文件中提供了所有支持数据库系统的配置示例。
默认情况下，Laravel示例[环境配置](http://laravelacademy.org/post/46.html#environment-configuration)已经为[Laravel Homestead](http://laravelacademy.org/post/51.html)做好准备，当然，你也可以按照需要为本地的数据库修改该配置。
### 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' => '',
],
~~~
注意我们在配置数组中新增了两个键：`read`和`write`，这两个键都对应一个包含单个键“host”的数组，读/写连接的其它数据库配置选项都共用mysql的主数组配置。
如果我们想要覆盖主数组中的配置，只需要将相应配置项放到`read`和`write`数组中即可。在本例中，`192.168.1.1`将被用作“读”连接，而`192.168.1.2`将被用作“写”连接。两个数据库连接的凭证（用户名/密码）、前缀、字符集以及其它配置将会共享`mysql`数组中的设置。
## 2、运行原生SQL查询
一旦你配置好数据库连接后，就可以使用`DB`门面来运行查询。`DB`门面为每种查询提供了相应方法：`select`, `update`, `insert`, `delete`, 和`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`门面的事务方法还可以用于控制[查询构建器](http://laravelacademy.org/post/126.html)和[Eloquent ORM](http://laravelacademy.org/post/138.html)的事务。
## 4、使用多个数据库连接
使用多个数据库连接的时候，可以使用`DB`门面的`connection`方法访问每个连接。传递给`connection`方法的连接名对应配置文件`config/database.php`中相应的连接：
~~~
$users = DB::connection('foo')->select(...);
~~~
你还可以通过连接实例上的`getPdo`方法底层原生的PDO实例：
~~~
$pdo = DB::connection()->getPdo();
~~~
> 扩展阅读：[实例教程 —— 使用DB门面对数据库进行操作](http://laravelacademy.org/post/854.html)
- 前言
- 序言
- 序言 ―― 发行版本说明
- 序言 ―― 升级指南
- 序言 ―― 贡献代码
- 开始
- 开始 ―― 安装及配置
- 开始 ―― Laravel Homestead
- 基础
- 基础 ―― HTTP路由
- 基础 ―― HTTP 中间件
- 基础 ―― HTTP 控制器
- 基础 ―― HTTP 请求
- 基础 ―― HTTP 响应
- 基础 ―― 视图
- 基础 ―― Blade模板
- 架构
- 架构 ―― 一次请求的生命周期
- 架构 ―― 应用目录结构
- 架构 ―― 服务提供者
- 架构 ―― 服务容器
- 架构 ―― 契约
- 架构 ―― 门面
- 数据库
- 数据库 ―― 起步
- 数据库 ―― 查询构建器
- 数据库 ―― 迁移
- 数据库 ―― 填充数据
- Eloquent ORM
- Eloquent ORM ―― 起步
- Eloquent ORM ―― 关联关系
- Eloquent ORM ―― 集合
- Eloquent ORM ―― 调整器
- Eloquent ORM ―― 序列化
- 服务
- 服务 ―― 用户认证
- 服务 ―― Artisan 控制台
- 服务 ―― Laravel Cashier（交易）
- 服务 ―― 缓存
- 服务 ―― 集合
- 服务 ―― Laravel Elixir
- 服务 ―― 加密
- 服务 ―― 错误&日志
- 服务 ―― 事件
- 服务 ―― 文件系统/云存储
- 服务 ―― 哈希
- 服务 ―― 帮助函数
- 服务 ―― 本地化
- 服务 ―― 邮件
- 服务 ―― 包开发
- 服务 ―― 分页
- 服务 ―― 队列
- 服务 ―― Redis
- 服务 ―― Session
- 服务 ―― Envoy 任务运行器（SSH任务）
- 服务 ―― 任务调度
- 服务 ―― 测试
- 服务 ―― 验证