安装
了解 Laravel
Laravel 是一个具有表达力、优雅语法的 Web 应用程序框架。Web 框架为创建应用程序提供了结构和起点，让你能够专注于创作出色的产品，而我们将处理繁琐的细节。
Laravel 致力于提供绝佳的开发体验，同时提供强大的功能，如全面的依赖注入、富有表达力的数据库抽象层、队列和定时任务、单元与集成测试等。
无论你是 PHP Web 框架的新手，还是拥有多年经验的开发者，Laravel 都是一个能与你共同成长的框架。我们将帮助你迈出 Web 开发的第一步，或在你提升专业技能时助你一臂之力。我们迫不及待想看到你构建的作品。
为什么选择 Laravel？
在构建 Web 应用程序时，你可以选择各种工具和框架。然而，我们相信 Laravel 是构建现代、全栈 Web 应用程序的最佳选择。
渐进式框架
我们喜欢称 Laravel 为“渐进式”框架。这意味着 Laravel 可以与你共同成长。如果你刚刚踏入 Web 开发领域，Laravel 丰富的文档、指南和 视频教程 将帮助你轻松入门，而不会感到不知所措。
如果你是一位资深开发者，Laravel 为你提供了强大的工具，用于 依赖注入、单元测试、队列、实时事件等。Laravel 经过精心调优，适合构建专业的 Web 应用程序，并能够胜任企业级负载。
可扩展的框架
Laravel 具有极佳的可扩展性。得益于 PHP 的可扩展性以及 Laravel 对 Redis 等快速分布式缓存系统的内置支持，使用 Laravel 进行横向扩展轻而易举。事实上，Laravel 应用程序已轻松扩展到每月处理数亿次请求。
需要极致扩展？像 Laravel Cloud 这样的平台让你能够以近乎无限的规模运行 Laravel 应用程序。
适配 AI 智能体的框架
Laravel 严谨的约定和定义明确的结构，使其成为使用 Cursor 和 Claude Code 等工具进行 AI 辅助开发 的理想框架。当你要求 AI 智能体添加控制器时，它确切地知道放在哪里。当你需要新的迁移时，命名约定和文件位置都是可预测的。这种一致性消除了在更灵活的框架中常让 AI 工具困惑的猜测。
除了文件组织，Laravel 富有表达力的语法和全面的文档，为 AI 智能体提供了生成准确、地道代码所需的上下文。Eloquent 关系、表单请求和中间件等功能遵循智能体可以可靠理解和复刻的模式。结果就是 AI 生成的代码看起来就像出自资深 Laravel 开发者之手，而不是从通用的 PHP 代码片段中拼凑出来的。
想了解更多关于为什么 Laravel 是 AI 辅助开发的完美选择，请查看我们关于 智能体开发 的文档。
社区驱动的框架
Laravel 整合了 PHP 生态系统中最好的包，提供了目前最强大且对开发者友好的框架。此外，全球成千上万的优秀开发者为 该框架做出了贡献。谁知道呢，也许你也会成为 Laravel 的贡献者。
创建 Laravel 应用程序
安装 PHP 和 Laravel 安装程序
在创建第一个 Laravel 应用程序之前，请确保你的本地机器已安装 PHP、Composer 和 Laravel 安装程序。此外，你应该安装 Node 和 NPM 或 Bun，以便编译应用程序的前端资源。
如果你本地没有安装 PHP 和 Composer，以下命令将在 macOS、Windows 或 Linux 上安装 PHP、Composer 和 Laravel 安装程序：
1/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"1# Run as administrator...2Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows/8.4'))1/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.4)"运行上述命令之一后，应重启终端会话。要在通过 php.new 安装后更新 PHP、Composer 和 Laravel 安装程序，你可以在终端中重新运行该命令。
如果你已经安装了 PHP 和 Composer，你可以通过 Composer 安装 Laravel 安装程序：
1composer global require laravel/installer想要获得功能齐全的图形化 PHP 安装与管理体验，请查看 Laravel Herd。
创建应用程序
安装好 PHP、Composer 和 Laravel 安装程序后，你就可以创建新的 Laravel 应用程序了。Laravel 安装程序会提示你选择首选的测试框架、数据库和入门套件。
1laravel new example-app应用程序创建完成后，你可以使用 dev Composer 脚本启动 Laravel 的本地开发服务器、队列工作进程和 Vite 开发服务器：
1cd example-app2npm install && npm run build3composer run dev启动开发服务器后，你可以在浏览器中访问 https://:8000。接下来，你可以 迈出进入 Laravel 生态系统的下一步。当然，你可能还想 配置数据库。
如果你想在开发 Laravel 应用程序时快人一步，请考虑使用我们的 入门套件。Laravel 的入门套件为你的新应用程序提供了后端和前端的身份验证脚手架。
初始配置
Laravel 框架的所有配置文件都存储在 config 目录中。每个选项都有文档说明，请随意浏览这些文件，熟悉可用的选项。
Laravel 开箱即用，几乎无需额外配置。你可以直接开始开发！不过，你可能希望查阅 config/app.php 文件及其文档。它包含了一些选项（如 url 和 locale），你可能需要根据应用程序进行调整。
基于环境的配置
由于 Laravel 的许多配置选项值可能取决于应用程序是在本地机器还是生产 Web 服务器上运行，因此许多重要的配置值是通过位于应用程序根目录的 .env 文件来定义的。
你的 .env 文件不应提交到版本控制系统中，因为每个开发者或服务器可能需要不同的环境配置。此外，如果入侵者获得对你代码仓库的访问权限，这也将构成安全风险，因为敏感凭据会暴露。
有关 .env 文件和基于环境的配置的更多信息，请查阅完整的 配置文档。
数据库与迁移
既然你已经创建了 Laravel 应用程序，你可能想要在数据库中存储一些数据。默认情况下，你的 .env 配置文件指定 Laravel 将使用 SQLite 数据库。
在创建应用程序期间，Laravel 已为你生成了 database/database.sqlite 文件，并运行了必要的迁移来创建应用程序的数据库表。
如果你倾向于使用 MySQL 或 PostgreSQL 等其他数据库驱动，你可以更新 .env 配置文件来使用相应的数据库。例如，如果你想使用 MySQL，请按如下方式更新 .env 配置文件中的 DB_* 变量：
1DB_CONNECTION=mysql2DB_HOST=127.0.0.13DB_PORT=33064DB_DATABASE=laravel5DB_USERNAME=root6DB_PASSWORD=如果你选择使用 SQLite 以外的数据库，则需要自行创建数据库并运行应用程序的 数据库迁移。
1php artisan migrate目录配置
Laravel 始终应该从 Web 服务器配置的“Web 目录”根路径运行。你不应尝试从“Web 目录”的子目录运行 Laravel 应用程序。这样做可能会暴露应用程序内部的敏感文件。
使用 Herd 安装
Laravel Herd 是一个专为 macOS 和 Windows 设计的极其快速、原生的 Laravel 和 PHP 开发环境。Herd 包含了 Laravel 开发所需的一切，包括 PHP 和 Nginx。
一旦安装了 Herd，你就可以开始 Laravel 开发了。Herd 包含了用于 php、composer、laravel、expose、node、npm 和 nvm 的命令行工具。
Herd Pro 为 Herd 增强了强大的功能，例如创建和管理本地 MySQL、Postgres 和 Redis 数据库的能力，以及本地邮件查看和日志监控。
macOS 上的 Herd
如果你在 macOS 上开发，可以从 Herd 官网 下载安装程序。安装程序会自动下载最新版本的 PHP，并将你的 Mac 配置为始终在后台运行 Nginx。
macOS 版 Herd 使用 dnsmasq 来支持“驻留”（parked）目录。任何位于驻留目录中的 Laravel 应用程序都会自动由 Herd 提供服务。默认情况下，Herd 会在 ~/Herd 创建一个驻留目录，你可以通过 .test 域名并在其后加上目录名来访问此目录中的任何 Laravel 应用程序。
安装 Herd 后，创建新 Laravel 应用程序最快的方法是使用随 Herd 捆绑的 Laravel CLI：
1cd ~/Herd2laravel new my-app3cd my-app4herd open当然，你也可以通过 Herd 的用户界面管理驻留目录和其他 PHP 设置，该界面可从系统托盘的 Herd 菜单中打开。
你可以查看 Herd 文档 来了解更多信息。
Windows 上的 Herd
你可以在 Herd 官网 下载 Windows 版安装程序。安装完成后，启动 Herd 以完成引导过程并首次访问 Herd UI。
通过左键点击系统托盘中的 Herd 图标即可访问 Herd UI。右键点击则会打开快捷菜单，方便使用日常所需的所有工具。
在安装过程中，Herd 会在你的用户主目录下创建一个名为 %USERPROFILE%\Herd 的“驻留”目录。该目录下的任何 Laravel 应用程序都会由 Herd 自动提供服务，你可以通过 .test 域名及目录名来访问。
安装 Herd 后，创建新 Laravel 应用程序最快的方法是使用随 Herd 捆绑的 Laravel CLI。若要开始使用，请打开 Powershell 并运行以下命令：
1cd ~\Herd2laravel new my-app3cd my-app4herd open你可以查看 Herd Windows 文档 以了解更多信息。
IDE 支持
在开发 Laravel 应用程序时，你可以自由选择任何代码编辑器。如果你正在寻找轻量级且可扩展的编辑器，VS Code 或 Cursor 结合官方的 Laravel VS Code 扩展 可以提供出色的支持，包括语法高亮、代码片段、Artisan 命令集成，以及针对 Eloquent 模型、路由、中间件、资源、配置和 Inertia.js 的智能补全。
若要获得全面且强大的 Laravel 支持，请看一看 JetBrains 的 IDE：PhpStorm。PhpStorm 对 Laravel 框架的内置支持包括 Blade 模板、Eloquent 模型/路由/视图/翻译/组件的智能补全，以及强大的代码生成和 Laravel 项目导航功能。
对于寻求基于云的开发体验的用户，Firebase Studio 提供了一种无需设置、直接在浏览器中构建 Laravel 应用的方式，让你能够从任何设备开始开发。
Laravel 与 AI
Laravel Boost 是一款强有力的工具，填补了 AI 编码智能体与 Laravel 应用程序之间的鸿沟。Boost 为 AI 智能体提供了 Laravel 专用的上下文、工具和指南，使它们能够生成更准确、符合特定版本及 Laravel 规范的代码。
在 Laravel 应用程序中安装 Boost 后，AI 智能体即可访问超过 15 种专业工具，包括识别所用包、查询数据库、搜索 Laravel 文档、读取浏览器日志、生成测试以及通过 Tinker 执行代码。
此外，Boost 还允许 AI 智能体访问超过 17,000 条向量化的 Laravel 生态系统文档，并针对你安装的包版本进行了定制。这意味着智能体能够提供针对你项目实际版本的具体指导。
Boost 还包含由 Laravel 官方维护的 AI 指南，帮助智能体遵循框架约定、编写适当的测试，并在生成 Laravel 代码时避免常见陷阱。
安装 Laravel Boost
Boost 可安装在运行 PHP 8.1 或更高版本的 Laravel 10、11、12 和 13 应用程序中。若要开始，请将 Boost 安装为开发依赖：
1composer require laravel/boost --dev安装完成后，运行交互式安装程序：
1php artisan boost:install安装程序将自动检测你的 IDE 和 AI 智能体，让你能够按需启用功能。Boost 尊重现有的项目约定，默认情况下不会强制使用主观的风格规则。
想了解更多关于 Boost 的信息，请访问 GitHub 上的 Laravel Boost 仓库。
添加自定义 AI 指南
要通过你自己的自定义 AI 指南来增强 Laravel Boost，请将 .blade.php 或 .md 文件添加到应用程序的 .ai/guidelines/* 目录中。运行 boost:install 时，这些文件将自动包含在 Laravel Boost 的指南中。
后续步骤
现在你已经创建了 Laravel 应用程序，你可能想知道接下来该学习什么。首先，我们强烈建议你阅读以下文档，以熟悉 Laravel 的工作原理：
你想要如何使用 Laravel 也将决定你后续的学习路径。Laravel 有多种使用方式，下面我们探讨该框架的两种主要应用场景。
Laravel 全栈框架
Laravel 可以作为全栈框架使用。所谓“全栈”框架，是指你将使用 Laravel 来路由请求，并通过 Blade 模板 或像 Inertia 这样的单页应用混合技术来渲染前端。这是使用 Laravel 框架最常见的方式，也是我们认为最高效的方式。
如果这就是你的计划，你可能想查看我们关于 前端开发、路由、视图 或 Eloquent ORM 的文档。此外，你可能还会对 Livewire 和 Inertia 等社区包感兴趣。这些包允许你在享受单页 JavaScript 应用带来的 UI 优势的同时，将 Laravel 作为全栈框架使用。
如果你正在将 Laravel 用作全栈框架，我们也强烈建议你学习如何使用 Vite 来编译应用程序的 CSS 和 JavaScript。
如果你想在构建应用程序时快人一步，请查看我们官方的 应用程序入门套件。
Laravel API 后端
Laravel 也可以作为 JavaScript 单页应用或移动应用的 API 后端。例如，你可能会将 Laravel 用作 Next.js 应用程序的 API 后端。在这种场景下，你可以使用 Laravel 提供 身份验证 以及数据存储/检索功能，同时利用 Laravel 强大的服务，如队列、邮件、通知等。
如果这是你的计划，你可能想查看我们关于 路由、Laravel Sanctum 和 Eloquent ORM 的文档。