安装

• 认识 Laravel
  • 为什么选择 Laravel？
• 创建 Laravel 应用
  • 安装 PHP 和 Laravel 安装器
  • 创建应用
• 初始配置
  • 基于环境的配置
  • 数据库和迁移
  • 目录配置
• 使用 Herd 进行本地安装
  • macOS 上的 Herd
  • Windows 上的 Herd
• 使用 Sail 进行 Docker 安装
  • macOS 上的 Sail
  • Windows 上的 Sail
  • Linux 上的 Sail
  • 选择您的 Sail 服务
• IDE 支持
• 后续步骤
  • 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 Cloud 等平台允许您以近乎无限的规模运行 Laravel 应用程序。

社区框架

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、Composer 和 Laravel 安装器后，您就可以创建新的 Laravel 应用程序了。Laravel 安装器将提示您选择首选的测试框架、数据库和入门套件

1laravel new example-app

创建应用程序后，您可以使用 dev Composer 脚本启动 Laravel 的本地开发服务器、队列工作器和 Vite 开发服务器

1cd example-app
2npm install && npm run build
3composer run dev

启动开发服务器后，您可以在 Web 浏览器中通过 https://127.0.0.1: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_* 变量，如下所示

1DB_CONNECTION=mysql
2DB_HOST=127.0.0.1
3DB_PORT=3306
4DB_DATABASE=laravel
5DB_USERNAME=root
6DB_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 的命令行工具。

macOS 上的 Herd

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

macOS 版 Herd 使用 dnsmasq 来支持“停放”目录。停放目录中的任何 Laravel 应用程序都将由 Herd 自动提供服务。默认情况下，Herd 在 ~/Herd 中创建一个停放目录，您可以使用其目录名称在 .test 域上访问此目录中的任何 Laravel 应用程序。

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

1cd ~/Herd
2laravel new my-app
3cd my-app
4herd open

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

您可以通过查看 Herd 文档 了解有关 Herd 的更多信息。

Windows 上的 Herd

您可以在 Herd 网站 上下载 Herd 的 Windows 安装程序。安装完成后，您可以启动 Herd 以完成入门过程并首次访问 Herd UI。

可以通过左键单击 Herd 的系统托盘图标来访问 Herd UI。右键单击会打开快速菜单，其中包含您日常所需的所有工具。

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

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

1cd ~\Herd
2laravel new my-app
3cd my-app
4herd open

您可以通过查看 Windows 版 Herd 文档 了解有关 Herd 的更多信息。

使用 Sail 进行 Docker 安装

我们希望无论您喜欢哪种操作系统，都能尽可能轻松地开始使用 Laravel。因此，在本地计算机上开发和运行 Laravel 应用程序有多种选择。虽然您可能希望稍后探索这些选项，但 Laravel 提供了 Sail，这是一个内置的解决方案，用于使用 Docker 运行您的 Laravel 应用程序。

Docker 是一种用于在小的、轻量级的“容器”中运行应用程序和服务的工具，这些容器不会干扰您本地机器上安装的软件或配置。这意味着您不必担心在本地机器上配置或设置复杂的开发工具，例如 Web 服务器和数据库。要开始使用，您只需安装 Docker Desktop。

Laravel Sail 是一个轻量级的命令行界面，用于与 Laravel 的默认 Docker 配置进行交互。Sail 为使用 PHP、MySQL 和 Redis 构建 Laravel 应用程序提供了一个很好的起点，而无需事先的 Docker 经验。

macOS 上的 Sail

如果您在 Mac 上开发并且已经安装了 Docker Desktop，您可以使用简单的终端命令来创建新的 Laravel 应用程序。例如，要在名为“example-app”的目录中创建新的 Laravel 应用程序，您可以在终端中运行以下命令

1curl -s "https://laravel.build/example-app" | bash

当然，您可以将此 URL 中的“example-app”更改为您喜欢的任何名称 - 只需确保应用程序名称仅包含字母数字字符、破折号和下划线。Laravel 应用程序的目录将在您执行命令的目录中创建。

Sail 安装可能需要几分钟时间，因为 Sail 的应用程序容器是在您的本地机器上构建的。

创建应用程序后，您可以导航到应用程序目录并启动 Laravel Sail。Laravel Sail 提供了一个简单的命令行界面，用于与 Laravel 的默认 Docker 配置进行交互

1cd example-app
2 
3./vendor/bin/sail up

应用程序的 Docker 容器启动后，您应该运行应用程序的 数据库迁移

1./vendor/bin/sail artisan migrate

最后，您可以在 Web 浏览器中通过 https://127.0.0.1 访问该应用程序。

Windows 上的 Sail

在 Windows 机器上创建新的 Laravel 应用程序之前，请确保安装 Docker Desktop。接下来，您应确保安装并启用了适用于 Linux 2 的 Windows 子系统 (WSL2)。WSL 允许您在 Windows 10 上原生运行 Linux 二进制可执行文件。有关如何安装和启用 WSL2 的信息，请参阅 Microsoft 的 开发人员环境文档。

接下来，您就可以创建您的第一个 Laravel 应用程序了。启动 Windows Terminal 并为您的 WSL2 Linux 操作系统开始新的终端会话。接下来，您可以使用简单的终端命令来创建新的 Laravel 应用程序。例如，要在名为“example-app”的目录中创建新的 Laravel 应用程序，您可以在终端中运行以下命令

