分布式數據庫 · ThinkPHP5.1完全開發手冊

## 分布式支持數據訪問層支持分布式數據庫，包括讀寫分離，要啟用分布式數據庫，需要開啟數據庫配置文件中的`deploy`參數： ~~~ return [ // 啟用分布式數據庫 'deploy' => 1, // 數據庫類型 'type' => 'mysql', // 服務器地址 'hostname' => '192.168.1.1,192.168.1.2', // 數據庫名 'database' => 'demo', // 數據庫用戶名 'username' => 'root', // 數據庫密碼 'password' => '', // 數據庫連接端口 'hostport' => '', ]; ~~~ >[info] 啟用分布式數據庫后，`hostname`參數是關鍵，`hostname`的個數決定了分布式數據庫的數量，默認情況下第一個地址就是主服務器。主從服務器支持設置不同的連接參數，包括： |連接參數| |---| |username| |password| |hostport| |database| |dsn| |charset| 如果主從服務器的上述參數一致的話，只需要設置一個，對于不同的參數，可以分別設置，例如： ~~~ return [ // 啟用分布式數據庫 'deploy' => 1, // 數據庫類型 'type' => 'mysql', // 服務器地址 'hostname' => '192.168.1.1,192.168.1.2,192.168.1.3', // 數據庫名 'database' => 'demo', // 數據庫用戶名 'username' => 'root,slave,slave', // 數據庫密碼 'password' => '123456', // 數據庫連接端口 'hostport' => '', // 數據庫字符集 'charset' => 'utf8', ]; ~~~ >[danger] 記住，要么相同，要么每個都要設置。 `V5.1.25+`版本開始，分布式的數據庫參數支持使用數組定義（通常為了避免多個賬號和密碼的誤解析），例如： ~~~ return [ // 啟用分布式數據庫 'deploy' => 1, // 數據庫類型 'type' => 'mysql', // 服務器地址 'hostname' =>[ '192.168.1.1','192.168.1.2','192.168.1.3'], // 數據庫名 'database' => 'demo', // 數據庫用戶名 'username' => 'root,slave,slave', // 數據庫密碼 'password' => ['123456','abc,def','hello'] // 數據庫連接端口 'hostport' => '', // 數據庫字符集 'charset' => 'utf8', ]; ~~~ 還可以設置分布式數據庫的讀寫是否分離，默認的情況下讀寫不分離，也就是每臺服務器都可以進行讀寫操作，對于主從式數據庫而言，需要設置讀寫分離，通過下面的設置就可以： ~~~ 'rw_separate' => true, ~~~ 在讀寫分離的情況下，默認第一個數據庫配置是主服務器的配置信息，負責寫入數據，如果設置了`master_num`參數，則可以支持多個主服務器寫入（每次隨機連接其中一個主服務器）。其它的地址都是從數據庫，負責讀取數據，數量不限制。每次連接從服務器并且進行讀取操作的時候，系統會隨機進行在從服務器中選擇。同一個數據庫連接的每次請求只會連接一次主服務器和從服務器，如果某次請求的從服務器連接不上，會自動切換到主服務器進行查詢操作。如果不希望隨機讀取，或者某種情況下其它從服務器暫時不可用，還可以設置`slave_no` 指定固定服務器進行讀操作，`slave_no`指定的序號表示`hostname`中數據庫地址的序號，從`0`開始。調用查詢類或者模型的`CURD`操作的話，系統會自動判斷當前執行的方法是讀操作還是寫操作并自動連接主從服務器，如果你用的是原生SQL，那么需要注意系統的默認規則：寫操作必須用數據庫的`execute`方法，讀操作必須用數據庫的`query`方法，否則會發生主從讀寫錯亂的情況。發生下列情況的話，會自動連接主服務器： * 使用了數據庫的寫操作方法（`execute`/`insert`/`update`/`delete`以及衍生方法）； * 如果調用了數據庫事務方法的話，會自動連接主服務器； * 從服務器連接失敗，會自動連接主服務器； * 調用了查詢構造器的`lock`方法； * 調用了查詢構造器的`master`方法 >[danger] 主從數據庫的數據同步工作不在框架實現，需要數據庫考慮自身的同步或者復制機制。如果在大數據量或者特殊的情況下寫入數據后可能會存在同步延遲的情況，可以調用`master()`方法進行主庫查詢操作。 >[info] 在實際生產環境中，很多云主機的數據庫分布式實現機制和本地開發會有所區別，但通常會采下面用兩種方式： > > * 第一種：提供了寫IP和讀IP（一般是虛擬IP），進行數據庫的讀寫分離操作； > * 第二種：始終保持同一個IP連接數據庫，內部會進行讀寫分離IP調度（阿里云就是采用該方式）。