在docker环境中，php容器连接mysql容器的核心做法是确保两者加入同一个自定义网络，并在php配置中使用mysql容器的服务名作为主机地址。具体而言，需要在`docker-compose.yml`中为两个服务指定相同的`networks`字段，然后在php代码（如pdo或mysqli）中将`host`参数设置为mysql服务的名称而非`localhost`。这样做能利用docker内置的dns解析将服务名映射到正确的内部ip，从而建立稳定的数据库连接。
如何配置Docker Compose实现网络互通
要实现PHP与MySQL的网络互通，必须在`docker-compose.yml`文件中显式定义一个自定义网络，并将两个服务都绑定到该网络上。默认情况下，Docker Compose会自动创建一个桥接网络，但显式声明可以确保网络驱动和DNS行为符合预期。关键在于`networks`字段的层级结构，它位于顶层配置下，并被各个服务引用。
version: '3.8'
services:
php-app:
image: php:8.2-apache
volumes:
- ./src:/var/www/html
networks:
- app-network
depends_on:
- mysql-db
mysql-db:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: rootpassword
MYSQL_DATABASE: mydb
networks:
- app-network
networks:
app-network:
driver: bridge
上述配置创建了一个名为`app-network`的桥接网络。`php-app`服务挂载了本地源码目录，并依赖`mysql-db`启动。`mysql-db`服务设置了环境变量以初始化数据库。两个服务通过`networks`指令连接到同一网络，使得它们可以通过服务名互相发现。运行`docker compose up`后，PHP容器内的进程即可通过DNS解析访问MySQL容器。
立即学习“PHP免费学习笔记（深入）”；
Docker Hub (hub.docker.com)。此技能适用于所有 Docker Hub 操作，包括读取、创建、更新和删除数据。只要任务涉及 Docker Hub，就使用此技能。
PHP代码中如何正确设置连接参数
在PHP代码中连接MySQL时，必须使用MySQL容器的服务名作为主机地址，严禁使用`127.0.0.1`或`localhost`。因为`localhost`在PHP的PDO或mysqli扩展中通常会尝试通过Unix socket连接，而Docker容器间通信基于TCP/IP，这会导致连接失败。正确的做法是将主机名设为`docker-compose.yml`中定义的MySQL服务名，例如`mysql-db`。
<?php
$host = 'mysql-db'; // MySQL容器的服务名
$dbname = 'mydb';
$username = 'root';
$password = 'rootpassword';
try {
$pdo = new PDO("mysql:host={$host};dbname={$dbname};charset=utf8mb4", $username, $password);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
echo "Connected successfully";
} catch (PDOException $e) {
die("Connection failed: " . $e->getMessage());
}
?>
这段代码展示了标准的PDO连接方式。变量`$host`被硬编码为`mysql-db`，这与Compose文件中的服务名一致。如果网络配置正确，`new PDO(...)`调用将成功建立TCP连接。若出现`SQLSTATE[HY000] [2002] Connection refused`错误，通常意味着主机名错误或网络未连通。若出现`Can't connect to local MySQL server through socket`，则说明误用了`localhost`导致尝试Socket连接。确保使用服务名可避免此类问题。
当MySQL容器重启后PHP连接是否会中断
当MySQL容器重启后，其内部IP地址可能会发生变化，但由于使用了自定义网络和DNS服务名解析，PHP容器无需重新配置即可继续连接。Docker的嵌入式DNS服务器会动态更新服务名对应的IP记录。只要MySQL服务在Compose文件中保持相同的名称，且PHP代码中的主机名不变，连接逻辑就不会因IP变动而失效。然而，如果MySQL容器长时间不可用，PHP应用需要处理超时异常。
