PHP数据库连接信息放在环境变量实现方案-php教程-PHP中文网

数据库连接信息必须通过环境变量注入而非硬编码，因配置文件暴露会导致敏感信息泄露，且环境变量符合十二要素应用原则，支持多环境隔离与安全分发。

php数据库连接信息放在环境变量实现方案

数据库连接信息必须从代码中剥离，硬编码在 config/database.php 或直接写死在 PDO 构造参数里，等于把锁孔焊死还把钥匙挂在门把手上。

一旦配置文件被意外暴露（比如 Nginx 未禁用 .php 文件源码下载、Git 提交漏加 .gitignore），攻击者 5 秒内就能拿到完整数据库访问权限。更危险的是：团队协作时，开发、测试、生产环境共用同一份配置，容易误连错库、清空线上表。

环境变量的本质是「运行时注入」——它不随代码版本流动，也不参与构建过程，天然满足十二要素应用原则中的「配置即外置」。

这是目前最轻量、兼容性最好的方案，支持 CLI、Apache、PHP 内置服务器，且不依赖 Web 服务器配置。

安装和加载只需两步：

composer require vlucas/phpdotenv

在入口文件（如 index.php 或框架的 bootstrap/app.php）顶部加入：

$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->safeLoad();

safeLoad() 的关键是：没有 .env 文件时不报错，适合生产环境跳过加载（靠系统级环境变量兜底）。

你的 .env 文件示例应长这样：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=dev_app
DB_USERNAME=dev_user
DB_PASSWORD=dev_pass
APP_ENV=local

⚠️ 必须确保该文件已加入 .gitignore；同时建议提交一个 .env.example，只留键名和空值，供新成员快速上手。

DrugBank 数据库

访问并分析来自 DrugBank 数据库的全面药物信息，包括药物属性、相互作用、靶点、通路、化学结构和药理学数据。用于药物数据、药物发现研究、药理学研究、药物-

下载

在 docker-compose.yml 中直接写 - DB_PASSWORD=mypass123 是高危操作——变量会留在镜像层或容器元数据中，docker inspect 一眼可见。

正确做法是用 env_file 引用外部文件，并确保该文件不进 Git：

services:
  php:
    image: php:8.2-fpm
    env_file:
      - .env.prod  # 或 .env.staging
    # 不再写 environment 下的明文 DB_*

此时 PHP 应用仍通过 getenv('DB_HOST') 或 $_ENV['DB_HOST'] 读取，与本地开发完全一致。

额外注意两点：

PHP 容器内需确保 variables_order 包含 E（即启用 $_ENV），检查 phpinfo() 或运行 php -i | grep variables_order
若用 Apache + mod_php，需在虚拟主机中显式 PassEnv DB_HOST DB_PASSWORD，否则 $_ENV 为空

容器化部署时，K8s Secret、Docker Swarm Secrets、AWS ECS Task Definition 或 CI/CD 的 secret 变量，都应映射为容器启动时的原生环境变量。这时 vlucas/phpdotenv 已无作用，getenv() 直接生效。

验证是否生效，可在 PHP 中加一行调试：

var_dump(getenv('DB_HOST'), $_ENV['DB_HOST'] ?? null);

如果两者都为 false 或 null，说明变量根本没注入成功——常见原因有：

真正容易被忽略的点在于：环境变量注入是一次性的，容器启动后无法热更新。哪怕你改了宿主机的 .env.prod，也必须 docker-compose up -d --force-recreate 才生效。这点和配置文件热重载完全不同，得提前在运维流程里卡住。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！

PHP数据库连接信息放在环境变量实现方案