为什么选择安装Laravel？深入了解这个强大的Web应用框架

安装认识 Laravel

我们会为你处理细节。

Laravel 致力于提供很棒的开发体验，并且提供了强大的特性。它有完全的依赖注入，有富有表现力的数据库抽象层，还有队列和计划任务，以及单元和集成测试等等。

如果你是刚接触 PHP 和 Web 框架的新人，或者是有多年经验的老手，Laravel 都能成为与你一同成长的框架。我们会帮你开启成为 Web 开发者的第一步，也能将你的经验提升到下一个层级。我们很期待看到你的作品。

为什么选择 Laravel?

有很多工具和框架能够用来构建一个 Web 应用。然而，我们坚信 Laravel 是构建现代化、全栈 Web 应用的最优选择。

一个渐进式框架

我们喜欢把 Laravel 称作是一个“渐进式”的框架。这意味着 Laravel 会和你一起发展进步。倘若你是初次踏入 Web 开发领域，Laravel 丰富的文档、指南以及视频教程能够帮助你熟悉使用技巧，从而不会感到手足无措。

如果你属于高级开发人员，那么 Laravel 给你提供了很强大的工具，这些工具可用于依赖注入，也可用于单元测试，还可用于队列以及广播系统等。Laravel 对构建专业的 Web 应用程序进行了细致的调整，并且已经准备好去应对企业的工作负载。

一个可扩展的框架

Laravel 具备令人难以置信的可扩展性。因为 PHP 具有灵活性，并且 Laravel 内置支持 Redis 等快速分布式缓存系统，所以使用 Laravel 进行扩展是很容易的事情。实际上，Laravel 应用程序已经能够很容易地扩展到每月能够处理数亿个请求。

是否需要压缩开发费用？Laravel Vapor 具备这样的能力，它能够让你在 AWS 最新的无服务器技术平台上运行 Laravel 应用程序，并且可以达到几乎无限的规模。

一个社区化的框架

Laravel 把 PHP 生态系统中最好的软件包融合在一起，提供了一个框架，既健壮又对开发人员友好。同时，来自世界各地的数千名有才华的开发人员为这个框架贡献了力量。谁能想到呢，或许你会成为下一个为 Laravel 做出贡献的人。

你的第一个 Laravel 项目

我们期望能够较为轻松地开启对 Laravel 的使用。在你自身的计算机上进行 Laravel 项目的开发与运行，存在着多种可供选择的方式。尽管你或许希望之后再去对这些选项进行研究，但 Laravel 提供了 Sail，这是一个能够利用 Docker 来运行 Laravel 项目的内置解决方案。

Docker 是一种工具，能在小型、轻量级的“容器”里运行应用程序和服务。它不会对本地计算机安装的软件或配置造成干扰。这表明你无需为在个人计算机上配置或设置复杂的开发工具而担忧，像 web 服务器和数据库这类。要开始的话，你仅仅需要安装 Docker Desktop。

并且在构建过程中无需之前的 Docker 经验。

提示

你已经是 Docker 专家了吗？不用担心哦！对于 Sail 的所有方面，都能够利用 Laravel 所附带的文件 docker-compose.yml 来进行自定义。

macOS 入门

如果你在 Mac 上进行开发且已经安装了 Docker Desktop，那么你能够使用一个较为简单的终端命令去创建一个新的 Laravel 项目。比如，若要在名为“example-app”的目录里创建一个新的 Laravel 应用程序，你可以在终端里运行如下命令：

curl -s 该链接为 "https://laravel.build/example-app" 。 此链接指向的是一个特定的应用程序示例。 它与 Laravel 框架相关联。 用于构建和展示基于 Laravel 的应用程序的示例。 可以通过该链接访问和查看这个示例应用程序。 它为开发者提供了一个参考和学习的范例。 帮助开发者更好地理解和使用 Laravel 框架来创建应用程序。 | bash

你可以将此 URL 中的“example-app”改成你喜欢的任何东西。Laravel 应用程序的目录会在你执行命令的那个目录里创建。

创建项目之后，你能够导航至应用程序目录，接着启动 Laravel Sail。Laravel Sail 给予了一个简便的命令行界面，以便与 Laravel 的默认 Docker 配置进行交互。

cd example-app
./vendor/bin/sail up

当第一次运行 Sail up 命令时，你的机器将会构建 Sail 的应用程序容器。此过程可能会花费几分钟的时间。不必担心，之后再尝试启动 Sail 会快很多。

启动 Docker 容器来运行应用程序之后，你便能够在 Web 浏览器里对该应用程序进行访问。

提示

如果你想继续了解关于 Laravel Sail 的更多信息，那么可以查看它的完整文档。

