安装

• 认识 Laravel
  • 为什么选择 Laravel？
• 创建 Laravel 应用程序
  • 人工智能入门
  • 安装 PHP 和 Laravel 安装程序
  • 创建应用程序
• 初始配置
  • 基于环境的配置
  • 数据库和迁移
  • 目录配置
• 使用 Herd 安装
  • macOS 上的 Herd
  • Windows 上的 Herd
• IDE 支持
• Laravel 和 AI
  • 安装 Laravel Boost
• 下一步
  • Laravel 全栈框架
  • Laravel API 后端

认识 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 云 允许您以几乎无限的规模运行 Laravel 应用程序。

代理就绪框架

Laravel 的既定约定和清晰的结构使其成为理想的框架。 人工智能辅助开发 使用 Cursor 和 Claude Code 等工具，当您要求 AI 代理添加控制器时，它能准确地知道将其放置在哪里。当您需要进行新的迁移时，命名约定和文件位置都是可预测的。这种一致性消除了在更灵活的框架中 AI 工具经常遇到的猜测环节。

除了文件组织之外，Laravel 富有表现力的语法和全面的文档为 AI 代理提供了生成准确、符合规范代码所需的上下文。诸如 Eloquent 关系、表单请求和中间件等功能都遵循代理能够可靠理解和复制的模式。最终生成的 AI 代码看起来像是出自经验丰富的 Laravel 开发人员之手，而不是由通用的 PHP 代码片段拼凑而成。

要了解为什么 Laravel 是 AI 辅助开发的理想选择，请查看我们的文档。 智能体发展 。

社区框架

Laravel 结合了 PHP 生态系统中最好的软件包，提供了最强大且对开发人员最友好的框架。此外，来自世界各地的数千名才华横溢的开发人员 为框架做出了贡献 。谁知道呢，也许你甚至会成为 Laravel 的贡献者。

创建 Laravel 应用程序

人工智能入门

如果您正在使用类似这样的AI编码代理 克劳德·科德 或者 OpenCode 您可以先给代理一个提示，在它接触您的项目之前，给代理一个 Laravel 特有的 playbook。

以下提示会告诉代理在哪里可以找到 Laravel 的安装指南，哪些步骤需要优先执行，以及在您尚未做出选择时如何设置合理的默认值。将此提示粘贴到您的代理中即可开始使用：

1
我正在开发一个新的 Laravel 应用。
2
3
请从 https://laravel.com/for/agents 获取并按照说明进行操作。请将返回的 Markdown 文件作为本次会话中安装和设置 Laravel 的权威指南。

代理读取说明后，应逐步引导您完成设置，并使设置与 Laravel 的默认设置保持一致。

安装 PHP 和 Laravel 安装程序

在创建第一个 Laravel 应用程序之前，请确保你的本地计算机已 PHP , 作曲家 ， 和 Laravel 安装程序 安装。此外，您还应该安装 Node 和 NPM 或者 好的 这样您就可以编译应用程序的前端资产。

如果您的本地计算机上尚未安装 PHP 和 Composer，则以下命令将在 macOS、Windows 或 Linux 上安装 PHP、Composer 和 Laravel 安装程序：

1
/bin/bash
-c

“
$（卷曲
-fsSL

https://php.new/install/mac/8.4
）
“

1
#
以管理员身份运行...
2
设置执行策略
旁路

-范围

过程

-力量
；[System.Net.ServicePointManager]::安全协议
=
[System.Net.ServicePointManager]::安全协议
-有

