thinkphp5.0數據庫配置

一、配置文件定義

常用的配置方式是在應用目錄或者模塊目錄下面的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');

字符串連接的定義格式爲：

數據庫類型://用戶名:密碼@數據庫地址:數據庫端口/數據庫名#字符集

注意：字符串方式可能無法定義某些參數，例如前綴和連接參數。

如果我們已經在應用配置文件（注意這裏不是數據庫配置文件）中配置了額外的數據庫連接信息，例如：

//數據庫配置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:[email protected]: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在線手冊中的以PDO::ATTR_開頭的常量。