Composer怎么安装Spatie ViewModels_Composer如何引入view-models将复杂视图逻辑封装到ViewModel类【方法】-composer-PHP中文网

spatie/laravel-view-models 仅支持 laravel 9+，laravel 8 及以下需手动构造 viewmodel；须手动注册 serviceprovider、用 view() 传实例、在 toview() 中获取请求/认证数据。

composer怎么安装spatie viewmodels_composer如何引入view-models将复杂视图逻辑封装到viewmodel类【方法】

composer require spatie/laravel-view-models 失败？先确认 Laravel 版本

这个包只支持 Laravel 9+，如果你用的是 Laravel 8 或更早版本，composer require spatie/laravel-view-models 会报依赖冲突——它硬依赖 laravel/framework:^9.0|^10.0|^11.0，不向下兼容。

常见错误现象：Root composer.json requires spatie/laravel-view-models ^3.0 -> found spatie/laravel-view-models[3.0.0, ..., 3.2.0] but these were not loaded，本质是版本锁死导致的解析失败。

运行 php artisan --version 确认当前 Laravel 版本
Laravel 8 及以下：别硬装，改用原生方式手动构造 ViewModel 类（无自动绑定）
Laravel 9+：确保 composer.json 中 "minimum-stability": "stable"，避免 dev 分支干扰

view-models 不自动注入？检查服务提供者是否注册

安装后视图里写 {{ $viewModel->title }} 报 Undefined variable: viewModel，大概率是服务提供者没生效——这个包不会自动发现，必须手动加到 config/app.php 的 providers 数组里。

使用场景：你希望在 Blade 中直接用 $viewModel 而非 app(YourViewModel::class)，就得走自动绑定流程。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

打开 config/app.php
在 'providers' => [...] 数组末尾添加：Spatie\ViewModels\ViewModelServiceProvider::class
执行 php artisan config:clear，别跳过这步，缓存不刷新就等于没注册

ViewModel 类里访问 Request 或 Auth 失败？别在构造函数里直接用 Facade

很多人把 Auth::user() 或 request()->query('search') 直接塞进 ViewModel 构造函数，结果测试时正常、线上报 Call to a member function query() on null——因为 Laravel 的服务容器在某些上下文（如队列、命令行）中可能还没完全启动请求栈。

参数差异：构造函数参数应只接收明确传入的对象（如 User $user），而非依赖全局状态。

正确做法：在 toView() 方法里按需获取，它总在视图渲染前执行，上下文完整

示例：

public function toView(): array
{
    return [
        'user' => Auth::user(),
        'search' => request()->input('search', ''),
    ];
}

性能影响：toView() 是懒加载时机，比构造函数里硬取更安全，也避免无谓的数据库查询

Blade 中怎么传参给 ViewModel？不是靠 @include，而是用 view() 函数

想给 ViewModel 传一个动态 ID，却写成 @include('posts.show', ['id' => $post->id])，结果 ViewModel 里收不到——@include 只传变量，不触发 ViewModel 绑定机制。

使用场景：你有一个 PostViewModel，需要根据路由参数或请求数据生成不同状态的视图数据。

正确调用方式：return view('posts.show', new PostViewModel($post->id));
如果用控制器方法返回视图，确保 view() 的第二个参数是 ViewModel 实例，不是数组
兼容性注意：Laravel 11 默认启用了「strict view binding」，传错类型（比如传数组）会直接报错，而不是静默忽略

Spatie ViewModels 的核心约束其实就一条：它只在 view() 函数被显式传入实例时才激活绑定逻辑。漏掉这一步，或者版本/注册/传参任一环没对上，整个链路就断了——没有魔法，全是契约。