Ubuntu如何配置Laravel环境变量

Ubuntu配置Laravel环境变量的详细步骤

1. 准备工作：安装Composer（Laravel依赖管理工具）

Laravel的安装与管理依赖Composer，首先需全局安装Composer：

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

安装完成后，验证Composer版本：

composer --version

2. 配置Composer全局环境变量（可选但推荐）

若需通过laravel命令全局创建项目，需将Composer的vendor/bin目录添加到系统PATH中：

echo 'export PATH=$PATH:~/.config/composer/vendor/bin' >> ~/.bashrc
source ~/.bashrc

验证Laravel命令是否可用：

laravel --version

3. 创建Laravel项目

使用Composer创建新的Laravel项目（以my_project为例）：

laravel new my_project
cd my_project

或通过Composer直接创建：

composer create-project --prefer-dist laravel/laravel my_project
cd my_project

4. 配置.env环境变量文件

Laravel通过.env文件管理环境变量（如数据库连接、应用密钥等）。

• 复制示例文件：Laravel自带.env.example模板，复制生成.env文件：

  cp .env.example .env
  

• 编辑.env文件：使用文本编辑器（如nano）打开.env，修改以下关键变量：

  APP_ENV=local                # 环境类型：local（开发）、production（生产）
  APP_DEBUG=true               # 调试模式：开发设为true，生产设为false
  APP_KEY=base64:xxxxxxxxxxxx  # 自动生成，可通过`php artisan key:generate`刷新
  DB_CONNECTION=mysql          # 数据库驱动（mysql/pgsql/sqlite等）
  DB_HOST=127.0.0.1            # 数据库服务器地址（本地为127.0.0.1）
  DB_PORT=3306                 # 数据库端口（MySQL默认3306）
  DB_DATABASE=my_database      # 数据库名称（需提前创建）
  DB_USERNAME=root             # 数据库用户名（如root）
  DB_PASSWORD=your_password    # 数据库密码（需与数据库用户一致）
  

  注意：APP_KEY是加密会话、Cookie的核心密钥，泄露会导致安全风险，生产环境务必保密。

5. 验证环境变量加载

Laravel启动时会自动加载.env文件中的变量。可通过以下命令查看当前配置：

php artisan env

或在代码中通过env()函数获取变量（如env('APP_ENV')）。

6. 缓存配置（生产环境优化）

生产环境建议缓存配置以提高性能，运行以下命令：

php artisan config:cache

提示：开发阶段无需缓存，修改.env后需清除缓存（php artisan config:clear）使变更生效。

7. 多环境配置（可选）

针对不同环境（如测试、生产），可创建专属.env文件：

cp .env.example .env.testing  # 测试环境
cp .env.example .env.production  # 生产环境

编辑对应文件（如.env.production）调整变量（如关闭调试、修改数据库连接），启动时通过--env参数指定环境：

php artisan serve --env=production

8. 常见问题排查

• 权限问题：确保.env文件可被Web服务器读取（权限设为644）：

  chmod 644 .env
  

• 变量未生效：修改.env后重启Laravel服务（如php artisan serve）或清除配置缓存。

通过以上步骤，即可在Ubuntu上完成Laravel环境变量的配置，确保应用在不同环境中安全、稳定运行。