“Eloquent Attribute Entity States”并非 Laravel 官方概念，其本质是业务层对模型数据一致性、合法性与阶段性的建模需求，须通过显式状态字段、受控赋值路径（如重写 setAttribute）、校验方法（如 submitForReview）及数据库约束（如 CHECK）协同实现。
“Eloquent Attribute Entity States”不是 Laravel 官方概念，也不存在对应 API 或生命周期钩子；所谓“实体状态”本质是业务层对模型数据一致性、合法性、阶段性的建模需求，必须靠手动控制属性赋值路径 + 显式状态字段 + 业务规则校验来实现。
set{Attribute}Attribute 无法覆盖所有赋值场景
很多人以为只要写了 setEmailAttribute() 就能拦截所有 email 赋值，但实际中大量路径会绕过它：
- 直接赋值
$user->email = 'x@y.z'—— 不触发任何访问器，除非该属性在$fillable中且走fill() - 批量赋值
$user->fill(['email' => 'x@y.z'])—— 会触发setEmailAttribute()，但前提是字段在$fillable或$guarded允许范围内 - 数据库查询结果加载（如
User::find(1)）—— 属性直接塞进$this->attributes，不走修改器 - JSON 反序列化（
toArray()→new User($array)）—— 绕过所有访问器，只走$casts和构造逻辑
真正可控的入口只有重写 setAttribute()，但它必须小心处理递归：$this->$key = $value 会再次调用自身，导致栈溢出。
状态变更必须绑定显式动作，不能依赖“自动感知”
Entity State 不是时间戳或布尔开关，而是业务语义明确的阶段标识（如 'draft' → 'reviewing' → 'published'），它的变更必须由具体方法驱动：
立即学习“PHP免费学习笔记（深入）”；
- 不要在
setStatusAttribute()里自动更新updated_at或发事件——这会让状态变成被动副作用，难以追踪谁、何时、为何改了状态 - 应提供明确方法：
$post->submitForReview()、$post->publish()，内部做状态校验 + 时间戳更新 + 事件生成 - 这些方法要检查前置条件（如
status === 'draft'才允许submitForReview），失败时抛异常而非静默忽略 - 避免把状态逻辑散落在控制器或服务类里——状态迁移规则必须收口到模型自身，否则多人协作时极易不一致
并发更新下状态一致性需原子操作保障
当多个请求同时尝试改变同一模型的状态（例如两个管理员同时点击“发布”），仅靠 PHP 层判断 + save() 无法防止竞态：
-
if ($post->status === 'reviewing') { $post->status = 'published'; $post->save(); }是典型非原子操作，两次读+一次写之间可能被其他请求插入 - 正确做法是使用数据库级原子更新：
User::where('id', 123)->where('status', 'reviewing')->update(['status' => 'published', 'published_at' => now()]) - 返回受影响行数，为 0 表示状态已变，操作被拒绝，此时应反馈用户“状态已被他人更新”
- 若需复杂校验（如检查关联审核记录是否存在），再配合
DB::transaction+sharedLock()或forUpdate()锁定行
最易被忽略的是：状态字段本身必须可空、可枚举、有默认值，并在迁移中加数据库约束（如 CHECK (status IN ('draft', 'reviewing', 'published'))）。没有约束的字符串字段，等于没状态。
