如何使用 PHP 安全可靠地获取 FiveM 服务器状态数据-php教程-PHP中文网

如何使用 PHP 安全可靠地获取 FiveM 服务器状态数据

本文介绍如何通过 curl 替代 file_get_contents 安全读取 fivem 服务器的 dynamic.json 接口，解决连接超时问题，并正确解析玩家数量与最大容量。

本文介绍如何通过 curl 替代 file_get_contents 安全读取 fivem 服务器的 dynamic.json 接口，解决连接超时问题，并正确解析玩家数量与最大容量。

在为 FiveM 服务器开发配套网站时，实时显示在线玩家数（clients）和最大支持人数（sv_maxclients）是常见需求。但直接使用 file_get_contents() 请求远程 dynamic.json 接口（如 http://fivem.lrfreeroamitalia.it:30120/dynamic.json）极易因网络延迟、防火墙限制或主机环境限制（如 Aruba.it 默认禁用 allow_url_fopen 或设置严格超时）而触发 Connection timed out 错误。

推荐改用 cURL —— 它更灵活、可控性强，支持自定义超时、重试、SSL 配置及错误处理，是生产环境中获取远程 JSON 数据的标准实践。

以下是优化后的完整示例代码：

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

<?php $curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'http://fivem.lrfreeroamitalia.it:30120/dynamic.json',
    CURLOPT_RETURNTRANSFER => true,      // 返回字符串而非直接输出
    CURLOPT_TIMEOUT => 5,                // 设置合理超时（秒），避免长时间阻塞
    CURLOPT_CONNECTTIMEOUT => 3,         // 连接阶段超时（可选，提升响应性）
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_SSL_VERIFYPEER => false,     // 若目标为 HTTP 可省略；若升级为 HTTPS 必须设为 true 并配置 CA
    CURLOPT_HTTPHEADER => ['User-Agent: FiveM-Status-Widget/1.0'],
]);

$response = curl_exec($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
$error = curl_error($curl);

curl_close($curl);

// 基础错误处理
if ($response === false || $httpCode !== 200) {
    echo '<span class="status-error">无法连接服务器</span>';
    error_log("FiveM API request failed: HTTP {$httpCode}, Error: {$error}");
    exit;
}

$data = json_decode($response, false); // false → 返回对象（便于链式访问）

// 验证关键字段是否存在
if (!isset($data->clients) || !isset($data->sv_maxclients)) {
    echo '<span class="status-error">数据格式异常</span>';
    error_log('Invalid FiveM dynamic.json structure: ' . print_r($data, true));
    exit;
}

echo htmlspecialchars((int)$data->clients) . '/' . htmlspecialchars((int)$data->sv_maxclients);
?>

✅ 关键改进说明：