PHP无法连接虚拟机MySQL的根本原因是网络连通性、MySQL权限和配置三者未对齐:需修改bind-address为0.0.0.0或虚拟机IP并重启服务;创建'phpuser'@'%'并授权;PHP代码中使用虚拟机真实IP而非localhost;同时放行防火墙3306端口并确保宿主机能telnet通。

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,必须改成:
立即学习“PHP免费学习笔记(深入)”;
-
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';
GRANT ALL PRIVILEGES ON your_db.* TO 'phpuser'@'%';
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 —— 三者缺一不可,少一个都连不上。











