应通过环境变量、独立配置目录、主机名映射、Dotenv文件及CLI参数五种方式实现PHP多环境配置切换。具体包括设置APP_ENV变量、按环境加载config子目录、根据HTTP_HOST匹配环境、加载.env.{env}文件，以及命令行--env参数覆盖。
如果您在使用PHP框架开发应用时需要在不同环境间切换配置，但发现配置文件混乱或环境变量无法正确加载，则可能是由于环境标识未明确设置或配置加载逻辑存在缺陷。以下是实现多环境切换的具体步骤：
一、通过环境变量区分环境
利用系统级环境变量（如APP_ENV）控制框架加载对应配置，避免硬编码和手动修改配置文件，确保部署一致性。
1、在服务器或本地终端中设置环境变量：export APP_ENV=development（Linux/macOS）或 set APP_ENV=production（Windows CMD）。
2、在PHP入口文件（如public/index.php）顶部添加：putenv('APP_ENV=' . ($_SERVER['APP_ENV'] ?? 'production'));
立即学习“PHP免费学习笔记（深入）”；
3、读取该变量并加载对应目录下的配置：$env = getenv('APP_ENV') ?: 'production'; require __DIR__ . '/../config/' . $env . '/database.php';
二、使用独立配置文件目录结构
将开发、测试、生产环境的配置分别存放在隔离的子目录中，通过统一入口动态引入，降低误用风险。
1、在config目录下创建三个子目录：development/、testing/、production/。
2、每个子目录内放置相同命名的配置文件，例如database.php、app.php，内容按环境定制。
3、在配置加载器中根据当前环境选择路径：$configPath = __DIR__ . '/config/' . $env . '/';
三、基于主机名自动识别环境
在无环境变量支持的共享主机或容器中，可通过解析当前请求的HTTP_HOST或SERVER_NAME自动匹配环境，减少人工干预。
1、定义主机名映射关系：$hostMap = ['dev.example.com' => 'development', 'test.example.com' => 'testing', 'example.com' => 'production'];
2、获取当前请求主机：$currentHost = $_SERVER['HTTP_HOST'] ?? $_SERVER['SERVER_NAME'] ?? 'localhost';
3、匹配并设置环境：$env = $hostMap[$currentHost] ?? 'development';
四、使用Dotenv加载不同.env文件
借助vlucas/phpdotenv库，为各环境维护独立的.env文件，通过文件名后缀区分，避免敏感信息混入代码库。
1、安装依赖：composer require vlucas/phpdotenv
2、创建多个环境文件：.env.development、.env.testing、.env.production
3、在启动时加载对应文件：$dotenv = Dotenv\Dotenv::createImmutable(__DIR__, '.env.' . $env); $dotenv->load();
五、在CLI命令中指定环境参数
运行Artisan类命令或自定义脚本时，允许通过--env参数覆盖默认环境，便于调试与批量操作。
1、在命令解析逻辑中捕获参数：$env = $argv[array_search('--env', $argv) + 1] ?? 'production';
2、将该值注入配置管理器：Config::setEnvironment($env);
3、确保所有后续配置读取均基于此值进行路径或键值检索：Config::get('database.host');
