PHP原生不支持读取.env文件,必须使用vlucas/phpdotenv库;需调用load()加载,优先用getenv()读取,.env文件严禁提交至Git,生产环境应改用系统级环境变量。

PHP 读取 .env 文件要用 vlucas/phpdotenv,原生不支持
PHP 自身没有内置加载 .env 文件的机制,$_ENV 或 getenv() 只能读系统级环境变量,不是项目根目录下的 .env 文件。直接写 require '.env'; 会报错或被当成 PHP 代码执行——这是新手最常踩的坑。
标准做法是用社区广泛验证的 vlucas/phpdotenv 库,它按规范解析键值、处理引号和注释,并安全注入到 $_ENV 和 $_SERVER 中:
composer require vlucas/phpdotenv
初始化时必须显式调用 load()(v5+ 版本):
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__); $dotenv->load();
-
createImmutable()更安全,禁止后续修改已加载变量 - 路径传
__DIR__是常见误配点:如果.env不在__DIR__下,要手动指定父目录,比如dirname(__DIR__) - 别在 CLI 和 Web 共用同一份
load()调用——CLI 环境可能已有冲突变量,建议按入口隔离加载
getenv() 和 $_ENV 行为不一致,优先用 getenv()
v5+ 的 phpdotenv 默认只写入 $_ENV,但 PHP 配置 variables_order 若不含 E,$_ENV 就为空;而 getenv() 总能读到已设的环境变量,更可靠。
立即学习“PHP免费学习笔记(深入)”;
所以读取时别写 $_ENV['DB_HOST'],改用:
$host = getenv('DB_HOST') ?: 'localhost';
-
getenv()返回false而非null或空字符串,用?:判断最稳妥 - 若需类型强制(如布尔),不能依赖
.env里的true/false字符串,得自己转换:filter_var(getenv('DEBUG'), FILTER_VALIDATE_BOOLEAN) -
putenv()设置的变量对getenv()可见,但不会自动同步进$_ENV,混用易出错
.env 文件绝不能提交到 Git,且要排除敏感值硬编码
.env 是开发配置载体,不是部署方案。一旦把数据库密码、API 密钥提交到仓库,就等于公开泄露——很多安全扫描工具第一件事就是搜 password= 或 key=。
必须做三件事:
- 把
.env加进.gitignore,并确认没被意外 track 过(用git rm --cached .env清理) - 提供
.env.example,只含占位符(如DB_PASSWORD=your_password_here),不带真实值 - 生产环境禁用
phpdotenv,改用系统级环境变量(如 Docker 的environment:、Nginx 的fastcgi_param),避免文件 I/O 和解析开销
多环境配置别靠多个 .env 文件拼接,用 override 模式更可控
有人想搞 .env.local 覆盖 .env,或按环境切 .env.production,但 phpdotenv 默认不支持自动加载后缀文件。强行用 createMutable() + 多次 load() 容易覆盖顺序混乱,比如 APP_DEBUG=true 在 .env 里是 false,结果被 .env.local 错误覆盖成 true 上了生产。
正确方式是启用 override 并按确定顺序加载:
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__, ['.env', '.env.local']); $dotenv->load();
- 数组中越靠后的文件,优先级越高(
.env.local覆盖.env) - 所有文件都必须存在,缺一个就报错——用
createUnsafeImmutable()可跳过缺失文件,但不推荐 - CI/CD 流水线里不要生成临时
.env,应通过构建参数注入变量,再由部署平台挂载



















