官方文档

AI 代理开发

AI 编程代理的兴起——Claude Code、OpenCode、Cursor、GitHub Copilot——改变了开发者写代码的方式。这些工具能生成整个功能、调试复杂问题、以空前的速度重构代码，但它们好不好用，很大程度上取决于它们有多懂你的代码库。Laravel 在 AI 辅助和代理式开发上是最好用的框架之一。

为什么 Laravel 适合 AI 开发

Laravel 一套强势的约定和清晰的结构，让它特别适合 AI 辅助开发。你让 AI 加个控制器（Controller），它知道往哪放；要加个迁移（Migration），命名和文件位置都是可预测的。这种一致性消掉了 AI 在更灵活框架里那种"猜"来"猜"去的麻烦。

除了文件组织，Laravel 表达力强的语法和详尽文档给 AI 足够的上下文去生成准确、地道的代码。Eloquent 关联、Form Request、中间件（Middleware）这些都有 AI 能稳定理解和复刻的模式。最终生成的代码像是一个老 Laravel 写的，不是东拼西凑的 PHP 片段。

Laravel Boost

Laravel Boost 是连接 AI 编程代理和你 Laravel 应用的桥梁。Boost 是一个 MCP（Model Context Protocol）服务器，带 15+ 个专门工具，让 AI 代理深入了解你应用的结构、数据库、路由等。装上 Boost，你的 AI 代理从一个通用代码助手变成一个懂你具体应用的 Laravel 专家。

术语：MCP

MCP（Model Context Protocol，模型上下文协议）是一个让 AI 代理能调用外部工具、读取外部数据的标准协议。Boost 就是一个 MCP 服务器——AI 代理（Cursor、Claude Code 等）通过 MCP 协议连到 Boost，Boost 再去读你应用的数据库、路由、配置等内部信息，把结果喂给 AI。这样 AI 不用"猜"你的应用结构，能拿到真实数据。

Boost 提供三大能力：一组用于检查和操作你应用的 MCP 工具、专门为 Laravel 生态写的可组合 AI 指南、以及一个包含 17000+ 条 Laravel 专属知识的文档 API。

安装

Boost 支持 Laravel 10、11、12、13，要求 PHP 8.1+。好消息：用 laravel new 建项目时，安装器默认就会装好并初始化 Boost（自动跑 composer require laravel/boost --dev 和 php artisan boost:install 两步），新项目里 Boost 已就位，不用再手动装。不想装就加 --no-boost 跳过。

只有老项目（Laravel 10–12）或建项目时加了 --no-boost 现在想补回来，才手动两步：

composer require laravel/boost --dev

php artisan boost:install

boost:install 会自动探测你的 IDE 和 AI 代理，让你选适合你项目的集成。Boost 会生成必要的配置文件，比如给 MCP 兼容编辑器的 .mcp.json、给 AI 上下文的指南文件。

信息

生成的配置文件（.mcp.json、CLAUDE.md、boost.json）可以安全地加进 .gitignore——如果你想让每个开发者各自配置自己的环境。

可用工具

Boost 通过 MCP 协议给 AI 代理暴露一整套工具，让代理深入了解并操作你的 Laravel 应用：

  • 应用自省——查询 PHP 和 Laravel 版本、列出已装的包、检查应用的配置和环境变量。
  • 数据库工具——检查数据库 schema、跑只读查询、不用离开对话就能理解数据结构。
  • 路由检查——列出所有已注册路由及其中间件、控制器、参数。
  • Artisan 命令——发现可用的 Artisan 命令及其参数，让代理能为你的任务建议并执行对的命令。
  • 日志分析——读并分析应用的日志文件，帮助调试。
  • 浏览器日志——用 Laravel 前端工具开发时，访问浏览器控制台日志和错误。
  • Tinker 集成——通过 Laravel Tinker 在你应用上下文里执行 PHP 代码，让代理测试假设、验证行为。
  • 文档搜索——搜索 Laravel 生态文档，结果按你装的包版本过滤。

AI 指南

Boost 自带一套专门为 Laravel 生态写的 AI 指南。这些指南教 AI 代理怎么写地道的 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 是轻量、定向的知识模块，代理在处理特定领域时可以按需激活。和指南（一开始就全加载）不同，技能让详细的模式和最佳实践只在相关时才加载，减少上下文膨胀，提高 AI 生成代码的相关性。

技能覆盖流行的 Laravel 包，如 Livewire、Inertia、Tailwind CSS、Pest 等。跑 boost:install 并把技能选为一项功能时，技能会根据你 composer.json 里探测到的包自动安装。

Boost 自带一个强大的文档 API，给 AI 代理访问 17000+ 条 Laravel 生态文档。和普通网页搜索不同，这些文档是索引化、向量化、按你装的包版本过滤的。

代理需要理解某个功能怎么用时，可以搜 Boost 的文档 API，拿到准确的、按版本的信息。这解决了 AI 代理建议旧框架版本里已废弃方法或语法的常见问题。