ThinkPHP 數據庫操作(一) : 連接數據庫

　　ThinkPHP內置了抽象數據庫訪問層，把不同的數據庫操作封裝起來，我們只需要使用公共的Db類進行操 作，而無需針對不同的數據庫寫不同的代碼和底層實現，Db類會自動調用相應的數據庫驅動來處理。採用 PDO方式，目前包含了Mysql、SqlServer、PgSQL、Sqlite等數據庫的支持。

　　如果應用需要使用數據庫，必須配置數據庫連接信息，數據庫的配置文件有多種定義方式。 

• 一、配置文件定義
• 二、方法配置
• 三、模型類定義
• 配置參數參考

一、配置文件定義

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

需要注意的是，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對象	無

 

注意：

　　如果是使用 pgsql 數據庫驅動的話，請先導入 thinkphp/library/think/db/connector/pgsql.sql 文件到數據庫執行。