[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);