简体中文
安装
认识 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 应用。
原生支持智能体的框架
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 安装器：
shell
/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"shell
# 以管理员身份运行...
Set-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'))shell
/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.4)"运行上述命令后，您应重新启动终端会话。要在通过 php.new 安装后更新 PHP、Composer 和 Laravel 安装器，可以在终端中重新运行该命令。
如果您已经安装了 PHP 和 Composer，可以通过 Composer 安装 Laravel 安装器：
shell
composer global require laravel/installer注意
欲获得完整功能的图形化 PHP 安装和管理体验，请查看 Laravel Herd。
创建应用
在安装 PHP、Composer 和 Laravel 安装器后，您就可以创建一个新的 Laravel 应用了。Laravel 安装器将提示您选择首选的测试框架、数据库和入门套件：
shell
laravel new example-app应用创建完成后，您可以使用 dev Composer 脚本启动 Laravel 的本地开发服务器、队列工作程序和 Vite 开发服务器：
shell
cd example-app
npm install && npm run build
composer run dev启动开发服务器后，您的应用将在浏览器中通过 http://localhost:8000 访问。接下来，您可以开始进入 Laravel 生态系统的下一步。当然，您可能还想配置数据库。
注意
如果您希望在开发 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_* 变量，如下所示：
ini
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=如果您选择使用 SQLite 以外的数据库，则需要创建数据库并运行应用的数据库迁移：
shell
php artisan migrate目录配置
Laravel 应始终从 Web 服务器配置的“Web 目录”根目录提供服务。您不应尝试从“Web 目录”的子目录提供 Laravel 应用服务。尝试这样做可能会暴露应用中存在的敏感文件。
使用 Herd 安装
Laravel Herd 是一个快速的原生 Laravel 和 PHP 开发环境，适用于 macOS 和 Windows。Herd 包含了开始 Laravel 开发所需的一切，包括 PHP 和 Nginx。
安装 Herd 后，您就可以开始使用 Laravel 进行开发。Herd 包含 php、composer、laravel、expose、node、npm 和 nvm 的命令行工具。
注意
Herd Pro 增强了 Herd，提供了额外的强大功能，如创建和管理本地 MySQL、Postgres 和 Redis 数据库的能力，以及本地邮件查看和日志监控。
macOS 上的 Herd
如果您在 macOS 上开发，可以从 Herd 网站 下载 Herd 安装程序。安装程序会自动下载最新版本的 PHP，并配置您的 Mac 始终在后台运行 Nginx。
macOS 上的 Herd 使用 dnsmasq 支持“停放”目录。Herd 会自动为停放目录中的任何 Laravel 应用提供服务。默认情况下，Herd 在 ~/Herd 创建一个停放目录，您可以使用其目录名称在 .test 域上访问该目录中的任何 Laravel 应用。
安装 Herd 后，创建新 Laravel 应用的最快方法是使用 Herd 捆绑的 Laravel CLI：
shell
cd ~/Herd
laravel new my-app
cd my-app
herd open当然，您始终可以通过 Herd 的 UI 管理停放目录和其他 PHP 设置，可以从系统托盘中的 Herd 菜单打开。
您可以通过查看 Herd 文档 了解有关 Herd 的更多信息。
Windows 上的 Herd
您可以从 Herd 网站 下载 Windows 版 Herd 安装程序。安装完成后，您可以启动 Herd 完成入门过程，并首次访问 Herd UI。
通过左键单击 Herd 的系统托盘图标可以访问 Herd UI。右键单击打开快速菜单，提供您日常所需的所有工具。
安装期间，Herd 在您的主目录中创建了一个“停放”目录，位于 %USERPROFILE%\Herd。Herd 会自动为停放目录中的任何 Laravel 应用提供服务，您可以使用其目录名称在 .test 域上访问该目录中的任何 Laravel 应用。
安装 Herd 后，创建新 Laravel 应用的最快方法是使用 Herd 捆绑的 Laravel CLI。要开始，请打开 Powershell 并运行以下命令：
shell
cd ~\Herd
laravel new my-app
cd my-app
herd open您可以通过查看 Windows 版 Herd 文档 了解有关 Herd 的更多信息。
IDE 支持
在开发 Laravel 应用时，你可以自由选择任何代码编辑器。如果你在寻找轻量且可扩展的编辑器，VS Code 或 Cursor 搭配官方的 Laravel VS Code 扩展 能为 Laravel 提供出色的支持，包括语法高亮、代码片段、Artisan 命令集成，以及对 Eloquent 模型、路由、中间件、资源、配置和 Inertia.js 的智能自动补全等功能。
要获得对Laravel全面且强大的支持，请关注JetBrains IDE——PhpStorm。PhpStorm内置的Laravel框架支持涵盖Blade模板、对Eloquent模型/路由/视图/翻译和组件的智能自动补全，同时还提供强大的代码生成功能以及跨Laravel项目的便捷导航。
对于希望获得云端开发体验的用户，Firebase Studio 可让你直接在浏览器中即时使用 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 应用中。首先，将 Boost 作为开发依赖进行安装：
shell
composer require laravel/boost --dev安装完成后，运行交互式安装程序：
shell
php artisan boost:install安装程序会自动检测您的 IDE 和 AI 代理，允许您选择适合项目的功能。Boost 尊重现有的项目约定，默认不会强制推行带有主观偏好的样式规则。
注意
如需了解更多有关 Boost 的信息，请查看 GitHub 上的 Laravel Boost 仓库。
添加自定义AI指南
若需为 Laravel Boost 添加您自定义的 AI 指南，请将 .blade.php 或 .md 文件添加到您应用程序的 .ai/guidelines/* 目录中。当您运行 boost:install 命令时，这些文件将自动包含在 Laravel Boost 的指南中。
下一步
现在您已经创建了 Laravel 应用，您可能想知道接下来要学习什么。首先，我们强烈建议您通过阅读以下文档来熟悉 Laravel 的工作原理：
您希望如何使用 Laravel 也将决定您旅程的下一步。使用 Laravel 有多种方式，我们将在下面探索框架的两种主要用例。
Laravel 全栈框架
Laravel 可以作为全栈框架使用。我们所说的“全栈”框架是指您将使用 Laravel 路由请求到您的应用，并通过 Blade 模板 或单页应用混合技术如 Inertia 渲染前端。这是使用 Laravel 框架的最常见方式，并且在我们看来，也是使用 Laravel 的最具生产力的方式。
如果这是您计划使用 Laravel 的方式，您可能想查看我们的前端开发、路由、视图或 Eloquent ORM 文档。此外，您可能会对社区包如 Livewire 和 Inertia 感兴趣。这些包允许您在享受单页 JavaScript 应用提供的许多 UI 优势的同时，将 Laravel 用作全栈框架。
如果您将 Laravel 用作全栈框架，我们还强烈建议您学习如何使用 Vite 编译应用的 CSS 和 JavaScript。
注意
如果您想在构建应用时抢占先机，请查看我们的官方应用入门套件之一。
Laravel API 后端
Laravel 也可以作为 JavaScript 单页应用或移动应用的 API 后端。例如，您可以将 Laravel 用作 Next.js 应用的 API 后端。在这种情况下，您可以使用 Laravel 为应用提供认证和数据存储/检索，同时利用 Laravel 的强大服务，如队列、电子邮件、通知等。
如果这是您计划使用 Laravel 的方式，您可能想查看我们的路由、Laravel Sanctum 和 Eloquent ORM 文档。