快速入门 · laravel 5.4

<article><h1>数据库：入门</h1><ul><li><a href="#introduction">简介</a><ul><li><a href="#configuration">配置信息</a></li><li><a href="#read-and-write-connections">数据库读写分离</a></li><li><a href="#using-multiple-database-connections">使用多数据库连接</a></li></ul></li><li><a href="#running-queries">运行原生 SQL 语句</a><ul><li><a href="#listening-for-query-events">监听查询事件</a></li></ul></li><li><a href="#database-transactions">数据库事务</a></li></ul><a name="introduction"></a><h2><a href="#introduction">简介</a></h2>Laravel 对主流数据库系统连接和查询都提供了很好的支持，尤其是流畅的 <a href="/docs/5.4/queries">查询语句构造器</a> ， Laravel 支持四种类型的数据库：<ul><li>MySQL</li><li>Postgres</li><li>SQLite</li><li>SQL Server</li></ul><a name="configuration"></a><h3>配置信息</h3>Laravel 应用程序的数据库配置文件放置在 <code class=" language-php">config/database.php</code> 文件中。在这个配置文件内你可以定义所有的数据库连接，以及指定默认使用哪个连接。在此文件内提供了所有支持的数据库系统示例。默认情况下，Laravel 的 <a href="/docs/5.4/installation#environment-configuration">环境配置</a> 示例会使用 <a href="/docs/5.4/homestead">Laravel Homestead</a>，对于 Laravel 开发来说这是一个相当便利的本地虚拟机。当然你也可以根据需求来随时修改本机端的数据库设置。<h4>SQLite 配置</h4>请使用 <code class=" language-php">touch database/database.sqlite</code> 命令创建一个 SQLite 文件，您可以通过使用数据库的绝对路径来轻松地配置您的环境变量来指向这个新创建的数据库：<pre class=" language-php"><code class=" language-php">DB_CONNECTION=sqlite DB_DATABASE=/absolute/path/to/database.sqlite</code></pre><h4>SQL Server 配置</h4>Laravel 支持 SQL Server 数据库，你需要在 <code class=" language-php">config/database.php</code> 中为连接 SQL Server 数据库做配置：<pre class=" language-php"><code class=" language-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' => '', ],</code></pre><a name="read-and-write-connections"></a><h3>数据库读写分离</h3>有时候你希望把一个数据库作为只读数据库，而另一个数据库则负责写入、更新以及删除。Laravel 会让你轻而易举的实现，并适用于原始查找、查询语句构造器或是 Eloquent ORM。通过下面这个例子，我们来学习如何配置数据库读写连接的分离：<pre class=" language-php"><code class=" language-php">'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' => '', ],</code></pre>注意，有两个键加入了这个配置文件数组内： <code class=" language-php">read</code> 和 <code class=" language-php">write</code> 。它们两个都是一个数组且只包含了一个键： <code class=" language-php">host</code> 。而 <code class=" language-php">read</code> 和 <code class=" language-php">write</code> 连接的其他配置都包含在 <code class=" language-php">mysql</code> 数组中。所以，如果需要在主要的数组内重写值，只需在 <code class=" language-php">read</code> and <code class=" language-php">write</code> 数组内放置设置参数即可。在这个例子中， <code class=" language-php">192.168.1.1</code> 将会只提供数据读取数据的功能，而 <code class=" language-php">192.168.1.2</code> 提供数据库写入。数据库的凭证、前缀、编码设置，以及所有其它的选项都被存放在 <code class=" language-php">mysql</code> 数组内，这两个连接将会共用这些选项。<a name="using-multiple-database-connections"></a><h3>使用多数据库连接</h3>当使用多个数据连接时，你可以使用 <code class=" language-php">DB</code> facade 的 <code class=" language-php">connection</code> 方法。在 <code class=" language-php">config/database.php</code> 中定义好的数据库连接 <code class=" language-php">name</code> 作为 <code class=" language-php">connection</code> 的参数进行传递。<pre class=" language-php"><code class=" language-php">$users = DB::connection('foo')->select(...);</code></pre>你也可以在连接的实例中使用 <code class=" language-php">getPdo</code> 方法访问原始的底层 PDO 实例：<pre class=" language-php"><code class=" language-php">$pdo = DB::connection()->getPdo();</code></pre><a name="running-queries"></a><h2><a href="#running-queries">运行原生 SQL 语句</a></h2>配置好数据库连接以后，你可以使用 <code class=" language-php">DB</code> facade 来执行查询。 <code class=" language-php">DB</code> facade 提供了 <code class=" language-php">select</code> 、 <code class=" language-php">update</code> 、 <code class=" language-php">insert</code> 、 <code class=" language-php">delete</code> 和 <code class=" language-php">statement</code> 的查询方法。<h4>运行 Select</h4>运行一个基础的查询语句，你可以使用 <code class=" language-php">DB</code> facade 的 <code class=" language-php">select</code> 方法：<pre class=" language-php"><code class=" language-php"><?php namespace App\Http\Controllers; use Illuminate\Support\Facades\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]); } }</code></pre>传递到 <code class=" language-php">select</code> 方法的第一个参数是一个原生的 SQL 查询，而第二个参数则是传递的所有绑定到查询中的参数值。通常，这些都是 <code class=" language-php">where</code> 字句约束中的值。参数绑定可以避免 SQL 注入攻击。<code class=" language-php">select</code> 方法以数组的形式返回结果集，数组中的每一个结果都是一个PHP <code class=" language-php">StdClass</code> 对象，你可以像下面这样访问结果值：<pre class=" language-php"><code class=" language-php">foreach ($users as $user) { echo $user->name; }</code></pre><h4>使用命名绑定</h4>除了使用 <code class=" language-php">?</code> 来表示参数绑定外，你也可以使用命名绑定运行查找：<pre class=" language-php"><code class=" language-php">$results = DB::select('select * from users where id = :id', ['id' => 1]);</code></pre><h4>运行 insert</h4>运行 <code class=" language-php">Insert</code> 语句，你可以是使用 <code class=" language-php">DB</code> facade 的 <code class=" language-php">insert</code> 方法。像 <code class=" language-php">select</code> 一样，该方法将原生SQL语句作为第一个参数，将参数绑定作为第二个参数：<pre class=" language-php"><code class=" language-php">DB::insert('insert into users (id, name) values (?, ?)', [1, 'Dayle']);</code></pre><h4>运行 Update</h4><code class=" language-php">update</code> 方法用于更新已经存在于数据库的记录。该方法会返回此语句执行所影响的行数：<pre class=" language-php"><code class=" language-php">$affected = DB::update('update users set votes = 100 where name = ?', ['John']);</code></pre><h4>运行 Delete</h4><code class=" language-php">delete</code> 方法用于删除已经存在于数据库的记录。如同 <code class=" language-php">update</code> 一样，删除的行数将会被返回。<pre class=" language-php"><code class=" language-php">$deleted = DB::delete('delete from users');</code></pre><h4>运行一般声明</h4>有些数据库没有返回值，对于这种类型的操作，可以使用 <code class=" language-php">DB</code> facade 的 <code class=" language-php">statement</code> 方法。<pre class=" language-php"><code class=" language-php">DB::statement('drop table users');</code></pre><a name="listening-for-query-events"></a><h3>监听查询事件</h3>如果你希望能够监控到程序执行的每一条 SQL 语句，那么你可以使用 <code class=" language-php">listen</code> 方法。该方法对查询日志和调试非常有用，你可以在 <a href="/docs/5.4/providers">服务容器</a> 中注册该方法：<pre class=" language-php"><code class=" language-php"><?php namespace App\Providers; use Illuminate\Support\Facades\DB; use Illuminate\Support\ServiceProvider; class AppServiceProvider extends ServiceProvider { /** * 启动应用服务。 * * @return void */ public function boot() { DB::listen(function ($query) { // $query->sql // $query->bindings // $query->time }); } /** * 注册服务提供者。 * * @return void */ public function register() { // } }</code></pre><a name="database-transactions"></a><h2><a href="#database-transactions">数据库事务</a></h2>想要在一个数据库事务中运行一连串操作，可以使用 <code class=" language-php">DB</code> facade 的 <code class=" language-php">transaction</code> 方法。如果在事务的 <code class=" language-php">Closure</code> 中抛出了异常，那么事务会自动的执行回滚操作。如果 <code class=" language-php">Closure</code> 成功的执行，那么事务就会自动的进行提交操作。你不需要在使用 <code class=" language-php">transaction</code> 方法时考虑手动执行回滚或者提交操作：<pre class=" language-php"><code class=" language-php">DB::transaction(function () { DB::table('users')->update(['votes' => 1]); DB::table('posts')->delete(); });</code></pre><h4>手动操作事务</h4>如果你想要手动开始一个事务的回滚和提交操作，你可以使用 <code class=" language-php">DB</code> facade 的 <code class=" language-php">beginTransaction</code> 方法。<pre class=" language-php"><code class=" language-php">DB::beginTransaction();</code></pre>你也可以通过 <code class=" language-php">rollBack</code> 方法来回滚事务：<pre class=" language-php"><code class=" language-php">DB::rollBack();</code></pre>最后，可以通过 <code class=" language-php">commit</code> 方法来提交这个事务：<pre class=" language-php"><code class=" language-php">DB::commit();</code></pre><blockquote class="has-icon tip"><div class="flag"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:a="http://ns.adobe.com/AdobeSVGViewerExtensions/3.0/" version="1.1" x="0px" y="0px" width="56.6px" height="87.5px" viewBox="0 0 56.6 87.5" enable-background="new 0 0 56.6 87.5" xml:space="preserve"><path fill="#FFFFFF" d="M28.7 64.5c-1.4 0-2.5-1.1-2.5-2.5v-5.7 -5V41c0-1.4 1.1-2.5 2.5-2.5s2.5 1.1 2.5 2.5v10.1 5 5.8C31.2 63.4 30.1 64.5 28.7 64.5zM26.4 0.1C11.9 1 0.3 13.1 0 27.7c-0.1 7.9 3 15.2 8.2 20.4 0.5 0.5 0.8 1 1 1.7l3.1 13.1c0.3 1.1 1.3 1.9 2.4 1.9 0.3 0 0.7-0.1 1.1-0.2 1.1-0.5 1.6-1.8 1.4-3l-2-8.4 -0.4-1.8c-0.7-2.9-2-5.7-4-8 -1-1.2-2-2.5-2.7-3.9C5.8 35.3 4.7 30.3 5.4 25 6.7 14.5 15.2 6.3 25.6 5.1c13.9-1.5 25.8 9.4 25.8 23 0 4.1-1.1 7.9-2.9 11.2 -0.8 1.4-1.7 2.7-2.7 3.9 -2 2.3-3.3 5-4 8L41.4 53l-2 8.4c-0.3 1.2 0.3 2.5 1.4 3 0.3 0.2 0.7 0.2 1.1 0.2 1.1 0 2.2-0.8 2.4-1.9l3.1-13.1c0.2-0.6 0.5-1.2 1-1.7 5-5.1 8.2-12.1 8.2-19.8C56.4 12 42.8-1 26.4 0.1zM43.7 69.6c0 0.5-0.1 0.9-0.3 1.3 -0.4 0.8-0.7 1.6-0.9 2.5 -0.7 3-2 8.6-2 8.6 -1.3 3.2-4.4 5.5-7.9 5.5h-4.1H28h-0.5 -3.6c-3.5 0-6.7-2.4-7.9-5.7l-0.1-0.4 -1.8-7.8c-0.4-1.1-0.8-2.1-1.2-3.1 -0.1-0.3-0.2-0.5-0.2-0.9 0.1-1.3 1.3-2.1 2.6-2.1H41C42.4 67.5 43.6 68.2 43.7 69.6zM37.7 72.5H26.9c-4.2 0-7.2 3.9-6.3 7.9 0.6 1.3 1.8 2.1 3.2 2.1h4.1 0.5 0.5 3.6c1.4 0 2.7-0.8 3.2-2.1L37.7 72.5z"></path></svg></div> 使用 <code class=" language-php">DB</code> facade 的事务方法也适用于 <a href="/docs/5.4/queries">查询语句构造器</a> 和 <a href="/docs/5.4/eloquent">Eloquent ORM</a> 。</blockquote><h2>译者署名</h2><table><thead><tr><th>用户名</th><th>头像</th><th>职能</th><th>签名</th></tr></thead><tbody><tr><td><a href="https://laravel-china.org/users/79">@skyverd</a></td><td><img class="avatar-66 rm-style" src="https://dn-phphub.qbox.me/uploads/avatars/79_1427370664.jpeg?imageView2/1/w/100/h/100"></td><td>翻译</td><td>全桟工程师，<a href="https://skyverd.com">时光博客</a></td></tr></tbody></table></article>