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

CodeIgniter 有一個(gè)配置文件用來(lái)保存數(shù)據(jù)庫(kù)連接值（用戶名、密碼、數(shù)據(jù)庫(kù)名等等）， 這個(gè)配置文件位于 application/config/database.php 。 你也可以放置不同的 database.php 文件到特定的環(huán)境配置文件夾里 來(lái)設(shè)置 特定環(huán)境 的數(shù)據(jù)庫(kù)連接值。

配置存放在一個(gè)多維數(shù)組里，原型如下:

$db['default'] = array(
    'dsn'   => '',
    'hostname' => 'localhost',
    'username' => 'root',
    'password' => '',
    'database' => 'database_name',
    'dbdriver' => 'mysqli',
    'dbprefix' => '',
    'pconnect' => TRUE,
    'db_debug' => TRUE,
    'cache_on' => FALSE,
    'cachedir' => '',
    'char_set' => 'utf8',
    'dbcollat' => 'utf8_general_ci',
    'swap_pre' => '',
    'encrypt' => FALSE,
    'compress' => FALSE,
    'stricton' => FALSE,
    'failover' => array()
);

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

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

// Oracle
$db['default']['dsn'] = '//localhost/XE';

注解

如果你沒(méi)有為需要 DSN 參數(shù)的驅(qū)動(dòng)指定 DSN 字符串，CodeIgniter 將使用你提供的其他配置信息自動(dòng)生成它。

注解

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

當(dāng)主數(shù)據(jù)庫(kù)由于某些原因無(wú)法連接時(shí)，你還可以配置故障轉(zhuǎn)移（failover）。 可以像下面這樣為一個(gè)連接配置故障轉(zhuǎn)移:

$db['default']['failover'] = array(
        array(
            'hostname' => 'localhost1',
            'username' => '',
            'password' => '',
            'database' => '',
            'dbdriver' => 'mysqli',
            'dbprefix' => '',
            'pconnect' => TRUE,
            'db_debug' => TRUE,
            'cache_on' => FALSE,
            'cachedir' => '',
            'char_set' => 'utf8',
            'dbcollat' => 'utf8_general_ci',
            'swap_pre' => '',
            'encrypt' => FALSE,
            'compress' => FALSE,
            'stricton' => FALSE
        ),
        array(
            'hostname' => 'localhost2',
            'username' => '',
            'password' => '',
            'database' => '',
            'dbdriver' => 'mysqli',
            'dbprefix' => '',
            'pconnect' => TRUE,
            'db_debug' => TRUE,
            'cache_on' => FALSE,
            'cachedir' => '',
            'char_set' => 'utf8',
            'dbcollat' => 'utf8_general_ci',
            'swap_pre' => '',
            'encrypt' => FALSE,
            'compress' => FALSE,
            'stricton' => FALSE
        )
    );

你可以指定任意多個(gè)故障轉(zhuǎn)移。

我們使用多維數(shù)組的原因是為了讓你隨意的存儲(chǔ)多個(gè)連接值的設(shè)置， 譬如：如果你有多個(gè)環(huán)境（開發(fā)、生產(chǎn)、測(cè)試 等等）， 你能為每個(gè)環(huán)境建立獨(dú)立的連接組，并在組之間進(jìn)行切換。 舉個(gè)例子，如果要設(shè)置一個(gè) "test" 環(huán)境，你可以這樣做:

$db['test'] = array(
    'dsn'   => '',
    'hostname' => 'localhost',
    'username' => 'root',
    'password' => '',
    'database' => 'database_name',
    'dbdriver' => 'mysqli',
    'dbprefix' => '',
    'pconnect' => TRUE,
    'db_debug' => TRUE,
    'cache_on' => FALSE,
    'cachedir' => '',
    'char_set' => 'utf8',
    'dbcollat' => 'utf8_general_ci',
    'swap_pre' => '',
    'compress' => FALSE,
    'encrypt' => FALSE,
    'stricton' => FALSE,
    'failover' => array()
);

然后，設(shè)置位于配置文件中的 $active_group 變量，告訴系統(tǒng)要使用 "test" 組:

$active_group = 'test';

注解

分組的名稱 "test" 是任意的，你可以取任意的名字。默認(rèn)情況下， 主連接使用 "default" 這個(gè)名稱。當(dāng)然，您可以基于您的項(xiàng)目為它起一個(gè)更有意義的名字。

查詢構(gòu)造器

可以通過(guò)數(shù)據(jù)庫(kù)配置文件里的 $query_builder 變量對(duì) 查詢構(gòu)造器類 進(jìn)行全局的設(shè)定（啟用設(shè)成 TRUE，禁用設(shè)成 FALSE，默認(rèn)是 TRUE）。 如果你不用這個(gè)類，那么你可以通過(guò)將這個(gè)變量值設(shè)置成 FALSE 來(lái)減少在數(shù)據(jù)庫(kù)類初始化時(shí)對(duì)電腦資源的消耗。

$query_builder = TRUE;

注解

一些 CodeIgniter 的類，例如 Sessions，在執(zhí)行一些函數(shù)的時(shí)候需要查詢構(gòu)造器的支持。

參數(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ù)。