用途
Laravel Specialist 为 Laravel 框架开发提供专家指导，基于现代 Laravel 11+ 特性、Livewire 3 和 PHP 8.3。它专注于构建可扩展的 Web 应用、API、实时功能，并借助 Octane 进行性能优化。
何时使用
- 构建新的 Laravel 应用或 API
- 实现 Livewire 3 响应式组件
- 使用 Octane 优化 Laravel 性能
- 设计 Eloquent 模型与关系
- 创建自定义 Artisan 命令
- 实现 Laravel 队列与任务
- 通过 Broadcasting 构建实时功能
- 配置 Laravel Sail 或部署
快速开始
在以下情况调用本技能：
- 开发 Laravel Web 应用或 API
- 使用 Livewire 3 构建响应式 UI
- 使用 Octane 或缓存优化性能
- 处理 Eloquent ORM 模式
- 实现 Laravel 生态包
以下情况不要调用：
- 无 Laravel 的通用 PHP → 使用 /php-pro
- WordPress 开发 → 使用 /wordpress-master
- 前端 JavaScript 框架 → 使用 /vue-expert 或 /react-specialist
- 独立于 Laravel 的数据库设计 → 使用 /database-administrator
决策框架
特性类型？ ├── 交互式 UI │ ├── 复杂 SPA → Inertia.js + Vue/React │ └── 响应式组件 → Livewire 3 ├── API │ ├── 简单 REST → Laravel API Resources │ └── 复杂 → Laravel + Sanctum/Passport ├── 后台处理 │ └── Laravel Queues 配合 Redis/SQS └── 实时 └── Laravel Echo + Pusher/Soketi
核心工作流
1. Laravel 11 应用搭建
- 使用 laravel new --using=sail 创建项目
- 配置环境与数据库
- 设置认证（Breeze/Jetstream）
- 通过迁移定义模型
- 实现路由与控制器
- 添加中间件与策略
2. Livewire 3 组件开发
- 创建 Livewire 组件类
- 定义公共属性与方法
- 使用 wire 指令构建 Blade 模板
- 实现验证与操作
- 使用 Alpine.js 进行客户端增强
- 使用 Livewire 测试工具进行测试
3. 性能优化
- 使用 Swoole/RoadRunner 启用 Octane
- 实现查询缓存与预加载
- 使用 Redis 处理会话与缓存
- 优化 Composer 自动加载器
- 配置 OPcache 设置
- 为异步任务设置队列工作进程
最佳实践
- 使用严格类型与 PHP 8.3 特性（readonly、enums）
- 预加载关系以避免 N+1 查询
- 使用表单请求进行验证
- 使用 Laravel Pint 保持代码风格一致
- 使用 Laravel 测试工具编写功能测试
- 利用 Laravel 内置安全特性
反模式
| 反模式 | 问题 | 正确做法 |
|---|---|---|
| 臃肿控制器 | 难以测试与维护 | 将逻辑移至 Actions/Services |
| N+1 查询 | 性能下降 | 使用 with() 预加载 |
| 到处写原生 SQL | 失去 Eloquent 优势 | 使用 Eloquent，必要时才用原生 |
| 忽略队列 | 用户响应变慢 | 将慢操作放入队列 |
| 无缓存 | 不必要的数据库负载 | 缓存开销大的查询 |