CodeIgniter自帶的數據庫類使用介紹

在 CodeIgniter 中，使用數據庫是非常頻繁的事情。你可以使用框架自帶的數據庫類，就能便捷地進行數據庫操作。

初始化數據庫類

依據你的數據庫配置載入並初始化數據庫類：

$this->load->database();

被載入之後你可以在任何地方使用它。

以對象形式返回查詢結果

$query = $this->db->query('SELECT name, title, email FROM my_table');

foreach ($query->result() as $row)
{
    echo $row->title;
    echo $row->name;
    echo $row->email;
}

echo 'Total Results: ' . $query->num_rows();

上面的result()函數返回一個對象的數組。例如：$row->title

以數組形式返回查詢結果

$query = $this->db->query('SELECT name, title, email FROM my_table');

foreach ($query->result_array() as $row)
{
    echo $row['title'];
    echo $row['name'];
    echo $row['email'];
}

上面的result_array()函數返回一個帶下標的數組。例如：$row['title']

返回一條數據

對象形式：

$query = $this->db->query('SELECT name FROM my_table LIMIT 1');

$row = $query->row();
echo $row->name;

上面的row()函數返回一個 對象。例如：$row->name

數組形式：

$query = $this->db->query('SELECT name FROM my_table LIMIT 1');

$row = $query->row_array();
echo $row['name'];

上面的row_array()函數返回一個 數組。例如：$row['name']

插入(insert)數據

$sql = "INSERT INTO mytable (title, name) 
        VALUES (".$this->db->escape($title).", ".$this->db->escape($name).")";

$this->db->query($sql);

echo $this->db->affected_rows();

快捷插入方式：

$data = array(
               'title' => $title,
               'name' => $name,
               'date' => $date
            );

$this->db->insert('mytable', $data); 

// Produces: INSERT INTO mytable (title, name, date) VALUES ('{$title}', '{$name}', '{$date}')

數據庫配置

CodeIgniter 有一個配置文件讓你存放數據庫連接值（username:用戶名，password:密碼，database name:數據庫名，等等..）. 配置文件位於以下路徑：application/config/database.php

配件文件存放在一個如下格式的一個多維數組裡：

$db['default']['hostname'] = "localhost";
$db['default']['username'] = "root";
$db['default']['password'] = "";
$db['default']['database'] = "database_name";
$db['default']['dbdriver'] = "mysql";
$db['default']['dbprefix'] = "";
$db['default']['pconnect'] = TRUE;
$db['default']['db_debug'] = FALSE;
$db['default']['cache_on'] = FALSE;
$db['default']['cachedir'] = "";
$db['default']['char_set'] = "utf8";
$db['default']['dbcollat'] = "utf8_general_ci";

使用多維數組的原因是為了讓你隨意的存儲多個連接值的設置。舉例：如果你運行多個環境（development：開發、production：制作、test：測試 等等..），你能為每個環境建立獨立的連接組，並在組直接進行切換。舉例，設置一個"test"環境，你可以這樣做：

$db['test']['hostname'] = "localhost";
$db['test']['username'] = "root";
$db['test']['password'] = "";
$db['test']['database'] = "database_name";
$db['test']['dbdriver'] = "mysql";
$db['test']['dbprefix'] = "";
$db['test']['pconnect'] = TRUE;
$db['test']['db_debug'] = FALSE;
$db['test']['cache_on'] = FALSE;
$db['test']['cachedir'] = "";
$db['test']['char_set'] = "utf8";
$db['test']['dbcollat'] = "utf8_general_ci";

那麼，告訴系統使用"test"組，你可以設置位於配置文件中的變量：

$active_group = "test";

注意: "test"的名字是任意的，這可以讓你自由設置，我們的主要連接默認使用"default"這個名字，當然，您可以基於您的項目為它起一個更有意義的名字。

Active Record

Active Record 類 可以通過數據庫配置文件裡的$active_record變量進行全局的設定（允許/禁止 TRUE/FALSE (boolean)）. 如果你不用這個類，哪麼你可以通過將這個變量值設置成FALSE來減少在數據庫類初始化時對電腦資源的消耗。 $active_record = TRUE;

注意： 一些CodeIgniter的類，例如Sessions，在執行一些函數的時候需要Active Records的支持。

參數解析：

• hostname - 數據庫的主機名，通常位於本機，可以表示為 "localhost". 
• username - 需要連接到數據庫的用戶名. 
• password - 登陸數據庫的密碼. 
• database - 你需要連接的數據庫名. 
• dbdriver - 數據庫類型。如：mysql、postgres、odbc 等。必須為小寫字母。 
• dbprefix - 當運行Active Record查詢時數據表的前綴,它允許在一個數據庫上安裝多個CodeIgniter程序. 
• pconnect - TRUE/FALSE (boolean) - 使用持續連接. 
• db_debug - TRUE/FALSE (boolean) - 顯示數據庫錯誤信息. 
• cache_on - TRUE/FALSE (boolean) - 數據庫查詢緩存是否開啟，詳情請見數據庫緩存類。 
• cachedir - 數據庫查詢緩存目錄所在的服務器絕對路徑。 
• char_set - 與數據庫通信時所使用的字符集。 
• dbcollat - 與數據庫通信時所使用的字符規則(character collation )。 
• port - 數據庫端口號. 當前只用於 Postgres 驅動程序. 要使用這個值，你應該添加一行代碼到數據庫配置數組。

記錄一下，方便查閱。