ThinkPHP 3.2.3 資料庫驅動全面採用 PDO 重寫,配置靈活度大幅提升:支援 DSN 字串、模型級別獨立連線、分布式主從讀寫分離、獨立除錯模式等。本文詳細梳理配置參數變更、連線方式多樣化與實戰範例。
/* 資料庫設定 */
'DB_TYPE' => 'mysql', // 資料庫類型:mysql/sqlite/oracle/pgsql/sqlsrv/firebird
'DB_HOST' => '192.168.1.10', // 伺服器 IP
'DB_NAME' => 'thinkphp', // 資料庫名
'DB_USER' => 'root', // 使用者名稱
'DB_PWD' => '1234', // 密碼
'DB_PORT' => '3306', // 連接埠(空則用預設)
'DB_PREFIX' => 'think_', // 表前綴
'DB_PARAMS' => array(), // PDO 連線參數(第 4 參數)
'DB_DEBUG' => TRUE, // 獨立除錯模式,開啟記錄 SQL 日誌
'DB_LITE' => false, // Lite 模式:僅支援原生 SQL 查詢
'DB_FIELDS_CACHE'=> true, // 啟用欄位緩存
'DB_CHARSET' => 'utf8', // 編碼預設 utf8
'DB_DEPLOY_TYPE' => 0, // 0 集中式(單庫) 1 分布式(主從)
'DB_RW_SEPARATE' => false, // 讀寫分離(主從模式有效)
'DB_MASTER_NUM' => 1, // 主庫數量
'DB_SLAVE_NO' => '', // 指定從庫序號
DB_FIELDTYPE_CHECK // 3.2.3 強制欄位類型檢測
DB_SQL_BUILD_CACHE // 取消 SQL 建構緩存
DB_SQL_BUILD_QUEUE
DB_SQL_BUILD_LENGTH
DB_SQL_LOG // 由 DB_DEBUG 取代
DB_BIND_PARAM // PDO 自動參數綁定,無需設定
DB_DEBUG // 獨立資料庫除錯開關(原綁定 APP_DEBUG)
DB_LITE // 輕量模式,僅支援原生 SQL
'DB_TYPE' => 'mysql',
'DB_HOST' => '192.168.1.10',
'DB_NAME' => 'thinkphp',
'DB_USER' => 'root',
'DB_PWD' => '1234',
'DB_PORT' => '3306',
'DB_PREFIX' => 'think_',
'DB_CHARSET'=> 'utf8',
'DB_DEBUG' => TRUE
$connection 屬性陣列方式(鍵名全小寫):
namespace Home\Model;
use Think\Model;
class UserModel extends Model {
protected $connection = array(
'db_type' => 'mysql',
'db_user' => 'root',
'db_pwd' => '1234',
'db_host' => '192.168.1.10',
'db_port' => '3306',
'db_name' => 'thinkphp',
'db_charset'=> 'utf8',
);
}
DSN 字串方式(格式:類型://用戶:密碼@主機:埠/資料庫#字符集):
protected $connection = 'mysql://root:1234@192.168.1.10:3306/thinkphp#utf8';
引用配置檔預設連線:
'DB_CONFIG1' => array( ... ), // 或 DSN 字串
protected $connection = 'DB_CONFIG1';
$User = M('User', 'other_', 'mysql://root:1234@192.168.1.10/demo#utf8');
// 實例化 User 模型,操作 demo 資料庫的 other_user 表
$User = M('User', 'other_', 'DB_CONFIG2'); // 使用配置檔預設連線
一般無需手動設定,驅動會根據 DB_TYPE 自動生成 PDO DSN。特殊需求(如 SSL、Unix Socket)可手動覆蓋:
'DB_DSN' => 'mysql:host=192.168.1.10;dbname=thinkphp;charset=utf8'
$connection,保持控制器乾淨。DB_DEPLOY_TYPE=1、DB_RW_SEPARATE=true、配置多從庫權重。PDO 重寫帶來的不僅是相容性,更是統一、安全、可擴展的資料存取基礎。