CodeIgniter4 數(shù)據(jù)庫(kù)配置

CodeIgniter 有一個(gè)用來(lái)保存數(shù)據(jù)庫(kù)配置的文件（用戶名，密碼，數(shù)據(jù)庫(kù)名等），這個(gè)配置文件位于 application/Config/Database.php。你也可以在 .env 文件里配置數(shù)據(jù)庫(kù)連接參數(shù)。下面來(lái)看看詳細(xì)配置信息。

配置信息是一個(gè)數(shù)組，存儲(chǔ)在類的屬性里面，原型如下:

public $default = [
        'DSN'   => '',
        'hostname' => 'localhost',
        'username' => 'root',
        'password' => '',
        'database' => 'database_name',
        'DBDriver' => 'MySQLi',
        'DBPrefix' => '',
        'pConnect' => TRUE,
        'DBDebug'  => TRUE,
        'cacheOn'  => FALSE,
        'cacheDir' => '',
        'charset'  => 'utf8',
        'DBCollat' => 'utf8_general_ci',
        'swapPre'  => '',
        'encrypt'  => FALSE,
        'compress' => FALSE,
        'strictOn' => FALSE,
        'failover' => array(),
];

類的屬性名稱就是連接名稱，并且在連接時(shí)可以作為指定配置組名稱使用。

有些數(shù)據(jù)庫(kù)驅(qū)動(dòng)（例如：PDO，PostgreSQL，Oracle，ODBC）可能需要提供完整的 DNS 信息。在這種情況下，你需要使用 DNS 配置參數(shù)，就像使用該驅(qū)動(dòng)的原生 PHP 擴(kuò)展一樣，例如:

// PDO
$default['DSN'] = 'pgsql:host=localhost;port=5432;dbname=database_name';


// Oracle
$default['DSN'] = '//localhost/XE';

注解

如果你沒(méi)有指定 DNS 驅(qū)動(dòng)需要的參數(shù)信息，CodeIgniter 將使用你提供的其它配置信息自動(dòng)構(gòu)造它。

如果你提供了一個(gè) DNS 參數(shù)，但是缺少了某些配置（例如：數(shù)據(jù)庫(kù)的字符集），若該配置存在在其它的配置項(xiàng)中，CodeIgniter 將自動(dòng)在 DNS 上附加上該配置。

當(dāng)主數(shù)據(jù)庫(kù)由于某些原因無(wú)法連接時(shí)，你可以配置多個(gè)災(zāi)備數(shù)據(jù)庫(kù)。例如可以像下面這樣為一個(gè)連接配置災(zāi)備數(shù)據(jù)庫(kù):

$default['failover'] = [
                [
                        'hostname' => 'localhost1',
                        'username' => '',
                        'password' => '',
                        'database' => '',
                        'DBDriver' => 'MySQLi',
                        'DBPrefix' => '',
                        'pConnect' => TRUE,
                        'DBDebug'  => TRUE,
                        'cacheOn'  => FALSE,
                        'cacheDir' => '',
                        'charset'  => 'utf8',
                        'DBCollat' => 'utf8_general_ci',
                        'swapPre'  => '',
                        'encrypt'  => FALSE,
                        'compress' => FALSE,
                        'strictOn' => FALSE
                ],
                [
                        'hostname' => 'localhost2',
                        'username' => '',
                        'password' => '',
                        'database' => '',
                        'DBDriver' => 'MySQLi',
                        'DBPrefix' => '',
                        'pConnect' => TRUE,
                        'DBDebug'  => TRUE,
                        'cacheOn'  => FALSE,
                        'cacheDir' => '',
                        'charset'  => 'utf8',
                        'DBCollat' => 'utf8_general_ci',
                        'swapPre'  => '',
                        'encrypt'  => FALSE,
                        'compress' => FALSE,
                        'strictOn' => FALSE
                ]
        ];

你可以指定任意多個(gè)災(zāi)備數(shù)據(jù)庫(kù)配置。

你可以選擇性地存儲(chǔ)多組連接信息。例如，在一個(gè)安裝實(shí)例里面運(yùn)行多個(gè)環(huán)境（開發(fā)、生產(chǎn)、測(cè)試等），你可以為每個(gè)環(huán)境配置連接組，然后在組之間進(jìn)行切換。舉個(gè)例子：若要設(shè)置一個(gè) ‘test’ 環(huán)境，你可以這么做:

public $test = [
        'DSN'   => '',
        'hostname' => 'localhost',
        'username' => 'root',
        'password' => '',
        'database' => 'database_name',
        'DBDriver' => 'MySQLi',
        'DBPrefix' => '',
        'pConnect' => TRUE,
        'DBDebug'  => TRUE,
        'cacheOn'  => FALSE,
        'cacheDir' => '',
        'charset'  => 'utf8',
        'DBCollat' => 'utf8_general_ci',
        'swapPre'  => '',
        'compress' => FALSE,
        'encrypt'  => FALSE,
        'strictOn' => FALSE,
        'failover' => array()
);

然后，修改該配置文件中的屬性值，告知系統(tǒng)使用該組信息:

$defaultGroup = 'test';

注解

組名稱 ‘test’ 是任意的。它可以是你想要的任意名稱。默認(rèn)情況下，主連接使用 ‘default’ 這個(gè)名稱，但你也可以起一個(gè)與你項(xiàng)目更加相關(guān)的名稱。

你可以修改配置文件里面類的構(gòu)造函數(shù)，讓它自動(dòng)檢測(cè)運(yùn)行環(huán)境并將 ‘defaultGroup’ 更新為正確的值:

class Database
{
    public $development = [...];
    public $test        = [...];
    public $production  = [...];


        public function __construct()
        {
                $this->defaultGroup = ENVIRONMENT;
        }
}

配置 .env 文件

你也可以將當(dāng)前服務(wù)器的數(shù)據(jù)庫(kù)配置保存到 .env 文件 中。你只需要在默認(rèn)配置組中輸入你想要變更的值。該值在 default 組中的格式為:

database.default.username = 'root';
database.default.password = '';
database.default.database = 'ci4';

其它信息

參數(shù)解釋:

注解

根據(jù)你使用的數(shù)據(jù)庫(kù)平臺(tái)（MySQL、PostgreSQL等）不是所有參數(shù)都要配置。例如，當(dāng)你使用 SQLite 時(shí)，你無(wú)需指定用戶名和密碼，數(shù)據(jù)庫(kù)名稱是你的數(shù)據(jù)庫(kù)文件路徑。以上內(nèi)容假設(shè)你使用的是 MySQL 數(shù)據(jù)庫(kù)。