安装

认识Laravel
- 为什么选择Laravel?
你的第一个Laravel项目
初始化配置
- 基于环境的配置
- 目录配置
接下来的步骤
- 将 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 Vapor 等平台允许您在 AWS 最新的无服务器技术上以几乎无限的规模运行 Laravel 应用程序。

一个社区的框架

Laravel 结合了 PHP 生态系统中最好的扩展，以提供最强大且对开发人员友好的框架。此外，来自世界各地的数千名才华横溢的开发人员为框架做出了贡献。说不定你就是下一个 Laravel 的贡献者。

你的第一个Laravel项目

我们希望尽可能轻松地开始使用 Laravel。在您自己的计算机上开发和运行 Laravel 项目有多种选择。虽然您可能希望稍后探索这些选项，但 Laravel 提供了 Sail，这是一个使用 [Docker](www.docker.comocker.com)运行 Laravel 应用。

Docker是一个工具, 用于在小型, 轻量级的 "容器 "中运行应用程序和服务, 它不会干扰你的本地计算机的安装软件或配置. 这意味着你不必担心在个人电脑上配置或设置复杂的开发工具，如网络服务器和数据库。要开始使用，您只需要安装 Docker Desktop。

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

{tip} 已经是 Docker 专家？别担心！关于 Sail 的所有内容都可以使用 Laravel 附带的 docker-compose.yml 文件进行自定义。

在macOS上开始使用

如果你是在Mac上开发，并且Docker Desktop已经安装，你可以使用一个简单的终端命令来创建一个新的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 的应用程序容器将在您的机器上构建。这可能需要几分钟。 不用担心，随后尝试启动 Sail 会快得多。

启动应用程序的 Docker 容器后，您可以在浏览器中访问应用程序：http://localhost。

{tip} 要继续了解有关 Laravel Sail 的更多信息，请查看其完整文档。

在Windows上开始使用

在创建新的 Laravel 应用程序之前，请确保安装 Docker Desktop。接下来，您应该确保已安装并启用 Windows Subsystem for Linux 2 (WSL2)。 WSL 允许您在 Windows 10 上本地运行 Linux 二进制文件。有关如何安装和启用 WSL2 的信息可以查看 Microsoft 的 [开发人员环境文档](https://docs.microsoft.com/en-us/windows/wsl/安装-win10）。

{tip} 安装并启用 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 的应用程序容器将在您的机器上构建。这可能需要几分钟。 不用担心，随后尝试启动 Sail 会快得多。

启动应用程序的 Docker 容器后，您可以在浏览器中访问应用程序：http://localhost。

{tip} 要继续了解有关 Laravel Sail 的更多信息，请查看其完整文档。

在 WSL2 中开发

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

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

在 Linux 中开发

如果你在 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 的应用程序容器将在您的机器上构建。这可能需要几分钟。 不用担心，随后尝试启动 Sail 会快得多。

启动应用程序的 Docker 容器后，您可以在浏览器中访问应用程序：http://localhost。

{tip} 要继续了解有关 Laravel Sail 的更多信息，请查看其完整文档。

选择您的 Sail 服务

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

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

如果你没有指定你想配置的服务，将配置默认的mysql、redis、meilisearch、mailhog和selenium堆栈。

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

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

通过 Composer 安装

如果你的电脑已经安装了 PHP 和 Composer，你可以直接使用 Composer 创建一个新的 Laravel 项目。创建应用程序后，您可以使用 Artisan CLI 的 serve 命令启动 Laravel 的本地开发服务器：

composer create-project laravel/laravel example-app
 
cd example-app
 
php artisan serve

Laravel 安装程序

或者，您可以将 Laravel 安装程序安装为全局 Composer 依赖项：

composer global require laravel/installer
 
laravel new example-app
 
cd example-app
 
php artisan serve

请确保将 Composer 的全局 vendor bin 目录放置在你的系统环境变量 $PATH 中，以便您的系统可以找到 laravel 可执行文件。该目录根据您的操作系统存在于不同的位置；但是，一些常见的位置包括：

macOS: $HOME/.composer/vendor/bin
Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin
GNU / Linux Distributions: $HOME/.config/composer/vendor/bin or $HOME/.composer/vendor/bin

为了方便，Laravel安装程序也可以为你的新项目创建一个Git仓库。为了表示你想创建一个Git仓库, 在创建一个新项目的时候，传递--git标志:

laravel new example-app --git

此命令将为您的项目初始化一个新的 Git 存储库并自动提交基本的 Laravel 框架。 git 标志假定您已正确安装和配置 Git。您还可以使用 --branch 标志来设置初始分支名称：

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

除了使用 --git 标志，您还可以使用 --github 标志来创建 Git 存储库，并在 GitHub 上创建相应的私有存储库：

laravel new example-app --github

然后，创建的存储库将在 https://github.com/<your-account>/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的许多配置选项值可能会有所不同，这取决于你的应用程序是在你的本地计算机上运行还是在生产环境上运行，许多重要的配置值是使用.env文件定义的，该文件存在于你的应用程序的根目录。

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

{tip} 有关 .env 文件和基于环境的配置的更多信息，请查看完整的配置文档。

目录配置

Laravel应该总是从你的Web服务器配置的 "web目录 "的根目录中获取服务. 你不应该试图在 "web目录 "的子目录下提供Laravel应用程序. 试图这样做可能会暴露你的应用程序中存在的敏感文件.

接下来的步骤

现在你已经创建了你的Laravel项目, 你可能想知道接下来要学习什么. 首先, 我们强烈建议通过阅读以下文档来熟悉Laravel的工作原理:

你想如何使用Laravel也将决定你接下来的旅程. 使用Laravel的方式有很多种, 我们将在下面探讨这个框架的两个主要用例.

将 Laravel 用作全栈框架

Laravel 可以作为一个全栈框架。 “全栈”框架是指您将使用 Laravel 将请求路由到您的应用程序并通过 Blade 模板或使用单页应用程序混合呈现您的前端像 Inertia.js 这样的技术。这是使用 Laravel 框架最常见的方式。

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

如果你使用 Laravel 作为全栈框架，我们也强烈建议你学习如何使用 Laravel Mix 编译应用程序的 CSS 和 JavaScript。

{tip} 如果您想开始构建您的应用程序，请查看我们的官方应用程序入门工具包。

将 Laravel 用作 API 后端

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

如果这是你计划使用 Laravel 的方式，你可能想查看我们关于 routing、Laravel Sanctum 的文档和 Eloquent ORM。

{tip} 需要开始搭建 Laravel 后端和 Next.js 前端的脚手架？ Laravel Breeze 提供 API 堆栈以及 Next.js 前端实现，这样你就可以在几分钟内开始工作。