ThinkPHP在Docker中读不到.env文件的主因是容器未正确挂载该文件或权限不足，而非框架不支持；应通过volume挂载或环境变量注入，避免硬COPY进镜像，并确认file_exists(ROOT_PATH.'/.env')返回true。
ThinkPHP 在 Docker 中读不到 .env 文件的常见原因
不是 ThinkPHP 不支持 .env，而是 Docker 容器启动时默认不自动加载它——框架只在应用初始化阶段调用 think\Env::load()，而该方法默认只读取项目根目录下的 .env。如果文件没挂载进容器、权限不对、或被 .dockerignore 排除，Env::get() 就始终返回 null。
Dockerfile 里不能靠 COPY .env 到镜像里
硬 COPY .env 进镜像是反模式：不同环境（dev/staging/prod）需要不同配置，镜像该是不可变的。实际部署中应通过 volume 挂载或环境变量注入。
- 构建阶段
COPY .env .会导致敏感信息（如数据库密码）留在镜像层，docker history可直接看到 - 多环境共用一个镜像时，必须重新构建才能换配置，失去容器优势
- ThinkPHP 的
Env::load()默认只在public/index.php或命令行入口中执行一次，且不监听文件变化
正确挂载 .env 到容器并确保可读
用 docker run -v 或 docker-compose.yml 的 volumes 把宿主机的 .env 映射到容器内项目根目录，路径必须完全匹配 ThinkPHP 查找位置（通常是 /var/www/html/.env 或你定义的 APP_PATH/../.env）。
- 确认宿主机
.env文件存在且内容格式正确（DB_HOST=127.0.0.1，不能有空格、中文、引号包裹值） - 挂载路径末尾不要加斜杠：
-v $(pwd)/.env:/var/www/html/.env✅，-v $(pwd)/.env:/var/www/html/.env/❌（会变成目录） - 检查容器内文件权限：
docker exec -it your-app ls -l /var/www/html/.env，确保 web 用户（如 www-data）有读权限 - 如果用 Swoole 或 Worker 模式，需重启服务进程才能重载
.env，因为配置已在启动时缓存
替代方案：用 Docker 原生环境变量覆盖 .env
ThinkPHP 支持「环境变量 > .env」优先级，只要容器启动时传入 DB_HOST=192.168.10.10 这类变量，Env::get('DB_HOST') 就会直接返回它，跳过文件读取——这对 CI/CD 和 Secret 管理更安全。
立即学习“PHP免费学习笔记（深入）”；
- 在
docker-compose.yml中写：environment: - DB_HOST=192.168.10.10 - APP_DEBUG=true
- 注意命名一致性：ThinkPHP 默认将环境变量名转为小写并用下划线分隔，
APP_DEBUG对应env('APP_DEBUG')，但app_debug不生效 - 若使用
php-fpm，需在www.conf里显式开启clear_env = no，否则 PHP-FPM 会清空所有非白名单环境变量
真正容易被忽略的是：ThinkPHP 的 Env::load() 不报错也不提示文件缺失，它静默失败。调试时别只看 var_dump(Env::get('DB_NAME'))，先 var_dump(file_exists(ROOT_PATH . '.env')) 确认文件是否真在容器里。
