連接數據庫 · thinkphp5

# 連接數據庫 > ThinkPHP內置了抽象數據庫訪問層，把不同的數據庫操作封裝起來，我們只需要使用公共的Db類進行操作，而無需針對不同的數據庫寫不同的代碼和底層實現，Db類會自動調用相應的數據庫驅動來處理。數據庫抽象訪問層基于PDO方式，目前內置包含了Mysql、SqlServer、PgSQL、Sqlite等數據庫的支持。如果應用需要使用數據庫，必須配置數據庫連接信息，數據庫的配置文件有多種定義方式。 ## 配置文件在應用配置目錄或者模塊配置目錄（不清楚配置目錄位置的話參考配置章節）下面的`database.php`中（后面統稱為數據庫配置文件）配置下面的數據庫參數： ``` return [ // 數據庫類型 'type' => 'mysql', // 服務器地址 'hostname' => '127.0.0.1', // 數據庫名 'database' => 'thinkphp', // 數據庫用戶名 'username' => 'root', // 數據庫密碼 'password' => '', // 數據庫連接端口 'hostport' => '', // 數據庫連接參數 'params' => [], // 數據庫編碼默認采用utf8 'charset' => 'utf8', // 數據庫表前綴 'prefix' => 'think_', ]; ``` 系統默認支持的數據庫`type`包括： type數據庫mysqlMySQLsqliteSqLitepgsqlPgSQLsqlsrvSqlServer`type`參數支持命名空間完整定義，不帶命名空間定義的話，默認采用`\think\db\connector`作為命名空間，如果使用應用自己擴展的數據庫驅動，可以配置為： ``` // 數據庫類型 'type' => '\org\db\Mysql', ``` 表示數據庫的連接器采用 `\org\db\Mysql`類作為數據庫連接驅動，而不是默認的`\think\db\connector\Mysql`。每個模塊可以設置獨立的數據庫連接參數，并且相同的配置參數可以無需重復設置，例如我們可以在`admin`模塊的數據庫配置文件中定義： ``` return [ // 服務器地址 'hostname' => '192.168.1.100', // 數據庫名 'database' => 'admin', ]; ``` 表示`admin`模塊的數據庫地址改成 `192.168.1.100`，數據庫名改成`admin`，其它的連接參數和應用的`database.php`中的配置一樣。 ThinkPHP`5.1`支持數據庫的斷線重連機制（默認關閉），需要的話，在數據庫配置文件中設置： ``` // 開啟斷線重連 'break_reconnect' => true, ``` ### 連接參數可以針對不同的連接需要添加數據庫的連接參數（具體的連接參數可以參考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支持的連接參數。 ## 方法配置我們可以調用`Db::connect`方法動態配置數據庫連接信息，例如： ``` Db::connect([ // 數據庫類型 'type' => 'mysql', // 數據庫連接DSN配置 'dsn' => '', // 服務器地址 'hostname' => '127.0.0.1', // 數據庫名 'database' => 'thinkphp', // 數據庫用戶名 'username' => 'root', // 數據庫密碼 'password' => '', // 數據庫連接端口 'hostport' => '', // 數據庫連接參數 'params' => [], // 數據庫編碼默認采用utf8 'charset' => 'utf8', // 數據庫表前綴 'prefix' => 'think_', ]); ``` 或者使用字符串方式： ``` Db::connect('mysql://root:1234@127.0.0.1:3306/thinkphp#utf8'); ``` > `connect`方法必須在查詢的最開始調用，否則可能會導致部分查詢失效。字符串連接的定義格式為： > #### 數據庫類型://用戶名:密碼@數據庫地址:數據庫端口/數據庫名#字符集 > 字符串方式可能無法定義某些參數，例如前綴和連接參數。實際應用中，我們應當盡量避免把數據庫配置信息寫在代碼中，而應該統一定義在配置文件，我們可以在**數據庫配置文件**中增加額外的配置參數，例如： ``` return [ // 數據庫類型 'type' => 'mysql', // 服務器地址 'hostname' => '127.0.0.1', // 數據庫名 'database' => 'thinkphp', // 數據庫用戶名 'username' => 'root', // 數據庫密碼 'password' => '', // 數據庫連接端口 'hostport' => '', // 數據庫連接參數 'params' => [], // 數據庫編碼默認采用utf8 'charset' => 'utf8', // 數據庫表前綴 'prefix' => 'think_', //數據庫配置1 'db_config1' => [ // 數據庫類型 'type' => 'mysql', // 服務器地址 'hostname' => '192.168.1.8', // 數據庫名 'database' => 'thinkphp', // 數據庫用戶名 'username' => 'root', // 數據庫密碼 'password' => '1234', // 數據庫編碼默認采用utf8 'charset' => 'utf8', // 數據庫表前綴 'prefix' => 'think_', ], //數據庫配置2 'db_config2' => 'mysql://root:1234@192.168.1.10:3306/thinkphp#utf8', ]; ``` 然后需要動態鏈接的時候使用下面的方式 ``` Db::connect('db_config1'); Db::connect('db_config2'); ``` 動態連接數據庫的`connect`方法僅對當次查詢有效。 > 這種方式的動態連接和切換數據庫比較方便，經常用于多數據庫連接的應用需求。 ## 模型類定義如果某個模型類里面定義了`connection`屬性的話，則該模型操作的時候會自動按照給定的數據庫配置進行連接，而不是配置文件中設置的默認連接信息，例如： ``` <?php namespace app\index\model; use think\Model; class User extends Model { // 直接使用配置參數名 protected $connection = 'db_config1'; } ``` 和前面一種方法配置一樣，`connection`屬性可以支持數組和字符串方式。 > 需要注意的是，ThinkPHP的數據庫連接是惰性的，所以并不是在實例化的時候就連接數據庫，而是在有實際的數據操作的時候才會去連接數據庫。 ## 數據庫調試模式無論應用是否部署模式，數據庫有自己獨立的調試模式開關，數據庫配置參數中的`debug`參數就是數據庫調試模式的開關（默認關閉）。 ``` // 數據庫調試模式 'debug' => true, ``` 數據庫調試模式開啟后，可以支持下列行為： - 記錄SQL日志； - 分析SQL性能； - 支持SQL監聽；由于上述行為不可避免會產生額外的開銷，因此對性能存在一定的影響，但并不大，因為所有的日志是最終統一一次性寫入，而且可以設置為某個用戶才寫入日志。 > 在生產模式下面，必須關閉應用調試模式（`app_debug`），否則會暴露你的服務器敏感信息。和應用調試模式不同，開啟數據庫調試模式并不會對外暴露任何安全信息，因此是否開啟數據庫調試模式，看自己的需求。 ## 配置參數參考下面是默認支持的數據庫連接信息：參數名描述默認值type數據庫類型無hostname數據庫地址127.0.0.1database數據庫名稱無username數據庫用戶名無password數據庫密碼無hostport數據庫端口號無dsn數據庫連接dsn信息無params數據庫連接參數空charset數據庫編碼utf8prefix數據庫的表前綴無debug是否調試模式falsedeploy數據庫部署方式:0 集中式(單一服務器),1 分布式(主從服務器)0rw\_separate數據庫讀寫是否分離主從式有效falsemaster\_num讀寫分離后主服務器數量1slave\_no指定從服務器序號無fields\_strict是否嚴格檢查字段是否存在trueresultset\_type數據集返回類型arrayauto\_timestamp自動寫入時間戳字段falsesql\_explain是否需要進行SQL性能分析開啟調試有效falsequery指定查詢對象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, ``` 開啟后，系統會自動判斷數據庫斷線并嘗試重新連接。大多數情況下都能自動識別，`V5.1.6+`版本以上如果在一些特殊的情況下或者某些數據庫驅動的斷線標識錯誤還沒有定義，支持配置下面的信息： ``` // 斷線標識字符串 'break_match_str' => [ 'error with', ], ``` 在 `break_match_str`配置中加入你的數據庫錯誤信息關鍵詞。