自定义扩展get_client_version支持更多客户端信息

gitbox 2025-05-11

在开发 Web 应用时，了解客户端的详细信息可以帮助我们进行更精细的功能适配、安全验证以及用户行为分析。PHP 是一种灵活的服务器端语言，可以通过函数来解析客户端的 User-Agent，但我们也可以通过自定义的 get_client_version 函数实现更强大、可扩展的客户端信息提取功能。

一、基本思路

get_client_version 函数的核心目的是从请求头中提取客户端的类型（如浏览器、操作系统、设备类型）和版本信息。我们将通过解析 $_SERVER['HTTP_USER_AGENT'] 来实现这一功能，并支持加载自定义扩展规则。

二、函数实现

以下是基础版本的 get_client_version 函数实现，并支持加载用户自定义的扩展：

function get_client_version($user_agent = null, $custom_rules = []) {
    if (is_null($user_agent)) {
        $user_agent = $_SERVER['HTTP_USER_AGENT'] ?? '';
    }

    $clients = [
        'Chrome' => '/Chrome\/([0-9\.]+)/',
        'Firefox' => '/Firefox\/([0-9\.]+)/',
        'Safari' => '/Version\/([0-9\.]+).*Safari/',
        'Edge' => '/Edg\/([0-9\.]+)/',
        'Opera' => '/OPR\/([0-9\.]+)/',
        'Internet Explorer' => '/MSIE\s([0-9\.]+);/',
        'Windows' => '/Windows NT ([0-9\.]+)/',
        'macOS' => '/Mac OS X ([0-9_\.]+)/',
        'iOS' => '/iPhone OS ([0-9_\.]+)/',
        'Android' => '/Android ([0-9\.]+)/',
    ];

    // 合并自定义规则
    if (!empty($custom_rules) && is_array($custom_rules)) {
        $clients = array_merge($clients, $custom_rules);
    }

    $result = [];

    foreach ($clients as $name => $pattern) {
        if (preg_match($pattern, $user_agent, $matches)) {
            $result[$name] = str_replace('_', '.', $matches[1]);
        }
    }

    return $result;
}

三、使用示例

$client_info = get_client_version();

// 输出客户端信息
echo '<pre>';
print_r($client_info);
echo '</pre>';

四、支持自定义扩展

你可以通过传递自定义规则来检测专属的客户端特征，比如企业内部定制的应用客户端或某些特殊的浏览器壳。

$custom_rules = [
    'MyAppClient' => '/MyApp\/([0-9\.]+)/'
];

$client_info = get_client_version(null, $custom_rules);

// 输出客户端信息，包括自定义内容
echo '<pre>';
print_r($client_info);
echo '</pre>';

五、典型应用场景

用户分析：统计用户使用的浏览器和版本分布。
功能兼容性处理：针对不同浏览器或系统做兼容性优化。
安全策略：识别不受支持的客户端并禁止访问。
API 限制：根据客户端信息限制特定客户端调用某些接口。

六、部署建议

推荐在项目的公共入口处统一调用 get_client_version 并将结果缓存至 $_SESSION 或日志记录。
针对高并发环境建议结合 Redis 或文件缓存，避免重复解析。

七、参考链接

用户代理信息可以参考 MDN 的文档：https://developer.mozilla.org/
更多浏览器标识符：https://www.useragentstring.com/

get_client_version