通过环境变量区分运行环境，结合配置文件分离与Dotenv组件实现多环境管理。1. 使用getenv()读取APP_ENV决定加载对应配置；2. 将开发、测试、生产配置拆分为独立文件存于config目录；3. 本地通过composer安装vlucas/phpdotenv并创建.env文件模拟环境变量；4. 入口文件中初始化Dotenv加载.env；5. 生产环境由服务器或Docker直接设置环境变量，避免敏感信息泄露；6. 统一配置加载入口，杜绝硬编码，提升部署效率与安全性。
在开发 PHP 网站时，通常会涉及多个运行环境，如本地开发、测试、预发布和生产环境。每个环境的数据库配置、API 地址、调试开关等参数都不同。如果每次部署都要手动修改配置，不仅效率低还容易出错。因此，建立一套统一的多环境配置管理机制非常必要。
使用环境变量区分不同配置
最推荐的方式是通过系统环境变量来标识当前所处环境。PHP 可以通过 $_ENV 或 getenv() 获取环境变量，也可以借助 vlucas/phpdotenv 在开发环境模拟环境变量。
示例：
// index.php 或入口文件中
$env = getenv('APP_ENV') ?: 'development';
switch ($env) {
case 'production':
require_once 'config/production.php';
break;
case 'testing':
require_once 'config/testing.php';
break;
default:
require_once 'config/development.php';
}
配置文件分离 + 自动加载
将不同环境的配置拆分为独立文件，集中存放在 config 目录下，避免混淆。
立即学习“PHP免费学习笔记（深入）”；
- config/development.php —— 开发环境
- config/testing.php —— 测试环境
- config/production.php —— 生产环境
每个文件返回数组格式的配置：
// config/development.php
return [
'db_host' => 'localhost',
'db_name' => 'myapp_dev',
'debug' => true,
'api_url' => 'https://api.dev.example.com'
];
使用 Dotenv 管理本地环境变量（开发推荐）
在本地开发中，不建议直接写死配置。可使用 phpdotenv 组件读取 .env 文件自动设置环境变量。
安装方式：
composer require vlucas/phpdotenv
项目根目录创建 .env 文件：
.env
APP_ENV=development
DB_HOST=localhost
DB_NAME=myapp_dev
DEBUG=true
在入口文件加载 dotenv：
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->safeLoad(); // 加载 .env 文件中的变量
之后即可用 getenv('DB_HOST') 获取值，实现配置解耦。
生产环境通过服务器设置环境变量
线上环境不要使用 .env 文件，应由服务器或容器（如 Docker）直接设置环境变量。
Nginx + PHP-FPM 示例：
fastcgi_param APP_ENV production;
fastcgi_param DB_HOST "prod-db.example.com";
Docker 示例：
environment:
- APP_ENV=production
- DEBUG=false
这样保证敏感信息不会随代码泄露，也便于运维统一管理。
基本上就这些。核心思路是：用环境变量决定配置源，配置文件按环境分离，开发用 .env 模拟，线上靠系统注入。统一入口加载，避免硬编码。简单有效，适合大多数 PHP 项目。
