連接數據庫 · ThinkPHP5.0完全開發手冊

> ThinkPHP內置了抽象數據庫訪問層，把不同的數據庫操作封裝起來，我們只需要使用公共的Db類進行操作，而無需針對不同的數據庫寫不同的代碼和底層實現，Db類會自動調用相應的數據庫驅動來處理。采用PDO方式，目前包含了Mysql、SqlServer、PgSQL、Sqlite等數據庫的支持。如果應用需要使用數據庫，必須配置數據庫連接信息，數據庫的配置文件有多種定義方式。 [TOC=2] ## 一、配置文件定義常用的配置方式是在應用目錄或者模塊目錄下面的`database.php`中添加下面的配置參數： ~~~ return [ // 數據庫類型 'type' => 'mysql', // 數據庫連接DSN配置 'dsn' => '', // 服務器地址 'hostname' => '127.0.0.1', // 數據庫名 'database' => 'thinkphp', // 數據庫用戶名 'username' => 'root', // 數據庫密碼 'password' => '', // 數據庫連接端口 'hostport' => '', // 數據庫連接參數 'params' => [], // 數據庫編碼默認采用utf8 'charset' => 'utf8', // 數據庫表前綴 'prefix' => 'think_', // 數據庫調試模式 'debug' => false, // 數據庫部署方式:0 集中式(單一服務器),1 分布式(主從服務器) 'deploy' => 0, // 數據庫讀寫是否分離主從式有效 'rw_separate' => false, // 讀寫分離后主服務器數量 'master_num' => 1, // 指定從服務器序號 'slave_no' => '', // 是否嚴格檢查字段是否存在 'fields_strict' => true, ]; ~~~ `type`參數支持命名空間完整定義，不帶命名空間定義的話，默認采用`\think\db\connector`作為命名空間，如果使用應用自己擴展的數據庫驅動，可以配置為： ~~~ // 數據庫類型 'type' => '\org\db\Mysql', ~~~ 表示數據庫的連接器采用 `\org\db\Mysql`類作為數據庫連接驅動，而不是默認的`\think\db\connector\Mysql`。每個模塊可以設置獨立的數據庫連接參數，并且相同的配置參數可以無需重復設置，例如我們可以在admin模塊的database.php配置文件中定義： ~~~ return [ // 服務器地址 'hostname' => '192.168.1.100', // 數據庫名 'database' => 'admin', ]; ~~~ 表示admin模塊的數據庫地址改成 `192.168.1.100`，數據庫名改成`admin`，其它的連接參數和應用的`database.php`中的配置一樣。 `V5.0.6+`版本開始，支持Mysql的斷線重連機制，默認關閉，需要的話，是數據庫配置文件中添加： ~~~ // 開啟斷線重連 '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, ~~~ 在database中設置的params參數中的連接配置將會和內置的設置參數合并，如果需要使用長連接，并且返回數據庫的小寫列名，可以采用下面的方式定義： ~~~ 'params' => [ \PDO::ATTR_PERSISTENT => true, \PDO::ATTR_CASE => \PDO::CASE_LOWER, ], ~~~ > 你可以在params里面配置任何PDO支持的連接參數。 ## 二、方法配置我們可以在調用Db類的時候動態定義連接信息，例如： ~~~ 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'); ~~~ 字符串連接的定義格式為： >[info] #### 數據庫類型://用戶名:密碼@數據庫地址:數據庫端口/數據庫名#字符集注意：字符串方式可能無法定義某些參數，例如前綴和連接參數。如果我們已經在**應用配置文件**（注意這里不是數據庫配置文件）中配置了額外的數據庫連接信息，例如： ~~~ //數據庫配置1 'db_config1' => [ // 數據庫類型 'type' => 'mysql', // 服務器地址 'hostname' => '127.0.0.1', // 數據庫名 'database' => 'thinkphp', // 數據庫用戶名 'username' => 'root', // 數據庫密碼 'password' => '', // 數據庫編碼默認采用utf8 'charset' => 'utf8', // 數據庫表前綴 'prefix' => 'think_', ], //數據庫配置2 'db_config2' => 'mysql://root:1234@localhost:3306/thinkphp#utf8'; ~~~ 我們可以改成 ~~~ Db::connect('db_config1'); Db::connect('db_config2'); ~~~ ## 三、模型類定義如果在某個模型類里面定義了`connection`屬性的話，則該模型操作的時候會自動連接給定的數據庫連接，而不是配置文件中設置的默認連接信息，通常用于某些數據表位于當前數據庫連接之外的其它數據庫，例如： ~~~ //在模型里單獨設置數據庫連接信息 namespace app\index\model; use think\Model; class User extends Model { protected $connection = [ // 數據庫類型 'type' => 'mysql', // 數據庫連接DSN配置 'dsn' => '', // 服務器地址 'hostname' => '127.0.0.1', // 數據庫名 'database' => 'thinkphp', // 數據庫用戶名 'username' => 'root', // 數據庫密碼 'password' => '', // 數據庫連接端口 'hostport' => '', // 數據庫連接參數 'params' => [], // 數據庫編碼默認采用utf8 'charset' => 'utf8', // 數據庫表前綴 'prefix' => 'think_', ]; } ~~~ 也可以采用DSN字符串方式定義，例如： ~~~ //在模型里單獨設置數據庫連接信息 namespace app\index\model; use think\Model; class User extends Model { //或者使用字符串定義 protected $connection = 'mysql://root:1234@127.0.0.1:3306/thinkphp#utf8'; } ~~~ 并且支持直接使用數據庫連接的配置名稱，例如： ~~~ //在模型里單獨設置數據庫連接信息 namespace app\index\model; use think\Model; class User extends Model { // 直接使用配置參數名 protected $connection = 'db_config1'; } ~~~ > 需要注意的是，ThinkPHP的數據庫連接是惰性的，所以并不是在實例化的時候就連接數據庫，而是在有實際的數據操作的時候才會去連接數據庫。 ## 配置參數參考下面是默認支持的數據庫連接信息： |參數名|描述|默認值| |---|---|---| |type|數據庫類型|無| |hostname|數據庫地址|127.0.0.1| |database|數據庫名稱|無| |username|數據庫用戶名|無| |password|數據庫密碼|無| |hostport|數據庫端口號|無| |dsn|數據庫連接dsn信息|無| |params|數據庫連接參數|空| |charset|數據庫編碼|utf8| |prefix|數據庫的表前綴|無| |debug|是否調試模式|false| |deploy|數據庫部署方式:0 集中式(單一服務器),1 分布式(主從服務器)|0| |rw_separate|數據庫讀寫是否分離主從式有效|false| |master_num|讀寫分離后主服務器數量|1| |slave_no|指定從服務器序號|無| |fields_strict|是否嚴格檢查字段是否存在|true| |resultset_type|數據集返回類型|array| |auto_timestamp|自動寫入時間戳字段|false| |sql_explain|是否需要進行SQL性能分析開啟調試有效|false| |query|指定查詢對象|think\db\Query| |builder|指定數據庫Builder對象|無| 常用數據庫連接參數（params）可以參考[PHP在線手冊](http://php.net/manual/zh/pdo.constants.php)中的以`PDO::ATTR_`開頭的常量。 >[danger]#### 注意： >*** > 如果是使用`pgsql`數據庫驅動的話，請先導入 `thinkphp/library/think/db/connector/pgsql.sql`文件到數據庫執行。