查詢補助函式

獲取查詢執行的資訊

$this->db->insert_id()

進行資料庫插入時的插入ID數字。

Note

如果使用了 PDO 驅動連接 PostgreSQL 或是使用 InterBase 驅動程式，這個函式會需要一個 $name 參數，用來指定適當的序列來檢查插入的 id 。

$this->db->affected_rows()

顯示會執行 “寫入” 類型的查詢所影響的列數（ insert, update 等）。

Note

在 MySQL ， “DELETE FROM TABLE” 回傳受影響的列數會是 0 。資料庫類別做了一點小 hack ，讓他可以傳回正確的數字。預設這個 hack 是開啟的，不過也可以從資料庫驅動程式檔案中將它關閉。

$this->db->last_query()

回傳最近一次執行的查詢（查詢字串，不是查詢結果）。 例如：

$str = $this->db->last_query();

// 產生： SELECT * FROM sometable....

Note

在資料庫設定中取消 save_queries 設定，會使這個函式失效

取得資料庫的資訊

$this->db->count_all()

讓你可以確知一個資料表中資料的列數。使用資料表名稱作為第一個參數。例如：

echo $this->db->count_all('my_table');

// 產生一個整數，像是 25

$this->db->platform()

輸出目前在運行的資料庫平台（ MySQL, MS SQL, Postgres 等）：

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

$this->db->version()

輸出目前在運行的資料庫版本：

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

讓查詢更容易

$this->db->insert_string()

這個函式簡化了插入資料到資料庫的過程。它會回傳一個正確格式的 SQL 插入字串。例如：

$data = array('name' => $name, 'email' => $email, 'url' => $url);

$str = $this->db->insert_string('table_name', $data);

第一個參數是資料表名稱，第二個參數是要插入資料的關聯陣列。上面的例子會產生：

INSERT INTO table_name (name, email, url) VALUES ('Rick', '[email protected]', 'example.com')

Note

值會被自動跳脫，以產生較安全的查詢。

$this->db->update_string()

這個函式簡化了撰寫資料庫更新的過程。它會回傳一個正確格式的 SQL 更新字串。例如：

$data = array('name' => $name, 'email' => $email, 'url' => $url);

$where = "author_id = 1 AND status = 'active'";

$str = $this->db->update_string('table_name', $data, $where);

第一個參數是資料表名稱，第二個參數是要更新資料的關連陣列，第三個則是 “where” 子句。上面的例子會產生：

UPDATE table_name SET name = 'Rick', email = '[email protected]', url = 'example.com' WHERE author_id = 1 AND status = 'active'

Note

值會被自動跳脫，以產生較安全的查詢。