PHP如何连接并操作InfluxDB时序数据库_使用官方客户端库-php教程-PHP中文网

influxdata/influxdb-client-php 已停更且不支持 influxdb 2.x 完整功能，推荐直接调用 http api：写入用 /api/v2/write（带 org/bucket 参数和 token 认证），查询用 /api/v2/query（传 flux 脚本），时间戳须为纳秒整数。

php如何连接并操作influxdb时序数据库_使用官方客户端库

InfluxDB 官方 PHP 客户端库（influxdata/influxdb-client-php）已停止维护，2023 年起不再更新，且不支持 InfluxDB 2.x 的完整功能（如多组织、细粒度权限、Buckets API 等），直接使用它连接 InfluxDB 2.3+ 很可能失败或行为异常。

为什么 `influxdata/influxdb-client-php` 不能放心用

这个库最后稳定版是 v2.1.0（2022 年发布），之后官方转向 Go/Python/JS 客户端，PHP 被移出「first-class client」名单。常见问题包括：

writeApi()->write() 在启用 TLS 或使用自定义 org 参数时静默丢数据
调用 queryApi()->query() 返回空数组，即使 InfluxDB CLI 或 Chronograf 能查到结果
不识别 Authorization: Token xxx 头格式，仍尝试用 Basic Auth 拼接用户名密码
对 Flux 查询的响应结构解析错误，getTables() 可能抛出 TypeError

替代方案：用 cURL + 原生 HTTP API（推荐）

InfluxDB 2.x 完全通过 RESTful HTTP 接口提供服务，PHP 内置 curl 足够可靠，可控性远高于废弃 SDK。关键点：

写入用 POST /api/v2/write，必须带 org 和 bucket 查询参数，Authorization: Token xxx 请求头
查询用 POST /api/v2/query，请求体为 Flux 脚本，Accept: application/json，返回标准 JSON 表格结构
所有时间戳必须是纳秒级整数（非 Unix 时间戳），写入行协议时用 1717028452000000000 这种格式
Flux 查询结果中，table 字段标识分组，values 是数据行，columns 描述字段顺序和类型

示例写入（无依赖）：

function influxWrite($url, $token, $org, $bucket, $line) {
    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => "$url/api/v2/write?org=$org&bucket=$bucket",
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $line,
        CURLOPT_HTTPHEADER => [
            "Authorization: Token $token",
            "Content-Type: text/plain; charset=utf-8"
        ],
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_NOBODY => false,
    ]);
    $res = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    return $httpCode === 204;
}

调用：influxWrite('https://localhost:8086', 'my-token', 'my-org', 'my-bucket', 'cpu,host=server01 usage=0.64 1717028452000000000');