2017
07-20

Phalcon入门教程之模型CURD(2)

上一篇 Phalcon入门教程之模型CURD(1) 中介绍了 Phalcon 模型的 insertselect 操作,本篇将介绍 updatedelete 的用法。文中所用的示例代码皆沿用上一篇的数据表,这里不在赘述。

更新记录

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 :APL0

UPDATE `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语句(先 selectupdate ),在性能上会有所损耗。下面跟大家分享只执行一条 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 值,而影响行数会正常返回。所以建议根据影响行数来判断是否执行成功。
如果需要批量删除,或者使用非主键作为删除条件,那么只能写原生SQL或者PHQL去删除数据,当然也可以自己封装一个函数。

以上代码已托管在github:https://github.com/KevinJay/marser-phalcon-demo

最后,欢迎大家加入QQ群交流讨论:

  • 广州PHP高端交流群:158587573
  • Phalcon玩家群:150237524
「真诚赞赏,手留余香」
您的支持将鼓励我继续创作 :)