PHP容器连接MySQL需用服务名而非localhost，通过环境变量传参，确保MySQL健康检查通过后再启动PHP，并配置用户权限允许远程访问及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'] ?? ''; <p>$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免费学习笔记（深入）”；
- 在 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插件创建用户
