php 8.5.5 不存在——截至 2026 年 7 月，php 官方最新稳定版为 8.3.x，8.4 已正式发布，8.5 尚未发布；所谓“8.5.5”多为误标、非官方构建或混淆版本号，实际连接 tidb 只需 php ≥ 8.1 并启用 mysqli 或 pdo_mysql 扩展，使用标准 mysql 驱动配置端口 4000 和 charset=utf8mb4 即可。
PHP 8.5.5 不存在，先确认你的 PHP 版本
PHP 官方没有发布过 8.5.5 —— 当前最新稳定版是 8.3.x（截至 2024 年中），8.4 尚未正式 GA。你看到的 8.5.5 很可能是误读、自定义构建版本，或把 TiDB 版本号（如 TiDB v8.5.0）和 PHP 混淆了。连接 TiDB 的关键是 PHP 版本 ≥ 8.0（推荐 ≥ 8.1），且启用 mysqli 或 PDO_MySQL 扩展。
用 PDO 连 TiDB：驱动选 mysql，不是 tidb
TiDB 兼容 MySQL 协议，PHP 不需要专用驱动。直接用标准 PDO_MySQL 即可，但要注意几个关键点：
-
host填 TiDB Server 地址（如127.0.0.1或容器名），port默认4000（不是 MySQL 的3306） -
dsn中必须显式指定charset=utf8mb4，否则中文可能乱码 - 推荐开启
PDO::ATTR_EMULATE_PREPARES => false，让预处理走原生协议（TiDB 支持），避免类型丢失 - 若启用了 TLS（如 TiDB Cloud），需在 DSN 中加
&sslmode=required，并配置pdo_mysql.default_socket或 CA 文件路径
示例连接代码：
$dsn = 'mysql:host=127.0.0.1;port=4000;dbname=test;charset=utf8mb4';
$pdo = new PDO($dsn, 'root', '', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_EMULATE_PREPARES => false,
]);
mysqli 方式同样可行，但注意端口和错误处理
mysqli 是另一套原生 MySQL 接口，对 TiDB 兼容性良好，但默认不抛异常，容易掩盖错误：
- 务必检查
mysqli_connect_error()或使用mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT)开启异常模式 - 连接时明确传入端口：
new mysqli('127.0.0.1', 'root', '', 'test', 4000) - TiDB 的
autocommit默认为1，但事务行为与 MySQL 一致，START TRANSACTION和COMMIT可照常使用 - 不支持部分 MySQL 特有变量（如
sql_mode=STRICT_TRANS_TABLES在 TiDB 中无效），连接后执行SET SESSION tidb_skip_utf8_check=1可略过某些校验（仅调试用）
常见报错及对应解法
连不上？大概率卡在这几个地方：
-
Connection refused→ TiDB Server 没起来，或防火墙/SELinux 拦了4000端口；用telnet 127.0.0.1 4000测试连通性 -
Access denied for user→ 用户权限不足；TiDB 默认root@%无密码，但若改过密码，需确认用户是否被CREATE USER显式创建并GRANT权限 -
Unknown database 'xxx'→ 数据库名拼错，或该库在 TiDB 中确实不存在（TiDB 不自动创建 DB，需先用mysql -h ... -e "CREATE DATABASE xxx"初始化） -
Server sent charset unknown→ DSN 缺少charset=utf8mb4，或 PHP 的default_charset配置冲突
TiDB 的兼容层不是 100% 无缝，比如不支持 SELECT ... FOR UPDATE NOWAIT（会报语法错），这类细节得查 TiDB 的 MySQL 兼容性矩阵，而不是假设 PHP 驱动有问题。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
