Composer怎么安装Spatie Laravel Data_Composer如何引入Laravel Data做数据对象和请求验证【教程】-composer-PHP中文网

能直接装上，但需先确认 laravel 和 php 版本兼容性：v3.x 要求 laravel 10/11 且 php ≥ 8.1；laravel 9 应用需改用 ^2.15 版本，否则因依赖冲突安装失败。

composer怎么安装spatie laravel data_composer如何引入laravel data做数据对象和请求验证【教程】

composer require spatie/laravel-data 能直接装上吗

不能直接装，得先确认 Laravel 版本和 PHP 版本是否匹配。Spatie Laravel Data 当前（v3.x）要求 Laravel 10 或 11，PHP ≥ 8.1；如果你用的是 Laravel 9，得降级到 spatie/laravel-data:^2.15，否则 composer require 会报依赖冲突，常见错误是：Conclusion: don't install laravel/framework v10.39.0 这类提示。

实操建议：

先运行 php -v 和 php artisan --version 确认环境
查清当前 Laravel 主版本号（比如 10.x），再对照官方兼容表选对包版本
安装时显式指定版本更稳，例如：composer require spatie/laravel-data:^3.10
装完别忘了运行 php artisan vendor:publish --provider="Spatie\Data\DataServiceProvider"（v3 起已自动注册，但部分配置仍需手动发布）

用 DataTransferObject 还是 Data 类做请求验证

用 Data 类，不是 DataTransferObject。后者是旧版（v2 及之前）的基类，v3 已废弃；新版统一用 Spatie\Data\Data 作为所有数据对象的父类，它内置了请求验证能力——只要在控制器里类型提示该类，Laravel 就会自动调用其 rules() 方法校验请求，并抛出标准 ValidationException。

常见错误现象：写了 rules() 却没生效，多半是因为继承错了类，或者没在控制器参数里正确声明类型：

✅ 正确写法：public function store(UserData $data)，其中 UserData extends Data
❌ 错误写法：public function store(Request $request) 再手动 new UserData，这样绕过了自动验证流程
rules() 返回数组，键名必须与属性名一致，且不支持嵌套点号（如 address.street），要用数组形式定义嵌套规则

rules() 里怎么写嵌套字段和条件验证

嵌套字段验证必须用数组结构，不能用点号语法；条件验证（比如“当 type=premium 时 email_required”）要靠 Rule::requiredIf() 或闭包，不能只靠静态数组。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

示例场景：用户注册时，plan 是 premium 才要求填 company_name：

class UserData extends Data
{
    public function __construct(
        public string $name,
        public string $email,
        public string $plan,
        public ?string $company_name = null,
    ) {
    }

    public static function rules(): array
    {
        return [
            'name' => ['required', 'string'],
            'email' => ['required', 'email'],
            'plan' => ['required', 'in:basic,premium'],
            'company_name' => [
                Rule::requiredIf(fn () => request()->input('plan') === 'premium'),
                'string',
            ],
        ];
    }
}

注意点：

request() 在 rules() 里可用，但仅限于当前请求上下文；测试时需用 HttpTestCase 模拟请求，否则会报错
嵌套数据对象（比如 address: AddressData）的验证要单独定义 AddressData::rules()，父类里只写 'address' => ['required', 'array']，具体字段交由子类处理
不要在 rules() 里访问未初始化的属性或外部服务，它在验证阶段就执行，早于构造函数