php 8.3+ 连接 mysql 必须用 mysqli 或 pdo,mysql_connect() 已彻底移除;mysqli 需调用 set_charset('utf8mb4') 显式设字符集,pdo 必须在 dsn 中指定 charset 且传入 attr_errmode_exception;连接成功后须执行 select 1 验证真实可用性。

PHP 最新版(8.3+)连接 MySQL,必须用 mysqli 或 PDO,mysql_connect() 已彻底消失——不是“不推荐”,是根本不存在。写错函数名或漏配关键项,会直接报 Fatal error: Uncaught Error: Call to undefined function mysql_connect() 或静默失败,连错误都看不到。
mysqli_connect() 报 Connection refused 怎么快速定位
这不是 PHP 代码问题,是底层网络或服务没通。常见真实原因:-
MySQL服务根本没运行:Linux 执行sudo systemctl status mysql,macOS 检查brew services list | grep mysql,Windows 看服务里MySQL80是否启动 -
localhost在 macOS 或某些 Docker 环境下走 Unix socket,但 PHP 默认尝试 TCP;换成127.0.0.1更可靠 - MySQL 配置了
bind-address = 127.0.0.1,但你用的是容器 IP(如172.18.0.2)或远程地址——确认my.cnf中bind-address允许该 IP,或设为0.0.0.0(仅限可信内网) - 端口不是 3306:XAMPP 是 3306,MAMP 是 8889,Docker 映射常为 3307;
mysqli_connect()第 5 个参数必须显式传端口,例如mysqli_connect('127.0.0.1', 'root', '', 'test', 3307)
PDO new PDO() 不报错却连不上
PDO 默认不抛异常,连接失败只会返回false,而不会中断流程。这是新手最常卡住的点:
- DSN 字符串里的
charset=utf8mb4必须写在mysql:host=localhost;dbname=test;charset=utf8mb4里,不能靠后续setAttribute()补救 -
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION必须作为第 4 个参数传进new PDO()构造函数——如果连接阶段就失败(比如 host 错、密码错),对象都创建不了,setAttribute()根本没机会执行 - 密码含
@、/、:会导致 DSN 解析断裂;要么 URL 编码(如rawurlencode($pass)),要么改用环境变量读取
mysqli 面向对象写法中 utf8mb4 怎么设才生效
new mysqli() 构造时传 charset=utf8mb4 是无效的。mysqli 的字符集必须单独调用方法设置:
- 创建连接后立刻执行
$mysqli->set_charset('utf8mb4') - 必须在任何
query()或prepare()前调用,放在查询后面等于没设 - 要检查返回值:
if (!$mysqli->set_charset('utf8mb4')) { die('字符集设置失败'); } -
set_charset()只影响当前连接,不改变 MySQL 服务器全局配置;如果表/列本身是utf8而非utf8mb4,仍可能存丢 emoji 或生僻字
为什么验证连接不能只看对象是否创建成功
连接对象创建成功 ≠ 数据库可执行查询。MySQL 可能允许握手但拒绝后续操作(比如用户无权限、max_connections 耗尽、防火墙拦截查询端口):- 用一条轻量查询验证真实可用性:
$mysqli->query("SELECT 1")或$pdo->query("SELECT 1") - 如果返回
false或抛出异常,说明连接虽建起,但权限或状态异常 - 生产环境建议封装一个
isConnected()方法,内部执行SELECT 1并捕获异常,而不是只依赖构造函数不报错
字符集、异常模式、网络可达性、权限范围——这四点漏掉任一,都会让“看起来连上了”变成“查不出数据”或“插进去全是问号”。别急着写业务逻辑,先确保 SELECT 1 能跑通。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











