PHP API JSON数据解析与列表展示：高效提取所有特定字段

<?php
// 假设 $term 来自用户输入，实际应用中需进行适当过滤和验证
$term = $_POST["keyword"] ?? ''; 

// API请求URL
$url = 'https://example.com/ws/addresses/match?term=' . urlencode($term);

// 初始化cURL会话
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
// 设置HTTP头部，例如授权Token
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: s9-2659fbc5-036c-47-testtt-e2d']);
// 将API响应作为字符串返回，而不是直接输出
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

// 执行cURL请求并获取响应
$result = curl_exec($ch);

// 检查cURL错误
if (curl_errno($ch)) {
    echo 'cURL Error: ' . curl_error($ch);
    // 在生产环境中应记录日志而非直接输出
    exit; 
}

// 关闭cURL会话
curl_close($ch);

// 将JSON字符串解码为PHP对象或关联数组
// 默认解码为stdClass Object
$data = json_decode($result);

// 检查JSON解码错误
if (json_last_error() !== JSON_ERROR_NONE) {
    echo 'JSON Decode Error: ' . json_last_error_msg();
    // 在生产环境中应记录日志而非直接输出
    exit;
}
?>

stdClass Object
(
    [success] => 1
    [result] => stdClass Object
        (
            [matches] => Array // 这是一个包含多个匹配项的数组
                (
                    [0] => stdClass Object
                        (
                            [label] => E 0th St, Tennessee, IL // 我们需要提取的字段
                            // ... 其他字段 ...
                        )
                    [1] => stdClass Object
                        (
                            [label] => E 1 Rd, Tecumseh, KS
                            // ...
                        )
                    // ... 更多匹配项 ...
                )
        )
)

<ul id="title">
<?php
// 检查 $data 是否有效，并且包含预期的结构
if (isset($data->result->matches) && is_array($data->result->matches)) {
    // 直接迭代 $data->result->matches 数组
    foreach ($data->result->matches as $street) {
        // $street 在每次迭代中会成为 matches 数组中的一个 stdClass Object
        // 我们可以直接访问 $street->label
        // 注意：selectCountry 函数的参数值需要进行 HTML 实体编码以防止XSS攻击
        $encodedLabel = htmlspecialchars($street->label, ENT_QUOTES, 'UTF-8');
        ?>
        <li onClick="selectCountry('<?php echo $encodedLabel; ?>');"><?php echo $encodedLabel; ?></li>
        <?php
    }
} else {
    // 处理没有匹配项或数据结构不符合预期的情况
    echo '<li>No matches found or invalid data structure.</li>';
}
?>
</ul>