如何在 PHP 中安全访问含点号（.）的 JSON 键值-php教程-PHP中文网

如何在 PHP 中安全访问含点号（.）的 JSON 键值

本文详解如何使用 json_decode() 将含特殊字符（如英文句号）的 json 键正确解析为 php 关联数组，并通过方括号语法安全访问嵌套字段，避免语法错误。

本文详解如何使用 json_decode() 将含特殊字符（如英文句号）的 json 键正确解析为 php 关联数组，并通过方括号语法安全访问嵌套字段，避免语法错误。

在 PHP 中处理来自 IoT 设备（如 Cube 电动自行车）的 JSON 数据时，常会遇到键名包含点号（.）的情况，例如 "actual.remaining.mileage" 或 "position.altitude"。这类键名无法通过对象属性访问（如 $obj->actual.remaining.mileage），因为点号会被 PHP 解析为属性访问操作符，导致语法错误或空值。

正确做法是：将 JSON 解码为关联数组（而非对象），然后使用标准的方括号语法访问带点号的键：

Aria2 Json Rpc

通过 JSON‑RPC 2.0 与 aria2 下载管理器交互，使用自然语言命令管理下载、查询状态并控制任务。适用于 aria2、下载管理或种子操作。

下载

// 示例 JSON 字符串（实际中通常来自 file_get_contents() 或 cURL 响应）
$json = '{
  "result": [
    {
      "telemetry": {
        "actual.remaining.mileage": 26.81,
        "position": {
          "altitude": 0,
          "direction": 0,
          "latitude": 34.799687,
          "longitude": 7.478863,
          "satellites": 0,
          "speed": 0
        },
        "position.altitude": 0,
        "vehicle.mileage": 624.071
      },
      "connected": true
    }
  ]
}';

// 关键：第二个参数设为 true，强制返回关联数组
$data = json_decode($json, true);

// 安全访问含点号的键
$remainingMileage = $data['result'][0]['telemetry']['actual.remaining.mileage'];     // 26.81
$vehicleMileage   = $data['result'][0]['telemetry']['vehicle.mileage'];              // 624.071
$positionAltitude = $data['result'][0]['telemetry']['position.altitude'];           // 0

// 访问嵌套对象（如 position）仍用常规键名
$latitude = $data['result'][0]['telemetry']['position']['latitude'];                // 34.799687

⚠️ 重要注意事项：

必须使用 json_decode($json, true) —— 若省略 true 参数，默认返回 stdClass 对象，此时 $obj->telemetry->"actual.remaining.mileage" 是非法语法，PHP 会报错 Parse error: syntax error, unexpected '"'；

建议添加错误检查，确保 JSON 有效且结构符合预期：

if (json_last_error() !== JSON_ERROR_NONE) {
    throw new InvalidArgumentException('Invalid JSON: ' . json_last_error_msg());
}
if (!isset($data['result'][0]['telemetry'])) {
    throw new RuntimeException('Expected telemetry data not found');
}