數據庫 ―― 起步 · Laravel 5.1 中文文檔

# 數據庫 —— 起步 ## 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)