CodeIgniter 資料庫操作函式完整速查表

彙整 CodeIgniter 常用資料庫操作函式，包含查詢結果處理、新增、更新、查詢建構器、條件語法等，方便開發快速查閱。

查詢結果處理

$query = $this->db->query("SELECT * FROM table");

$query->result();        // 回傳物件陣列
$query->result_array();  // 回傳關聯陣列
$query->row();           // 單筆物件
$query->row_array();     // 單筆關聯陣列
$query->num_rows();      // 結果筆數
$query->num_fields();    // 欄位數
$query->free_result();   // 釋放記憶體

新增與更新輔助

// 取得最後新增的 ID
$this->db->insert_id();

// 影響行數 (UPDATE/INSERT)
$this->db->affected_rows();

// 取得資料表總列數
$this->db->count_all('table_name');

// 取得資料庫版本與平台
$this->db->version();
$this->db->platform();

// 取得最後執行的 SQL
$this->db->last_query();

// 產生 INSERT/UPDATE 字串 (自動轉義)
$this->db->insert_string('table_name', $data);
$this->db->update_string('table_name', $data, $where);

查詢建構器

// 取得全部資料
$this->db->get('table_name');

// 分頁：LIMIT 10 OFFSET 20
$this->db->get('table_name', 10, 20);

// 依條件查詢
$this->db->get_where('table_name', array('id' => $id), $offset);

// 指定欄位
$this->db->select('title, content, date');
$data = $this->db->get('table_name');

// 聚合函式
$this->db->select_max('age', 'nianling'); // MAX(age) AS nianling
$this->db->select_min('age');
$this->db->select_sum('age');

// 自定義 FROM
$this->db->select('title, content, date');
$this->db->from('table_name');

WHERE 條件語法

// 簡單條件
$this->db->where('name', $name);
$this->db->where('title', $title);
// 產生: WHERE name = '...' AND title = '...'

// 範圍條件
$this->db->where_in('field', array('a', 'b'));
$this->db->where_not_in('field', array('a', 'b'));

// LIKE 比對
$this->db->like('title', 'match', 'both'); // %match%
$this->db->like('title', 'match', 'before'); // %match
$this->db->like('title', 'match', 'after');  // match%

使用提醒

• 所有透過 Active Record 產生的查詢會自動進行資料轉義，安全性較高。
• 複雜 JOIN 或子查詢建議直接撰寫 SQL 並使用參數綁定。
• 查詢結束後呼叫 free_result() 釋放資源，避免記憶體洩漏。