Windows 入门

在新建 Laravel 应用之前，你要先确认你的 Windows 电脑已经安装了 Docker Desktop。接着，还得确认已经安装并且启用了适用于 Linux 的 Windows 子系统 2 （WSL2）。因为 WSL 能够让你在 Windows 10 上运行 Linux 二进制文件。关于如何安装并启用 WSL2，请参阅微软 开发者环境文档。

提示

安装并启用 WSL2 之后，需要确保 Docker Desktop 已被配置为使用 WSL2 后端。

接下来，要创建你的第一个 Laravel 项目。先启动 Windows Terminal，接着为 WSL2 Linux 操作系统打开一个终端。之后，能够使用简单的命令来新建 Laravel 项目。例如，若想在“example-app”文件夹中新建 Laravel 应用，可在终端中运行如下命令：

curl -s该链接为 https://laravel.build/example-app 。| bash

你可以随意更改 URL 中的“example-app”。同时，Laravel 应用会在执行命令的那个文件夹中被创建。

创建项目后，你能够切换至应用目录，接着启动 Laravel Sail。Laravel Sail 给予了一个简便的命令行接口，此接口可用来与 Laravel 默认的 Docker 配置进行交互。

cd example-app
./vendor/bin/sail up

当你第一次运行 Sail 的 up 命令时，Sail 的应用容器会在你的机器上进行编译。此过程需花费几分钟时间。无需担忧，后续就会很快了。

应用的 Docker 容器一旦启动，你就能够在 Web 浏览器中通过特定方式访问你的应用了。

提示

如果你想要继续学习更多关于 Laravel Sail 的知识，那么可以去参阅相关的详细文档。

使用 WSL2 进行开发

你需要能够修改在 WSL2 安装中创建的 Laravel 应用程序文件。我们推荐你使用微软的 Visual Studio Code 编辑器，同时搭配其 Remote Development 扩展，这样它们就能帮助你解决这个问题。

这些工具一旦成功安装，你就能够使用 Windows Terminal 。在应用根目录执行 code. 命令，这样就能打开任何 Laravel 项目。

在 Linux 使用 Laravel Sail

在进行 Linux 开发时，若已经安装了 Docker Compose，那么就能够使用简单的终端命令来创建一个新的 Laravel 项目。比如，想要在“example-app”目录里创建新的 Laravel 应用，可在终端中运行如下命令：

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

你可以把 URL 里的“example-app”换成你喜欢的任何内容。Laravel 应用程序的目录会在执行命令的那个目录里创建。

项目创建完成之后，你能够导航到应用目录并且启动 Laravel Sail。Laravel Sail 具备一个简单的命令行接口，此接口可用来与 Laravel 的默认 Docker 配置进行交互。

cd example-app
./vendor/bin/sail up

当你第一次运行 Sail 的 up 命令时，Sail 的应用容器会在你的机器上进行编译。此过程需要花费一定时间。不必担心，之后就会快起来。

一旦应用的 Docker 容器启动了，你便可在 Web 浏览器中通过 访问你的应用了。

提示

技巧：要继续学习更多关于 Laravel Sail 的知识，请参阅 详细文档。

选择你的 Sail 服务

当创建一个新的 Laravel 应用程序时，使用 Sail 来创建。你能够通过 with 查询变量，去选择哪些服务需要配置到新应用程序的 docker-compose.yml 文件中。可选择的服务有 mailhog。

curl -s 该链接为 "https://laravel.build/example-app"，并且带有 "mysql" 和 "redis" 两个参数。 | bash

如果你没有制定想要配置的服务，那么默认会配置 selenium。

你能够通过在 URL 里添加参数，以此来指定 Sail 所默认安装的服务。

curl -s 该链接为 https://laravel.build/example-app，同时包含 with 参数，其值为 mysql 和 redis，并且是一个 devcontainer 相关的链接。 | bash

通过 Composer 安装

如果你的终端安装了 PHP 和 Composer，那么你能够直接利用 Composer 去创建一个新的 Laravel 项目。应用程序创建完毕之后，你可以借助 Artisan CLI 的 serve 命令来启动 Laravel 的本地服务。

composer创建项目 laravel/laravel 并命名为 example-app
cd example-app
php artisan serve

通过 Laravel 安装器

你可以通过以下方式来安装：利用 Laravel 安装器，并将其设置为全局 Composer 依赖。

composer全球需要 laravel/installer 。
laravel new example-app
cd example-app
php artisan serve

你需要把 Composer 的全局 vendor bin 目录放置到你的系统环境变量 $PATH 里，这样系统就能找到 laravel 的可执行文件。不同操作系统下，该目录的路径不一样，下面列出一些常见的位置：

