AI 辅助开发
简介
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 应用程序中。要开始使用，请将 Boost 作为开发依赖项安装：
composer require laravel/boost --dev安装完成后，运行交互式安装程序：
php artisan boost:install安装程序将自动检测您的 IDE 和 AI 智能体，允许您选择适合项目的集成方案。Boost 将生成必要的配置文件，例如用于 MCP 兼容编辑器的 .mcp.json 以及用于 AI 上下文的指南文件。
NOTE
如果您希望每位开发者自行配置他们的环境，那么像 .mcp.json、CLAUDE.md 和 boost.json 这样的生成配置文件可以安全地添加到您的 .gitignore 中。
可用工具
Boost 通过模型上下文协议向 AI 智能体提供了一套全面的工具。这些工具使智能体能够深入理解和与您的 Laravel 应用程序交互：
- 应用内省 - 查询您的 PHP 和 Laravel 版本，列出已安装的包，并检查应用程序的配置和环境变量。
- 数据库工具 - 检查数据库模式，执行只读查询，并在不离开对话的情况下了解您的数据结构。
- 路由检查 - 列出所有已注册的路由及其对应的中间件、控制器和参数。
- Artisan 命令 - 发现可用的 Artisan 命令及其参数，使智能体能够为您的任务建议和执行正确的命令。
- 日志分析 - 读取和分析应用程序的日志文件以帮助调试问题。
- 浏览器日志 - 在使用 Laravel 前端工具开发时访问浏览器控制台日志和错误信息。
- Tinker 集成 - 通过 Laravel Tinker 在您的应用程序上下文中执行 PHP 代码，允许智能体测试假设并验证行为。
- 文档搜索 - 搜索 Laravel 生态系统文档，结果会根据您已安装的包版本进行定制。
AI 指南
Boost 包含一套专门为 Laravel 生态系统精心设计的全面 AI 指南。这些指南教导 AI 智能体如何编写地道的 Laravel 代码、遵循框架惯例并避免常见陷阱。指南是可组合且具备版本感知的，这意味着智能体收到的指令适用于您确切的包版本。
指南适用于 Laravel 本身以及 Laravel 生态系统中的 16 个以上包，包括：
- Livewire (2.x, 3.x 和 4.x)
- Inertia.js (React 和 Vue 变体)
- Tailwind CSS (3.x 和 4.x)
- Filament (3.x 和 4.x)
- PHPUnit
- Pest PHP
- Laravel Pint
- 以及更多
当您运行 boost:install 时，Boost 会自动检测您的应用程序使用了哪些包，并将相关指南汇编到您项目的 AI 上下文文件中。
文档搜索
Boost 包含一个强大的文档 API，使 AI 智能体能够访问超过 17,000 条 Laravel 生态系统文档。与通用的网络搜索不同，这些文档经过索引、向量化处理，并经过过滤以匹配您确切的包版本。
当智能体需要了解某个功能的工作原理时，它可以搜索 Boost 的文档 API 并获取准确的、特定版本的信息。这解决了 AI 智能体建议使用旧框架版本中已弃用的方法或语法的常见问题。
IDE 集成
Boost 集成了支持模型上下文协议的流行 IDE 和 AI 工具。以下是在几个流行编辑器中启用 Boost 的方法：
// torchlight! {"lineNumbers": false}
Boost 通常会被自动检测到。如果需要手动设置：
1. 在您的项目目录中打开终端
2. 运行：claude mcp add laravel-boost -- php artisan boost:mcp// torchlight! {"lineNumbers": false}
1. 打开命令面板 (Cmd+Shift+P 或 Ctrl+Shift+P)
2. 选择 "MCP: Open Settings"
3. 切换打开 "laravel-boost" 选项// torchlight! {"lineNumbers": false}
1. 打开命令面板 (Cmd+Shift+P 或 Ctrl+Shift+P)
2. 选择 "MCP: List Servers"
3. 导航至 "laravel-boost" 并按回车键
4. 选择 "Start server"// torchlight! {"lineNumbers": false}
1. 按两次 Shift 键打开 Search Everywhere
2. 搜索 "MCP Settings" 并按回车键
3. 启用 "laravel-boost" 旁边的复选框
4. 点击 "Apply"// torchlight! {"lineNumbers": false}
Boost 通常会被自动检测到。如果需要手动设置：
1. 在您的项目目录中打开终端
2. 运行：codex mcp add -- php artisan boost:mcp// torchlight! {"lineNumbers": false}
Boost 通常会被自动检测到。如果需要手动设置：
1. 在您的项目目录中打开终端
2. 运行：gemini mcp add laravel-boost -- php artisan boost:mcp自定义 Boost 指南
虽然 Boost 的内置指南全面涵盖了 Laravel 生态系统，但您可能希望为 AI 智能体添加项目特定的说明。
添加项目指南
要为您的项目添加自定义指南，请在应用程序的 .ai/guidelines 目录中创建 .blade.php 或 .md 文件：
.ai/
└── guidelines/
└── api-conventions.md
├── architecture.md
├── testing-standards.blade.php这些文件将在您运行 boost:install 时自动包含。使用这些指南来记录您团队的编码标准、架构决策、特定领域术语或任何其他有助于 AI 智能体为您的项目编写更好代码的上下文。
包指南
如果您维护一个 Laravel 包并希望为您的用户提供 AI 指南，您可以在包的 resources/boost/guidelines 目录中包含指南：
resources/
└── boost/
└── guidelines/
└── core.blade.phpAI 指南应简要概述您的包的功能，列出任何必需的文件结构或约定，并解释如何创建或使用其主要功能（附带示例命令或代码片段）。保持指南简洁、可操作且专注于最佳实践，以便 AI 能为您的用户生成正确的代码。以下是一个示例：
## 包名称
这个包提供了[功能的简要描述]。
### 功能
- 功能 1：[清晰简短的描述]。
- 功能 2：[清晰简短的描述]。示例用法：
@verbatim
<code-snippet name="如何使用功能 2" lang="php">
$result = PackageName::featureTwo($param1, $param2);
</code-snippet>
@endverbatim当用户在包含您的包的应用程序中安装 Boost 时，您的指南将被自动发现并包含在他们的 AI 上下文中。这使得包作者能够帮助 AI 智能体理解如何正确使用他们的包。