PHP8.3使用什么代码实现与MySQL数据库的连接？

本文共计1122个文字，预计阅读时间需要5分钟。

PHP 8.3 删除了 `mysql_connect()` 和其他 `mysql_*` 函数，这些函数不再可用。应使用新的 PDO 或 mysqli 扩展。例如，使用 PDO 连接 MySQL，代码如下：

你只有两个可靠选择：mysqli（面向过程或面向对象）或 PDO（推荐）。两者都原生支持 PHP 8.3，无需额外安装扩展（只要编译时启用了 mysqli 和 pdo_mysql，默认几乎都启用）。

• mysqli 更轻量，适合简单项目或已有 mysqli 代码迁移
• PDO 支持预处理、多种数据库驱动、统一接口，更适合新项目或需要换库的场景
• 别碰 mysqlnd —— 它只是 MySQL Native Driver，不是连接函数，不能单独用来“连接”

用 mysqli_connect() 连接 MySQL（推荐面向对象写法）

虽然 mysqli_connect() 函数仍可用，但强烈建议用面向对象方式：更清晰、自动管理资源、异常更可控。PHP 8.3 对 mysqli 的错误报告模式支持更好，配合 mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT) 可让所有错误抛出异常，避免手动检查 mysqli_error()。

示例（含基础错误捕获）：

立即学习“PHP免费学习笔记（深入）”；

<?php mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT); try { $mysqli = new mysqli('localhost', 'user', 'pass', 'dbname', 3306); echo "连接成功"; } catch (mysqli_sql_exception $e) { error_log("MySQL 连接失败: " . $e->getMessage()); die("服务暂时不可用"); } ?>

• 端口 3306 可省略（默认值），但显式写出更明确，尤其 Docker 或非标端口部署时
• 密码为空时传空字符串 ''，不要传 null，否则可能触发类型警告
• 连接后立即执行 $mysqli->set_charset('utf8mb4')，否则中文可能乱码（utf8mb4 是 MySQL 8.0+ 推荐字符集）

PDO 连接 MySQL 并启用异常模式

PDO 在 PHP 8.3 中行为稳定，但默认 PDO::ATTR_ERRMODE 是 PDO::ERRMODE_SILENT，错误只设 $pdo->errorInfo()，极易漏判。必须显式设为 PDO::ERRMODE_EXCEPTION 才能统一用 try/catch 处理。

示例（DSN 写法 + 常见选项）：

<?php $dsn = 'mysql:host=localhost;dbname=dbname;charset=utf8mb4'; $options = [ PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC, PDO::ATTR_EMULATE_PREPARES => false, // 关键：禁用模拟预处理，让 MySQL 原生处理 ]; try { $pdo = new PDO($dsn, 'user', 'pass', $options); } catch (PDOException $e) { error_log("PDO 连接失败: " . $e->getMessage()); die("数据库服务异常"); } ?>

• charset=utf8mb4 必须写在 DSN 里（不是 options 里），否则连接建立后才设 charset 可能不生效
• PDO::ATTR_EMULATE_PREPARES => false 在 PHP 8.3 + MySQL 8.0+ 环境下应始终关闭，否则 JSON 字段、TIMESTAMP 类型等可能解析异常
• 如果用 Unix socket（如 MAMP、Homebrew MySQL），DSN 改成 mysql:unix_socket=/tmp/mysql.sock;dbname=...

连接失败常见原因和快速排查点

即使语法全对，PHP 8.3 连不上 MySQL 往往卡在环境层。先看错误信息再改代码：

• 报 Connection refused：MySQL 服务没启动，或 bind-address 配置为 127.0.0.1 却用 localhost（MySQL 会尝试 socket），换成 127.0.0.1 或确认 socket 路径
• 报 Access denied for user：用户权限不足，PHP 8.3 不影响权限逻辑，但注意 MySQL 8.0+ 默认认证插件是 caching_sha2_password，老客户端可能不兼容 —— 创建用户时显式指定 mysql_native_password：CREATE USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'pass';
• 报 SSL connection error：MySQL 要求 SSL 但 PHP 没配，可在 DSN 加 &sslmode=disabled（开发环境），生产环境应配好证书
• mysqli 和 PDO 报的错误信息格式不同，PDO 的 getMessage() 包含 SQLSTATE，更利于定位协议级问题

真正麻烦的从来不是写哪几行代码，而是 MySQL 用户权限、socket 路径、SSL 策略、字符集这四样东西混在一起出问题时，错误提示还藏在不同层级里。