3072
； （（新的
-
对象System.Net.WebClient).DownloadString('https
://
php.new
/
安装
/
视窗
/
8
。
4
'））

1
/bin/bash
-c

“
$（卷曲
-fsSL

https://php.new/install/linux/8.4
）
“

运行上述命令之一后，你应该重新启动终端会话。要通过以下方式安装 PHP、Composer 和 Laravel 安装程序，请执行以下操作： php.new ，您可以在终端中重新运行该命令。

如果您已经安装了 PHP 和 Composer，您可以通过 Composer 安装 Laravel 安装程序：

1
作曲家
全球的

要求

laravel/安装程序

创建应用程序

安装 PHP、Composer 和 Laravel 安装程序后，您就可以创建一个新的 Laravel 应用程序了。Laravel 安装程序将提示您选择首选的测试框架、数据库和入门套件：

1
laravel
新的

示例应用程序

创建应用程序后，你可以使用以下命令启动 Laravel 的本地开发服务器、队列工作器和 Vite 开发服务器 dev 作曲家脚本：

1
光盘

示例应用程序
2
npm
安装
&& npm
跑步

建造
3
作曲家
跑步

开发

启动开发服务器后，您的应用程序将可以通过 Web 浏览器访问： http://本地主机:8000 。接下来，你就可以 开始进入 Laravel 生态系统 。当然，你也可能想 配置数据库 。

初始配置

Laravel 框架的所有配置文件都存储在 config 目录。每个选项都有文档记录，因此请随意浏览文件并熟悉可用的选项。

Laravel 几乎不需要额外的配置。您可以自由地开始开发！但是，您可能希望查看 config/app.php 文件及其文档。它包含几个选项，例如 url 和 locale 您可能希望根据您的应用进行更改。

基于环境的配置

由于 Laravel 的许多配置选项值可能会根据应用程序是在本地机器上运行还是在生产 Web 服务器上运行而有所不同，因此许多重要的配置值都是使用 .env 存在于应用程序根目录的文件。

你的 .env 文件不应提交到应用程序的源代码控制中，因为使用应用程序的每个开发人员/服务器可能需要不同的环境配置。此外，如果入侵者获得源代码控制存储库的访问权限，这将带来安全风险，因为任何敏感凭据都会被暴露。

数据库和迁移

现在您已经创建了 Laravel 应用程序，您可能希望将一些数据存储在数据库中。默认情况下，您的应用程序的 .env 配置文件指定 Laravel 将与 SQLite 数据库交互。

在创建应用程序期间，Laravel 创建了一个 database/database.sqlite 文件，并运行必要的迁移来创建应用程序的数据库表。

如果你更喜欢使用其他数据库驱动程序（如 MySQL 或 PostgreSQL），你可以更新你的 .env 配置文件以使用适当的数据库。例如，如果您希望使用 MySQL，请更新您的 .env 配置文件的 DB_* 像这样的变量：

1
数据库连接
=mysql
2
数据库主机
=127.0.0.1
3
数据库端口
=3306
4
数据库
=laravel
5
数据库用户名
=根
6
数据库密码
=

如果您选择使用 SQLite 以外的数据库，则需要创建数据库并运行应用程序的 数据库迁移 :

1
php
工匠

迁移

目录配置

Laravel 应始终从为 Web 服务器配置的“Web 目录”根目录提供服务。您不应尝试从“Web 目录”的子目录提供服务 Laravel 应用程序。尝试这样做可能会暴露应用程序中存在的敏感文件。

使用 Herd 安装

Laravel 群 是一款速度超快的原生 Laravel 和 PHP 开发环境，适用于 macOS 和 Windows。Herd 包含开始使用 Laravel 开发所需的一切，包括 PHP 和 Nginx。

安装 Herd 后，您就可以开始使用 Laravel 进行开发了。Herd 包含以下命令行工具： php , composer , laravel , expose , node , npm ， 和 nvm 。

macOS 上的 Herd

如果你在 macOS 上进行开发，你可以从 Herd 网站 安装程序会自动下载最新版本的 PHP，并将您的 Mac 配置为始终运行 Nginx 在背景中。

Herd 适用于 macOS 域名系统 支持“停放”目录。停放目录中的任何 Laravel 应用程序都将自动由 Herd 提供服务。默认情况下，Herd 在 ~/Herd 并且您可以访问此目录中的任何 Laravel 应用程序 .test 域使用其目录名称。

安装 Herd 后，创建新 Laravel 应用程序的最快方法是使用与 Herd 捆绑在一起的 Laravel CLI：

1
光盘

~
/一群
2
laravel
新的

我的应用程序
3
光盘

我的应用程序
4
一群
打开

当然，您始终可以通过 Herd 的 UI 管理您的停放目录和其他 PHP 设置，该 UI 可以从系统托盘中的 Herd 菜单打开。

您可以通过查看 群体文档 。

Windows 上的 Herd

您可以在以下位置下载 Herd 的 Windows 安装程序： Herd 网站 。安装完成后，您可以启动 Herd 来完成入职流程并首次访问 Herd UI。

左键单击 Herd 的系统托盘图标即可访问 Herd UI。右键单击可打开快捷菜单，其中可访问您日常所需的所有工具。

在安装过程中，Herd 会在你的主目录中创建一个“停放”目录，位于 %USERPROFILE%\Herd 。停放目录中的任何 Laravel 应用程序都将自动由 Herd 提供服务，您可以通过 .test 域使用其目录名称。

安装 Herd 后，创建新 Laravel 应用程序的最快方法是使用与 Herd 捆绑在一起的 Laravel CLI。首先，打开 Powershell 并运行以下命令：

1
光盘

~
\H
埃德
2
laravel
新的

我的应用程序
3
光盘

我的应用程序
4
一群
打开

您可以通过查看 Windows 版 Herd 文档 。

IDE 支持

在开发 Laravel 应用程序时，您可以自由使用任何代码编辑器。如果您正在寻找轻量级且可扩展的编辑器， VS 代码 或者 光标 结合官方 Laravel VS Code 扩展 为 Laravel 提供出色的支持，包括语法高亮、代码片段、artisan 命令集成以及针对 Eloquent 模型、路由、中间件、资产、配置和 Inertia.js 的智能自动完成等功能。

要获得 Laravel 的广泛而强大的支持，请查看 PhpStorm PhpStorm 是 JetBrains 的一款 IDE。它内置了对 Laravel 框架的支持，包括 Blade 模板、Eloquent 模型、路由、视图、翻译和组件的智能自动完成功能，以及强大的代码生成和 Laravel 项目导航功能。

对于那些寻求基于云的开发体验的人来说， Firebase 工作室 直接在浏览器中使用 Laravel 进行构建。Firebase Studio 无需任何设置，即可在任何设备上轻松构建 Laravel 应用。

Laravel 和 AI

Laravel Boost 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 作为开发依赖项安装：

1
作曲家
要求

Laravel/Boost

--dev

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

1
php
工匠

提升：安装

安装程序将自动检测您的 IDE 和 AI 代理，允许您选择适合您项目的功能。Boost 尊重现有的项目惯例，默认情况下不会强制执行任何固定的样式规则。

添加自定义 AI 指南

要使用您自己的自定义 AI 指南来增强 Laravel Boost，请添加 .blade.php 或者 .md 将文件传输到您的应用程序 .ai/guidelines/* 目录。运行 Laravel Boost 时，这些文件将根据 Laravel Boost 的指南自动包含在内。 boost:install 。

下一步

现在您已经创建了 Laravel 应用程序，您可能想知道接下来要学习什么。首先，我们强烈建议您阅读以下文档以熟悉 Laravel 的工作原理：

如何使用 Laravel 也将决定您接下来的旅程。使用 Laravel 的方法多种多样，我们将在下面探讨该框架的两个主要用例。

Laravel 全栈框架

Laravel 可以充当全栈框架。我们所说的“全栈”框架是指您将使用 Laravel 将请求路由到您的应用程序并通过以下方式呈现您的前端 Blade 模板 或者单页应用程序混合技术，例如 惯性 。这是使用 Laravel 框架最常见的方式，并且，在我们看来，也是使用 Laravel 最有效率的方式。

如果你打算这样使用 Laravel，你可能需要查看我们的文档 前端开发 , 路由 , 视图 或 Eloquent ORM 。此外，您可能还想了解以下社区软件包 活线 和 惯性 。这些软件包允许您使用 Laravel 作为全栈框架，同时享受单页 JavaScript 应用程序提供的许多 UI 好处。

如果你使用 Laravel 作为全栈框架，我们也强烈建议你学习如何使用 迅速地 。

Laravel API 后端

Laravel 还可以用作 JavaScript 单页应用程序或移动应用程序的 API 后端。例如，您可以将 Laravel 用作您的 Next.js 应用程序。在此上下文中，您可以使用 Laravel 来提供 验证 以及应用程序的数据存储/检索，同时还可以利用 Laravel 强大的服务，如队列、电子邮件、通知等。

如果你打算这样使用 Laravel，你可能需要查看我们的文档 路由 , 拉拉维尔圣人 ，以及 Eloquent ORM 。