PHP8.2连接MySQL教程详解

PHP 8.3+ 已彻底移除过时的 mysql_connect()，必须使用 mysqli 或 PDO 连接 MySQL，但仅创建连接对象远远不够——字符集（utf8mb4）需显式设置、异常模式必须在初始化阶段启用、网络连通性与服务状态须逐项排查，且务必通过执行 `SELECT 1` 验证连接的真实可用性；任何一环疏漏（如 DSN 中 charset 缺失、PDO 异常模式未传入构造函数、mysqli 字符集设在查询之后、或 MySQL bind-address/端口/密码特殊字符未正确处理）都会导致静默失败、乱码、emoji 丢失或权限异常，让看似成功的连接在实际查询时彻底失效。

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 能跑通。

终于介绍完啦！小伙伴们，这篇关于《PHP8.2连接MySQL教程详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！