在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代码中如何正确设置连接参数
在PHP代码中连接MySQL时,必须使用MySQL容器的服务名作为主机地址,严禁使用`127.0.0.1`或`localhost`。因为`localhost`在PHP的PDO或mysqli扩展中通常会尝试通过Unix socket连接,而Docker容器间通信基于TCP/IP,这会导致连接失败。正确的做法是将主机名设为`docker-compose.yml`中定义的MySQL服务名,例如`mysql-db`。
Docker Hub (hub.docker.com)。此技能适用于所有 Docker Hub 操作,包括读取、创建、更新和删除数据。只要任务涉及 Docker Hub,就使用此技能。

<?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应用需要处理超时异常。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










