PHP连接虚拟机MySQL方法详解

本文深入解析了PHP无法连接虚拟机中MySQL的常见困局，直击网络连通性、MySQL服务配置与用户权限三大核心障碍：必须将MySQL的bind-address改为0.0.0.0或虚拟机真实IP并重启服务，创建带'%'主机域的专用用户并正确授权（MySQL 8+还需注意认证插件兼容性），PHP代码中务必使用虚拟机局域网IP而非localhost，同时开放防火墙3306端口并确保宿主机可通过telnet验证连通性——三者严丝合缝，缺一不可，帮你彻底摆脱“Connection refused”和“Access denied”的反复折腾。

PHP 无法直接连接虚拟机里的 MySQL，不是 PHP 的问题，而是网络连通性、MySQL 权限和配置三者没对齐。

确认虚拟机 MySQL 是否监听外部连接

默认安装的 MySQL（如 Ubuntu 的 mysql-server）通常只绑定 127.0.0.1，拒绝所有来自宿主机的 TCP 连接。

检查方法：

sudo grep -i "bind-address" /etc/mysql/mysql.conf.d/mysqld.cnf

如果输出是 bind-address = 127.0.0.1，必须改成：

• bind-address = 0.0.0.0（允许所有 IP 连入），或
• bind-address = 192.168.x.x（填虚拟机实际网卡 IP，更安全）

改完重启服务：sudo systemctl restart mysql。不重启，配置无效。

给 MySQL 用户授权远程访问权限

MySQL 默认的 root@localhost 用户不能从宿主机（比如 192.168.56.1）登录，必须显式创建或修改用户 host。

在虚拟机内用 MySQL 客户端执行：

CREATE USER 'phpuser'@'%' IDENTIFIED BY 'your_strong_password';<br>GRANT ALL PRIVILEGES ON your_db.* TO 'phpuser'@'%';<br>FLUSH PRIVILEGES;

关键点：

• 'phpuser'@'%' 中的 % 表示任意主机（含宿主机），不能省略或写成 localhost
• 不要直接改 root@localhost 的 host——容易锁死，另建专用用户更稳妥
• 若用的是 MySQL 8+，注意默认认证插件是 caching_sha2_password，PHP 7.4 以下可能不兼容，可加 ALTER USER 'phpuser'@'%' IDENTIFIED WITH mysql_native_password BY '...';

宿主机 PHP 连接时填对 IP 和端口

别用 localhost 或 127.0.0.1 ——那会走宿主机自己的回环，不是连虚拟机。

必须用虚拟机的「真实局域网 IP」，例如：

• VirtualBox：设置为「桥接网卡」或「Host-only 网卡」，查 IP 用 ip a（Ubuntu）或 ifconfig（旧版）
• VMware：确保网络模式为「桥接」或「NAT 模式 + 端口转发」；NAT 下需手动在 VMware 设置里把主机 3307 → 虚拟机 3306 转发
• PHP 连接代码中，$host 填 '192.168.56.101'（虚拟机 IP），不是 'localhost'

示例 PDO 连接：

$pdo = new PDO('mysql:host=192.168.56.101;port=3306;dbname=test', 'phpuser', 'your_strong_password');

防火墙和 SELinux 可能静默拦截

即使 MySQL 配置全对，也可能被拦在半路：

• Ubuntu/Debian：sudo ufw status，若为 active，运行 sudo ufw allow 3306
• CentOS/RHEL：sudo firewall-cmd --list-ports，加规则：sudo firewall-cmd --add-port=3306/tcp --permanent && sudo firewall-cmd --reload
• SELinux（CentOS）：sudo setsebool -P mysqld_connect_any on（允许 mysqld 主动外连，但此处是反向——重点其实是 mysqld_can_network_connect，启用：sudo setsebool -P mysqld_can_network_connect on）

测试是否通：在宿主机终端执行 telnet 192.168.56.101 3306。如果连不上，PHP 必然失败，先解决这个再调代码。

最常卡住的地方不是 PHP 写错，而是虚拟机 MySQL 没放开监听、用户没授权 @'%'、或者宿主机根本 ping 不通那个 IP —— 三者缺一不可，少一个都连不上。

理论要掌握，实操不能落！以上关于《PHP连接虚拟机MySQL方法详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！