Laravel 中文文档

主题

AI 辅助开发 ​

简介 ​

Laravel 在 AI 辅助和 Agentic 开发方面具有独特的优势，是最佳框架之选。Claude Code、OpenCode、Cursor 和 GitHub Copilot 等 AI 编码 agent 的兴起已经改变了开发者编写代码的方式。这些工具可以生成完整的功能、调试复杂问题并以前所未有的速度重构代码——但它们的有效性在很大程度上取决于它们对你的代码库的理解程度。

为什么选择 Laravel 进行 AI 开发？ ​

Laravel 的约定式规范和良好定义的结构使其成为 AI 辅助开发的理想框架。当你要求 AI agent 添加一个 controller 时，它确切地知道应该放在哪里。当你需要新的 migration 时，命名约定和文件位置是可预测的。这种一致性消除了在更灵活的框架中经常困扰 AI 工具的猜测工作。

除了文件组织之外，Laravel 富有表现力的语法和全面的文档为 AI agent 提供了生成准确、地道代码所需的上下文。Eloquent 关联关系、表单请求和 middleware 等功能遵循 agent 可以可靠理解和复制的模式。最终结果是 AI 生成的代码看起来像是由经验丰富的 Laravel 开发者编写的，而不是从通用 PHP 代码片段拼凑而成。

Laravel Boost ​

Laravel Boost 弥合了 AI 编码 agent 与你的 Laravel 应用之间的差距。Boost 是一个配备了超过 15 个专业工具的 MCP（Model Context Protocol）服务器，为 AI agent 提供对你的应用结构、数据库、路由等的深入洞察。当你安装 Boost 后，你的 AI agent 将从通用代码助手转变为理解你特定应用的 Laravel 专家。

Boost 提供三大核心功能：一套用于检查和与应用交互的 MCP 工具、专为 Laravel 生态系统精心设计的可组合 AI 指南，以及包含超过 17,000 条 Laravel 特定知识的强大文档 API。

安装 ​

Boost 可以安装在运行 PHP 8.1 或更高版本的 Laravel 10、11 和 12 应用中。首先，将 Boost 作为开发依赖安装：

shell
composer require laravel/boost --dev

安装完成后，运行交互式安装程序：

shell
php artisan boost:install

安装程序将自动检测你的 IDE 和 AI agent，让你选择适合项目的集成。Boost 将生成必要的配置文件，例如用于 MCP 兼容编辑器的 .mcp.json 和用于 AI 上下文的指南文件。

NOTE

生成的配置文件（如 .mcp.json、CLAUDE.md 和 boost.json）可以安全地添加到 .gitignore 中，如果你希望每个开发者配置自己的环境。

可用工具 ​

Boost 通过 Model Context Protocol 向 AI agent 公开了一套全面的工具。这些工具允许 agent 深入理解并与你的 Laravel 应用交互：

  • 应用内省 - 查询你的 PHP 和 Laravel 版本，列出已安装的包，检查应用的配置和环境变量。
  • 数据库工具 - 检查数据库结构，执行只读查询，在对话中直接了解你的数据结构。
  • 路由检查 - 列出所有已注册的路由及其 middleware、controller 和参数。
  • Artisan 命令 - 发现可用的 Artisan 命令及其参数，使 agent 能够为你的任务建议和执行正确的命令。
  • 日志分析 - 读取和分析应用的日志文件以帮助调试问题。
  • 浏览器日志 - 在使用 Laravel 前端工具进行开发时访问浏览器控制台日志和错误。
  • Tinker 集成 - 通过 Laravel Tinker 在应用上下文中执行 PHP 代码，允许 agent 测试假设并验证行为。
  • 文档搜索 - 搜索 Laravel 生态系统文档，结果针对你安装的包版本进行定制。

AI 指南 ​

Boost 包含一套专为 Laravel 生态系统精心设计的全面 AI 指南。这些指南教导 AI agent 如何编写地道的 Laravel 代码、遵循框架约定并避免常见陷阱。指南是可组合且版本感知的，这意味着 agent 会收到适合你确切包版本的指令。

指南适用于 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 是轻量级、有针对性的知识模块，agent 可以在处理特定领域时按需激活。与预先加载的指南不同，skills 允许仅在相关时才加载详细的模式和最佳实践，从而减少上下文膨胀并提高 AI 生成代码的相关性。

Skills 适用于流行的 Laravel 包，如 Livewire、Inertia、Tailwind CSS、Pest 等。当你运行 boost:install 并选择 skills 作为功能时，skills 会根据 composer.json 中检测到的包自动安装。

Boost 包含一个强大的文档 API，为 AI agent 提供对超过 17,000 条 Laravel 生态系统文档的访问。与通用的网络搜索不同，此文档经过索引、向量化并进行过滤，以匹配你确切的包版本。

当 agent 需要理解某个功能的工作原理时，它可以搜索 Boost 的文档 API 并获取准确的、特定版本的信息。这消除了 AI agent 建议使用旧框架版本中已弃用方法或语法的常见问题。

Agent 集成 ​

Boost 与支持 Model Context Protocol 的流行 IDE 和 AI 工具集成。有关 Cursor、Claude Code、Codex、Gemini CLI、GitHub Copilot 和 Junie 的详细设置说明，请参阅 Boost 文档的 Set Up Your Agents 部分。