ThinkPHP6如何配置环境参数_ThinkPHP6配置环境参数隔离【部署】

ThinkPHP 6 的环境参数隔离，靠的不是在代码里写 if-else，也不是根据域名自动判断——它只认 APP_ENV 这个环境变量。而且，这个变量必须由 Web 服务器显式地传递过去，否则框架就会退回到 config/ 根目录下的配置，你连个报错提示都看不到。

为什么 .env 里改了 APP_ENV 却没生效？

很多开发者会遇到一个让人抓狂的问题：在命令行下用 php think optimize:config 测试一切正常，但一旦部署到 Nginx 上，配置就退回到了默认值。原因很简单——CLI 环境能读取 .env 文件，但 FPM 请求不会自动加载它。Nginx 或 Apache 并不会自作主张地把 .env 里的内容注入到 PHP 运行时，你需要明确告诉它该怎么做。

• 常见错误：本地用内置服务器测试得好好的，一上 Nginx 就“失灵”，退回默认配置。
• 根本原因：Nginx 配置里漏掉了 fastcgi_param APP_ENV $app_env; 这一行。
• 验证方法：在控制器里打印一下 $_SERVER['APP_ENV']，如果返回空值，就说明环境变量根本没传过去。
• 正确做法：在 location ~ .php$ 块内加入这一行，并确保 $app_env 已被定义。你可以通过 set $app_env "production"; 来硬编码，或者让它从系统环境变量中继承。

config/APP_ENV/ 目录下该怎么写配置文件？

ThinkPHP 6 不支持在配置文件中写 if (APP_ENV === 'develop') 这样的条件判断。原因很关键：框架在还没读到环境变量的时候，就已经开始加载配置了，此时 APP_ENV 根本不可用。所以，正确的做法是建独立目录。

• 为每个环境创建专属目录：比如 config/develop/ 和 config/production/。
• 文件名必须与根目录保持一致，像 database.php、cache.php 这些。
• 只改差异项：开发库用 'hostname' => '127.0.0.1'，生产库用 'hostname' => 'db-prod.internal'，没必要把整个文件复制一遍。
• 必须警惕的是：生产环境下，一定要删掉 'params' => [PDO::ATTR_EMULATE_PREPARES => true] 这个选项。如果不删，预处理机制就会失效，带来安全隐患。
• 另外，像 APP_URL 或 ASSET_URL 这种变量，不要写在 .env 里。它们应该由 Nginx 的 fastcgi_param 直接注入。

.env 文件本身该怎么管？

.env 文件是一个运行时入口，不是配置源。它的唯一使命，就是给 CLI 和 Web 服务提供初始的环境变量值。一旦你把 .env 提交到 Git，敏感信息就等于裸奔了。

• 立刻执行 echo ".env" >> .gitignore 并提交，这是最快也最有效的防护措施。
• 生产环境禁止用 git clone 来同步 .env，必须由运维人员手动创建。
• 线上的 .env 只保留三项最小集：APP_ENV=production、APP_DEBUG=false、DB_PASSWORD=xxx。越少越安全。
• APP_DEBUG=true 仅用于开发排查，别把它当成环境切换的逻辑开关。
• 最后，runtime 目录必须可写。否则，环境切换后缓存无法重建，旧的配置就会一直残留，让你排查半天都找不出问题。

说到底，最容易被忽略的环节就是 Nginx 没有传 APP_ENV。它不像 APP_DEBUG 那样有兜底行为，缺了就是缺了，框架会直接放弃加载 config/APP_ENV/ 目录，而且连个错误提示都不会给你。这一点，值得每个部署上踩过坑的开发者牢记。