【如何使用PHP的putenv函数来正确设置和管理环境变量？步骤详解】

gitbox 2025-09-03

二、配合getenv与$_ENV使用

设置环境变量后，我们往往需要在程序中读取它。可以使用两种方式：

通过 getenv() 获取

<span><span><span class="hljs-title function_ invoke__">putenv</span></span><span>(</span><span><span class="hljs-string">"APP_DEBUG=true"</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">getenv</span></span><span>(</span><span><span class="hljs-string">"APP_DEBUG"</span></span><span>); </span><span><span class="hljs-comment">// 输出: true</span></span><span>
</span></span>

通过 $_ENV 超全局变量获取

在某些配置下（取决于 php.ini 中 variables_order 的设置），putenv 设置的值会同步到 $_ENV。

<span><span><span class="hljs-title function_ invoke__">putenv</span></span><span>(</span><span><span class="hljs-string">"API_KEY=123456"</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$_ENV</span></span><span>[</span><span><span class="hljs-string">"API_KEY"</span></span><span>]; </span><span><span class="hljs-comment">// 如果启用，输出: 123456</span></span><span>
</span></span>

需要注意的是，不同服务器环境和PHP配置可能影响 $_ENV 的可用性，因此更推荐使用 getenv() 来保证兼容性。

三、在Web应用中的应用场景

区分运行环境

<span><span><span class="hljs-title function_ invoke__">putenv</span></span><span>(</span><span><span class="hljs-string">"APP_ENV=development"</span></span><span>);
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">getenv</span></span><span>(</span><span><span class="hljs-string">"APP_ENV"</span></span><span>) === </span><span><span class="hljs-string">"development"</span></span><span>) {
    </span><span><span class="hljs-title function_ invoke__">error_reporting</span></span><span>(E_ALL);
    </span><span><span class="hljs-title function_ invoke__">ini_set</span></span><span>(</span><span><span class="hljs-string">"display_errors"</span></span><span>, </span><span><span class="hljs-number">1</span></span><span>);
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-title function_ invoke__">ini_set</span></span><span>(</span><span><span class="hljs-string">"display_errors"</span></span><span>, </span><span><span class="hljs-number">0</span></span><span>);
}
</span></span>

数据库配置管理

<span><span><span class="hljs-title function_ invoke__">putenv</span></span><span>(</span><span><span class="hljs-string">"DB_HOST=127.0.0.1"</span></span><span>);
</span><span><span class="hljs-title function_ invoke__">putenv</span></span><span>(</span><span><span class="hljs-string">"DB_USER=root"</span></span><span>);
</span><span><span class="hljs-title function_ invoke__">putenv</span></span><span>(</span><span><span class="hljs-string">"DB_PASS=secret"</span></span><span>);

</span><span><span class="hljs-variable">$pdo</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title function_ invoke__">PDO</span></span><span>(
    </span><span><span class="hljs-string">"mysql:host="</span></span><span> . </span><span><span class="hljs-title function_ invoke__">getenv</span></span><span>(</span><span><span class="hljs-string">"DB_HOST"</span></span><span>),
    </span><span><span class="hljs-title function_ invoke__">getenv</span></span><span>(</span><span><span class="hljs-string">"DB_USER"</span></span><span>),
    </span><span><span class="hljs-title function_ invoke__">getenv</span></span><span>(</span><span><span class="hljs-string">"DB_PASS"</span></span><span>)
);
</span></span>

敏感信息保护
将API密钥、第三方服务的Token等存储在环境变量中，避免硬编码在代码里，增强安全性。

四、注意事项与最佳实践

作用范围
- putenv 设置的环境变量仅对当前PHP进程有效，不会持久化到系统环境中。
- 如果想让环境变量在服务器重启后依然有效，应通过操作系统配置文件（如 .bashrc 或 .env 文件）设置。
兼容性
- 在CLI模式和Web模式下表现一致，但某些托管环境可能对 putenv 有限制。
推荐做法
- 使用 .env 文件 + PHP加载器（如 vlucas/phpdotenv 库）统一管理环境变量。
- 在代码中仅通过 getenv 获取变量，避免硬编码。