为了方便，Laravel 安装程序能够为你的新项目构建一个 Git 仓库。要是想创建 Git 仓库，在创建新项目的时候可以通过 --git 来进行指定。

laravel new example-app --git

此命令会给你的项目初始化一个新的 Git 仓库，并且会自动提交基础的 Laravel 框架。在使用 git 命令之前，你需要确保已经正确地安装并配置了 Git。你还能够使用这个 --branch 命令来设定初始的分支名称。

laravel new example-app --git --branch="main"

你除了可以使用 --git 命令，还能够使用 --github 命令在 GitHub 上创建相应的私有仓库。

laravel new example-app --github

创建的仓库位于 /example-app 。在使用 github 命令之前，你需要确保已正确安装 GitHub CLI 并且已通过 GitHub 完成身份验证。同时，你也应当安装 git 并进行正确配置。若有需要，你可以传递 GitHub CLI 所支持的其他命令。

laravel new example-app --github="--public"

你能够使用 --organization 这个命令，在特定的 GitHub 组织当中去创建仓库。

laravel new example-app --github="--public" --organization="laravel"

初始配置

Laravel 框架的配置文件都存于 config 目录里。每个选项都有相关文档记录。可以随意浏览这些文件，从而熟悉可用的选项。

Laravel 几乎无需进行额外的配置。你能够自由地开始展开开发！不过，你或许希望去查看 config/app.php 文件以及它的相关文档。该文件包含了一些选项，例如 timezone 和 locale 等，你或许希望依据你的应用程序来对其进行更改。

目录权限

安装完 Laravel 之后，你或许需要对两个文件配置读写权限。storage 目录需要允许 Web 服务器写入，bootstrap/cache 目录也需要允许 Web 服务器写入。否则，Laravel 程序将无法正常运行。

基于环境的配置

Laravel 的许多配置选项值会因应用程序是在本地计算机还是生产 Web 服务器上运行而不同。所以，许多重要的配置值是通过位于应用程序根目录中的.env 文件来定义的。

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

提示

有关.env 基于文件和环境的配置的更多信息，你可以查看完整的内容。

目录配置

Laravel 始终应当从为你的 Web 服务器所配置的“Web 目录”的根目录来提供服务。你不可以尝试从“Web 目录”的子目录去提供 Laravel 应用程序。若尝试这样做，可能会将应用程序中存在的敏感文件暴露出来。

下一步

现在你创建了 Laravel 项目，可能想知道后续要学习什么。首先，我们强烈建议你阅读以下文档来熟悉 Laravel 的工作原理：

你对 Laravel 的使用方式将会决定你旅程的后续走向。Laravel 有多种使用途径，我们将对以下框架的两个主要用途进行探讨。

Laravel 全栈框架

Laravel 能够作为一个全栈框架。全栈框架意味着你会利用 Laravel 把请求路由到你的应用程序中，并且通过 Blade 模板或者借助单页应用程序混合技术 Inertia.js 来呈现前端。这是运用 Laravel 框架最为常见的方式。

如果你计划以这种方式使用 Laravel，那么你或许需要查看我们有关路由的文档、查看我们有关视图的文档，或者查看我们有关 Eloquent ORM 的文档。另外，你可能会对 Livewire 以及 Inertia.js 等社区软件包感兴趣。这些包能让你把 Laravel 当作全栈框架来使用，并且还能让你享受到单页 JavaScript 应用程序所具备的诸多 UI 优势。

如果你将 Laravel 当作全栈框架来使用，那么我们强烈建议你去学习怎样使用 Laravel Mix 来编译应用程序的 CSS 和 JavaScript 。

提示

如果你想要快速地构建你的应用程序，那么就查看我们的官方应用程序入门工具包吧。

Laravel API 后端

Laravel 能够充当 JavaScript 单页应用程序或者移动应用程序的 API 后端。比如说，你可以将 Laravel 用作 Next.js 应用程序的 API 后端。在这种情形下，你能够运用 Laravel 来给你的应用程序给予身份验证以及数据的存储与检索。并且，还可以借助 Laravel 的强大服务，像队列、电子邮件、通知等这些方面。

如果这是你计划采用 Laravel 的方式，那么你或许需要查看我们有关路由的文档，以及查看我们有关 Laravel Sanctum 的文档，还有查看我们有关 Eloquent ORM 的文档。

提示

如果你需要抢先搭建 Laravel 后端和 Next.js 前端的脚手架，那么 Laravel Breeze 可以提供相关支持以及 Next.js 前端的实现，这样你就能在几分钟内开始使用了。