PHPDocker数据库连接配置教程

本文深入解析了PHP容器在Docker环境中连接MySQL数据库的核心配置要点：强调必须使用Docker Compose中定义的服务名（如db）而非localhost进行连接，通过环境变量安全传递数据库参数避免硬编码，并借助健康检查与depends_on确保PHP容器在MySQL完全就绪后才启动；同时提醒需正确配置MySQL用户权限（允许'%'远程访问）、绑定地址（bind-address=0.0.0.0）及认证插件兼容性，真正实现稳定、可复现、生产就绪的容器化数据库连接。

在 PHP Docker 环境中连接数据库，关键不是改 PHP 代码，而是让容器之间能通信、环境变量传得准、配置里用对服务名。

用服务名代替 localhost

Docker Compose 启动的多个服务（如 php、mysql）默认在同一个自定义网络里，彼此可通过 服务名 直接访问。PHP 容器里不要写 localhost:3306 或 127.0.0.1:3306，而应写 MySQL 服务在 docker-compose.yml 中定义的名字，比如：

• 若 MySQL 服务名为 db，则 PDO 连接 DSN 应为：mysql:host=db;port=3306;dbname=test
• 若服务名为 mysql，就写 host=mysql

通过环境变量注入数据库配置

避免把数据库地址、密码硬编码进 PHP 文件。推荐在 docker-compose.yml 中用 environment 或 .env 文件传参，并在 PHP 中读取：

• docker-compose.yml 示例片段：

services:
  php:
    build: ./php
    environment:
      - DB_HOST=db
      - DB_PORT=3306
      - DB_NAME=test
      - DB_USER=root
      - DB_PASS=password

• PHP 中获取方式（如使用 PDO）：

$host = $_ENV['DB_HOST'] ?? 'db';
$port = $_ENV['DB_PORT'] ?? '3306';
$dbname = $_ENV['DB_NAME'] ?? 'test';
$user = $_ENV['DB_USER'] ?? 'root';
$pass = $_ENV['DB_PASS'] ?? '';
$dsn = "mysql:host=$host;port=$port;dbname=$dbname;charset=utf8mb4";
$pdo = new PDO($dsn, $user, $pass, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
]);

确认 MySQL 容器已就绪再启动 PHP

PHP 容器启动时，MySQL 可能还没完全初始化好，直接连接会报 “Connection refused”。可采取以下任一方式规避：

• 在 PHP 启动脚本中加简单重试逻辑（如用 while ! mysqladmin ping -h db -u root --password=password --silent; do sleep 2; done）
• 使用 depends_on + 自定义健康检查（推荐）：

services:
  db:
    image: mysql:8.0
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "--password=password"]
      interval: 20s
      timeout: 10s
      retries: 10
  php:
    build: ./php
    depends_on:
      db:
        condition: service_healthy

检查 MySQL 用户权限与绑定地址

MySQL 容器默认只允许本地 root 登录，且可能绑定到 127.0.0.1。需确保：

• 用户允许从其他主机连接（如创建用户时用 'root'@'%'，或执行 GRANT ALL ON *.* TO 'root'@'%' IDENTIFIED BY 'password'; FLUSH PRIVILEGES;）
• MySQL 配置中禁用 skip-networking，并设置 bind-address = 0.0.0.0（Docker 官方镜像通常已默认满足）
• 如果用的是 MySQL 8+，注意默认认证插件是 caching_sha2_password，PHP 7.4+ 原生支持；旧版 PHP 可改用 mysql_native_password 插件创建用户

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。