原文:使用 CodeIgniter 框架快速开发 PHP 应用(四)
使用 CI 简化数据库开发
你学习CI 是因为你想要使编程更容易和更有生产力。这一章讲述CI的Active Record类。 如果CI只提供一个Active Record类，它还是物超所值的。当然，CI是免费的，只不过我要强调Active Record（以后简称AR）类的价值是非常高的，它是你提高生产力的主要工具。
AR使你以最小的代价获得最大的回报。 它简单，易于使用和维护。
这一章描述CI如何连接到一个数据库,你如何使用AR操纵数据库。你将会见到:
。 AR类与传统PHP/MySQL接口的比较
。 如何读取数据库并显示结果
。 如何创建,更新, 删除查询
CI保留让你用传统的方法编写数据库查询，但是我不会详细介绍这部分内容。它的知识完全被在线手册覆盖。使用AR类后，你可能不会再用传统的方式来做数据库查询了。
配置config文件
你或许已经注意到在这本书的大多数的章节会谈到system/application/config 文件夹和里面的config文件。这些文件对控制CI按要求工作相当必要。而且你可以让大部分的配置参数等于系统的默认值。数据库config文件在正常使用数据库之前需要进行设置。
基本上，你仅仅必须告诉它你的数据库在哪里、它是什么类型。 文件的默认值为:
$active_group="default";
$db[‘default‘][‘hostname‘]="";
$db[‘default‘][‘username‘]="";
$db[‘default‘][‘password‘]="";
$db[‘default‘][‘database‘]="";
$db[‘default‘][‘dbdriver‘]="";
其他的选项可以保留为默认值。 必选项是:
hostname: 你的数据库的位置, 举例来说, ‘localhost‘ 或 IP 地址
username和password: 使用者名称和密码必须有充分的权限，允许你的网站存取数据库中的数据。
database: 你的数据库的名字, 举例来说, ‘websits‘
dbdriver: 你正在使用的数据库的类型 - CI可受的有选项有MySQL、MySQLi、 Postgre SQL、ODBC和MS SQL
以我的经验来看, 最困难的事情之一就是把新的CI网站连接到数据库。你可能需要查询你的ISP-有时他们的数据库运行在与他们的web server IP地址不同的地方。如果你正在使用 MySQL, 他们可能提供 phpMyAdmin, 通常告诉你 hostname-这可能是 ‘localhost‘ 或者它可能是一个 IP 住址。
你可能注意到 config 文件的内容实际上是一个多维数组。在 $db数组里包含一个叫做default的数组，你所做的设置就是往里增加键/值对，例如 hostname = 127.0.0.1 。你还可以增加其他的数据库设置, 通过改变$active_group的设置可以容易地更改数据据库。
这为网站连接到数个数据库提供了可能性-举例来说, 一个测试数据库和一个产品数据库-你可以很容易地在他们之间切换。 或者你可以在二个数据库之间交换数据。
为我们的网站设计数据库
我想表达的是 CI 能用来开发正式的网站。 我现在正在维护客户的一些网站，而且我想要监控他们,用我设计的方法测试它们, 用数据库保存我想要的数据, 而且可以得到这些网站的分析报告。 因此让我们试着创建它。 先让我们确定一些目标。 它们是:
1. 用最少的人工干预管理一个或更多的远程网站
2. 对远程网站进行定期的测试
3. 生成符合要求的分析报告, 提供网站的细节和测试结果
因此, 第一件事情是我们将会需要一个网站的数据库。 建立一个名为websites的MySQL数据库，你也可以使用别的数据库产品。
现在，我们需要增加一些表来保存各种数据。让我们为网站增加一张表，字段有URL，他们的名字和密码/用户名, 和他们的类型。我们也将会为每个网站建立一个ID字段-而且在 MySQL数据库中，至少，需要为实体生成一个唯一标识符，可以使用自动增量类型来达到这一目的。
每个网站必须有一个不同的主机，我们需要另一表来保存主机信息。一般有一个域名与主机相关联，所以我们需要一个域名表来保存有关域名的信息，还需要一个人员表来记录这些人的姓名，密码，邮件地址，备用邮件地址，手机号码，曾至宠物的名字，可能还有其它的一些什么。
因此我们的网站表需要包括这样一些字段：domain ID, host ID, 两个people ID，一个存放网站站长的ID一个存放网站管理人的ID（管理人为网站提供技术支持，保证网站正常运行.)
你能见到，这是一个完整的关系型数据库，让我们来建立它!
完整的建表文档，SQL文件格式：
websites.sql:
SQL
DROP TABLE IF EXISTS `ci_sessions`;
CREATE TABLE IFNOT EXISTS `ci_sessions` (
`session_id` varchar(40) NOT NULL default ‘0‘,
`peopleid` int(11) NOT NULL,
`ip_address` varchar(16) NOT NULL default ‘0‘,
`user_agent` varchar(50) NOT NULL,
`last_activity` int(10) unsigned NOT NULL default ‘0‘,
`left` int(11) NOT NULL,
`name` varchar(25) NOT NULL,
`status` tinyint(4) NOT NULL default ‘0‘
) ENGINE=MyISAM DEFAULT CHARSET=latin1;
DROP TABLE IF EXISTS `domains`;
CREATE TABLE IFNOT EXISTS `domains` (
`id` int(10) NOT NULL auto_increment,
`url` varchar(100) NOT NULL,
`name` varchar(100) NOT NULL,
`registrar` varchar(100) NOT NULL,
`dateregd` int(11) NOT NULL default ‘0‘,
`cost` float NOT NULL default ‘0‘,
`regdfor` int(11) NOT NULL default ‘0‘,
`notes` blob NOT NULL,
`pw` varchar(25) NOT NULL,
`un` varchar(25) NOT NULL,
`lastupdate` int(11) NOT NULL default ‘0‘,
`submit` varchar(25) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 AUTO_INCREMENT=10 ;
DROP TABLE IF EXISTS `events`;
CREATE TABLE IFNOT EXISTS `events` (
`id` int(10) NOT NULL auto_increment,
`name` varchar(50) NOT NULL default ‘not set‘,
`type` enum(‘test‘,‘alert‘,‘report‘) NOT NULL,
`testid` int(10) NOT NULL,
`siteid` int(10) NOT NULL,
`userid` int(10) NOT NULL,
`reported` int(11) NOT NULL,
`result` blob NOT NULL,
`time` int(11) NOT NULL,
`timetaken` float NOT NULL,
`isalert` varchar(2) NOT NULL,
`emailid` int(11) NOT NULL,
`submit` varchar(25) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 AUTO_INCREMENT=69 ;
DROP TABLE IF EXISTS `frequencies`;
CREATE TABLE IFNOT EXISTS `frequencies` (
`id` int(10) NOT NULL,
`name` varchar(16) NOT NULL,
`submit` varchar(25) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;
DROP TABLE IF EXISTS `hosts`;
CREATE TABLE IFNOT EXISTS `hosts` (
`id` int(11) NOT NULL auto_increment,
`cost` float NOT NULL,
`name` varchar(100) NOT NULL,
`hosturl` varchar(100) NOT NULL,
`un` varchar(50) NOT NULL,
`pw` varchar(50) NOT NULL,
`ns1url` varchar(36) NOT NULL,
`ns1ip` varchar(36) NOT NULL,
`ns2url` varchar(36) NOT NULL,
`ns2ip` varchar(36) NOT NULL,
`ftpurl` varchar(100) NOT NULL,
`ftpserverip` varchar(36) NOT NULL,
`ftpun` varchar(50) NOT NULL,
`ftppw` varchar(50) NOT NULL,
`cpurl` varchar(36) NOT NULL,
`cpun` varchar(36) NOT NULL,
`cppw` varchar(36) NOT NULL,
`pop3server` varchar(36) NOT NULL,
`servicetel` varchar(50) NOT NULL,
`servicetel2` varchar(50) NOT NULL,
`serviceemail` varchar(100) NOT NULL,
`webroot` varchar(48) NOT NULL,
`absoluteroot` varchar(48) NOT NULL,
`cgiroot` varchar(48) NOT NULL,
`booked` int(11) NOT NULL,
`duration` int(11) NOT NULL,
`lastupdate` int(11) NOT NULL default ‘0‘,
`submit` varchar(25) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 AUTO_INCREMENT=6 ;
DROP TABLE IF EXISTS `people`;
CREATE TABLE IFNOT EXISTS `people` (
`id` int(11) NOT NULL auto_increment,
`uname` varchar(25) NOT NULL,
`pw` varchar(25) NOT NULL,
`status` smallint(3) NOT NULL default ‘1‘,
`name` varchar(50) NOT NULL,
`firstname` varchar(50) NOT NULL,
`surname` varchar(50) NOT NULL,
`email` varchar(120) NOT NULL,
`lastupdate` int(11) NOT NULL default ‘0‘,
`submit` varchar(25) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 AUTO_INCREMENT=5 ;
DROP TABLE IF EXISTS `sites`;
CREATE TABLE IFNOT EXISTS `sites` (
`id` int(10) NOT NULL auto_increment,
`name` varchar(100) NOT NULL,
`url` varchar(100) NOT NULL,
`un` varchar(50) NOT NULL,
`pw` varchar(50) NOT NULL,
`client1` int(10) NOT NULL default ‘0‘,
`client2` int(10) NOT NULL default ‘0‘,
`admin1` int(10) NOT NULL default ‘0‘,
`admin2` int(10) NOT NULL default ‘0‘,
`domainid` int(10) NOT NULL default ‘0‘,
`hostid` int(10) NOT NULL default ‘0‘,
`webroot` varchar(50) NOT NULL,
`files` text NOT NULL,
`filesdate` int(11) NOT NULL default ‘0‘,
`lastupdate` int(11) NOT NULL default ‘0‘,
`submit` varchar(25) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 AUTO_INCREMENT=15 ;
DROP TABLE IF EXISTS `tests`;
CREATE TABLE IFNOT EXISTS `tests` (
`id` int(11) NOT NULL auto_increment,
`siteid` int(11) NOT NULL default ‘0‘,
`name` varchar(250) NOT NULL,
`type` varchar(25) NOT NULL,
`url` varchar(120) NOT NULL,
`regex` varchar(250) NOT NULL,
`p1` varchar(250) NOT NULL,
`p2` varchar(250) NOT NULL,
`p3` varchar(250) NOT NULL,
`p4` varchar(250) NOT NULL,
`p5` varchar(250) NOT NULL,
`p6` varchar(250) NOT NULL,
`frequency` int(10) NOT NULL default ‘0‘,
`lastdone` int(10) NOT NULL default ‘0‘,
`isalert` varchar(2) NOT NULL,
`setup` int(10) NOT NULL default ‘0‘,
`lastupdate` int(10) NOT NULL default ‘0‘,
`notes` varchar(250) NOT NULL,
`submit` varchar(25) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1 AUTO_INCREMENT=11 ;
DROP TABLE IF EXISTS `types`;
CREATE TABLE IFNOT EXISTS `types` (
`id` varchar(7) NOT NULL,
`name` varchar(50) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;
复制代码
我们现在要用一个更简单容易的方法来实现这一切。 所以，让我们看看CI框架为我们提供了什么功能，我们要重点介绍AR类。
Active Record
AR是一个‘设计模式‘-又一个高度抽象的东西，就象 MVC。 它本身不是代码, 只是一个模式。对于代码。 有一些不同的解释。它的核心是把你的数据库和PHP对象建立一个对应关系。每次，当你执行一个QUERY语句。每一张数据库里的表是一个类，每一行是一个对象。所有你需要做的只是创建它，修改它或者删除它。例如，“方法”，是从类继承而来。Ruby on Rails 是使用AR模式的，CI也是，尽管这两种框架实现AR的方式有一点不同。
理论的东西够多了-但是这是什么意思呢？好吧, 用代码简单和清楚地描述一下吧。
使用AR类的优点
AR节约你的时间，自动运作，使SQL语句方便易懂。
节约时间
当你在PHP编程时，每写一个数据库查询的时候，你每次一定要与数据库建立连接。 对CI来说，第一次连接数据库时，你在每个控制器或模型的构造函数里放入这样一行语名：
$this->load->database();
一旦你这样做了，你不需要重复连接, 在那个控制器或模型就可以做任意多次的查询。
你已经在 config文件中设置了关于数据库的参数，就象我们在这一章开始时看到的一样。 再一次，这使更新你的网站比较容易，如果你想要改变数据库名字、密码或位置的话。
自动机制
一经你已经连接到数据库， CI 的AR生成隐含的代码。 举例来说, 如果你进行下列的插入操作:
PHP
$data = array(
‘title‘=> $title,
‘name‘ => $name,
‘date‘ => $date
);
$this->db->insert(‘mytable‘,$data);
复制代码
你正在插入的数据据已经被在幕后转换成这样一行代码:
PHP
function escapte($str) {
switch (gettype($str)) {
case ‘string‘:
$str="‘".$this->escape_str($str)."‘";
break;
case ‘boolean‘:
$str=?($str=== FALSE) 0: 1;
break;
default :
$str=?($str=== NULL) ‘NULL‘: $str;
break;
}
return $str;
}
复制代码
换句话说， CI框架使你的代码变得更强健。 现在，让我们看看它是如何工作的。
第一，连接数据库非常简单。 在传统的PHP编程时，你可能是这样做的:
PHP
$connection = mysql_connect;(" localhost" ， " fred","12345")
mysql_select_db("websites",$connection);
$result = mysql_query;("select * from sites", $connection);
while ($row = mysql_fetch_array($result,MYSQL_NUM)) {
foreach($row as $attribute) {
print "{$attribute[1]}";
}
}
复制代码
换句话说，你必须重复地输入host、username和password,建立一个连接,然后选择一个连接的数据库。 你必须每次都这样做，然后再开始一个查询。 CI以一条命令替换连接工作:
$this->load->database();
在每个控制器或者模型中或者其它类的构造函数里放入这条命令。 在这之后，你就可以直接开始查询了。 连接数据被保存在你的数据库 config 文件中，CI每次都会去那里查询它。
因此, 在每个CI函数中，你可以直接进行数据库查询。上面的query在CI中被转换成：
PHP
$query = $this->db->get(‘sites‘);
foreach($query->result() as $row) {
print $row->url
}
复制代码
很简单, 不是吗?
这一个章的余下部分给出不同query的用法。
读取查询
常用的查询是取回来自数据库的数据。等同于select的查询是：
PHP
$query =$this->db->get(‘sites‘);
复制代码
这是一个‘select *‘ 查询，目标是site表-换句话说，它取回所有的行。 如果你偏爱分开来写，你能这样做:
PHP
$this->db->from(‘sites‘);
$query = $this->db->get();
复制代码
如果你想要得到特定的列, 而不是全部列, 这样做:
PHP
$this->db->select(‘url‘,‘name‘,‘clientid‘);
$query = $this->db->get(‘sites‘);
复制代码
你可能要对结果排序，你可以在get语句前插入:
PHP
$this->db->orderby("name","desc");
复制代码
desc是降序的意思。 你也能选择asc(升序) 或
rand(random).
你也可能想要限制返回的行数，比如你想要最初五个结果。你可以在get语句前插入:
PHP
$this->db->limit(5);
复制代码
当然，在大多数的查询，你不可能在表中返回所有记录。 数据库的具有按给定条件过滤返回结果的能力。 这通常使用where子句来实现， CI 这样表达:
PHP
$this->db->where(‘clientid‘,‘1‘);
复制代码
这条语句会查找客户号是 1 的客户相连的所有的网站。 但是这对我们并不是很有帮助，我们并不会记住人员表的ＩＤ号。对人来说，用姓名是比较合理的办法，因此我们需要连接到people表：
PHP
$this->db->from(‘sites‘);
$this->db->join(‘people‘,‘sites.peopleid=people.id‘);
复制代码
有ＳＱＬ知识的人都知道，这相当于：
SQL
select sites.* from sites,people
where sites.peopleid=people.id
复制代码
注意 SQL 的约定，如果一个列名在二张表中是重复的, 你需要在列名前加上表名和一个“."号。 因此 sites.peopleid 在位置桌子中意谓 peopleid 所在的表是sites.在进行ＳＱＬ多表查询时，最好把列名进行唯一性的标识，这样可以避免产生岐义，也可以让你自己明了。
你可以增加更多的where子句的操作符。 举例来说，增加否定操作符:
PHP
$this->db->where(‘url!=‘,‘ www.mysite.com‘);
复制代码
或比较操作符:
PHP
$this->db->where(‘id >‘,‘3‘);
复制代码
或联合陈述: ("where ...and..."):
PHP
$this->db->where(‘url!=‘,‘ www.mysite.com‘);
$this->db->where(‘id >‘,‘3‘);
复制代码
或使用 $this->db->orwhere()来表示: ("where …or "):
PHP
$this->db->where(‘url!=‘,‘ www.mysite.com‘);
$this->db->orwhere(‘url!=‘,‘ www.anothersite.com‘);
复制代码
现在让我们建立一个完整的查询:
PHP
$this->db->select(‘url‘,‘name‘,‘clientid‘,‘people.surname as client‘);
$this->db->where(‘clientid‘,‘3‘);
$this->db->limit(5);
$this->db->from(‘sites‘);
$this->db->join(‘people‘,‘sites.clientid=people.id‘);
$this->db->orderby("name"," desc");
$query = $this->db->get();
复制代码
这应该给我们前五个 (用姓名排序)网站，这些网站属于 3 号客户, 而且还显示客户的姓和他或她的身份证数字!
使用AR的潜在好处是已经进行了自动的转义，因此，你不必关心转义的问题。 这适用于这样的函数象$this->db->where(), 以及在下一个段中被描述的数据插入和修改语句。(安全警告: 这不同于阻止交叉脚本攻击-对付这个你需要 CI 的 xss_clean() 函数。它也不相同于验证你的数据-对付这个你需要 CI 的验证类。 见第 5 章。)
显示查询结果
在CI显示查询结果相当简单。假定我们定义了上述的查询语句, 最后一句是：
PHP
$query =$this->db->get();
复制代码
然后，如果有多个结果，他们被保存在$row对象中，你可以用一个 foreach 循环:
PHP
foreach($query->result() as $row) {
print $row->url;
print $row->name;
print $row->client;
}
复制代码
或如果我们只想要一个结果，它可以作为一个对象被返回, 或在这里当做一个
$row数组:
PHP
if ($query->num_rows()>0) {
$row =$query->row_array();
print $row[‘url‘];
print $row[‘name‘];
print $row[‘client‘];
}
复制代码
我比较喜欢对象语法胜过数组-更简洁!
如果你遵守 MVC 模式，你将会在模型中保存你的查询和数据库交互, 然后通过视图显示数据。
生成和更新查询
ＡＲ有三个函数帮助你在数据库内生成新的实体，它们是$this->db->insert(),$this->db->update,$this->db->set().
“create"和“update"的不同之处是“create"是向表中插入一条全新的记录，而"update"是修改表中已经存在的记录。因此对“update"，你必须首先定位需要修改的记录。
CI 用数组来保存数据，或是使用$this->db->set(); 你可以任选一种。
因此, 如果要在websites数据库中加入一行。首先，确保在我们的控制器中的构造函数加入:
PHP
$this->load->database();
复制代码
我们想要增加一个新的网站，包含有一个网址,一个名字，一个类型和一个客户ID。 如果用数组的方式，这可能是:
PHP
$data = array(
‘url‘ => ‘www.mynewclient.com‘,
‘name‘ => ‘BigCo Inc‘,
‘clientid‘ => ‘33‘,
‘type‘ => ‘dynamic‘
);
复制代码
把这些信息增加到sites表，我们使用：
PHP
$this->db->insert(‘sites‘, $data);
复制代码
我们更可以使用$this->db->set():
PHP
$this->db->set(‘url‘,‘www.mynewclinet.com‘);
$this->db->set(‘name‘,‘BigCo Inc‘);
$this->db->set(‘clientid‘, ‘33‘);
$this->db->set(‘type‘,‘dynamic‘);
$this->db->insert(‘sites‘);
复制代码
如果我们正在更新一笔现有的记录, 我们也可以创建一个数组, 或使用 $this->db->set(), 但是现在有二个不同。
第一, 我们必须定位我们想要更新的记录; 其次，我们需要使用$this->db->update(). 如果我想要在sites中更新一笔记录(针对‘id‘列的值1的那行记录)，使用数组的方式是这样处理的:
PHP
$this->db->where(‘id‘,‘1‘);
$this->db->update(‘sites‘, $data);
复制代码
你也可以使用$this->db->set()方式, 就象前面做过的那样。
CI 提供几个函数检查数据库是否成功执行了相关操作。 最有用的：
PHP
$this->db->affected_rows();
复制代码
在执行insert或update后应该返回 ‘1‘-但是如果我正在update一批记录的话，可能返回更大的一个整数。
你已经注意到当我insert一笔新的记录时，我没有设定ID这一列。这是因为ID这列被设定为自动插入类型。但是当我update一笔现有的记录时候，我必须引用ID属性，否则数据库不知道该改变哪一笔记录。
如果我正在insert一笔新的记录, 在实际产生它之前，我们并不知道ID具体的值。如果我需要引用新的记录的ID, 使用下列语句：
PHP
$new_id_number = $this->db->insert_id();
复制代码
(这一行代码必须跟在insert语句之后，否则可能得到错误的结果.)
还有一点需要知道，CI的AR操作, 包括 $this->db->insert() 和 $this->db->update()会被自己地转义。
从 1.5 版， CI 也包含了对事务的支持，即指定的一批SQL操作要么全成功，要么全失败，换句话说，要么提交，要么回滚。这在复式记帐应用和许多商业应用中是很重要的。举例来说，说你正在卖电影票。 你需要接受付款, 同时分配座位。 如果你的系统收费成功但分配座位失败，这个客户肯定是要光火的。
CI 现在也让事务处理变得很简单，即要么“提交”，要么回滚。你可以参考用户手册以得到更多关于事务的信息。
删除操作
删除操作也许是最简单的。你只要定位好需要删除记录，比如我们要删除ID为2的记录:
PHP
$this->db->where(‘id‘,‘2‘);
$this->db->delete(‘sites‘);
复制代码
要小心使用删除操作，因为如果你不注意where中的条件，可能会误操作，甚至最坏的结果是删除整张表。
AR和传统SQL编程的结合
CI 不要求你只能使用AR，你也能用CI直接发送SQL查询。比如：假定你已在构造函数里已连接了数据库，你可以在需要的地方直接使用类似的SQL查询：
PHP
$this->db->query("select id, name, url from sites where ‘type‘=‘dynamic‘");
复制代码
我个人觉得AR更容易使用。借助数组为AR准备数据更直观，更容易理解，虽然可能需要更多的代码。AR还能自动转义，对不熟悉SQL语法的程序员会更有吸引力。
还有需要介绍的一个使用AR的技巧是关于where函数的，当我们需要在where中放入这样一个比较复要的语句时：
client=‘3‘ and (type = ‘dynamic‘ or type = ‘static‘)
由于使用了左右括号，因此不能直接放入where函数，你可以把这分成两行：
$c;
$this->db->where($condition);
在一些复杂的情况下，你可能需要直接使用SQL语法建立查询而不是使用AR，比如要使用复杂的表连接，子查询，左连接等等。不管怎样，CI框架确保你能做到传统PHP能做到的一切，而带来更多的好处。
需要指出的是，如果你试着混合使用AR和直接的SQL查询，你可能会有麻烦。
摘要
我们已经介绍了CI的Active Record类，而且见到，它是多么容易使用:
。建立和一或较多的数据库的连接
。使用AR从数据库读取数据或插入，更新，删除信息
。或直接使用SQL的标准语法执行查询
CI 的AR功能是概念清晰又容易使用, 而且使代码非常易读。它自动化数据库连接,并把连接数据保存至一个 config 文件。