ClickHouse / PHP

把 ClickHouse装进 PHP 的日常

查询构建、Schema、迁移与 ORM 一套齐备,六种框架共用同一套 API。

仓鼠小仓,clickhouse 的项目宠物

一个客户端,覆盖建表、查询与迁移

clickhouse-php 用 HTTP 协议连接 ClickHouse,把查询构建、Schema 管理、数据迁移与 ORM 收在同一个包里。

同一套调用方式可以运行在原生 PHP、Laravel、Webman、ThinkPHP、Hyperf、Yii2 与 Yii3 中,不需要为框架重写业务代码。

  • 查询构建器与参数绑定
  • Schema Builder 与迁移
  • ORM 与多连接管理
6框架适配
v2.3.1当前版本
HTTP传输方式
仓鼠小仓 的 微笑 表情

小仓

一只圆滚滚的黄色卡通仓鼠,戴 PHP 紫围巾,挂着 ClickHouse 黄色小房子吊牌,右爪挥动打招呼。

查询、建表、迁移,都交给我。

从一条查询到整套数据层

构建、建表、迁移、映射都在同一个命名空间里完成。

查询构建器

链式构建 SELECT、INSERT 与聚合查询,参数绑定避免拼接 SQL。

Schema 构建器

用 PHP 描述表结构,字段、索引与引擎一次写清。

数据迁移

版本化迁移文件,支持 run、rollback 与 refresh。

ORM 映射

ActiveRecord 模型与只读集合,保留原生查询的灵活度。

连接池与多连接

多连接管理配 Swoole、Swow、Workerman 协程池,FPM 自动直连。

六框架适配

Laravel、Webman、ThinkPHP、Hyperf、Yii2、Yii3 共用核心。

从客户端到完整数据层

四次关键发布,把查询、建表、迁移与多框架接入补齐。

v2.3.1

流式解析与发布判定

优化流式响应解析与版本发布判定,补齐文档说明。

v2.3.0

宠物接入 Pet API

宠物形态整合进 Pet API,并出现在命令输出里。

v2.1.0

Yii2 与 Yii3 适配

新增 Yii2 应用组件与 Yii3 DI 接入,框架适配增至六个。

v2.0.0

流式读取与查询 SETTINGS

修复审查发现的缺陷,新增流式读取与查询级 SETTINGS。

版本日志

最近的发布记录,完整列表在 GitHub Releases。

最新 v2.3.1 全部版本
v2.3.12026-10-19

优化流式解析、发布版本判定与文档说明。

v2.3.02026-10-18

宠物形态整合进 Pet API 与命令输出。

v2.2.02026-10-18

新增 1200x630 Social Preview 图。

v2.1.32026-10-18

重做项目宠物为卡通仓鼠,README 去除 HTML 标签。

v2.1.22026-10-18

为项目视觉资产保留商业权利。

v2.1.12026-09-29

修复 Laravel 13 安装与 Guzzle 8 兼容问题。

安装与使用

先安装,再跑一个最小示例。

PHP 8.0+ / HTTP完整 README
安装
composer require erikwang2013/clickhouse-php
最小示例
use Erikwang2013\ClickHouse\ClickHouse;

ClickHouse::bootstrap();

$rows = ClickHouse::table('logs')
    ->where('date', '>=', '2024-01-01')
    ->whereIn('level', ['error', 'warn'])
    ->orderBy('timestamp', 'desc')
    ->limit(100)
    ->get();

foreach ($rows as $row) {
    echo $row['message'];
}

小仓的十二种表情

鼠标停一停,它会换一种心情。

搜索本站

输入关键词,例如“上传”“迁移”“JWT”。