PHP环境区分关键在于APP_ENV必须在PHP启动前由服务器（Nginx/Apache）、Docker或CLI前置设置，合法值仅dev/test/prod小写；.env仅限开发，生产须禁用并验证getenv('APP_ENV')为prod。
PHP 里区分开发与生产环境，关键不在写多少判断逻辑，而在于 APP_ENV 是否在 PHP 启动前被正确设置 —— 它决定了配置加载路径、调试开关是否生效、甚至错误是否暴露给用户。
APP_ENV 必须在 PHP 启动前设置，否则 .env 文件可能被跳过
ThinkPHP 和多数现代 PHP 框架（如 Laravel）都依赖 APP_ENV 决定加载哪个配置目录（config/dev/ 或 config/prod/）。但这个变量如果是在 PHP 脚本里用 putenv() 或 $_ENV['APP_ENV'] = 'prod' 设置的，已经太晚了。
- Nginx 下必须加
fastcgi_param APP_ENV production;到 server 或 location 块中，且确保它出现在include fastcgi.conf;之后 - Apache 下用
SetEnv APP_ENV production，放在.htaccess或虚拟主机配置里 - Docker 中通过
environment:或env_file:注入，不能只靠.env文件 - CLI 运行时（如
php think optimize:config）必须前置设置：APP_ENV=production php think optimize:config
常见现象：.env 里写了 APP_DEBUG=true，但页面不显示错误 —— 很大概率是 APP_ENV 没设或设成了 dev 以外的值（比如 development），导致框架压根没加载 config/dev/app.php 里的调试配置。
env() 函数读取变量时，默认值不是可选，而是必须考虑的兜底
ThinkPHP 的 env('DB_HOST', '127.0.0.1') 看似只是“提供默认值”，实则承担着安全和健壮性责任：一旦 APP_ENV 未设、.env 不存在、或变量名拼错，env() 就会返回 null（而非抛错），后续数据库连接直接失败。
立即学习“PHP免费学习笔记（深入）”；
- 所有敏感字段（
DB_PASS、API_KEY）必须配默认值，哪怕设为''，避免null导致类型错误 - 布尔型变量别直接用
env('APP_DEBUG')，应写成env('APP_DEBUG', false)—— 字符串'false'不等于布尔false -
env()读的是大写键名，.env里写db_host=localhost是无效的，必须是DB_HOST=localhost
本地开发用 .env，生产环境必须禁用 .env 文件读取
.env 文件只适合本地或 CI 流水线临时注入，绝不能出现在生产服务器上。ThinkPHP 6+ 在 App::init() 阶段才加载 .env，且仅当系统级 APP_ENV 未预设时才 fallback 使用它 —— 这个 fallback 行为本身就是安全隐患。
- 生产环境部署后，立刻删掉项目根目录下的
.env文件（或用chmod 000 .env锁死） - 确认
phpinfo()中$_SERVER['APP_ENV']显示为production，而不是空或local - 若用
vlucas/phpdotenv，不要在生产入口文件中调用$dotenv->load()；改用 Web 服务器注入环境变量 -
.env中含特殊字符（如@、!、空格）必须用单引号包裹：DB_PASSWORD='mypass@2026!'
APP_ENV 的合法值只有三个小写字符串：dev / test / prod
ThinkPHP 不识别 development、staging、production 这类常见命名，也不接受大写。写错就等于没设 —— 框架会静默 fallback 到 config/ 根目录，而那里通常只有基础配置，没有环境专属逻辑。
- 入口文件
public/index.php顶部不能出现define('APP_ENV', 'prod');—— 这是常量，不是环境变量，框架不认 - 必须用系统级方式设置：
export APP_ENV=prod（shell）、fastcgi_param APP_ENV prod;（Nginx） - 检查当前生效值最准的方式是打印
getenv('APP_ENV')，而不是看.env内容 - 测试环境建议统一用
test，避免和dev混淆；CI 流水线构建镜像时，固定写死prod
最容易被忽略的一点：环境切换不是改一个变量就完事，它牵动配置加载顺序、日志级别、缓存策略、甚至路由行为。确认 APP_ENV 正确只是第一步，紧接着要验证 config/<code>APP_ENV/database.php 是否真被加载、APP_DEBUG 是否按预期启停、以及错误页面是否返回 500 而非堆栈。
