Laravel 10/11版本文档完善差异：PHP 8.1+属性语法适配避坑指南【汇总】-php教程-PHP中文网

Laravel 10/11虽支持PHP 8.1+属性，但模型Cast需配合Attribute声明、验证规则须显式启用withAttributes()、路由属性仅限public方法、事件监听需在EventServiceProvider中调用listenUsingAttributes()才生效。

laravel 10/11版本文档完善差异：php 8.1+属性语法适配避坑指南【汇总】

Laravel 10 和 11 官方文档对 PHP 8.1+ 属性（Attributes）的支持已逐步补全，但实际开发中仍存在不少“文档没写清楚、代码却会报错”的细节坑点。核心问题不在于是否支持属性语法，而在于 Laravel 框架层与 PHP 原生属性机制的交互边界——尤其是模型、验证器、路由、事件等高频场景下，属性声明的位置、顺序、参数类型和反射时机，稍有偏差就会导致无法识别或静默失效。

模型字段定义：不能直接用 #[Cast] 替代 $casts 数组

Laravel 文档提到支持 #[Cast] 属性，但仅适用于 Eloquent 模型的 属性（property）本身，且必须配合 #[Cast] + #[Attribute] 的完整声明方式。它不会自动映射到传统 $casts 数组逻辑，也不会触发 getCastableAttributes() 的旧流程。

✅ 正确写法（Laravel 11+）：

class User extends Model
{
    #[Cast('datetime')]
    public DateTimeImmutable|null $last_login_at = null;
}

❌ 错误写法（常见误解）：

class User extends Model
{
    // 这样写不会生效！Laravel 不会扫描类属性上的 Cast 并自动注册
    #[Cast('array')]
    public array $settings = [];

    // 也不支持在 $casts 数组里混用字符串和属性
    protected $casts = [
        'email_verified_at' => 'datetime',
        #[Cast('json')] 'preferences' => 'json', // 语法错误
    ];
}

表单验证：自定义规则属性需显式启用 AttributeRule

Laravel 11 引入了 Illuminate\Validation\Rules\AttributeRule，但文档未强调：默认情况下，Validator 实例 不会自动发现 类中带 #[Rule] 的属性。你必须手动调用 withAttributes() 或使用 Validator::make(...)->withAttributes() 才能激活。

验证类需继承 Illuminate\Validation\Rules\AttributeRule 并实现 passes()
属性必须标注 #[Rule]，且目标属性名需与验证字段名一致（区分大小写）
若用 request()->validate([...])，该快捷方式 不支持属性规则，必须改用 Validator::make(...) 显式构造