安装

• 认识 Laravel
  • 为什么选择 Laravel ?
• 创建一个 Laravel 项目
  • 安装 PHP 和 Laravel 安装器
  • 创建项目
• 初始配置
  • 基于环境的配置
  • 数据库和迁移
  • 目录配置
• 使用Herd进行安装
  • macOS 上的 Herd
  • Windows 上的 Herd
• 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 结合了 PHP 生态系统中最好的软件包，提供了最健壮、对开发人员友好的框架。此外，来自世界各地的数千名有才华的开发人员 为框架做出贡献。谁知道呢，也许你就是下一个 Laravel 贡献者。

创建 Laravel 应用

安装 PHP 和 Laravel 安装器

在创建首个 Laravel 应用前，请确保本地环境已安装 PHP、Composer 及 Laravel 安装器。此外，你需安装 Node 和 NPM 或 Bun，以编译应用的前端资源。

若本地尚未安装 PHP 和 Composer，以下命令可在 macOS、Windows 或 Linux 上安装 PHP、Composer 和 Laravel 安装器：

# macOS
/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"

# Windows PowerShell
# 以管理员身份运行...
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'))

# Linux
/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.4)"

运行上述命令后，请重启终端会话。若需更新通过 php.new 安装的 PHP、Composer 和 Laravel 安装器，可在终端重新运行该命令。

若已安装 PHP 与 Composer，可通过以下命令安装 Laravel 安装器：

composer global require laravel/installer

[!NOTE]
如需图形化 PHP 安装与管理工具，请查看 Laravel Herd。

创建应用

安装 PHP、Composer 和 Laravel 安装器后，执行以下命令创建新 Laravel 应用。Laravel 安装器将引导你选择测试框架、数据库及初始包及入门套件：

laravel new example-app

应用创建完成后，可使用 dev Composer 脚本启动 Laravel 本地开发服务器、队列及 Vite 开发服务器：

cd example-app
npm install && npm run build
composer run dev

开发服务器启动后，你就可以通过 localhost:8000 访问你的应用。接下来，你就可以开始进入 Laravel 生态的下一步。当然，你可能还想配置数据库。

[!NOTE]
若想在开发 Laravel 应用时抢占先机，可考虑使用我们的入门套件。Laravel 入门套件为新应用提供后端与前端认证脚手架。

初始配置

Laravel 框架的所有配置文件存放于 config 目录。每项配置均有文档说明，你可自由浏览文件，熟悉可用选项。

Laravel 开箱可用，不需要额外配置，你可以自由地开发！然而，你可能希望查看 config/app.php 文件及其文档。其中包含如 url 和 locale 等选项，你可根据应用需求调整。

基于环境的配置

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

你的 .env 文件不应该提交到应用程序的源代码控制中，因各开发者或服务器可能需不同环境配置。此外，如果入侵者访问了你的源代码仓库，这将成为安全风险，因为任何敏感数据都会被公开。

[!NOTE]
若要了解更多关于 .env 文件和基于环境的配置的信息，请查看完整的 配置文档。

数据库和迁移

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

应用创建期间，Laravel 为你生成了 database/database.sqlite 文件，并运行了必要的迁移以创建应用数据库表。

如果你更想使用其他数据库驱动，例如 MySQL 或者 PostgreSQL，可更新 .env 配置文件以使用相应数据库。例如，若使用 MySQL，可如此更新 .env 文件中的 DB_* 变量：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

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

php artisan migrate

[!NOTE]
如果你在 macOS 或 Windows 上进行开发，并且需要在本地安装 MySQL、PostgreSQL 或 Redis，请考虑使用 Herd Pro 或 DBngin。

目录配置

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。

[!NOTE]
Herd Pro 为 Herd 增添了额外的强大功能，例如创建和管理本地 MySQL、Postgres 和 Redis 数据库的能力，以及本地邮件查看和日志监控的能力。

macOS 上的 Herd

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

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

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

cd ~/Herd
laravel new my-app
cd my-app
herd open

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

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

Windows 上的使用 Herd

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

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

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

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

cd ~\Herd
laravel new my-app
cd my-app
herd open

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

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 。

本译文仅用于学习和交流目的，转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议，如果我们的工作有侵犯到您的权益，请及时联系我们。

原文地址：https://learnku.com/docs/laravel/12.x/in...

译文地址：https://learnku.com/docs/laravel/12.x/in...