PHP连接InfluxDB 2.x必须使用influxdata/influxdb-client-php库，禁用旧版客户端；需正确配置url、token、org、bucket四参数；写入时注意时间戳格式（纳秒或RFC3339）；查询须用Flux语法并显式指定时间范围。
PHP 连 InfluxDB 2.x 不能用 PDO 或旧版 influxdb-php（v1.x）客户端直接连——它们不支持 token 鉴权和 Line Protocol v2，强行配只会报 401 Unauthorized 或 404 Not Found。必须用官方维护的 influxdata/influxdb-client-php 库。
装对客户端：只认 influxdata/influxdb-client-php
删掉所有 influxdb/influxdb-php、influxdb/influxdb 或带 org.influxdb 的旧包。Composer 安装唯一有效库：
composer require influxdata/influxdb-client-php
它基于 Guzzle 和 PSR-7，要求 PHP ≥ 7.4，且必须启用 cURL 和 json 扩展。若用宝塔或 Docker，确认这些扩展已开启，否则实例化 InfluxDB2Client 会直接 fatal error。
四个连接参数一个都不能错
连不上 80% 是这四个值填错或漏了：
立即学习“PHP免费学习笔记（深入）”；
-
url：必须带协议，如"http://localhost:8086"或"https://influx.example.com:8086"；写成"localhost:8086"或"127.0.0.1"会静默失败 -
token：从 InfluxDB UI 的 Data > Tokens 页面复制完整字符串（含==），不是密码，也不是 API key -
org：组织名（Organization），不是邮箱、不是用户名；默认安装后是my-org@example.com这类，但你得在 UI 里确认真实值 -
bucket：存储桶名（Bucket），必须已存在；不能写成数据库名，也不能指望它自动创建
示例初始化：
$client = new InfluxDB2Client([ "url" => "http://localhost:8086", "token" => "aBcDeFgHiJkLmNoPqRsTuVwXyZ==", "org" => "my-org-name", "bucket" => "my-bucket" ]);
写数据时时间戳格式不对就丢点，还不报错
writeRecords() 和 writePoint() 默认静默丢弃非法字段——最常见就是时间戳格式错：
- 传
int：单位是纳秒，不是秒，别用time()，得写time() * 1e9 - 传
string：只能是 RFC3339 格式，如"2024-05-20T10:30:00Z"；"Y-m-d H:i:s"或"2024-05-20 10:30:00"直接拒收，无提示 - 留空：服务端自动打时间戳，最安全，适合调试阶段
写入前加一行检查：
if (!is_int($timestamp) && !preg_match('/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/', $timestamp)) {
throw new InvalidArgumentException('Invalid timestamp format');
}查数据要用 Flux 语法，不是 SQL
InfluxDB 2.x 不再支持 SELECT * FROM ... 这类 InfluxQL；必须用 Flux 查询语言，且注意时区：
- 查询语句必须以
from(bucket: "...")开头 - 时间范围必须显式指定，如
|> range(start: -1h)；不写就查不到任何数据 - 所有时间默认按 UTC 解析，如果设备上报的是本地时间，得手动 offset，比如
|> timeShift(duration: -8h)
简单查最近 5 条：
$query = 'from(bucket: "my-bucket") |> range(start: -5m) |> filter(fn: (r) => r._measurement == "sensor_temp") |> limit(n: 5)'; $result = $client->getQueryApi()->query($query);
真正容易被忽略的是：InfluxDB 2.x 的 PHP 客户端不校验 bucket 是否真存在，也不校验 org 是否拼错——它只在校验 token 时才返回明确错误。其他参数错，要么查不到数据，要么写不进点，全程安静。调试时务必先用 curl 手动测通这四个参数：curl -X GET "http://localhost:8086/api/v2/buckets?org=my-org-name" -H "Authorization: Token your-token-here=="。
