PHP连接MyCat实现MySQL协议接入

本文详解了PHP如何通过标准MySQL扩展（PDO或mysqli）无缝连接MyCat这一MySQL协议代理，强调其无需额外扩展、兼容原生SQL写法的便捷性，同时系统梳理了关键配置要点——包括正确使用8066端口、逻辑库名映射、MySQL 8.x用户认证插件适配、防火墙与网络连通性检查，并深入揭示了MyCat在SQL路由层面的限制与行为差异（如跨库JOIN拒绝、分片表子查询风险、广播式DML隐患及全局序列ID特性），辅以实用的错误排查路径和生产级规范建议，帮助开发者避开常见陷阱，高效构建可扩展的分布式数据库接入方案。

PHP 连接 MyCat 就是连接一个“伪装成 MySQL 的代理”，只要 MyCat 启动正常、配置正确，PDO 或 mysqli 完全可以像连真实 MySQL 一样用——不需要额外扩展、不需要 JDBC 桥接、也不需要改 SQL 写法。

MyCat 必须启用 MySQL 协议端口

MyCat 默认监听 8066 端口（SQL 请求）和 9066 端口（管理命令），PHP 必须连 8066，而非后端 MySQL 的 3306。如果连不上，先确认：

• netstat -tuln | grep :8066 能看到 MyCat 进程在监听
• schema.xml 中的 配置了正确的后端 MySQL 地址和账号（MyCat 自己要能连上这些库）
• 防火墙或安全组放行了 8066 端口（尤其是云服务器）
• MySQL 8.x 用户需显式指定认证插件：ALTER USER 'mycat'@'%' IDENTIFIED WITH mysql_native_password BY 'xxx'; FLUSH PRIVILEGES;

PDO 连接字符串写法与注意事项

使用标准 MySQL DSN，但 host 和 port 指向 MyCat，database 填逻辑库名（即 schema.xml 中定义的 name 属性值）：

$dsn = 'mysql:host=192.168.1.100;port=8066;dbname=TESTDB;charset=utf8mb4';
$pdo = new PDO($dsn, 'mycat_user', 'mycat_pass', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);

关键点：

• 不要在 DSN 中写 unix_socket，MyCat 不支持本地 socket 连接
• 若 MyCat 后端用了 MySQL 8.x，PDO 必须用 mysqlnd 驱动（PHP 7.4+ 默认），否则可能报 Authentication plugin 'caching_sha2_password' cannot be loaded
• 连接成功后执行 SELECT VERSION()，返回结果通常是 5.6.29-Mycat-1.6.7.1-release 类似字样，说明连的是 MyCat 而非直连 MySQL

SQL 执行时哪些行为会被 MyCat 拦截或改写

MyCat 在协议层解析 SQL，对以下操作有强干预，PHP 层需提前知晓限制：

• 跨库 JOIN：若涉及多个 ，MyCat 默认拒绝，报错类似 java.lang.RuntimeException: can't find table define...
• 子查询含分片表：如 SELECT * FROM user WHERE id IN (SELECT user_id FROM order WHERE status=1)，若 order 是分片表，MyCat 可能路由失败或返回空
• 未带分片键的 UPDATE/DELETE：例如对分片表 user 执行 UPDATE user SET name='x' WHERE age > 18（无 id 条件），MyCat 会广播到所有分片，性能极差且可能被 sqlMaxLimit 截断
• LAST_INSERT_ID() 返回的是 MyCat 生成的全局序列值（若启用了 sequence_db_conf.properties），不是后端 MySQL 的自增 ID

错误排查优先看 MyCat 日志而非 PHP 报错

PHP 层报错如 SQLSTATE[HY000] [2002] Connection refused 或 SQLSTATE[HY000] [1105] unknown error，往往掩盖了真实原因。应立刻检查：

• /usr/local/mycat/logs/mycat.log 中最近的 ERROR 行，常见如 can't resolve table xxx、no route to datasource
• /usr/local/mycat/logs/processor0.log 中对应线程的完整 SQL 解析路径
• 用原生 mysql -h192.168.1.100 -P8066 -umycat_user -p 登录，手动执行相同 SQL，观察是否报错一致

MyCat 对 SQL 的兼容性不是 100%，尤其在复杂嵌套、窗口函数、CTE 上表现不稳定；生产环境务必把路由规则、分片键设计、SQL 写法约束写进团队开发规范，而不是靠 PHP 层兜底。

理论要掌握，实操不能落！以上关于《PHP连接MyCat实现MySQL协议接入》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！