phpEnv安装ClickHouse驱动 phpEnv PHP连接大数据仓库

phpEnv 不支持 ClickHouse，需通过 HTTP 接口（端口 8123）调用，推荐使用 salsify/clickhouse-php 库或 cURL 发送请求，而非尝试 PDO/MySQLi 驱动。

开门见山地说，phpEnv 这个 Windows 下的 PHP 集成环境，默认并没有为 ClickHouse 准备“直通车”。它和 XAMPP 这类工具一样，出厂配置只涵盖了 MySQLi、PDO_MySQL 这些关系型数据库的“标配”扩展。所以，想用 PHP 去连接 ClickHouse 大数据仓库，得自己动手找路，指望在 phpEnv 的管理界面里点个按钮就搞定，那肯定是行不通的。

ClickHouse 在 PHP 中没有原生 PDO 或 mysqli 驱动

这里有个关键认知需要厘清：ClickHouse 和 MySQL 压根不是一回事。MySQLi 和 PDO_MySQL 扩展只认 MySQL 自家的通信协议，而 ClickHouse 用的是自研的 HTTP（默认端口8123）或原生 TCP（端口9000）协议。两者互不兼容。因此，试图通过修改 PDO::ATTR_ERRMODE 或者把 DSN 字符串里的“mysql”换成“clickhouse”来蒙混过关，是绝对连接不上的。

常见的错误现象，无外乎下面几种：

• 报错 PDOException: could not find driver（哪怕你已经在 DSN 里写了 pdo_clickhouse）。
• 遇到 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 中的 8123 已经启用。
• 其次，确认用于连接的用户在 users.xml 中配置了正确的 HTTP 访问权限（检查对应 和 设置）。
• 技术上，使用 file_get_contents() 或者更灵活的 curl_init() 来发送 POST 请求都可以，SQL 查询语句（query）可以放在 URL 的查询字符串里，也可以放在 POST 的请求体中。
• 返回的数据默认是 TSV 格式，如果想更方便地用 PHP 处理，在请求 URL 后加上 &format=JSONEachRow 参数，让结果以 JSON 格式返回会是个好主意。

来看一个简短的代码示例：

$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」扩展

网上搜索时，你可能会发现一些名为 pdo-clickhouse 的 GitHub 项目。需要警惕的是，这些项目大多只是封装了一层伪 PDO 接口，底层依然调用的是 HTTP，并非真正的原生 PDO 驱动。另外，像 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 封装

如果确实希望获得类似操作数据库的体验，而不是直接裸写 cURL，那么 ClickHouse 官方生态中有一个更靠谱的选择：基于其 C++ 客户端封装的 HTTP 库，例如 salsify/clickhouse-php（注意区分同名的老旧库）。这个库不会去注册一个 PDO 驱动，而是提供了一个 ClickHouse\Client 类，其使用方式与 PDOStatement 有些相似。

它的使用方式大致如下：

• 通过 Composer 安装：composer require salsify/clickhouse-php（phpEnv 是支持 Composer 的）。
• 初始化客户端时，指定 HTTP 地址如 http://localhost:8123/，不要使用 9000 端口。
• 执行 INSERT 操作时，必须使用 writeRows() 方法分批发送数据，不能直接拼接成一个巨大的 SQL 字符串。
• 查询返回的结果默认是数组格式，并非 PDOStatement 对象，因此不支持 fetch() 那样的链式调用方法。

关键在于，这个方案完全不触及 PHP 的运行时扩展机制，只是纯库级别的封装，因此与 phpEnv 的兼容性是最好的。

最后必须强调一个根本性的认知：ClickHouse 并非 MySQL 的替代品，它没有事务、没有行级锁、对 JOIN 的优化器支持也有限。用 PHP 连接它，本质上是在“调用一个高性能的数据查询 API”，而不是在进行传统的“数据库连接”——理清这个认知偏差，远比配错一个端口号更重要，它能帮你避免很多潜在的线上问题。