Laravel环境配置与安装步骤

本文是一份面向初学者的 Laravel 环境配置与安装实战指南，以 macOS Sonoma 系统为背景，手把手带你完成从检查 PHP 8.1+ 及必备扩展、安装 Composer，到创建项目、配置 Nginx 服务器、设置关键目录权限及生成安全密钥的全流程；无论你是否熟悉 PHP 开发环境，只要跟着清晰步骤操作，就能快速搭建起一个可运行的 Laravel 开发环境，为后续项目开发打下坚实基础。

如果您正在准备搭建 Laravel 开发项目，但不确定系统是否满足框架的运行需求，或者不清楚如何正确安装和配置环境，以下是详细的指导步骤帮助您完成 Laravel 的环境配置与安装。

本文运行环境：MacBook Pro，macOS Sonoma

一、确认系统环境要求

Laravel 对服务器环境有一定的依赖，确保您的设备满足最低要求是成功安装的前提。主要涉及 PHP 版本、扩展支持以及 Composer 工具。

1、检查当前 PHP 版本，在终端中执行 php -v，确保版本不低于 8.1。

2、验证必要扩展是否启用，包括 OpenSSL、PDO、Mbstring、Tokenizer、XML 和 Ctype 扩展。

3、若缺少扩展，请根据操作系统修改 php.ini 配置文件并取消对应扩展前的分号注释。

二、安装 Composer 依赖管理工具

Composer 是 PHP 的包管理器，Laravel 通过它来加载核心组件和第三方库。必须先安装 Composer 才能继续 Laravel 的初始化。

1、访问官网 getcomposer.org 下载安装脚本，或在终端运行 curl -sS https://getcomposer.org/installer | php。

2、将 composer.phar 移动至系统可执行路径，例如 sudo mv composer.phar /usr/local/bin/composer。

3、测试安装是否成功，输入 composer --version 查看返回信息。

三、创建 Laravel 项目

使用 Composer 创建新的 Laravel 项目会自动下载框架文件并配置基础结构目录。

1、在命令行中运行 composer create-project laravel/laravel project-name，其中 project-name 为自定义项目名称。

2、等待依赖安装完成后，进入项目根目录 cd project-name。

3、启动内置开发服务器，执行 php artisan serve，默认监听 http://localhost:8000。

四、配置 Web 服务器（Nginx）

在生产环境中推荐使用 Nginx 作为 Web 服务器，需正确设置文档根目录和重写规则以支持路由访问。

1、将 Nginx 的 root 指向 Laravel 项目的 public 目录，例如 /var/www/project-name/public。

2、添加 location 块处理所有请求转发到 index.php，配置如下：

location / { try_files $uri $uri/ /index.php?$query_string; }

3、重启 Nginx 服务使配置生效：sudo nginx -s reload。

五、设置文件权限与环境变量

Laravel 在运行过程中需要对 storage 和 bootstrap/cache 目录进行读写操作，同时利用 .env 文件管理配置。

1、授予 storage 和 bootstrap/cache 可写权限：chmod -R 775 storage bootstrap/cache。

2、复制环境配置模板：cp .env.example .env。

3、生成应用密钥：php artisan key:generate，该操作会自动填充 APP_KEY。

文中关于PHP配置的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Laravel环境配置与安装步骤》文章吧，也可关注golang学习网公众号了解相关技术文章。