创建(Create)
在ThinkPHP中使用add方法新增数据到数据库(而并不是create方法)。add 写入(新增)数据到数据库 | |
---|---|
用法 | add($data='',$options=array(),$replace=false) |
参数 | data(可选):要新增的数据,支持数组和对象,如果留空取当前数据对象 options(可选):操作表达式,通常由连贯操作完成,默认为空数组 replace(可选):是否允许写入时更新,默认为false(个别数据库支持) |
回调接口 | 写入前 _before_insert(&$data,$options) 写入成功 _after_insert($data,$options) |
返回值 | 如果数据非法或者查询错误则返回false 如果是自增主键 则返回主键值,否则返回1 |
相关方法 | 通常和data、create方法配合使用 |
- $User = M("User"); // 实例化User对象
- $data['name'] = 'ThinkPHP';
- $data['email'] = 'ThinkPHP@gmail.com';
- $User->add($data);
- $User->data($data)->add();
- $User = M("User"); // 实例化User对象
- // 根据表单提交的POST数据创建数据对象
- $User->create();
- $User->add(); // 根据条件保存修改的数据
- $User->addAll($data)
- add($data='',$options=array(),$replace=false)
读取(Read)
在ThinkPHP中读取数据的方式很多,通常分为读取数据和读取数据集。 读取数据集使用select方法(新版已经废除原来的findall方法):select 查询数据集 | |
---|---|
用法 | select($options=array()) |
参数 | options(可选):为数组的时候表示操作表达式,通常由连贯操作完成;如果是数字或者字符串,表示主键值。默认为空数组。 |
回调接口 | 查询成功 _after_select(&$resultSet,$options) |
返回值 | 查询错误返回false 查询结果为空返回null 查询成功返回查询的结果集(二维索引数组) |
相关方法 | 通常配合连贯操作where、field、order、limit、join等一起使用 |
- $User = M("User"); // 实例化User对象
- // 查找status值为1的用户数据 以创建时间排序 返回10条数据
- $list = $User->where('status=1')->order('create_time')->limit(10)->select();
find 查询数据 | |
---|---|
用法 | find($options=array()) |
参数 | options(可选):为数组的时候表示操作表达式,通常由连贯操作完成;为数字或者字符串的时候表示主键值。默认为空数组。 |
回调接口 | 查询后 _after_find(&$result,$options) |
返回值 | 如果查询错误返回false 如果查询结果为空返回null 如果查询成功返回查询的结果(索引数组) |
相关方法 | 通常配合连贯操作where、field、order、join等一起使用 |
- $User = M("User"); // 实例化User对象
- // 查找status值为1name值为think的用户数据
- $User->where('status=1 AND name="think"')->find();
getField 查询某个字段的值 | |
---|---|
用法 | getField($field,$sepa=null) |
参数 | field(必须):要获取的字段字符串(多个用逗号分隔) sepa(可选):字段数据间隔符号,如果是 NULL返回数组为数组。默认为null。 |
回调接口 | 查询后 _after_find(&$result,$options) |
返回值 | 如果查询结果为空返回null 如果field是一个字段则返回该字段的值 如果field是多个字段,返回数组。数组的索引是第一个字段的值,sepa为null则返回二维数组。 |
相关方法 | 通常配合连贯操作where、limit、order等一起使用 |
- $User = M("User"); // 实例化User对象
- // 获取ID为3的用户的昵称
- $nickname = $User->where('id=3')->getField('nickname');
- $this->getField('id',true); // 获取id数组
- $User = M("User"); // 实例化User对象
- // 获取所有用户的ID和昵称列表
- $list = $User->getField('id,nickname');
- $list = $User->getField('id,nickname,email');
- $list = $User->getField('id,nickname,email',':');
- $this->getField('id,name',5); // 限制返回5条记录
- $this->getField('id',3); // 获取id数组 限制3条记录
更新(Update)
在ThinkPHP中使用save方法更新数据库,并且也支持连贯操作的使用。save 更新数据到数据库 | |
---|---|
用法 | save($data='',$options=array()) |
参数 | data:要保存的数据,如果为空,则取当前的数据对象。 options:为数组的时候表示操作表达式,通常由连贯操作完成;为数字或者字符串的时候表示主键值。默认为空数组。 |
回调接口 | 更新前_before_update(&$data,$options) 更新成功后 _after_update($data,$options) |
返回值 | 如果查询错误或者数据非法返回false 如果更新成功返回影响的记录数 |
相关方法 | 通常配合连贯操作where、field、order等一起使用 |
- $User = M("User"); // 实例化User对象
- // 要修改的数据对象属性赋值
- $data['name'] = 'ThinkPHP';
- $data['email'] = 'ThinkPHP@gmail.com';
- $User->where('id=5')->save($data); // 根据条件保存修改的数据
- $User->save($data);
- $User = M("User"); // 实例化User对象
- // 要修改的数据对象属性赋值
- $data['id'] = 5;
- $data['name'] = 'ThinkPHP';
- $data['email'] = 'ThinkPHP@gmail.com';
- $User->save($data); // 根据条件保存修改的数据
- $User = M("User"); // 实例化User对象
- // 要修改的数据对象属性赋值
- $data['name'] = 'ThinkPHP';
- $data['email'] = 'ThinkPHP@gmail.com';
- $User->where('id=5')->data($data)->save(); // 根据条件保存修改的数据
- $User = M("User"); // 实例化User对象
- // 根据表单提交的POST数据创建数据对象
- $User->create();
- $User->save(); // 根据条件保存修改的数据
setField 更新某个字段的值 | |
---|---|
用法 | setField($field,$value='') |
参数 | options(可选):为数组的时候表示操作表达式,通常由连贯操作完成;为数字或者字符串的时候表示主键值。默认为空数组。 |
返回值 | 如果查询错误返回false 如果更新成功返回影响的记录数 |
相关方法 | 必须配合连贯操作where一起使用 |
- $User = M("User"); // 实例化User对象
- // 更改用户的name值
- $User-> where('id=5')->setField('name','ThinkPHP');
- $User = M("User"); // 实例化User对象
- // 更改用户的name和email的值
- $data = array('name'=>'ThinkPHP','email'=>'ThinkPHP@gmail.com');
- $User-> where('id=5')->setField($data);
setInc /setDec 字段增长/字段减少 | |
---|---|
用法 | setInc($field,$step=1)字段值增长 setDec($field,$step=1)字段值减少 |
参数 | field:要更新的字段名。 step:增长或者减少的数值,默认为1。 |
回调接口 | 如果查询错误返回false 如果更新成功返回影响的记录数 |
返回值 | 如果查询错误返回false 如果更新成功返回影响的记录数 |
相关方法 | 必须配合连贯操作where一起使用 |
- $User = M("User"); // 实例化User对象
- $User->where('id=5')->setInc('score',3); // 用户的积分加3
- $User->where('id=5')->setInc('score'); // 用户的积分加1
- $User->where('id=5')->setDec('score',5); // 用户的积分减5
- $User->where('id=5')->setDec('score'); // 用户的积分减1
删除(Delete)
在ThinkPHP中使用delete方法删除数据库中的记录。
用法 | delete($options=array()) |
参数 | options:为数组的时候表示操作表达式,通常由连贯操作完成,如果没有传入任何删除条件,则取当前数据对象的主键作为条件;为数字或者字符串的时候表示主键值。默认为空数组。 |
回调接口 | 删除成功后 _after_delete($data,$options) |
返回值 | 如果查询错误返回false 如果删除成功返回影响的记录数 |
相关方法 | 通常配合连贯操作where、field、order等一起使用 |
示例如下:
- $User = M("User"); // 实例化User对象
- $User->where('id=5')->delete(); // 删除id为5的用户数据
- $User->where('status=0')->delete(); // 删除所有状态为0的用户数据
delete方法可以用于删除单个或者多个数据,主要取决于删除条件,也就是where方法的参数,也可以用order和limit方法来限制要删除的个数,例如:
-
- // 删除所有状态为0的5 个用户数据 按照创建时间排序
- $User->where('status=0')->order('create_time')->limit('5')->delete();