Laravel - 安装

Laravel 使用 Composer 来管理其依赖项。因此，在使用 Laravel 之前，请确保您的机器上已安装 Composer。

系统要求：

确保您的服务器满足以下要求（请参考官方 Laravel 文档以获取您打算安装特定版本的具体要求，因为这些可能会变化）：

PHP（例如，Laravel 10 需要 >= 8.1，Laravel 11 需要 >= 8.2）
所需的 PHP 扩展：Ctype, cURL, DOM, Fileinfo, Filter, Hash, Mbstring, OpenSSL, PCRE, PDO, Session, Tokenizer, XML, JSON, Sodium（如果使用某些加密功能）。

步骤 1：安装 Composer

如果您尚未安装 Composer，请从官方网站下载并安装：https://getcomposer.org/download/

安装完成后，通过打开终端或命令提示符并输入以下命令进行验证：

composer --version

这将显示已安装的 Composer 版本。

步骤 2：创建一个新的 Laravel 项目

您可以使用 Composer 的 create-project 命令创建一个新的 Laravel 项目。打开您的终端，导航到您想创建项目的目录，然后运行：

composer create-project laravel/laravel example-app

将 example-app 替换为您希望的项目目录名称。此命令会将 Laravel 及其依赖项下载到一个新的 example-app 目录中。

或者，如果您已全局安装了 Laravel Installer（Laravel 安装器），可以使用它：

composer global require laravel/installer
laravel new example-app

在安装过程中，Composer 将下载许多软件包。您将看到类似于以下的输出（已省略部分内容）：

Installing laravel/laravel (v10.x.x)
  - Downloading laravel/laravel (v10.x.x)
  - Installing laravel/laravel (v10.x.x): Extracting archive
Installing dependencies from lock file
Verifying lock file contents can be installed on current platform.
Package operations: ... installs, ... updates, ... removals
  - Downloading ...
  - Installing ...
Generating optimized autoload files
...

完成后，您通常会看到有关发现软件包和发布资源的消息，然后是：

Application key set successfully.
Thank you! We hope you build something incredible. Dive in with: cd example-app && php artisan serve

步骤 3：运行开发服务器

Laravel 包含一个本地开发服务器，可用于提供您的应用程序。导航到您的项目目录：

cd example-app

然后，启动 Artisan 开发服务器：

php artisan serve

您应该看到如下输出：

INFO  Server running on [http://127.0.0.1:8000].

Press Ctrl+C to stop the server

步骤 4：访问您的应用程序

打开您的 Web 浏览器，导航到 http://127.0.0.1:8000（或 php artisan serve 命令显示的 URL）。

如果安装成功，您应该会看到默认的 Laravel 欢迎页面。此页面通常显示 Laravel 版本和文档链接。

替代方案：Laravel Sail (Docker 环境)

Laravel Sail 是一个轻量级的命令行接口，用于与 Laravel 的默认 Docker 开发环境交互。Sail 提供了一个很好的起点，让您可以使用 PHP、MySQL、Redis 等构建 Laravel 应用程序，而无需预先具备 Docker 经验。

如果您在创建项目时选择安装了 Sail（这通常是一个选项，也可以稍后添加），您通常会使用类似 ./vendor/bin/sail up 的命令来启动 Docker 容器，以及 ./vendor/bin/sail artisan serve（尽管通常不需要，因为 Web 服务器在容器中运行）。

请查阅 Laravel Sail 文档获取更多详情：https://laravel.com/docs/sail

下一步

安装 Laravel 后，您可以开始探索其功能：

配置： 查看 .env 文件和 config 目录。
路由： 在 routes/web.php 中定义路由。
控制器： 创建控制器来处理请求。
视图： 使用 resources/views 中的 Blade 模板设计您的 UI。
数据库： 设置迁移和模型以与数据库交互。

常见安装问题：

PHP 版本不匹配： 确保您的 CLI PHP 版本符合 Laravel 的要求。
缺少 PHP 扩展： composer create-project 命令通常会检查所需的扩展。如果您遇到错误，请检查您的 php.ini 以启用它们。
权限问题： storage 和 bootstrap/cache 目录需要对您的 Web 服务器/PHP 进程具有写入权限。