phpEnv 不支持安装或管理 TiDB，因其仅面向本地单机 PHP 环境，缺乏分布式组件部署能力；正确路径是用 TiUP 启动 playground 实例并配置 PHP PDO 显式指定 port=4000 和 charset=utf8mb4。
phpEnv 本身不支持直接安装或管理 TiDB —— 它是为 PHP 环境（尤其是 Windows 下的集成开发环境）设计的轻量级工具，只管 PHP、Apache/Nginx 和 MySQL/MariaDB，**完全不涉及分布式数据库部署**。想用 phpEnv “装 TiDB”，这条路走不通。
为什么 phpEnv 无法安装 TiDB
TiDB 是分布式系统，依赖多个独立组件（PD、TiKV、TiDB Server、TiFlash 等），启动和协调需专用工具（如 tiup）；而 phpEnv 的核心逻辑是拉取预编译的 Windows 二进制包并静默配置本地单机服务。它既没有 TiDB 的 Windows 官方发行版支持，也不提供集群拓扑管理、SSH 远程部署、证书生成、配置热更新等能力。
常见错误现象包括：
- 运行
phpenv install tidb报错 “Unknown database type” 或命令不存在 - 手动把 TiDB bin 文件丢进 phpEnv 目录，但
phpenv start启动失败，日志里全是pd-server: command not found - 误以为 phpEnv 的 MySQL 模块能“切换成 TiDB”，结果连接时提示
Unknown MySQL server host '127.0.0.1' (11001)（实际是端口未监听或服务根本没启）
本地快速验证 TiDB + PHP 的正确路径
绕过 phpEnv，用 TiUP 启一个最小可用的单机 TiDB 实例（tiup playground），再让 PHP 连上去，5 分钟内可跑通。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 确保已安装
tiup（执行curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh，然后source ~/.bashrc或重启终端） - 运行
tiup playground --db 1 --kv 1 --pd 1 --tiflash 0（关闭 TiFlash 可大幅降低内存占用，适合测试） - 注意终端输出里的
mysql>连接串，通常是mysql://root@127.0.0.1:4000/，端口固定为4000，不是3306 - PHP 中用 PDO 连：DSN 必须写全
mysql:host=127.0.0.1;port=4000;charset=utf8mb4，漏掉port=4000就连不上
PHP 连 TiDB 最容易被忽略的三个点
TiDB 兼容 MySQL 协议，但细节差异会直接导致失败：
-
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION必须开启，否则 SQL 错误（比如不支持的语法）会被静默吞掉，调试时像在黑盒里摸鱼 - 默认字符集必须显式指定
charset=utf8mb4，TiDB 对utf8（即 utf8mb3）支持不完整，不加这个参数，中文插入可能报ERROR 1366 (HY000): Incorrect string value - 事务隔离级别默认是
REPEATABLE-READ，但 TiDB 实际按快照读（SI）实现；如果代码里写了SET SESSION TRANSACTION ISOLATION LEVEL SERIALIZABLE，TiDB 会直接拒绝——它不支持该级别
真正要测分布式能力（比如水平扩展、高可用故障转移），就得放弃本地一键方案，老实用 tiup cluster 部署多节点，且必须跨机器或至少跨 Docker 网络。单机 playground 只能验语法和基础连接，别把它当生产环境对标。
