问题背景：JSON数字键的挑战
在处理来自API或其他源的JSON数据时，我们经常会遇到以数字作为键名的对象属性。例如，地理编码服务可能会返回一个包含年份作为键的普查数据对象：
{
"2019": {
"census_year": 2019,
"state_fips": "09",
// ... 其他属性
}
}在PHP中，当我们将JSON字符串解码为对象（通常通过json_decode()函数）后，尝试直接使用$object->2019这样的语法来访问这些数字键时，PHP解释器会将其误认为是语法错误，因为它期望一个有效的变量名或字符串字面量作为属性名，而不是一个裸露的整数。这通常会导致unexpected integer "2019"之类的错误。
核心解决方案：->{'数字键'} 语法
PHP提供了一种特殊的语法来解决这个问题：通过使用花括号将数字键名包裹起来，将其明确地声明为一个字符串。正确的访问方式是$object->{'数字键'}。
例如，要访问上述JSON结构中的2019键，您应该使用$object->{'2019'}。这种语法强制PHP将2019视为一个字符串字面量，从而允许它作为对象属性名被正确解析和访问。
立即学习“PHP免费学习笔记（深入）”；
示例代码与逐步演示
假设我们从一个地理编码应用程序接收到一个复杂的JSON响应，并且已经钻取到了一个包含年份作为键的普查数据部分。以下是模拟的响应数据和如何访问2019键的步骤：
<?php
// 模拟一个复杂的JSON响应对象
// 在实际应用中，这通常是 json_decode() 后的结果
$response = (object)[
'results' => [
(object)[
'response' => (object)[
'results' => [
(object)[
'fields' => (object)[
'census' => (object)[
'2019' => (object)[
'census_year' => 2019,
'state_fips' => '09',
'county_fips' => '09001',
'tract_code' => '100300',
'block_code' => '1061',
'block_group' => '1',
'full_fips' => '090011003001061',
'place' => null,
'metro_micro_statistical_area' => (object)[],
'combined_statistical_area' => (object)[],
'metropolitan_division' => null,
'source' => 'US Census Bureau'
]
]
]
]
]
]
]
]
];
// 1. 钻取到包含数字键的父对象
// 对应原始问题中的 dd($response->results[0]->response->results[0]->fields->census);
$censusData = $response->results[0]->response->results[0]->fields->census;
echo "--- 原始普查数据对象 ---" . PHP_EOL;
var_dump($censusData); // 此时 $censusData 看起来是 {#669 ▼ +"2019": {#666 ▶ ...}}
echo PHP_EOL . "--- 尝试直接访问 (错误示例) ---" . PHP_EOL;
// 错误示例：直接访问 $censusData->2019 会导致语法错误
// 如果取消注释，会得到 "unexpected integer "2019""
// try {
// $year2019Data = $censusData->2019;
// } catch (ParseError $e) {
// echo "错误: " . $e->getMessage() . PHP_EOL;
// }
echo PHP_EOL . "--- 正确访问 '2019' 键 ---" . PHP_EOL;
// 正确方法：使用花括号包裹数字键名
$year2019Data = $censusData->{'2019'};
var_dump($year2019Data);
echo PHP_EOL . "--- 访问 2019 年数据中的 'census_year' ---" . PHP_EOL;
echo "普查年份: " . $year2019Data->census_year . PHP_EOL; // 输出: 普查年份: 2019
echo "州 FIPS 码: " . $year2019Data->state_fips . PHP_EOL; // 输出: 州 FIPS 码: 09
?>运行上述代码，您会看到$year2019Data变量成功地获取了2019年份对应的普查数据对象，并且可以进一步访问其内部属性。
健壮性与最佳实践
在实际生产环境中，仅仅知道如何访问数字键是不够的，还需要考虑数据的健壮性和错误处理。
-
检查键是否存在 在访问任何属性之前，始终建议检查该属性是否存在，以避免在键缺失时引发错误。
if (isset($censusData->{'2019'})) { $year2019Data = $censusData->{'2019'}; // 继续处理 $year2019Data } else { echo "2019 年的数据不存在。" . PHP_EOL; } // 或者使用 property_exists() if (property_exists($censusData, '2019')) { $year2019Data = $censusData->{'2019'}; // ... } -
将JSON解码为关联数组 如果您更习惯于使用数组语法来访问数据，或者预见到大量数字键的情况，可以在json_decode()时将JSON字符串解码为关联数组，而不是对象。
$jsonString = '{ "2019": { "census_year": 2019 } }'; $dataArray = json_decode($jsonString, true); // 第二个参数设为 true if (isset($dataArray['2019'])) { $year2019Data = $dataArray['2019']; echo "普查年份 (数组方式): " . $year2019Data['census_year'] . PHP_EOL; }这种方式下，所有的键（包括数字键）都会被视为字符串，并可以通过标准的数组访问语法$array['key']来访问，避免了对象访问中数字键的特殊语法问题。缺点是失去了对象的一些特性，例如链式调用。
-
使用Laravel的data_get()辅助函数 在Laravel框架中，data_get()辅助函数提供了一种更强大、更容错的方式来访问嵌套数据。它支持点语法，并且可以优雅地处理缺失的键。
// 假设 $response 是一个 Laravel 集合或标准对象 $year2019Data = data_get($response, 'results.0.response.results.0.fields.census.2019'); // data_get() 默认在键不存在时返回 null，可以指定默认值 $year2019DataOrDefault = data_get($response, 'results.0.response.results.0.fields.census.2020', '未找到2020年数据'); var_dump($year2019Data); echo $year2019DataOrDefault . PHP_EOL;
data_get()函数在内部会处理各种键类型，包括数字键，使得访问路径更加简洁和健壮。这是处理复杂或不确定JSON结构时推荐的方法。
总结
在PHP/Laravel中访问JSON对象中以数字作为键的属性时，核心解决方案是使用$object->{'数字键'}的语法。这种方式将数字键明确地声明为字符串，从而避免了PHP解析器将其误判为整数而引发语法错误。为了构建更健壮的代码，建议结合isset()或property_exists()进行存在性检查。此外，根据项目需求，将JSON解码为关联数组或利用Laravel的data_get()辅助函数也是处理复杂JSON数据的有效策略。理解并正确应用这些方法，将帮助您高效、安全地从各种JSON数据源中提取所需信息。
