SP框架数据操作指南

本章将深入探讨SP框架的数据操作方法，涵盖数据查找、单条记录查询、新增记录、删除记录、更新记录、计算总数以及按字段增减等常用功能。

一、数据查找 findAll()

findAll() 方法用于从数据库中获取多条符合条件的记录，其用法如下：

findAll($cOnditions= array(), $sort = null, $fields = '*', $limit = null)

参数说明：

• $conditions：数组形式，表示查询条件。可以是简单的键值对条件，也可以是复杂的条件数组。
• $sort：字符串，指定查询结果的排序方式，如 'post_time ASC' 表示按时间升序排列。
• $fields：字符串，指定要返回的字段，默认为 '*' 即返回所有字段。
• $limit：字符串或数组，指定查询结果的数量和偏移量。

条件构造：

1. 简单条件：

例如，array('cid' => 12, 'score' => 100) 表示查询 c_id=12 AND score=100 的记录。

2. 复杂条件：

例如，模糊查询标题包含 'php' 的文章：array('title like :word', ':word' => '%php%')。

3. 使用绑定参数避免SQL注入：

绑定参数是防止SQL注入的最佳实践。例如：findAll(['ip like :ip', ':ip' => '218.26.35.%']);

二、查询一条记录 find()

find() 是 findAll() 的简化版，仅返回一条记录，等同于 findAll($conditions, $sort, $fields, 1)。

三、新增记录 create()

create() 方法用于向数据库中插入新记录：

create($row)

其中，$row 是一个关联数组，键为字段名，值为对应的字段值。例如：

$newrow = ['name' => 'jake', 'contents' => '这是我的第一个留言', 'post_time' => date('Y-m-d H:i:s'), 'post_ip' => $_SERVER['REMOTE_ADDR']];

四、删除记录 delete()

delete() 方法用于根据条件删除记录：

delete($condition)

返回影响行数，即被删除的记录数量。例如：$gb->delete(['gid' => 13]);

五、修改记录 update()

update() 方法用于更新现有记录：

update($condition, $row)

其中，$condition 是更新条件，$row 是待更新的新值数组。例如：$gb->update(['gid' => 12], ['contents' => '新信息']);

六、计算总数 findCount()

findCount() 方法用于计算符合条件的记录数量：

findCount($condition)

例如：$sum = $gb->findCount(['name' => 'jake']);

七、按字段增减 incr() / decr()

incr() 和 decr() 方法用于对数值字段进行增减操作：

incr($condition, $field, $optval = 1)

decr($condition, $field, $optval = 1)

例如，增加博客页面访问量：$blog->incr(['uid' => 10], 'click');

八、输出执行SQL供调试 dumpSql()

dumpSql() 方法用于收集并返回当前模型类执行过的全部SQL语句，便于调试：

$sqls = $model->dumpSql();