php 8.1 连不上远程 mysql 主因是 mysql 服务端未开放远程访问：需将 bind-address 改为 0.0.0.0 并重启服务，创建指定 ip 的用户并授权，同时放行防火墙及云服务器安全组的 3306 端口。

PHP 8.1 连不上远程 MySQL，90% 不是代码问题，而是 MySQL 服务端压根没“开门”——mysqli_connect() 报 Connection refused 或 Host 'x.x.x.x' is not allowed to connect，得先查服务、端口、权限三层，再动 PHP 代码。

MySQL 服务是否监听 3306 并允许外部连接

PHP 8.1 自身不拦连接，但 MySQL 默认只听 127.0.0.1。如果 bind-address = 127.0.0.1（常见于 /etc/mysql/mysql.conf.d/mysqld.cnf），那它连本机局域网 IP 都不认，更别说远程 PHP 了。

• 确认当前绑定地址：sudo grep bind-address /etc/mysql/mysql.conf.d/mysqld.cnf，必须是 0.0.0.0 或具体 PHP 服务器 IP
• 改完立即重启：sudo systemctl restart mysql
• 验证是否真在监听：ss -tlnp | grep :3306，输出里要有 *:3306，不是 127.0.0.1:3306
• 别信 ping 通就等于能连——ping 走 ICMP，MySQL 走 TCP/3306，完全两码事

用户权限是否匹配“从哪来 + 用谁连”

MySQL 的 user@host 是精确匹配项。'app_user'@'localhost' 和 'app_user'@'127.0.0.1' 是两个账号；'app_user'@'%' 看似方便，但在腾讯云/GCP 上常被安全组直接拦截，实际无效。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 登录 MySQL 后执行：SELECT User, Host FROM mysql.user WHERE User = 'your_user';，看返回的 Host 值是不是你 PHP 连接时用的 IP（比如 203.0.113.45）
• 创建用户务必带来源 IP：CREATE USER 'app_user'@'203.0.113.45' IDENTIFIED BY 'strong_password';
• 授权范围最小化：GRANT SELECT, INSERT ON mydb.* TO 'app_user'@'203.0.113.45';，别用 GRANT ALL ON *.*
• 执行完必须 FLUSH PRIVILEGES;，否则权限不生效

防火墙、安全组、SELinux 是否悄悄丢包

本地 ss -tlnp 显示 3306 在监听，systemctl status mysql 显示 active，但 PHP 还是 Connection refused？八成卡在这一层。

• Linux 防火墙检查：sudo ufw status（Ubuntu）或 sudo firewall-cmd --list-ports（CentOS），确保 3306/tcp 入站放行
• 云服务器（阿里云/腾讯云/AWS）必须进控制台 → 安全组 → 添加入方向规则：端口 3306，协议 TCP，源 IP 填 PHP 服务器公网 IP 或段（如 203.0.113.45/32）
• Docker 场景下，PHP 容器里写 localhost 是连自己，不是宿主机 MySQL；该用 host.docker.internal（Mac/Windows）或宿主机真实内网 IP（Linux）
• SELinux 临时关闭验证：sudo setenforce 0；若恢复后仍要连，需配策略而非永久关

PHP 8.1 连接代码中容易错的细节

PHP 8.1 默认启用 mysqli 扩展，但参数填错或字符集漏设，会导致连上却读不出中文、或预处理失败。

• 别用 localhost 当主机名——它在部分系统走 Unix socket，远程必须用 IP：$conn = mysqli_connect('203.0.113.45', $user, $pass, $db, 3306);
• 显式指定字符集，避免乱码：mysqli_set_charset($conn, 'utf8mb4');（放在 mysqli_connect() 之后、查询之前）
• PDO 方式注意 DSN 中密码含 @、/ 会解析错误，得用 urlencode() 编码：$dsn = "mysql:host=203.0.113.45;dbname=mydb;charset=utf8mb4";
• 测试时先简化：去掉数据库名，只连服务端，看 mysqli_connect() 返回是否为 resource；再加库名，再加查询

最常被跳过的一步：改完 MySQL 配置、建完用户、开了防火墙，却忘了重启 mysql 服务——sudo systemctl restart mysql 这条命令，少一次就全白搭。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！