[PHP]CodeIgniter學習手冊（三）：模型Model的介紹與簡單案例

什麼是模型?

模型是專門用來和資料庫打交道的PHP類。例如，假設你想用CodeIgniter來做一個Blog。你可以寫一個模型類，裡麵包含插入、更新、刪除Blog資料的方法。

下面的例子將向你展示一個普通的模型類:

<?class Blogmodel extends CI_Model {    var $title   = '';    var $content = '';    var $date    = '';    function __construct()    {        parent::__construct();    }        function get_last_ten_entries()    {        $query = $this->db->get('entries', 10);        return $query->result();    }    function insert_entry()    {        $this->title   = $_POST['title']; // 請閱讀下方的備忘        $this->content = $_POST['content'];        $this->date    = time();        $this->db->insert('entries', $this);    }    function update_entry()    {        $this->title   = $_POST['title'];        $this->content = $_POST['content'];        $this->date    = time();        $this->db->update('entries', $this, array('id' => $_POST['id']));    }}?>

注意: 上面用到的函數是 Active Record 資料庫函數.

備忘: 為了簡單一點，我們直接使用了$_POST。

不過，這不太好，平時我們應該使用輸類：

$this->input->post('title');

剖析模型

模型類檔案存放在 application/models/ 檔案夾。 如果你願意，可以在裡面建立子檔案夾。
最基本的模型類必須像這樣:

class Model_name extends CI_Model {    function __construct()    {        parent::__construct();    }}

Model_name 是模型類的名字。 類名的首字母必須大寫，其他字母小寫。並且確保你的類繼承了基本模型類(Base Model Class)。

檔案名稱應該是模型類名的小寫版。比如，如果你的類是:

class User_model extends CI_Model {    function __construct()    {        parent::__construct();    }}

類的檔案名稱應該是：

application/models/user_model.php

載入模型
模型可以在 控制器 中被引用。 就像這樣:

$this->load->model('Model_name');

如果模型檔案在子檔案夾下，引用的時候要帶上相對路徑名。例如：如果你有一個模型 application/models/blog/queries.php。 下面的代碼可以引用它:

$this->load->model('blog/queries');

模型一旦被載入，你就能通過下面的方法使用它:

$this->load->model('Model_name');$this->Model_name->function();

在預設的情況下模型名稱就直接被引入作為對象名，就如上面所示。當然，如果你願意，可以起個更好記的對象名！那麼，可以在載入模型函數中指定第二個參數來設定，例如：

$this->load->model('Model_name', 'fubar');$this->fubar->function();

這裡有個控制器的例子，載入一個模型，然後通過視圖顯示出來

class Blog_controller extends CI_Controller {    function blog()    {        $this->load->model('Blog');        $data['query'] = $this->Blog->get_last_ten_entries();        $this->load->view('blog', $data);    }}

自動載入模型
如果您需要一個在整個項目中都起作用的特定模型，您可以讓 CodeIgniter 在初始化時自動裝載它。實現的方法是開啟 application/config/autoload.php 檔案，然後在自動裝載數組中添加上這個模型。

備忘: 經過測試(以載入一個模型為例)自動載入模型和手動載入模型時，消耗的記憶體情況是一樣的。

但是當載入模型越多消耗記憶體就會越大。自動載入模型是要犧牲記憶體消耗換取的，所以盡量不要自動載入不必要貫穿全站項目的模型！

串連到資料庫

當一個模型被載入時，它並不會自動連接資料庫。以下方法可以使您串連資料庫:
您可以使用標準方法來串連資料庫（說明）, 也可以通過控制器或者您的自訂模型。
您可以把第三個參數設定為TRUE來使模型裝載函數自動連接資料庫，串連配置可以在您的資料庫設定檔中可以定義:

    $this->load->model('Model_name', '', TRUE);

您可以手動設定第三個參數來載入您的自訂資料庫配置:

$config['hostname'] = "localhost";$config['username'] = "myusername";$config['password'] = "mypassword";$config['database'] = "mydatabase";$config['dbdriver'] = "mysql";$config['dbprefix'] = "";$config['pconnect'] = FALSE;$config['db_debug'] = TRUE;$this->load->model('Model_name', '', $config);

下面是我在SAE中串連資料庫使用的Model，封裝了一些常用到的方法，比如Select，Insert等等。

<?class sae_sql_model extends CI_Model {  var $mysql;    var $sql;    function __construct()    {        parent::__construct();$this->mysql = new SaeMysql();    }    /*MySQL的Select查詢函數，函數的參數依次為： *1.表名-2.列名-3.開始的行數-4.查詢的函數 */    function select_limit($table_name,$row_name,$start_row,$row_count)    {$this->sql = "SELECT ".$row_name." FROM `".$table_name."` LIMIT ".$start_row.",".$row_count."";$data = $this->mysql->getData($this->sql);return $data;    }  /*MySQL的Select查詢函數，函數的參數依次為： *1.表名-2.列名-3.查詢的列名-4.查詢的目標 */function select_where($table_name,$row_name,$where_row,$target_row)    {$this->sql = "SELECT ".$row_name." FROM `".$table_name."` WHERE `".$where_row."`=".$target_row;$data = $this->mysql->getData($this->sql);return $data;    }/*MySQL的Insert插入函數，函數的參數依次為： *1.表名-2.插入資料的關聯陣列 */function insert_into($table_name,$array_data)    {//$tempKey和$tempValue兩個數組臨時儲存插入的資料$temp_key_string = "";$temp_value_string = "";//遍曆取出關聯陣列中的資料並將其儲存在字串中foreach($array_data as $key=>$value){$temp_key_string .= "`".$key."`,";$temp_value_string .= "'".$value."',";}//除去末尾的逗號$temp_key_string = substr($temp_key_string,0,-1);$temp_value_string = substr($temp_value_string,0,-1);//組裝Insert的SQL語句$this->sql = "INSERT INTO `".$table_name."` (".$temp_key_string.") VALUES (".$temp_value_string.");";//運行Insert的SQL語句$this->mysql->run_sql($this->sql);    }//測試輸出的函數    function select_output($array_data,$row_name)    {foreach($array_data as $key=>$value){echo $value[$row_name];}    }}?>

下面是幾個簡單的調用的例子：

//串連資料庫並返回查詢結果$sqlData = $this->sql_model->select_limit('Entries','*',0,10);//將資料庫的結果傳入data中$data['query']=$sqlData;//使用變數$data向目標網頁傳入資料$this->load->view('blog_view',$data);

Insert函數的調用例子：

//將要插入的資料存入關聯陣列中$data_array['entry_id'] = $_POST['entry_id'];$data_array['body'] = $_POST['body'];$data_array['author'] = $_POST['author'];//執行SQL語句$sqlData = $this->sql_model->insert_into('Comments',$data_array);