PHP8.3连接MySQL数据库教程

PHP 8.3 已彻底废弃并移除所有过时的 `mysql_*` 函数（包括 `mysql_connect()`），调用即触发致命错误，开发者必须转向现代、安全且原生支持的 mysqli（推荐面向对象写法）或 PDO（务必启用异常模式）；文章不仅清晰对比二者适用场景，还详解连接配置关键细节——如强制设置 `utf8mb4` 字符集、正确处理 MySQL 8.0+ 的认证插件兼容性、Unix socket 路径适配、SSL 策略应对，以及精准排查“Connection refused”“Access denied”等高频故障背后的真实原因，帮你绕过语言升级带来的陷阱，直击生产环境中最棘手的数据库连接痛点。

PHP8.3 默认不支持 mysql_connect()，必须用 mysqli 或 PDO

PHP 8.3 彻底移除了 mysql_connect() 及所有 mysql_* 函数，调用会直接报 Fatal error: Uncaught Error: Call to undefined function mysql_connect()。这不是配置问题，是语言层移除 —— 没有开关能打开，也没有扩展可装。

你只有两个可靠选择：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
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 策略、字符集这四样东西混在一起出问题时，错误提示还藏在不同层级里。

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