鏈接數據庫配置 · thinkphp6文檔

如果應用需要使用數據庫，必須配置數據庫連接信息，數據庫的配置文件有多種定義方式。 ## **配置文件** 在全局或者應用配置目錄（不清楚配置目錄位置的話參考配置章節）下面的`database.php`中（后面統稱為數據庫配置文件）配置下面的數據庫參數： ~~~ return [ // 默認使用的數據庫連接配置 'default' => 'mysql', // 自定義時間查詢規則 'time_query_rule' => [], // 自動寫入時間戳字段 // true為自動識別類型 false關閉 // 字符串則明確指定時間字段類型支持 int timestamp datetime date 'auto_timestamp' => true, // 時間字段取出后的默認時間格式 'datetime_format' => 'Y-m-d H:i:s', 'connections' => [ 'mysql' => [ // 數據庫類型 'type' => 'mysql', // 服務器地址 'hostname' => '127.0.0.1', // 數據庫名 'database' => 'thinkphp',//可以用.env文件配置 env('database.database', ''), // 數據庫用戶名 'username' => 'root', // 數據庫密碼 'password' => '', // 數據庫連接端口 'hostport' => '', // 數據庫連接參數 'params' => [], // 數據庫編碼默認采用utf8 'charset' => 'utf8', // 數據庫表前綴 'prefix' => 'think_', // 數據庫部署方式:0 集中式(單一服務器),1 分布式(主從服務器) 'deploy' => 0, // 數據庫讀寫是否分離主從式有效 'rw_separate' => false, // 讀寫分離后主服務器數量 'master_num' => 1, // 指定從服務器序號 'slave_no' => '', // 是否嚴格檢查字段是否存在 'fields_strict' => true, // 是否需要斷線重連 'break_reconnect' => false, // 監聽SQL 'trigger_sql' => env('app_debug', true), // 開啟字段緩存 'fields_cache' => false, // 字段緩存路徑 'schema_cache_path' => app()->getRuntimePath() . 'schema' . DIRECTORY_SEPARATOR, ], ], ]; ~~~ 新版采用多類型的方式配置，方便切換數據庫。 `default`配置用于設置默認使用的數據庫連接配置。 `connections`配置具體的數據庫連接信息，`default`配置參數定義的連接配置必須要存在。 `type`參數用于指定數據庫類型 | type | 數據庫 | | --- | --- | | mysql | MySQL | | sqlite | SqLite | | pgsql | PostgreSQL | | sqlsrv | SqlServer | | mongo | MongoDb | | oracle | Oracle | 每個應用可以設置獨立的數據庫連接參數，通常直接更改`default`參數即可： ~~~ return [ 'default' => 'admin', ]; ~~~ ### 連接參數可以針對不同的連接需要添加數據庫的連接參數（具體的連接參數可以參考PHP手冊），內置采用的參數包括如下： ~~~ PDO::ATTR_CASE => PDO::CASE_NATURAL, PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_ORACLE_NULLS => PDO::NULL_NATURAL, PDO::ATTR_STRINGIFY_FETCHES => false, PDO::ATTR_EMULATE_PREPARES => false, ~~~ 在數據庫配置文件中設置的`params`參數中的連接配置將會和內置的設置參數合并，如果需要使用長連接，并且返回數據庫的小寫列名，可以在數據庫配置文件中增加下面的定義： ~~~ 'params' => [ \PDO::ATTR_PERSISTENT => true, \PDO::ATTR_CASE => \PDO::CASE_LOWER, ], ~~~ > 你可以在`params`參數里面配置任何PDO支持的連接參數。 ## 切換連接我們可以在數據庫配置文件中定義多個連接信息 ~~~ return [ 'default' => 'mysql', 'connections' => [ 'mysql' => [ // 數據庫類型 'type' => 'mysql', // 服務器地址 'hostname' => '127.0.0.1', // 數據庫名 'database' => 'thinkphp', // 數據庫用戶名 'username' => 'root', // 數據庫密碼 'password' => '', // 數據庫連接端口 'hostport' => '', // 數據庫連接參數 'params' => [], // 數據庫編碼默認采用utf8 'charset' => 'utf8', // 數據庫表前綴 'prefix' => 'think_', ], 'demo' => [ // 數據庫類型 'type' => 'mysql', // 服務器地址 'hostname' => '127.0.0.1', // 數據庫名 'database' => 'demo', // 數據庫用戶名 'username' => 'root', // 數據庫密碼 'password' => '', // 數據庫連接端口 'hostport' => '', // 數據庫連接參數 'params' => [], // 數據庫編碼默認采用utf8 'charset' => 'utf8', // 數據庫表前綴 'prefix' => 'think_', ], ], ]; ~~~ 我們可以調用`Db::connect`方法動態配置數據庫連接信息，例如： ~~~ \think\facade\Db::connect('demo') ->table('user') ->find(); ~~~ > `connect`方法必須在查詢的最開始調用，而且必須緊跟著調用查詢方法，否則可能會導致部分查詢失效或者依然使用默認的數據庫連接。動態連接數據庫的`connect`方法僅對當次查詢有效。 > 這種方式的動態連接和切換數據庫比較方便，經常用于多數據庫連接的應用需求。 ## 模型類定義如果某個模型類里面定義了`connection`屬性的話，則該模型操作的時候會自動按照給定的數據庫配置進行連接，而不是配置文件中設置的默認連接信息，例如： ~~~ <?php namespace app\index\model; use think\Model; class User extends Model { protected $connection = 'demo'; } ~~~ > 需要注意的是，ThinkPHP的數據庫連接是惰性的，所以并不是在實例化的時候就連接數據庫，而是在有實際的數據操作的時候才會去連接數據庫。 ## 配置參數參考下面是默認支持的數據庫連接信息： | 參數名 | 描述 | 默認值 | | --- | --- | --- | | type | 數據庫類型 | 無 | | hostname | 數據庫地址 | 127.0.0.1 | | database | 數據庫名稱 | 無 | | username | 數據庫用戶名 | 無 | | password | 數據庫密碼 | 無 | | hostport | 數據庫端口號 | 無 | | dsn | 數據庫連接dsn信息 | 無 | | params | 數據庫連接參數 | 空 | | charset | 數據庫編碼 | utf8 | | prefix | 數據庫的表前綴 | 無 | | deploy | 數據庫部署方式:0 集中式(單一服務器),1 分布式(主從服務器) | 0 | | rw\_separate | 數據庫讀寫是否分離主從式有效 | false | | master\_num | 讀寫分離后主服務器數量 | 1 | | slave\_no | 指定從服務器序號 | 無 | | fields\_strict | 是否嚴格檢查字段是否存在 | true | | fields\_cache | 是否開啟字段緩存 | false | | schema\_cache\_path | 字段緩存目錄 | 無 | | trigger\_sql | 是否開啟SQL監聽 | true | | auto\_timestamp | 自動寫入時間戳字段 | false | | query | 指定查詢對象 | think\\db\\Query | 常用數據庫連接參數（`params`）可以參考[PHP在線手冊](http://php.net/manual/zh/pdo.constants.php)中的以`PDO::ATTR_`開頭的常量。如果同時定義了參數化數據庫連接信息和 dsn信息，則會優先使用dsn信息。 > 如果是使用`pgsql`數據庫驅動的話，請先導入`thinkphp/library/think/db/connector/pgsql.sql`文件到數據庫執行。 ## 斷線重連如果你使用的是長連接或者命令行，在超出一定時間后，數據庫連接會斷開，這個時候你需要開啟斷線重連才能確保應用不中斷。在數據庫連接配置中設置： ~~~ // 開啟斷線重連 'break_reconnect' => true, ~~~ 開啟后，系統會自動判斷數據庫斷線并嘗試重新連接。大多數情況下都能自動識別，如果在一些特殊的情況下或者某些數據庫驅動的斷線標識錯誤還沒有定義，支持配置下面的信息： ~~~ // 斷線標識字符串 'break_match_str' => [ 'error with', ], ~~~ 在`break_match_str`配置中加入你的數據庫錯誤信息關鍵詞。