快速入門 · 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>