CodeIgniter4 useSoftDeletes 软删除

做数据删除的时候,我们往往会用到软删除。CI4 对这一功能进行了支持。
CI4 使用 deleted_at 字段是否为 NULL 来判断是数据是否被删除。

<?php namespace App\Models;

use CodeIgniter\Model;

class UserModel extends Model
{
        protected $table      = 'users';
        protected $primaryKey = 'id';

        protected $returnType = 'array';
        protected $useSoftDeletes = true;

        protected $allowedFields = ['name', 'email'];

        protected $useTimestamps = false;
        protected $createdField  = 'created_at';
        protected $updatedField  = 'updated_at';
        protected $deletedField  = 'deleted_at';

        protected $validationRules    = [];
        protected $validationMessages = [];
        protected $skipValidation     = false;
}

如果 useSoftDeletes 设置为 true, 则所有数据结果默认排除掉已经删除的数据,具体的做法是会在 SQL 语句中增加 deleted_at IS NULL 来进行数据的过滤。
有很多人在 GITHUB 发 ISSUES 表示自己的 useSoftDeletes 无法正常工作,实际上是因为我们默认习惯将 deleted_at 默认设置为 int, DEFAILT 0, NOT NULL。我们需要让 deleted_at 允许 NULL 并且默认为 NULL。这样我们才能使用 useSoftDelets
如果我们希望返回的数据临时包括已删除的数据, 我们可以使用 withDeleted
如果我们希望返回的数据只包括已删除的数据,我们可以使用 onlyDeleted