SuperAPI AI 工具集

laravel-livewire

编程与开发

查看项目

更新于 10-26 16:21

技能介绍

Laravel Livewire 是一个用于 Laravel 的响应式组件框架,允许开发者使用 PHP 类与 Blade 模板构建动态界面,而无需编写 JavaScript。本条目基于 fusengine/claude-plugins 中的 laravel-livewire 技能资料整理,重点覆盖 Livewire 4 与 Laravel 13 的组合。

用途与定位 该技能用于在 Laravel 13 项目中构建 Livewire 4 响应式组件,覆盖数据绑定、操作调用、事件通信、单文件组件和基于文件的路由等场景。资料给出明确的决策指南:复杂逻辑选择基于类的组件;简单页面使用 Volt 函数式 API;中等复杂度使用 Volt 类式;快速嵌入使用 @volt 内联;基于文件的路由使用 Folio 与 Volt 组合。数据绑定也按场景区分:表单字段使用 wire:model.live.blur,搜索输入使用 wire:model.live.debounce.300ms,复选框/开关使用 wire:model.live,下拉选择使用 wire:model,无需同步时使用本地 Alpine x-data。

主要能力 核心能力包括:组件(带 Blade 视图的响应式 PHP 类)、wire:model 双向数据绑定、Actions(从前端调用 PHP 方法)、Events(组件间通信)、Volt(单文件组件)、Folio(基于文件的路由)。资料还列出生命周期、表单验证、Alpine 集成、文件上传、嵌套组件、加载状态、SPA 导航、测试、安全、预知验证(Precognition)和 Reverb WebSockets 等参考主题,并附带基础组件、表单组件、Volt 组件、数据表格、文件上传、嵌套组件和组件测试等完整代码模板。

使用方式 资料规定了强制性的 Agent 工作流:在任何实现之前,并行启动三个 Agent,每个 Agent 调用各带一个名称——fuse-ai-pilot:explore-codebase 检查现有 Livewire 组件;fuse-ai-pilot:research-expert 通过 Context7 验证 Livewire 4 模式;mcp__context7__query-docs 检查特定 Livewire 功能。实现完成后运行 fuse-ai-pilot:sniper 进行验证。

关键规则包括:循环中始终使用 wire:key;实时验证使用 wire:model.live.blur(Livewire 4.1+ 中单独的 .blur 仅同步客户端状态),而不是到处使用 .live;搜索输入使用 .debounce.300ms 防抖;敏感 ID 使用 #[Locked];破坏性操作中使用 authorize();内部逻辑使用 protected 方法。

最佳实践方面,推荐在 @foreach 循环中使用 wire:key、对搜索/筛选输入防抖、使用表单对象复用逻辑、用 Livewire::test() 测试、对 ID 使用 #[Locked]、对派生数据使用 #[Computed];不推荐在每个字段上使用 wire:model.live、在 render() 方法中查询、在操作中忘记授权、在循环中跳过 wire:key、在公共属性中存储敏感数据。

Laravel 13 与版本说明 资料说明 Livewire 4 是当前主版本(当前 4.4),被 L13 Livewire 起始套件使用。Livewire 4 要求 PHP 8.1+ / Laravel 10+(Laravel 13 本身要求 PHP 8.3)。#[Locked]、#[Computed]、#[On] 仍受支持。原生单文件/多文件组件(make_command.type 默认 sfc);Volt 保持在 1.x(当前 1.11),Folio 保持在 1.x(当前 1.2)。页面路由推荐使用 Route::livewire('/dashboard', Dashboard::class)(单文件/多文件组件必须使用)。端点使用基于 APP_KEY 派生的哈希路径 /livewire-{hash}/update,替代 /livewire/update,需要更新针对 /livewire/ 的防火墙、CDN 和中间件规则。wire:model.live 使用并行请求;wire:poll 为非阻塞。

从 Livewire 3 迁移 资料给出迁移步骤:执行 composer require livewire/livewire:^4.0,然后执行 php artisan optimize:clear。配置项重命名:layout → component_layout(layouts::app),lazy_placeholder → component_placeholder;smart_wire_keys 默认 true。4.1+ 中 .blur / .change 也控制客户端同步,若需旧行为(blur 时发起网络请求)应写 wire:model.live.blur。wire:model 会忽略来自子组件的事件(需要时加 .deep);<livewire:x /> 标签必须闭合。wire:transition 使用 View Transitions API(修饰符已移除);wire:scroll → wire:navigate:scroll。$this->stream() 的 to: 重命名为 el:;$wire.$js('name', fn) 已弃用,改为 $wire.$js.name = fn。wire:poll.5s、$this->dispatch('event')、表单对象(#[\Livewire\Attributes\Validate])保持不变。

限制与缺失 资料未提供该技能的收费、价格、平台支持范围、性能基准或具体效果数据;相关内容暂未提供。