influxdata/influxdb-client-php 已停更且不支持 InfluxDB 2.x 完整功能，推荐直接调用 HTTP API：写入用 /api/v2/write（带 org/bucket 参数和 Token 认证），查询用 /api/v2/query（传 Flux 脚本），时间戳须为纳秒整数。
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描述字段顺序和类型
示例写入（无依赖）：
立即学习“PHP免费学习笔记（深入）”；
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');
如果非要封装成类，别碰官方 SDK
可轻量封装一个 InfluxDBClient 类，只覆盖最常用操作，避免抽象过度：
- 构造函数只接收
$url、$token、$org、$bucket四个必需参数 -
write($line)方法不做批量合并，每条$line单独发一次 POST（InfluxDB 自身支持多行，但 PHP 层不预处理更安全） -
query($flux)返回原始 JSON 解码后的array，不尝试转成对象或模型 —— Flux 结构动态性强，硬映射易崩 - 错误统一用
throw new RuntimeException(curl_error($ch))，不吞掉网络层异常
不要加「连接池」「重试策略」「自动序列化」——这些在时序场景下反而引入不确定性，InfluxDB 写入本身是异步落盘，客户端保持简单最稳。
InfluxDB 1.8 用户注意协议切换
若还在用 1.8 版本，必须关掉 influxdb-client-php 的默认 v2 模式，改用其 v1 兼容路径：
- 初始化时传
['version' => '1.8']到配置数组 - 写入 endpoint 是
/write（不是/api/v2/write），无需org/bucket，改用db和rp参数 - 认证用
username+password，不是 Token；HTTP 头是Basic编码 - Flux 不可用，只能用 InfluxQL，
query接口路径为/query
混用 v1/v2 配置是常见报错源：400 Bad Request 或 401 Unauthorized 往往是因为客户端按 v2 发请求，服务端却是 v1 实例。
真正麻烦的不是怎么连，而是 Flux 查询结果的嵌套结构和纳秒时间戳处理 —— 这两处没文档会卡半天，建议先用 curl -v 把原始响应打出来看清楚再写 PHP 解析逻辑。