1curl -s https://laravel.build/example-app | bash

当然，您可以将此 URL 中的“example-app”更改为您喜欢的任何名称 - 只需确保应用程序名称仅包含字母数字字符、破折号和下划线。Laravel 应用程序的目录将在您执行命令的目录中创建。

Sail 安装可能需要几分钟时间，因为 Sail 的应用程序容器是在您的本地机器上构建的。

创建应用程序后，您可以导航到应用程序目录并启动 Laravel Sail。Laravel Sail 提供了一个简单的命令行界面，用于与 Laravel 的默认 Docker 配置进行交互

1cd example-app
2 
3./vendor/bin/sail up

应用程序的 Docker 容器启动后，您应该运行应用程序的 数据库迁移

1./vendor/bin/sail artisan migrate

最后，您可以在 Web 浏览器中通过 https://127.0.0.1 访问该应用程序。

在 WSL2 中开发

当然，您需要能够修改在 WSL2 安装中创建的 Laravel 应用程序文件。为此，我们建议使用 Microsoft 的 Visual Studio Code 编辑器及其用于 远程开发 的第一方扩展。

安装这些工具后，您可以使用 Windows Terminal 从应用程序的根目录执行 code . 命令来打开任何 Laravel 应用程序。

Linux 上的 Sail

如果您在 Linux 上开发并且已经安装了 Docker Compose，您可以使用简单的终端命令来创建新的 Laravel 应用程序。

首先，如果您使用的是适用于 Linux 的 Docker Desktop，您应该执行以下命令。如果您没有使用适用于 Linux 的 Docker Desktop，您可以跳过此步骤

1docker context use default

然后，要在名为“example-app”的目录中创建新的 Laravel 应用程序，您可以在终端中运行以下命令

1curl -s https://laravel.build/example-app | bash

当然，您可以将此 URL 中的“example-app”更改为您喜欢的任何名称 - 只需确保应用程序名称仅包含字母数字字符、破折号和下划线。Laravel 应用程序的目录将在您执行命令的目录中创建。

Sail 安装可能需要几分钟时间，因为 Sail 的应用程序容器是在您的本地机器上构建的。

创建应用程序后，您可以导航到应用程序目录并启动 Laravel Sail。Laravel Sail 提供了一个简单的命令行界面，用于与 Laravel 的默认 Docker 配置进行交互

1cd example-app
2 
3./vendor/bin/sail up

应用程序的 Docker 容器启动后，您应该运行应用程序的 数据库迁移

1./vendor/bin/sail artisan migrate

最后，您可以在 Web 浏览器中通过 https://127.0.0.1 访问该应用程序。

选择您的 Sail 服务

通过 Sail 创建新的 Laravel 应用程序时，您可以使用 with 查询字符串变量来选择应在新应用程序的 docker-compose.yml 文件中配置哪些服务。可用服务包括 mysql、pgsql、mariadb、redis、valkey、memcached、meilisearch、typesense、minio、selenium 和 mailpit

1curl -s "https://laravel.build/example-app?with=mysql,redis" | bash

如果您未指定要配置哪些服务，则将配置 mysql、redis、meilisearch、mailpit 和 selenium 的默认堆栈。

您可以通过将 devcontainer 参数添加到 URL 来指示 Sail 安装默认的 Devcontainer

1curl -s "https://laravel.build/example-app?with=mysql,redis&devcontainer" | bash

IDE 支持

您可以自由使用任何您喜欢的代码编辑器来开发 Laravel 应用程序；但是，PhpStorm 为 Laravel 及其生态系统提供了广泛的支持，包括 Laravel Pint。

此外，社区维护的 Laravel Idea PhpStorm 插件提供了各种有用的 IDE 增强功能，包括代码生成、Eloquent 语法完成、验证规则完成等等。

如果您在 Visual Studio Code (VS Code) 中开发，则官方 Laravel VS Code Extension 现已可用。此扩展程序将 Laravel 专用工具直接引入您的 VS Code 环境，从而提高工作效率。

后续步骤

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

您希望如何使用 Laravel 也将决定您旅程的下一步。使用 Laravel 的方法有很多种，下面我们将探讨该框架的两个主要用例。

Laravel 全栈框架

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

如果这是您计划使用 Laravel 的方式，您可能需要查看我们关于 前端开发、路由、视图 或 Eloquent ORM 的文档。此外，您可能对了解 Livewire 和 Inertia 等社区软件包感兴趣。这些软件包允许您将 Laravel 用作全栈框架，同时享受单页 JavaScript 应用程序提供的许多 UI 优势。

如果您将 Laravel 用作全栈框架，我们还强烈建议您学习如何使用 Vite 编译应用程序的 CSS 和 JavaScript。

Laravel API 后端

Laravel 也可以充当 JavaScript 单页应用程序或移动应用程序的 API 后端。例如，您可以将 Laravel 用作 Next.js 应用程序的 API 后端。在这种情况下，您可以使用 Laravel 为您的应用程序提供 身份验证 和数据存储/检索，同时还可以利用 Laravel 的强大服务，例如队列、电子邮件、通知等等。

如果这是您计划使用 Laravel 的方式，您可能需要查看我们关于 路由、Laravel Sanctum 和 Eloquent ORM 的文档。