PHP连接MySQL5适配指南与方法解析

本文深入解析了PHP 7.0及以上版本连接老旧MySQL 5（特别是5.0–5.5）时频繁失败的根本原因——不仅因mysql_*扩展被彻底移除，更关键在于旧版MySQL仅支持mysql_native_password认证、默认禁用TLS且对SSL/Socket路径/端口配置极为敏感；文章直击痛点，给出基于mysqli_connect()的最小可行连接方案，强调显式指定端口、禁用SSL、校准socket路径或IP、正确设置字符集等实操要点，并提醒避开PDO兼容陷阱、验证扩展启用状态及命令行快速排障，还客观指出PHP 5.6虽兼容性最佳但已停止维护，仅供离线应急参考——帮你绕过版本数字的迷惑，精准定位协议层真实障碍，快速打通遗留系统的数据库连接。

PHP 连接 MySQL 5（尤其是 5.0–5.5）时，如果用的是 PHP 7.0+ 或 PHP 8.x，默认会失败——因为这些新版 PHP 已彻底移除 mysql_* 扩展，且默认只支持 MySQLi 或 PDO，而旧版 MySQL 5 默认不启用 TLS、不支持新认证插件（如 caching_sha2_password），还会拒绝非 mysql_native_password 认证方式的连接。

确认 MySQL 5 的实际版本和认证方式

先登录 MySQL 命令行（或 phpMyAdmin），执行：

SELECT VERSION();
SELECT user, host, plugin FROM mysql.user WHERE user = 'your_user';

若返回的 plugin 是 caching_sha2_password 或 sha256_password，哪怕 MySQL 版本是 5.7+，也大概率连不上；但你标题里明确是「MySQL 5」，所以更可能是 5.0–5.5，这类版本压根不支持这些插件——问题往往出在 PHP 端用了不兼容的驱动或配置。

• MySQL 5.0–5.5 只支持 mysql_native_password 认证，且默认关闭 SSL
• PHP 7.0+ 不再提供 mysql_connect() 函数，调用即报 Fatal error: Uncaught Error: Call to undefined function mysql_connect()
• 即使改用 mysqli_connect()，若 MySQL 服务端未显式允许旧协议（如 old_passwords=1 已废弃，不用管），也不影响连接，真正卡点常是 socket 路径、端口或用户权限

用 mysqli 连 MySQL 5 的最小可行配置

别碰 PDO（它在旧 MySQL 上容易因预处理或字符集行为差异出问题），优先用面向过程的 mysqli_connect()，并显式禁用 SSL 和压缩：

$conn = mysqli_connect(
    'localhost',     // host
    'username',      // user
    'password',      // password
    'database',      // dbname
    3306,            // port，显式写上更稳
    '/var/run/mysqld/mysqld.sock' // socket，若走本地文件通信才需填，Windows 忽略
);

if (!$conn) {
    die('Connect Error: ' . mysqli_connect_error());
}mysqli_set_charset($conn, 'utf8');

• 务必检查 mysqli 扩展是否启用：php -m | grep mysqli
• 若 MySQL 在另一台机器，把 localhost 换成 IP，并确认防火墙放行 3306
• MySQL 5.5 默认 max_allowed_packet=1M，若 PHP 插入大字段失败，需同步调大该值
• 不要用 127.0.0.1 代替 localhost：前者走 TCP，后者优先走 socket；旧 MySQL 对 socket 路径敏感，路径错就直接拒连

PHP 5.6 是最省心的兼容版本

如果你能降级 PHP，PHP 5.6 是连接 MySQL 5 最稳妥的选择：它同时支持 mysql_*（已弃用但可用）、mysqli 和基础 PDO，且对旧协议容忍度高。但注意：

• PHP 5.6 已于 2019 年 EOL，公网服务器绝不可用，仅限离线调试或内网老系统临时救急
• 若必须用 mysql_connect()，确保 extension=php_mysql.dll（Windows）或 extension=mysql.so（Linux）在 php.ini 中开启——但该扩展在 PHP 7.0+ 中已被物理删除，删都删干净了
• PHP 5.6 下仍建议用 mysqli，避免未来迁移时重写全部数据库逻辑

真正麻烦的不是版本数字本身，而是 MySQL 5 各子版本对协议细节的实现差异——比如 5.0 不支持 SET NAMES utf8mb4，5.1 对空密码用户限制更严，而 PHP 7.4+ 的 mysqli::real_connect() 在超时参数处理上又和旧 MySQL handshake 有微妙冲突。动手前，先用 mysql --host=localhost --user=user --password=password -D database 命令行验证能否通，比在 PHP 里反复试错快得多。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP连接MySQL5适配指南与方法解析》文章吧，也可关注golang学习网公众号了解相关技术文章。