phpEnv 不支持 ClickHouse，需通过 HTTP 接口（端口 8123）调用，推荐使用 salsify/clickhouse-php 库或 cURL 发送请求，而非尝试 PDO/MySQLi 驱动。
phpEnv 本身不内置 ClickHouse 驱动，也不直接支持 ClickHouse —— 它是一个 Windows 下的 PHP 环境集成包（类似 XAMPP），默认只预装 MySQLi、PDO_MySQL、SQLite 等常见扩展。想用 PHP 连接 ClickHouse，必须手动编译或引入第三方驱动，且不能依赖 phpEnv 自带的「一键启用」界面。
ClickHouse 在 PHP 中没有原生 PDO 或 mysqli 驱动
MySQLi 只认 MySQL 协议，PDO_MySQL 也仅限 MySQL；ClickHouse 使用自研的 HTTP 或原生 TCP 协议（端口 8123 / 9000），和 MySQL 完全不兼容。你无法通过修改 PDO::ATTR_ERRMODE 或换 mysql:host=... DSN 就连上 ClickHouse。
常见错误现象：
-
PDOException: could not find driver（即使写了pdo_clickhouseDSN） -
Connection refused或404 Not Found（误用 MySQL 端口连 ClickHouse HTTP 接口） -
mysqli_connect(): php_network_getaddresses: getaddrinfo failed（硬套mysqli_connect("localhost", ...)）
唯一可行路径：用 HTTP + cURL 或 guzzlehttp/guzzle
ClickHouse 官方推荐 HTTP 接口（http://localhost:8123/），PHP 最稳妥的方式是发 HTTP 请求，不是「数据库连接」。不需要编译任何扩展，phpEnv 自带的 cURL 扩展已足够。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 确保 ClickHouse 服务正在运行，且
config.xml中<http_port>8123</http_port>已启用 - 确认用户有 HTTP 访问权限（检查
users.xml中对应用户的<networks></networks>和<profile></profile>） - 用
file_get_contents()或curl_init()发送 POST 请求，query参数放在 URL query string 或 POST body 中 - 返回格式默认是 TSV，加
&format=JSONEachRow更易解析
简短示例：
$ch = curl_init('http://localhost:8123/?query=SELECT%20version()&format=JSONEachRow');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);
var_dump(json_decode($result, true));别碰「pdo-clickhouse」或「clickhouse-php」扩展
网上有些 GitHub 项目叫 pdo-clickhouse，它们是伪造 PDO 接口的封装层，底层仍是 HTTP 调用，并非真正 PDO 驱动；而 clickhouse-php（如 sabreio/clickhouse）是纯 PHP 实现，但维护停滞、不支持新版协议（如 INSERT SELECT 多语句、压缩传输）、无 Windows 兼容性测试。
在 phpEnv 环境下尤其危险：
- 无法用
phpize编译（phpEnv不附带头文件和libtool） - 强行复制
.dll到ext/会导致PHP Startup: Unable to load dynamic library - 即使加载成功，
new PDO('clickhouse:host=localhost', ...)仍会报invalid data source name
如果真要「类数据库」体验，用官方 clickhouse-cpp 的 REST 封装
ClickHouse 官方推荐的 PHP 生态方案，其实是基于其 C++ client 的 HTTP 封装，例如：salsify/clickhouse-php（注意不是同名旧库）。它不注册 PDO 驱动，而是提供 ClickHouse\Client 类，行为接近 PDOStatement。
使用方式：
- 用
composer require salsify/clickhouse-php（phpEnv支持 Composer） - 初始化时指定
http://localhost:8123/，不写端口 9000 -
INSERT必须用writeRows()方法分块发送，不能拼大 SQL 字符串 - 查询结果默认是数组，不是
PDOStatement对象，不支持fetch()链式调用
关键点：它不改变 PHP 运行时，完全绕过扩展机制，和 phpEnv 兼容性最好。
ClickHouse 不是 MySQL 替代品，它没有事务、无行级锁、不支持 JOIN 优化器。用 PHP 连它，本质是「调 API」，不是「连数据库」——这个认知偏差，比配错端口更容易导致线上事故。
