原文发表于:
上一篇 中介绍了 Phalcon
模型的 insert
和 select
操作,本篇将介绍 update
和 delete
的用法。文中所用的示例代码皆沿用上一篇的数据表,这里不在赘述。
更新记录
Phalcon
模型更新记录的示例代码如下:
$articleModel = new ArticlesModel();//先调用 findFirst() 获取一条记录,返回值是当前模型对象$article = $articleModel->findFirst([ 'conditions' => 'aid = :aid:', 'bind' => [ 'aid' => 3 ],]);if($article) { //使用返回的模型对象调用 update() 函数执行更新操作 $result = $article->update([ 'title' => 'Phalcon更新测试1', ]); //update() 函数返回值为boolean var_dump($result);}
监听到的SQL语句如下:
SELECT * FROM `test_articles` WHERE `test_articles`.`aid` = :aid LIMIT :APL0UPDATE `test_articles` SET `title` = ?, `introduce` = ?, `status` = ?, `view_number` = ?, `is_recommend` = ?, `is_top` = ?, `create_by` = ?, `create_time` = ?, `modify_by` = ?, `modify_time` = ? WHERE `aid` = ?
通过代码和SQL语句,可以看出在调用 update()
函数之前,必须要先调用 findFirst()
函数获取一条记录。这是因为 update()
函数内部是默认使用主键作为更新条件的,所以 update()
函数没有更新条件这个参数,只能通过主键来更新。但是每次执行更新操作的时候,都要执行两条SQL语句(先 select
后 update
),在性能上会有所损耗。下面跟大家分享只执行一条 update
SQL语句的办法( 前提是已经知道主键值):
$articleModel = new ArticlesModel();$articleModel->aid = 3; //为主键成员属性赋值 $result = $articleModel->update([ 'title' => 'Phalcon更新测试',]);
上述代码运行之后,抛出一个异常:
SQLSTATE[23000]: Integrity constraint violation: 1048 Column 'introduce' cannot be null
意思是 introduce
字段值不能为空。我们回头再看前面监听到的 update
SQL语句,执行 update()
函数的时候,把 test_articles
表中的所有字段都更新了。也就是说,调用 update()
函数的时候,需要更新表中的所有字段,而不能只更新某个字段或者一部分字段,所以此处,需要传入全部字段做为参数:
$articleModel = new ArticlesModel();$articleModel->aid = 3;$result = $articleModel->update([ 'title' => 'Phalcon更新测试', 'introduce' => "Phalcon入门教程2", 'status' => 2, 'view_number' => 2, 'is_recommend' => 1, 'is_top' => 1, 'create_by' => 1, 'create_time' => date('Y-m-d H:i:s'), 'modify_by' => 1, 'modify_time' => date('Y-m-d H:i:s')]);if(!$result){ throw new \Exception('数据更新失败');}//获取影响行数(假设DI中注册的数据库服务名称为“db”)$affectedRows = $this->getDI()->get('db')->affectedRows();
每次更新数据的时候,都需要将所有字段全部更新,显然不符合咱天朝广大开发者的习惯,那有没有办法实现只更新部分字段呢?
更新部分字段
除了写原生SQL,或者通过PHQL的方式可以实现更新部分字段之外,Phalcon
中并没有提供可以直接使用的函数。不过,我们可以通过其他方法来曲线救国一下,下面是我封装的函数:
//文件路径:marser/app/frontend/models/ArticlesModel.php /** * 封装phalcon model的update函数,实现仅更新数据变更字段,而非所有字段更新 * @param array|null $data * @param null $whiteList * @return bool */ public function iupdate(array $data = null, $whiteList = null) { if (count($data) > 0) { //获取当前模型驿应的数据表所有字段 $attributes = $this->getModelsMetaData()->getAttributes($this); //取所有字段和需要更新的数据字段的差集,并过滤 $this->skipAttributesOnUpdate(array_diff($attributes, array_keys($data))); } return parent::update($data, $whiteList); }
函数很简单,先获取当前模型对应数据表的所有字段,并和需要更新的数据字段之间取差集,然后调用 skipAttributesOnUpdate
函数进行过滤。上述更新部分字段的示例代码就可以修改成:
$articleModel = new ArticlesModel();$articleModel->aid = 3;//注意这里的函数名$result = $articleModel->iupdate([ 'title' => 'Phalcon更新测试',]);if(!$result){ throw new \Exception('数据更新失败');}$affectedRows = $this->getDI()->get('db')->affectedRows();
至此就能更新成功,并能获取影响行数。
这里提一下,Phalcon
模型的 update()
函数有一个注意点。当更新的数据和表中的数据相同时,update()
函数会返回 true
值,但是影响行数却是0。 save()
Phalcon
模型的 save()
函数会判断当前模型对象中主键成员属性是否有值,若有值,就内部调用 update()
函数执行更新操作;若没值,就内部调用 create()
函数执行插入操作。
删除记录
删除记录和更新记录类似,要先调用 findFirst()
之后,再调用 delete()
函数删除一条数据。我们在知道主键的情况,也可以直接给主键成员属性赋值:
$articleModel = new ArticlesModel();$articleModel->aid = 4;$result = $articleModel->delete();$affectedRows = $this->getDI()->get('db')->affectedRows();
值得注意的是,不论主键ID是否存在,delete()
都会返回 true
值,而影响行数会正常返回。所以建议根据影响行数来判断是否执行成功。
以上代码已托管在github:
最后,欢迎大家加入QQ群交流讨论:
- 广州PHP高端交流群:158587573
- Phalcon玩家群:150237524