Laravel 中文文档

主题

全部文档

AI 辅助开发 ​

简介 ​

Laravel 在 AI 辅助与面向 Agent 的开发方面具备独特优势。Claude Code、OpenCode、Cursor 与 GitHub Copilot 等 AI 编程 agent 正在改变开发者写代码的方式。这些工具能以前所未有的速度生成完整功能、调试复杂问题并重构代码——但其效果高度取决于它们对你代码库的理解程度。

为什么用 Laravel 做 AI 开发？ ​

Laravel 明确的约定和清晰的结构，使它非常适合 AI 辅助开发。当你让 AI agent 新增控制器时，它清楚该放在哪里；需要新迁移时，命名与文件位置也是可预期的。这种一致性减少了 AI 在更松散框架中常遇到的猜测成本。

除了文件组织，Laravel 富有表现力的语法和全面的文档，也为 AI agent 提供了生成准确、地道代码所需的上下文。Eloquent 关联、表单请求、中间件等特性都遵循 agent 能够稳定理解并复现的模式。最终生成的代码更像资深 Laravel 开发者所写，而不是拼凑的通用 PHP 片段。

Laravel Boost ​

Laravel Boost 弥合了 AI 编程 agent 与 Laravel 应用之间的鸿沟。Boost 是一个 MCP（Model Context Protocol）服务器，配备超过 15 个专用工具，让 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 上下文的指南文件。

INFO

若希望每位开发者自行配置环境，可将 .mcp.json、CLAUDE.md、boost.json 等生成配置安全地加入 .gitignore。

可用工具 ​

Boost 通过 Model Context Protocol 向 AI agent 暴露一套完整工具。这些工具让 agent 能深入理解并与你的 Laravel 应用交互：

  • Application Introspection - 查询 PHP 与 Laravel 版本、列出已安装包，并检查应用配置与环境变量。
  • Database Tools - 检查数据库结构、执行只读查询，并在不离开对话的情况下了解数据结构。
  • Route Inspection - 列出所有已注册路由及其中间件、控制器与参数。
  • Artisan Commands - 发现可用的 Artisan 命令及其参数，帮助 agent 为任务建议并执行合适的命令。
  • Log Analysis - 读取并分析应用日志文件以协助调试。
  • Browser Logs - 在使用 Laravel 前端工具开发时访问浏览器控制台日志与错误。
  • Tinker Integration - 通过 Laravel Tinker 在应用上下文中执行 PHP 代码，让 agent 验证假设与行为。
  • Documentation Search - 搜索 Laravel 生态文档，结果会针对你已安装的包版本进行定制。

AI 指南 ​

Boost 包含专为 Laravel 生态打造的一整套 AI 指南。这些指南教导 AI agent 如何编写地道的 Laravel 代码、遵循框架约定并避免常见陷阱。指南可组合且感知版本，因此 agent 会收到与你确切包版本相匹配的说明。

指南覆盖 Laravel 本身以及生态中超过 16 个包，包括：

  • Livewire (2.x, 3.x, and 4.x)
  • Inertia.js (React, Svelte, and Vue variants)
  • Tailwind CSS (3.x and 4.x)
  • Filament (3.x and 4.x)
  • PHPUnit
  • Pest PHP
  • Laravel Pint
  • 以及更多

当你运行 boost:install 时，Boost 会自动检测应用使用的包，并将相关指南组装进项目的 AI 上下文文件。

Agent Skills ​

Agent Skills 是轻量、定向的知识模块，agent 可在处理特定领域时按需激活。与预先加载的指南不同，skills 仅在相关时加载详细模式与最佳实践，从而减少上下文膨胀并提高 AI 生成代码的相关性。

Skills 适用于 Livewire、Inertia、Tailwind CSS、Pest 等流行 Laravel 包。当你运行 boost:install 并选择 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 文档中的 设置你的 Agents 部分。