Eloquent 没有原生 Attribute Groups 机制，所谓“属性分组”是开发者为可读性、复用性或序列化而约定的模式；$casts、$appends 和访问器均不等价于分组；推荐通过 JsonResource 实现解耦、可扩展的分组策略。
PHP 中 Eloquent 没有原生的 Attribute Groups（属性分组）机制——这是个常见误解，Laravel 官方从未提供名为 attributeGroups 的配置或方法。所谓“字段逻辑分组”，实际是开发者为组织可读性、复用性或序列化行为而自行约定的模式，不是框架内置功能。
为什么 $casts、$appends 和访问器不等于“属性分组”
很多人试图用 $casts 或 $appends 模拟分组，但它们作用完全不同：
-
$casts只控制数据库字段到 PHP 类型的自动转换（如'is_active' => 'boolean'），不涉及逻辑归类 -
$appends仅影响toArray()/toJson()输出时是否包含访问器，且必须配合getXXXAttribute()方法，无法按业务域动态启用/禁用整组 - 访问器（如
getFullNameAttribute()）是单字段计算逻辑，不是分组容器
用 toArray() 重载 + 命名数组实现轻量分组
最直接可控的方式：在模型中定义分组方法，再覆盖 toArray()，按需注入结构化字段块。适合 API 返回、导出等明确场景。
示例：将用户信息拆为 identity、contact、stats 三组：
立即学习“PHP免费学习笔记（深入）”；
class User extends Model
{
public function getIdentityGroupAttribute()
{
return [
'id' => $this->id,
'name' => $this->name,
'role' => $this->role,
];
}
public function getContactGroupAttribute()
{
return [
'email' => $this->email,
'phone' => $this->phone,
];
}
public function toArray()
{
$array = parent::toArray();
// 只在需要时才展开分组，避免无意义嵌套
if (request()->has('with_groups')) {
$array['groups'] = [
'identity' => $this->identity_group,
'contact' => $this->contact_group,
'stats' => ['login_count' => $this->login_count ?? 0],
];
}
return $array;
}
}
注意：request() 在模型里调用属于耦合反模式，生产环境建议通过服务类或资源类（ApiResource）控制分组输出，模型只提供分组方法。
用 Laravel Resources 实现真正解耦的分组策略
API 层字段分组应交给 JsonResource，这才是 Laravel 推荐路径。模型保持纯净，分组逻辑由资源类决定：
定义 UserResource：
class UserResource extends JsonResource
{
public function toArray($request)
{
return [
'id' => $this->id,
'groups' => [
'identity' => [
'name' => $this->name,
'role' => $this->role,
],
'contact' => [
'email' => $this->email,
'phone' => $this->phone,
],
'stats' => [
'login_count' => $this->login_count ?? 0,
],
],
];
}
}
控制器中使用：return new UserResource($user);
优势明显：
- 分组结构完全与模型解耦，可为同一模型定义多个 Resource（如
UserPublicResource、UserAdminResource） - 支持条件分组：
if ($request->user()->can('view_sensitive')) { ... } - 天然兼容 Eager Loading 和缓存策略
别踩坑：用 setAttribute() 或 __set() 模拟分组会破坏数据一致性
有人尝试在模型里写：
public function setContactGroupAttribute($value)
{
$this->email = $value['email'] ?? null;
$this->phone = $value['phone'] ?? null;
}
这非常危险——Eloquent 的批量赋值（fill()、create()）不会触发该逻辑；且 save() 时无法保证字段原子性更新。更严重的是，它让模型状态变得不可预测：你不知道 $user->contact_group 是只读结构，还是可写代理。
真实项目中，字段逻辑分组几乎从不用于写入场景。如果真要批量更新某组字段，请显式传参或用 DTO 封装，而不是靠“伪属性”混淆语义。
分组本质是视图层契约，不是数据层能力。越早把分组逻辑推到 Resource 或 Transformer 层，后续加权限、审计、版本兼容就越省力。
