简介
Laravel 具有独特的定位,是进行 AI 辅助开发和智能体开发的首选框架。Claude Code、OpenCode、Cursor 和 GitHub Copilot 等 AI 编码智能体的兴起,改变了开发人员编写代码的方式。这些工具能够以空前的速度生成完整功能、调试复杂问题并重构代码——但它们的有效性在很大程度上取决于它们对你代码库的理解程度。
为何选择 Laravel 进行 AI 开发?
Laravel 固有的约定和定义明确的结构使其成为 AI 辅助开发的理想框架。当你要求 AI 智能体添加一个控制器时,它确切地知道该将其放在哪里。当你需要新的迁移文件时,命名约定和文件位置都是可预测的。这种一致性消除了在更灵活的框架中经常困扰 AI 工具的猜测过程。
除了文件组织,Laravel 富有表达力的语法和全面的文档,为 AI 智能体提供了生成准确、地道代码所需的上下文。Eloquent 关系、表单请求和中间件等功能遵循智能体可以可靠理解和复刻的模式。结果就是 AI 生成的代码看起来就像出自资深 Laravel 开发者之手,而不是从通用的 PHP 代码片段中拼凑出来的。
Laravel Boost
Laravel Boost 架起了 AI 编码智能体与 Laravel 应用程序之间的桥梁。Boost 是一个 MCP (模型上下文协议) 服务器,配备了 15 种以上的专用工具,为 AI 智能体提供关于应用程序结构、数据库、路由等的深度见解。当你安装 Boost 后,你的 AI 智能体将从通用的代码助手转变为能够理解你特定应用的 Laravel 专家。
Boost 提供了三大核心能力:一套用于检查和交互应用程序的 MCP 工具、专为 Laravel 生态系统精心设计的可组合 AI 指南,以及一个包含超过 17,000 条 Laravel 特定知识的强大文档 API。
安装
Boost 可安装在运行 PHP 8.1 或更高版本的 Laravel 10、11、12 和 13 应用程序中。若要开始,请将 Boost 安装为开发依赖:
composer require laravel/boost --dev安装完成后,运行交互式安装程序:
php artisan boost:install安装程序将自动检测你的 IDE 和 AI 智能体,允许你选择适合项目的集成。Boost 将生成必要的配置文件,例如用于 MCP 兼容编辑器的 .mcp.json 文件以及用于 AI 上下文的指南文件。
生成的配置文件(如.mcp.json、CLAUDE.md和boost.json)可以安全地添加到你的.gitignore中,如果你希望每位开发者配置自己的环境的话。
可用工具
Boost 通过模型上下文协议(Model Context Protocol)向 AI 智能体公开了一套全面的工具。这些工具允许智能体深入理解并与你的 Laravel 应用程序进行交互。
- 应用程序自省 – 查询你的 PHP 和 Laravel 版本,列出已安装的包,并检查应用程序的配置和环境变量。
- 数据库工具 – 在无需退出对话的情况下,检查数据库模式、执行只读查询并了解数据结构。
- 路由检查 – 列出所有已注册的路由及其对应的中间件、控制器和参数。
- Artisan 命令 – 发现可用的 Artisan 命令及其参数,使智能体能够针对你的任务建议并执行正确的命令。
- 日志分析 – 读取并分析应用程序的日志文件,以协助调试问题。
- 浏览器日志 – 在使用 Laravel 前端工具进行开发时,访问浏览器控制台日志和错误信息。
- Tinker 集成 – 通过 Laravel Tinker 在应用程序上下文中执行 PHP 代码,允许智能体验证假设并确认行为。
- 文档搜索 – 搜索 Laravel 生态系统文档,并获得根据你所安装的包版本量身定制的结果。
AI 指南(AI Guidelines)
Boost 包含一套专门为 Laravel 生态系统精心制作的全面 AI 指南。这些指南教导 AI 智能体如何编写符合习惯的 Laravel 代码、遵循框架约定并避免常见陷阱。指南是可组合且具备版本感知能力的,这意味着智能体接收到的指令将完全适配你所使用的确切包版本。
指南涵盖了 Laravel 本身以及 Laravel 生态系统中的 16 个以上的包,包括:
- Livewire (2.x, 3.x, 和 4.x)
- Inertia.js (React, Svelte, 和 Vue 变体)
- Tailwind CSS (3.x 和 4.x)
- Filament (3.x 和 4.x)
- PHPUnit
- Pest PHP
- Laravel Pint
- 以及更多
当你运行 boost:install 时,Boost 会自动检测你的应用程序使用了哪些包,并将相关的指南整合到项目的 AI 上下文文件中。
智能体技能(Agent Skills)
智能体技能 (Agent Skills) 是轻量级、针对性的知识模块,智能体可以在处理特定领域时按需激活。与预先加载的指南不同,技能允许仅在相关时加载详细的模式和最佳实践,从而减少上下文冗余并提高 AI 生成代码的相关性。
这些技能适用于 Livewire、Inertia、Tailwind CSS、Pest 等主流 Laravel 包。当你运行 boost:install 并选择技能作为功能时,系统会根据在 composer.json 中检测到的包自动安装相应的技能。
文档搜索
Boost 包含一个强大的文档 API,使 AI 智能体能够访问超过 17,000 条 Laravel 生态系统文档。与通用的网络搜索不同,这些文档经过索引、向量化并根据你使用的特定包版本进行了筛选。
当智能体需要理解某个功能的工作原理时,它可以搜索 Boost 的文档 API 并获得准确的、特定于版本的相关信息。这消除了 AI 智能体建议已弃用的方法或旧版本框架语法的常见问题。
智能体集成
Boost 与支持模型上下文协议的流行 IDE 和 AI 工具集成。有关 Cursor、Claude Code、Codex、Gemini CLI、GitHub Copilot 和 Junie 的详细设置说明,请参阅 Boost 文档的 设置你的智能体 (Set Up Your Agents) 部分。
