Laravel 安装与环境配置详细教程

Laravel 是目前最受欢迎的 PHP 框架之一，以其优雅的语法和强大的功能，成为开发 Web 应用程序的首选工具。本教程将为你详细介绍如何在不同环境下安装 Laravel，并完成基础配置，帮助你快速启动第一个 Laravel 项目。

🌟 一、Laravel 安装前的准备

在安装 Laravel 之前，确保你的系统已满足以下基本要求：

✅ 1. PHP 版本要求

• Laravel 9 需要 PHP 8.0 或以上

• Laravel 10 需要 PHP 8.1 或以上

你当前使用的 PHP 版本是 PHP 7.4.33，可以选择安装 Laravel 8.x 或之前的版本。

✅ 2. 必要的 PHP 扩展

Laravel 需要以下 PHP 扩展支持：

• BCMath – 用于大整数处理

• Ctype – 字符类型处理

• Fileinfo – 文件类型检查

• JSON – JSON 数据处理

• Mbstring – 多字节字符串处理

• OpenSSL – 安全加密通信

• PDO – 数据库操作

• Tokenizer – 标记解析

• XML – XML 解析

✅ 3. 安装 Composer（PHP 包管理工具）

Laravel 通过 Composer 管理依赖包。

在 Windows 上安装 Composer

1. 访问 https://getcomposer.org 下载最新的安装程序

2. 下载并安装 Composer

3. 验证安装：
   composer -V

在 Linux/Mac 上安装 Composer

1. 下载 Composer 安装脚本：
   curl -sS https://getcomposer.org/installer | php

2. 将 Composer 移动到系统路径：
   sudo mv composer.phar /usr/local/bin/composer

🚀 二、安装 Laravel

🛠️ 方法 1：使用 Composer 创建项目

使用 Composer 直接创建一个新的 Laravel 项目：
composer create-project --prefer-dist laravel/laravel my-laravel-app

• my-laravel-app 是项目名称，可根据需要修改

• --prefer-dist 选项表示下载预打包版本，速度更快

🛠️ 方法 2：使用 Laravel Installer 创建项目

1. 首先全局安装 Laravel 安装器：
   composer global require laravel/installer

2. 将 Composer 全局路径添加到系统环境变量：

• Windows：在「系统属性」→「高级」→「环境变量」中配置 C:\Users\<YourUsername>\AppData\Roaming\Composer\vendor\bin

• Linux/Mac：在 ~/.bashrc 或 ~/.zshrc 文件中添加：
  export PATH="$PATH:$HOME/.composer/vendor/bin"

3. 创建新项目：
   laravel new my-laravel-app

🔥 三、配置 Laravel 环境

🌍 1. 设置环境文件（.env）

Laravel 使用 .env 文件来管理环境配置。

在项目根目录下创建 .env 文件：
cp .env.example .env

修改 .env 文件中的数据库配置：

makefile复制编辑APP_NAME=MyLaravelApp  
APP_ENV=local  
APP_KEY=  
APP_DEBUG=true  
APP_URL=http://localhost  

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

👉 常见配置项：

🔑 2. 生成应用密钥

生成 Laravel 应用的加密密钥：
php artisan key:generate

执行后会在 .env 文件中生成类似于：

ini复制编辑APP_KEY=base64:yTfDgSxM/6wAe6v0oOz9THC3frdF6uUzHwtCl7+5pjA=

🌐 3. 设置目录权限

设置 storage 和 bootstrap/cache 目录的权限，确保 Laravel 有权限写入：
chmod -R 775 storage bootstrap/cache

🚀 四、启动 Laravel 服务

1. 通过 Artisan 命令启动开发服务器：
   php artisan serve

2. 在浏览器中访问：
   http://127.0.0.1:8000

如果出现端口冲突，可以修改端口：
php artisan serve --port=8080

🎯 五、常见配置优化

🔹 1. 配置时区与本地化

在 config/app.php 文件中修改：

ini复制编辑'timezone' => 'Asia/Shanghai',  
'locale' => 'zh-CN',

🔹 2. 配置调试模式

在 .env 文件中设置：

ini复制编辑APP_DEBUG=true

🔹 3. 设置缓存与 Session

在 .env 文件中设置：

ini复制编辑SESSION_DRIVER=file  
CACHE_DRIVER=file

👉 可选驱动包括：file、database、redis、memcached

💡 六、安装完成后目录结构解析

bash复制编辑my-laravel-app  
├── app/                # 核心应用代码  ├── bootstrap/          # 框架引导文件  ├── config/             # 配置文件  ├── database/           # 数据迁移、种子、模型工厂  ├── public/             # Web 入口文件  ├── resources/          # 视图、CSS、JavaScript  ├── routes/             # 路由定义  ├── storage/            # 缓存、日志、上传文件  ├── tests/              # 测试代码  ├── vendor/             # Composer 依赖包  └── .env                # 环境配置文件

🚀 七、安装常见问题及解决方案

❓ 1. 安装失败 - PHP 版本不匹配

报错信息：
Your PHP version does not satisfy that requirement

✅ 解决方法：

• 升级 PHP 版本

• 如果无法升级，安装 Laravel 8.x 版本

❓ 2. 权限问题

报错信息：
Permission denied

✅ 解决方法：
chmod -R 775 storage bootstrap/cache

❓ 3. 启动后 404 或其他 HTTP 错误

✅ 解决方法：

• 确认 .env 中的 APP_URL 配置正确

• 清除缓存：
  php artisan config:clear
php artisan route:clear

🌟 总结：快速安装 Laravel，启动你的第一个项目！

通过本文的详细指南，你已完成 Laravel 的安装与环境配置。接下来，你可以开始配置路由、创建控制器和模型，搭建完整的 Web 应用。

👉 下一步推荐阅读：

• Laravel 路由定义与管理

• Laravel 控制器与模型用法