本文介绍如何在 laravel 中通过模型访问器（accessors）动态修改查询返回的数据，避免使用 retrieved 事件导致的修改无效问题，并提供获取原始值和追加属性的完整方案。
本文介绍如何在 laravel 中通过模型访问器（accessors）动态修改查询返回的数据，避免使用 retrieved 事件导致的修改无效问题，并提供获取原始值和追加属性的完整方案。
在 Laravel 中，若希望每次从数据库读取数据后自动、透明地修改字段值（例如脱敏手机号、格式化时间、拼接显示名称等），直接在 retrieved 模型事件中赋值（如 $data->field = 'new value'）是无效的——因为该事件触发时模型实例已构建完成并返回至调用方，对属性的修改仅作用于当前对象生命周期，无法影响控制器中已接收的模型实例状态，更无法改变序列化（如 JSON 响应）时的实际输出。
正确的做法是使用 Eloquent 访问器（Accessors）。访问器会在你读取模型属性时动态计算并返回值，既保持原始数据完整性，又确保所有消费方（控制器、API 响应、Blade 模板等）始终获得预处理后的结果。
✅ 正确实现：定义访问器
在模型中定义一个以 get{Property}Attribute 命名的公共方法即可：
// app/Models/User.php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class User extends Model
{
// 可选：将访问器字段加入 $appends，使其默认包含在 toArray() / JSON 输出中
protected $appends = ['display_name'];
// 访问器：动态修改 name 字段（例如首字母大写 + 后缀）
public function getNameAttribute($value)
{
return ucfirst($value) . ' (User)';
}
// 追加属性访问器：组合 first_name 和 last_name
public function getDisplayNameAttribute()
{
return trim("{$this->first_name} {$this->last_name}");
}
}
此时，在控制器中使用完全无感知：
// 在控制器中 $user = User::find(1); echo $user->name; // 输出：'John (User)'（经访问器处理） echo $user->display_name; // 输出：'John Doe'（由访问器动态生成）
? 获取原始未处理值
当业务需要绕过访问器、读取数据库原始值时，可使用 getRawOriginal() 方法：
echo $user->name; // 'John (User)'（访问器生效）
echo $user->getRawOriginal('name'); // 'john'（原始数据库值）
该方法安全可靠，不会触发访问器，适用于日志记录、数据比对、导出等场景。
⚠️ 注意事项与最佳实践
- ❌ 不要依赖 retrieved 事件修改属性值来影响外部逻辑——它不具备响应式更新能力；
- ✅ 访问器是惰性执行、只读转换，性能开销极小，且天然兼容 API 资源、Fractal、toArray() 和 JSON 响应；
- ✅ 若需条件性修改（如仅对 API 响应生效），可结合 API Resources 进行更精细控制；
- ✅ 使用 $appends 时注意避免循环访问（如 getDisplayNameAttribute 中又调用 $this->display_name）；
- ✅ 对敏感字段（如密码、token），务必确保访问器不意外暴露原始值——始终用 getRawOriginal() 显式获取底层数据。
综上，访问器是 Laravel 中处理“读时动态转换”的标准、优雅且高效的方式。它让数据转换逻辑集中于模型层，保障一致性与可维护性，是替代 retrieved 事件篡改的推荐方案。
