安装
认识 Laravel
Laravel 是一个具有高效、优雅语法的 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、Composer 和 Laravel 安装程序后更新它们php.new，您可以在终端中重新运行该命令。
如果您已经安装了 PHP 和 Composer，则可以通过 Composer 安装 Laravel 安装程序：
1composer global require laravel/installer要获得功能齐全的图形化 PHP 安装和管理体验，请查看Laravel Herd。
创建应用程序
安装完 PHP、Composer 和 Laravel 安装程序后，就可以创建一个新的 Laravel 应用程序了。Laravel 安装程序会Prompts您选择所需的测试框架、数据库和入门套件：
1laravel new example-app创建应用程序后，您可以使用devComposer 脚本启动 Laravel 的本地开发服务器、队列工作器和 Vite 开发服务器：
1cd example-app2npm install && npm run build3composer run dev启动开发服务器后，即可通过 Web 浏览器访问您的应用程序，网址为http://localhost:8000。接下来，您就可以开始进入 Laravel 生态系统了。当然，您可能还需要配置数据库。
如果您想在开发 Laravel 应用程序时抢占先机，可以考虑使用我们的入门套件之一。Laravel 的入门套件为您的新 Laravel 应用程序提供了后端和前端身份验证脚手架。
初始配置
Laravel 框架的所有配置文件都存储在该config目录中。每个选项都有文档记录，因此您可以随意浏览这些文件并熟悉可用的选项。
Laravel 几乎无需额外配置即可开箱即用。您可以自由地开始开发！不过，您可能希望查看该config/app.php文件及其文档。它包含一些选项，例如url和locale，您可以根据您的应用程序进行更改。
基于环境的配置
由于 Laravel 的许多配置选项值可能因应用程序是在本地计算机上运行还是在生产 Web 服务器上运行而有所不同，因此许多重要的配置值都是使用.env应用程序根目录中的文件定义的。
您的.env文件不应提交到应用程序的源代码控制中，因为每个使用您应用程序的开发人员/服务器可能需要不同的环境配置。此外，如果入侵者获得源代码控制存储库的访问权限，这将带来安全风险，因为任何敏感凭据都会被泄露。
有关.env基于文件和环境的配置的更多信息，请查看完整的配置文档。
数据库和迁移
现在你已经创建了 Laravel 应用程序，你可能需要将一些数据存储在数据库中。默认情况下，应用程序的.env配置文件指定 Laravel 将与 SQLite 数据库进行交互。
在创建应用程序期间，Laraveldatabase/database.sqlite为您创建了一个文件，并运行了必要的迁移来创建应用程序的数据库表。
如果您更喜欢使用其他数据库驱动程序（例如 MySQL 或 PostgreSQL），则可以更新.env配置文件以使用适当的数据库。例如，如果您希望使用 MySQL，请像这样更新.env配置文件的变量：DB_*
1DB_CONNECTION=mysql2DB_HOST=127.0.0.13DB_PORT=33064DB_DATABASE=laravel5DB_USERNAME=root6DB_PASSWORD=如果您选择使用 SQLite 以外的数据库，则需要创建数据库并运行应用程序的数据库迁移：
1php artisan migrate目录配置
Laravel 应始终从您为 Web 服务器配置的“Web 目录”的根目录提供服务。您不应尝试从“Web 目录”的子目录提供服务。这样做可能会暴露应用程序中的敏感文件。
使用 Herd 安装
Laravel Herd是一款速度超快的原生 Laravel 和 PHP 开发环境，适用于 macOS 和 Windows。Herd 包含 Laravel 开发所需的一切，包括 PHP 和 Nginx。
安装 Herd 后，即可开始使用 Laravel 进行开发。Herd 包含用于php、composer、laravel、expose、node、npm和 的命令行工具nvm。
Herd Pro为 Herd 增加了其他强大的功能，例如创建和管理本地 MySQL、Postgres 和 Redis 数据库的能力，以及本地邮件查看和日志监控的能力。
macOS 上的 Herd
如果您在 macOS 上进行开发，可以从Herd 网站下载 Herd 安装程序。该安装程序会自动下载最新版本的 PHP，并将您的 Mac 配置为始终在后台运行Nginx 。
macOS 版 Herd 使用dnsmasq来支持“停放”目录。任何位于停放目录中的 Laravel 应用程序都将自动由 Herd 提供服务。默认情况下，Herd 会在 创建一个停放目录~/Herd，您可以使用其目录名访问域中此目录中的任何 Laravel 应用程序.test。
安装 Herd 后，创建新 Laravel 应用程序的最快方法是使用与 Herd 捆绑在一起的 Laravel CLI：
1cd ~/Herd2laravel new my-app3cd my-app4herd open当然，您始终可以通过 Herd 的 UI 管理您的停放目录和其他 PHP 设置，该 UI 可以从系统托盘中的 Herd 菜单打开。
您可以通过查看Herd 文档了解有关 Herd 的更多信息。
Windows 上的 Herd
您可以在Herd 网站下载 Herd 的 Windows 安装程序。安装完成后，您可以启动 Herd 以完成入门Processes并首次访问 Herd UI。
左键点击 Herd 的系统托盘图标即可访问 Herd 用户界面。右键点击即可打开快捷菜单，访问您日常所需的所有工具。
在安装过程中，Herd 会在您的主目录中创建一个“停放”目录，地址为%USERPROFILE%\Herd。停放目录中的任何 Laravel 应用程序都将自动由 Herd 提供服务，您可以.test使用其目录名在域中访问此目录中的任何 Laravel 应用程序。
安装 Herd 后，创建新 Laravel 应用程序的最快方法是使用 Herd 捆绑的 Laravel CLI。首先，打开 Powershell 并运行以下命令：
1cd ~\Herd2laravel new my-app3cd my-app4herd open您可以通过查看Windows 的 Herd 文档了解有关 Herd 的更多信息。
IDE 支持
在开发 Laravel 应用程序时，您可以自由使用任何您想要的代码编辑器；然而，PhpStorm为 Laravel 及其生态系统提供了广泛的支持，包括Laravel Pint。
此外，社区维护的Laravel Idea PhpStorm 插件提供了各种有用的 IDE 增强功能，包括代码生成、Eloquent 语法完成、验证规则完成等。
如果您使用Visual Studio Code (VS Code)进行开发，官方Laravel VS Code 扩展现已推出。此扩展将 Laravel 专用工具直接引入您的 VS Code 环境，从而提高工作效率。
后续步骤
现在你已经创建了 Laravel 应用程序，你可能想知道接下来要学习什么。首先，我们强烈建议你阅读以下文档，熟悉 Laravel 的工作原理：
如何使用 Laravel 也将决定您接下来的旅程。Laravel 的使用方式多种多样，我们将在下文探讨该框架的两个主要用例。
Laravel 全栈框架
Laravel 可以作为一个全栈框架。我们所说的“全栈”框架是指您将使用 Laravel 将请求路由到您的应用程序，并通过Blade 模板或Inertia等单页应用程序Mix技术渲染前端。这是使用 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 的文档。