在Docker容器化部署的场景中，将PHP应用和MySQL数据库分别运行在不同容器中是比较常见的架构方案，此时PHP服务需要正确配置参数才能访问到容器内的MySQL实例。
环境准备
首先确保已经安装好Docker和Docker Compose，我们先通过Docker Compose来创建MySQL和PHP相关的容器，避免手动配置网络的繁琐步骤。以下是docker-compose.yml的配置示例：
version: '3'
services:
mysql:
image: mysql:8.0
container_name: mysql_container
environment:
MYSQL_ROOT_PASSWORD: root123
MYSQL_DATABASE: test_db
MYSQL_USER: test_user
MYSQL_PASSWORD: user123
ports:
- "3306:3306"
volumes:
- mysql_data:/var/lib/mysql
php_app:
image: php:8.2-fpm
container_name: php_container
depends_on:
- mysql
volumes:
- ./php_code:/var/www/html
volumes:
mysql_data:
启动容器后，两个服务会默认加入同一个Docker网络中，容器之间可以通过服务名称互相访问。
PHP连接MySQL的核心配置
PHP连接MySQL需要使用正确的主机地址、端口、账号密码等参数，其中主机地址不能直接写localhost或者127.0.0.1，而是要写Docker Compose中定义的MySQL服务名称，也就是上面的mysql。
使用mysqli扩展连接
首先确保PHP容器已经安装了mysqli扩展，可以在PHP容器中执行以下命令安装：
docker exec -it php_container bash docker-php-ext-install mysqli
连接代码示例：
<?php
// 数据库连接参数
$host = 'mysql'; // 对应docker-compose中mysql服务的名称
$port = 3306;
$user = 'test_user';
$password = 'user123';
$database = 'test_db';
// 创建连接
$conn = new mysqli($host, $user, $password, $database, $port);
// 检查连接是否成功
if ($conn->connect_error) {
die("连接失败: " . $conn->connect_error);
}
echo "PHP成功连接到Docker内的MySQL数据库";
// 执行简单查询测试
$sql = "SELECT VERSION()";
$result = $conn->query($sql);
if ($result->num_rows > 0) {
while($row = $result->fetch_assoc()) {
echo "MySQL版本: " . $row["VERSION()"];
}
}
// 关闭连接
$conn->close();
?>
使用PDO扩展连接
PDO是PHP中更通用的数据库扩展，支持多种数据库类型，连接示例如下：
<?php
$host = 'mysql';
$port = 3306;
$dbname = 'test_db';
$user = 'test_user';
$password = 'user123';
try {
$dsn = "mysql:host=$host;port=$port;dbname=$dbname;charset=utf8mb4";
$pdo = new PDO($dsn, $user, $password);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
echo "PDO方式成功连接Docker内的MySQL数据库";
// 测试查询
$stmt = $pdo->query("SELECT DATABASE()");
$result = $stmt->fetch(PDO::FETCH_ASSOC);
echo "当前连接的数据库: " . $result["DATABASE()"];
} catch (PDOException $e) {
die("连接失败: " . $e->getMessage());
}
?>
常见问题排查
- 连接超时：检查Docker容器是否正常运行，执行
docker ps查看mysql_container和php_container是否在运行中 - 访问拒绝：确认MySQL的用户权限是否正确，是否允许指定用户从PHP容器所在的网络访问，必要时可以在MySQL容器内执行授权命令
- 未知主机：检查连接参数的host是否写的是Docker Compose中MySQL服务的名称，不要写localhost或者宿主机IP
- 扩展未安装：如果报错提示mysqli或者PDO类不存在，说明PHP容器没有安装对应的扩展，按照上面的步骤安装即可
注意事项
如果是在宿主机上运行PHP脚本，而不是在Docker容器内运行，那么连接MySQL的host需要写宿主机的IP，或者写127.0.0.1，因为此时PHP脚本不在Docker网络中，无法直接通过服务名称访问容器内的MySQL。如果是生产环境，建议把PHP和MySQL都放在Docker网络中，避免将数据库端口直接暴露到宿主机，提升安全性。