ThinkPHP5框架怎么连接远程MySQL数据库-ThinkPHP-PHP中文网

thinkphp5连不上远程mysql主因是mysql未监听外网：需将bind-address设为0.0.0.0或指定ip，创建限定ip的专用用户（如'tp_app'@'192.168.1.100'），tp5配置中hostname填公网地址、charset必须为utf8mb4、hostport显式设3306。

thinkphp5框架怎么连接远程mysql数据库

MySQL服务端没监听外网，TP5连不上不是代码问题

ThinkPHP5连不上远程MySQL，90%的情况跟Db::connect()写得对不对无关，而是MySQL压根没在等你连——它默认只监听127.0.0.1，外部请求直接被丢弃。

必须确认MySQL正在监听通配地址：

编辑配置文件（常见路径：/etc/mysql/mysql.conf.d/mysqld.cnf 或 /etc/my.cnf）
找到 bind-address 行，改为：bind-address = 0.0.0.0（若只允许某台PHP服务器访问，可填其公网IP，更安全）
重启服务：sudo systemctl restart mysql
验证是否生效：sudo netstat -tlnp | grep :3306，输出中应含 *:3306，而非 127.0.0.1:3306

不能用 root@'%' 授权，否则云平台直接拦截

很多教程教你在MySQL里执行 UPDATE user SET host = '%' WHERE user = 'root'，这在腾讯云、阿里云、GCP上根本行不通——云平台安全组会拒绝这种宽泛授权，MySQL 8+ 的严格模式也会报错。

正确做法是显式创建限定来源IP的用户：

登录数据库服务器本地执行：mysql -u root -p

运行（把 192.168.1.100 换成你的TP5应用服务器公网IP）：

CREATE USER 'tp_app'@'192.168.1.100' IDENTIFIED BY 'strong_password_2026';<br>GRANT SELECT, INSERT, UPDATE ON mydb.* TO 'tp_app'@'192.168.1.100';<br>FLUSH PRIVILEGES;

切勿授 ALL PRIVILEGES；也别用 'tp_app'@'%'，除非你明确需要任意IP连接

TP5的 database.php 配置必须显式声明 charset 和 hostport

TP5不支持在DSN里传密码或端口，所有参数必须拆进数组；远程连接时，charset 必须设为 utf8mb4（不是 utf8），否则中文存入可能乱码或截断；hostport 也建议显式写上 3306，避免某些环境 fallback 失败。

btpanel phpsite 宝塔面板PHP网站

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

下载

示例配置（application/database.php）：

'hostname' => 'your.mysql.public.ip',<br>'database' => 'mydb',<br>'username' => 'tp_app',<br>'password' => 'strong_password_2026',<br>'hostport' => '3306',<br>'charset' => 'utf8mb4',<br>'prefix' => ''

注意：dsn 字段留空，TP5会自动拼接；若填了反而可能覆盖关键参数。

连接失败时优先检查网络层和权限层，别急着改PHP代码

当 Db::connect() 报错如 Host 'x.x.x.x' is not allowed to connect 或直接超时，说明请求根本没进MySQL进程。此时该查的不是TP5配置，而是：

从TP5服务器执行：telnet your.mysql.public.ip 3306，看是否能通（不通就卡在防火墙/安全组）
确认MySQL服务器防火墙放行了3306（sudo ufw allow 3306 或云平台安全组规则）
确认创建的用户确实匹配来源IP（SELECT host,user FROM mysql.user;）
如果MySQL启用了强制SSL，TP5配置里还得加 'params' => [\PDO::MYSQL_ATTR_SSL_CA => '/path/to/ca.pem']

远程数据库连接的本质是「网络 + 权限 + 编码」三重校验，少一环都会静默失败，而TP5报错信息往往不暴露底层原因。