php 8.6可通过clickhouse http接口写入jsoneachrow,并用带类型的查询参数读取json结果。服务端地址、sql模板和表名应固定,只有业务值走参数;不能把用户输入直接拼进sql或让调用者任意指定数据库端点。

官方文档:ClickHouse通过HTTP写入记录
准备受限账号和固定表
由数据库管理员创建目标库表,并给应用账号授予所需读写权限。示例表为app_events,包含event_id String、kind String、created_at DateTime三列;HTTP端口和TLS方式按实际部署配置。
PHP需启用cURL。远端使用有效证书的HTTPS,账号和密码放入运行环境,通过HTTP认证头传递,不把密码写进查询字符串。

官方文档:ClickHouse HTTP认证方式
发送写入并检查HTTP结果
<?php
function clickhouse(string $sql, string $body = '', array $params = []): string {
$base = rtrim(getenv('CLICKHOUSE_URL'), '/');
$url = $base . '/?' . http_build_query(['query' => $sql] + $params);
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $body,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 5,
CURLOPT_TIMEOUT => 30,
CURLOPT_USERPWD => getenv('CLICKHOUSE_USER') . ':' . getenv('CLICKHOUSE_PASSWORD'),
CURLOPT_HTTPHEADER => ['Content-Type: text/plain; charset=utf-8'],
]);
try {
$result = curl_exec($ch);
if ($result === false) throw new RuntimeException(curl_error($ch));
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) !== 200) {
throw new RuntimeException('ClickHouse请求失败');
}
return $result;
} finally {
curl_close($ch);
}
}
$row = json_encode(['event_id' => '42', 'kind' => 'export',
'created_at' => '2026-11-22 14:00:00'], JSON_THROW_ON_ERROR) . "\n";
clickhouse('INSERT INTO app_events FORMAT JSONEachRow', $row);
$json = clickhouse(
'SELECT event_id, kind FROM app_events WHERE kind = {kind:String} LIMIT 10 FORMAT JSON',
'', ['param_kind' => 'export']
);
$data = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
echo json_encode($data['data'], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);JSONEachRow每条记录一行,最后保留换行。日期的解释取决于列或服务端时区,生产系统应明确统一时区;SQL参数使用param_前缀,对应模板中的{kind:String}。
exa-js 是 Exa 官方 JavaScript 软件开发工具包,Exa 是一个为 AI 工作流构建的网络搜索 API。它为代理提供了一种具体的方式来搜索网络、检索页面内容,并从代码中生成有来源的答案,而不是手动拼接原始 HTTP 调用。
处理超时和部分返回边界
写入超时可能发生在服务端已接收之后,不能在没有幂等策略时盲目重试。是否允许重复、如何去重与表引擎和业务设计有关,不由HTTP客户端自动保证。
立即学习“PHP免费学习笔记(深入)”;
ClickHouse可能在响应已经开始后产生查询错误。读取结果时除了HTTP状态,还要确认完整响应能按目标格式解析;对需要更强完整性控制的查询,再按官方HTTP设置评估wait_end_of_query等选项。


















