讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

SoundView
SoundView

字幕擦除翻译、配音口型同步

updream

一键生成高质量推广成片

php怎么读取环境变量_env配置与安全使用【说明】

浅磊酱_2011

浅磊酱_2011

发布时间:2026-04-05 22:13:33

|

941人浏览过

|

来源于php中文网

原创

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

php怎么读取环境变量_env配置与安全使用【说明】

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免费学习笔记(深入)”;

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

所以读取时别写 $_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,应通过构建参数注入变量,再由部署平台挂载
实际项目里最容易忽略的是:.env 解析发生在请求生命周期早期,但某些框架(如 Laravel)会在容器启动后才加载它,导致中间件或服务提供者里提前访问变量失败。这种时机错位比语法错误更难排查。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

13324

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

7621

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2295

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

4808

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

5534

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

4351

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

6317

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4982

2023.11.13

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

0

2026.11.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn