ar（active record）
在启用ar的情况下（ci3.0默认已经启动并且没有配置项），通过
$this->db
的get方法可以获得一张表的结果集
[code]// ar会自动加上表前缀，因此get方法中的表名不用加上表前缀 $res = $this->db->get('user'); foreach ($res->result() as $item) { echo $item->name . "<br />"; }
通过insert方法可以简单的插入一条记录，参数是表名和关联数组
[code]$data = array('name'=>'mary', 'password'=>md5('mary')); $result = $this->db->insert('user', $data);
通过update方法修改记录，第一个参数是表明，第二个参数是修改后的内容，用关联数组表示，第三个参数是查询条件
[code]$data = array ('email'=>'mary@gmail.com', 'password'=>md5('123456')); $this->db->update('user', $data, array('name'=>'mary'));
通过delete方法删除一条记录，参数一是表名，参数二是查询条件
[code]$this->db->delete('user', array('name'=>'mary'));
连贯操作，对于比较复杂的sql语句，可以使用ar提供的连贯操作进行查询
[code]$result = $this->db->select('id, name') ->from('user') ->where('id >=', 1) ->limit(3,1) ->order_by('id desc ') ->get();
注意：limit的参数顺序与sql中的顺序是相反的，第一个参数表示显示的条数，第二个参数表示跳过的条数
不同查询条件下where语句的写法
[code]where('name', 'mary')或where('name =', 'mary')：表示查询条件是name字段值是mary where(array('name'=>'mary', 'id >'=>'1'));：表示查询条件有两个，name字段值是mary并且id字段值是1
通过last_query()方法可以获得通过连贯操作，由ar拼装的sql语句
[code]$this->db->last_query();
通过ar只能执行比较简单的查询，如果是复杂查询，建议使用$this->db->query($sql, $data)
进行查询
选择数据
下面的函数帮助你构建 sql select语句。
备注：如果你正在使用 php5，你可以在复杂情况下使用链式语法。本页面底部有具体描述。
[code]$this->db->get();
运行选择查询语句并且返回结果集。可以获取一个表的全部数据。
[code]$query = $this->db->get('mytable'); // produces: select * from mytable
第二和第三个参数允许你设置一个结果集每页纪录数(limit)和结果集的偏移(offset)
[code]$query = $this->db->get('mytable', 10, 20); // produces: select * from mytable limit 20, 10 (in mysql. other databases have slightly different syntax)
注意：第二参数是每页纪录数，第三个参数是偏移
你会注意到上面的函数由一个变量$query
执行，这个$query
可以用来显示结果集。
[code]$query = $this->db->get('mytable'); foreach ($query->result() as $row) { echo $row->title; } [code]$this->db->get_where();
跟上面的函数一样，只是它允许你在函数的第二个参数那里添加一个 where 从句，从而不用使用 db->where() 这个函数：
[code]$query = $this->db->get_where('mytable', array('id' => $id), $limit, $offset);
注意: get_where() 在以前的版本中写作 getwhere()，这是已经过时的用法，现已从代码中移除 getwhere()。
[code]$this->db->select();
允许你在sql查询中写 select 部分:
[code]$this->db->select('title, content, date'); $query = $this->db->get('mytable'); // produces: select title, content, date from mytable
注意: 如果你要查询表中的所有行，你可以不用写这个函数。省略后，codeigniter 会认为你要查询全部行(select *)。
$this->db->select()
[code]$this->db->select('(select sum(payments.amount) from payments where payments.invoice_id=4') as amount_paid', false); $query = $this->db->get('mytable');
关联数组方式:
[code]$array = array('title' => $match, 'page1' => $match, 'page2' => $match); $this->db->like($array); // where title like '%match%' and page1 like '%match%' and page2 like '%match%' $this->db->or_like();
本函数与上面那个函数几乎完全相同，唯一的区别是多个实例之间是用 or 连接起来的:
[code]$this->db->like('title', 'match'); $this->db->or_like('body', $match); // where title like '%match%' or body like '%match%'
说明: or_like() 曾经被称为 orlike(), 后者已经过时，现已从代码中移除 orlike()。
[code]$this->db->not_like();
本函数与 like() 几乎完全相同，唯一的区别是它生成 not like 语句:
[code]$this->db->not_like('title', 'match'); // where title not like '%match% $this->db->or_not_like();
本函数与 not_like() 几乎完全相同，唯一的区别是多个实例之间是用 or 连接起来的:
[code]$this->db->like('title', 'match'); $this->db->or_not_like('body', 'match'); // where title like '%match%' or body not like '%match%' $this->db->group_by();
允许你编写查询语句中的 group by 部分:
[code]$this->db->group_by("title"); // 生成: group by title
你也可以把多个值作为数组传递过去:
[code]$this->db->group_by(array("title", "date")); // 生成: group by title, date
说明: group_by() 曾经被称为 groupby(), 后者已经过时，现已从代码中移除 groupby()。
[code]$this->db->distinct();
为查询语句添加 “distinct” 关键字:
[code]$this->db->distinct(); $this->db->get('table'); // 生成: select distinct * from table $this->db->having();
允许你为你的查询语句编写 having 部分。有两种语法形式，一个或两个参数都可以:
[code]$this->db->having('user_id = 45'); // 生成: having user_id = 45 $this->db->having('user_id', 45); // 生成: having user_id = 45 你也可以把多个值通过数组传递过去: [code]$this->db->having(array('title =' => 'my title', 'id <' => $id)); // 生成: having title = 'my title', id < 45
如果你正在使用一个由codeigniter进行转义保护的数据库，为了避免内容转义，你可以传递可选的第三个参数，并将其设置为false。
[code]$this->db->having('user_id', 45); // 生成: having `user_id` = 45 (在诸如mysql等数据库中) $this->db->having('user_id', 45, false); // 生成: having user_id = 45 $this->db->or_having();
与 having() 函数几乎完全一样，唯一的区别是多个子句之间是用 “or” 分隔的。
[code]$this->db->order_by();
帮助你设置一个 order by 子句。第一个参数是你想要排序的字段名。第二个参数设置结果的顺序，可用的选项包括 asc (升序)或 desc(降序), 或 random(随机)。
[code]$this->db->order_by("title", "desc"); // 生成: order by title desc
你也可以在第一个参数中传递你自己的字符串:
[code]$this->db->order_by('title desc, name asc'); // 生成: order by title desc, name asc
或者，多次调用本函数就可以排序多个字段。
[code]$this->db->order_by("title", "desc"); $this->db->order_by("name", "asc"); // 生成: order by title desc, name asc
说明: order_by() 曾经被称为 orderby(), 后者已经过时，现已从代码中移除 orderby()。
说明: 目前 oracle 和 mssql 的驱动还不支持随机排序，将被默认设置为 ‘asc’(升序)。
[code]$this->db->limit();
限制查询所返回的结果数量:
[code]$this->db->limit(10); // 生成: limit 10
第二个参数设置的是结果偏移量。
[code]$this->db->limit(10, 20); // 生成: limit 20, 10 (仅限mysql中。其它数据库有稍微不同的语法) $this->db->count_all_results();
允许你获得某个特定的active record查询所返回的结果数量。可以使用active record限制函数，例如 where(),or_where()
, like(), or_like() 等等。范例：
[code]echo $this->db->count_all_results('my_table'); // 生成一个整数，例如 25 $this->db->like('title', 'match'); $this->db->from('my_table'); echo $this->db->count_all_results(); // 生成一个整数，例如 17
插入数据
[code]$this->db->insert();
生成一条基于你所提供的数据的sql插入字符串并执行查询。你可以向函数传递 数组 或一个 对象。下面是一个使用数组的例子：
[code]$data = array( 'title' => 'my title' , 'name' => 'my name' , 'date' => 'my date' ); $this->db->insert('mytable', $data); // produces: insert into mytable (title, name, date) values ('my title', 'my name', 'my date')
第一个参数包含表名，第二个是一个包含数据的关联数组。
下面是一个使用对象的例子：
[code]/* class myclass { var $title = 'my title'; var $content = 'my content'; var $date = 'my date'; } */ $object = new myclass; $this->db->insert('mytable', $object); // produces: insert into mytable (title, content, date) values ('my title', 'my content', 'my date')
第一个参数包含表名，第二个是一个对象。（原文有错：the first parameter will contain the table name, the second is an associative array of values.）
注意: 所有的值已经被自动转换为安全查询。
[code]$this->db->set();
本函数使您能够设置inserts(插入)或updates(更新)值。
它可以用来代替那种直接传递数组给插入和更新函数的方式:
[code]$this->db->set('name', $name); $this->db->insert('mytable'); // 生成: insert into mytable (name) values ('{$name}')
如果你多次调用本函数，它们会被合理地组织起来，这取决于你执行的是插入操作还是更新操作:
[code]$this->db->set('name', $name); $this->db->set('title', $title); $this->db->set('status', $status); $this->db->insert('mytable');
set() 也接受可选的第三个参数($escape)，如果此参数被设置为 false，就可以阻止数据被转义。为了说明这种差异，这里将对 包含转义参数 和 不包含转义参数 这两种情况的 set() 函数做一个说明。
[code]$this->db->set('field', 'field+1', false); $this->db->insert('mytable'); // 得到 insert into mytable (field) values (field+1) $this->db->set('field', 'field+1'); $this->db->insert('mytable'); // 得到 insert into mytable (field) values ('field+1')
你也可以将一个关联数组传递给本函数:
[code]$array = array('name' => $name, 'title' => $title, 'status' => $status); $this->db->set($array); $this->db->insert('mytable');
或者一个对象也可以:
[code]/* class myclass { var $title = 'my title'; var $content = 'my content'; var $date = 'my date'; } */ $object = new myclass; $this->db->set($object); $this->db->insert('mytable');
更新数据
[code]$this->db->update();
根据你提供的数据生成并执行一条update(更新)语句。你可以将一个数组或者对象传递给本函数。这里是一个使用数组的例子:
[code]$data = array( 'title' => $title, 'name' => $name, 'date' => $date ); $this->db->where('id', $id); $this->db->update('mytable', $data); // 生成: // update mytable // set title = '{$title}', name = '{$name}', date = '{$date}' // where id = $id
或者你也可以传递一个对象:
[code]/* class myclass { var $title = 'my title'; var $content = 'my content'; var $date = 'my date'; } */ $object = new myclass; $this->db->where('id', $id); $this->db->update('mytable', $object); // 生成: // update mytable // set title = '{$title}', name = '{$name}', date = '{$date}' // where id = $id
说明: 所有值都会被自动转义，以便生成安全的查询。
你会注意到
$this->db->where()
[code]$this->db->update('mytable', $data, "id = 4");
或者是一个数组:
[code]$this->db->update('mytable', $data, array('id' => $id));
在进行更新时，你还可以使用上面所描述的 $this->db->set() 函数。
删除数据
[code]$this->db->delete();
生成并执行一条delete(删除)语句。
[code]$this->db->delete('mytable', array('id' => $id)); // 生成: // delete from mytable // where id = $id
第一个参数是表名，第二个参数是where子句。你可以不传递第二个参数，使用 where() 或者 or_where() 函数来替代它:
[code]$this->db->where('id', $id); $this->db->delete('mytable'); // 生成: // delete from mytable // where id = $id
如果你想要从一个以上的表中删除数据，你可以将一个包含了多个表名的数组传递给delete()函数。
[code]$tables = array('table1', 'table2', 'table3'); $this->db->where('id', '5'); $this->db->delete($tables);
如果你想要删除表中的全部数据，你可以使用 truncate() 函数，或者 empty_table() 函数。
[code]$this->db->empty_table();
生成并执行一条delete(删除)语句。
[code] $this->db->empty_table('mytable'); // 生成 // delete from mytable $this->db->truncate();
生成并执行一条truncate(截断)语句。
[code]$this->db->from('mytable'); $this->db->truncate(); // 或 $this->db->truncate('mytable'); // 生成: // truncate mytable
说明: 如果 truncate 命令不可用，truncate() 将会以 “delete from table” 的方式执行。
链式方法
链式方法允许你以连接多个函数的方式简化你的语法。考虑一下这个范例:
[code]$this->db->select('title')->from('mytable')->where('id', $id)->limit(10, 20); $query = $this->db->get();
以上就是codeigniter学习笔记 item5--ci中的ar的内容。