在 CodeIgniter 4 中，可通过模型的 $afterFind 回调钩子自动处理查询结果，但需注意回调接收的参数结构——实际为包含 data（单条记录）或 data（数据集数组）和 result 等键的关联数组，而非原始数据本身。
在 codeigniter 4 中，可通过模型的 `$afterfind` 回调钩子自动处理查询结果，但需注意回调接收的参数结构——实际为包含 `data`（单条记录）或 `data`（数据集数组）和 `result` 等键的关联数组，而非原始数据本身。
CodeIgniter 4 的模型生命周期钩子（如 $afterFind）会在 find(), first(), findRow() 等查询方法执行后自动触发，用于对返回结果进行统一转换。但关键点在于：$afterFind 回调函数接收到的参数并非裸数据数组，而是一个标准化的上下文数组，其结构如下：
- 单条记录（如 first() 或 findRow()）：$data['data'] 是该记录（关联数组）；
- 多条记录（如 findAll()）：$data['data'] 是记录数组；
- 同时还包含 $data['result']（QueryResult 对象）、$data['id']（主键值，若适用）等元信息。
因此，直接访问 $data['user_image'] 会报错或逻辑失效——必须通过 $data['data']['user_image']（单条）或遍历 $data['data']（多条）来操作。
✅ 正确实现示例（支持单条与多条场景）：
<?php
namespace App\Models;
use CodeIgniter\Model;
class UserModel extends Model
{
protected $table = 'users';
protected $allowedFields = ['username', 'email', 'user_image'];
// 注册 afterFind 钩子
protected $afterFind = ['getImage'];
protected function getImage(array $data): array
{
// 处理单条记录（e.g., first(), findRow()）
if (is_array($data['data']) && !isset($data['data'][0])) {
if (isset($data['data']['user_image']) && $data['data']['user_image'] == 0) {
$data['data']['user_image'] = 'default-avatar.png';
}
}
// 处理多条记录（e.g., findAll(), find()）
elseif (is_array($data['data']) && isset($data['data'][0])) {
foreach ($data['data'] as &$row) {
if (isset($row['user_image']) && $row['user_image'] == 0) {
$row['user_image'] = 'default-avatar.png';
}
}
}
return $data;
}
}⚠️ 注意事项：
- getImage 方法必须声明为 protected，且接受单个 array $data 参数，返回处理后的 $data；
- 不要修改 $data['result'] 或其他非 data 键，否则可能破坏查询链路；
- 若需深度定制（如添加虚拟字段、格式化时间），建议在钩子中统一处理，避免在控制器重复逻辑；
- 钩子不会影响 insert()/update() 等写操作，仅作用于读取结果。
? 扩展建议：对于更复杂的转换需求（如图片 URL 拼接、状态映射），可封装为独立服务类，并在钩子中调用，保持模型职责清晰。
通过正确理解 $afterFind 的数据结构并合理处理 data 键，即可安全、高效地实现模型层数据的自动化修饰。
