Laravel模型修改器仅在模型赋值时触发，用于轻量业务标准化处理，如邮箱转小写；标准类型转换应优先用$casts，字段映射需结合访问器与__set/__get实现。
Laravel 模型修改器（Mutator）用于在设置属性值时自动处理数据，但它本身不改变数据库字段类型或存储格式，也不影响查询逻辑。正确使用的关键在于明确它的触发范围、配合更稳定的机制（如 $casts），并避开常见陷阱。
修改器的基本写法与触发时机
修改器方法名必须遵循 set{AttributeName}Attribute 格式，其中 AttributeName 是驼峰命名的属性名，对应数据库中下划线命名的字段。
- 它只在模型层赋值时生效：比如
$user->email = 'ABC@EXAMPLE.COM'、$user->fill(['email' => '...'])、User::create([...]) - 对
DB::table()->update()或原生 SQL 操作完全无效 - 批量赋值时，键名需能匹配到模型定义的属性名（如
email），才会触发对应修改器
哪些场景适合用修改器
适合做轻量、业务相关的标准化处理，且该逻辑确实需要“写入前强制干预”：
- 邮箱转小写：
$this->attributes['email'] = Str::lower($value) - 用户名清理空格或特殊字符：
trim(preg_replace('/[^a-z0-9_]/i', '', $value)) - 金额统一存为“分”：
$this->attributes['amount'] = (int)round($value * 100) - JSON 字段预设结构（配合
$casts = ['meta' => 'array']后再增强校验）
哪些情况应优先用 $casts 而非修改器
标准、通用、可复用的数据转换，Laravel 已提供更健壮的方案：
- 时间字段：用
'published_at' => 'datetime'或自定义 cast，别手动在修改器里 new Carbon() - 布尔值标准化：
'is_active' => 'boolean'自动转 true/false，无需setIsActiveAttribute - JSON 字段：
'settings' => 'json'自动序列化/反序列化，比手写json_encode()更安全 - 大小写统一：可配合自定义 cast 类（如
LowercaseCast），比重复写修改器更易测试和复用
字段映射与前后端兼容技巧
当数据库字段名（如 first_name）和前端期望字段（如 firstName）不一致时，可结合修改器 + 访问器 + 简单映射实现双向透明：
- 在模型中定义
protected $maps = ['firstName' => 'first_name'] - 写一个通用修改器：
public function __set($key, $value) { if (isset($this->maps[$key])) { $this->attributes[$this->maps[$key]] = $value; } else { parent::__set($key, $value); } } - 配合访问器
public function __get($key) { if (isset($this->maps[$key])) { return $this->attributes[$this->maps[$key]]; } ... } - 这样前端传
firstName，模型自动存进first_name，读取时也按firstName返回
