公司动态

3行代码快速识别访客浏览器:PhpUserAgent入门教程与Composer安装指南

📅 2026/8/27 14:48:11
3行代码快速识别访客浏览器:PhpUserAgent入门教程与Composer安装指南
3行代码快速识别访客浏览器PhpUserAgent入门教程与Composer安装指南【免费下载链接】PhpUserAgentLightning Fast, Minimalist PHP User Agent String Parser.项目地址: https://gitcode.com/gh_mirrors/ph/PhpUserAgentPhpUserAgent 是一个极速、极简的 PHP UserAgent用户代理解析器只需 3 行代码就能识别访客的浏览器、浏览器版本和操作系统平台。它不到 200 行核心代码仅靠 3 个正则表达式即可准确解析几乎所有现代浏览器非常适合做访问统计、按设备适配样式或屏蔽爬虫等场景。为什么选择 PhpUserAgent相比其他笨重的浏览器识别方案PhpUserAgent 的核心卖点就 4 个⚡快解析逻辑轻量没有知识引擎式的大数据表运行开销极低小核心解析代码不到 200 行由 3 个正则表达式构成见 src/UserAgentParser.php✅准100% 单元测试覆盖对特殊版本 IE 等疑难杂症的识别准确率很高易用支持 Composer 安装函数式和对象式两种调用风格兼容 PHP 5.4它内置识别能力一览类别覆盖数量示例操作系统平台35Windows、Android、iPad、PlayStation 5、Nintendo Switch浏览器50Chrome、Safari、Edge、Firefox、Opera、Vivaldi爬虫机器人70Googlebot、Baiduspider、bingbot、GPTBot、AhrefsBot完整清单可查看 src/UserAgent/Platforms.php、src/UserAgent/Browsers.php 和 src/UserAgent/Bots.php 三个常量文件。最快安装方法一条 Composer 命令搞定打开终端在你的 PHP 项目根目录执行composer require donatj/phpuseragentparser环境要求PHP 5.4.0ext-ctype扩展详见 composer.json。 若你偏好直接克隆源码仓库地址为 https://gitcode.com/gh_mirrors/ph/PhpUserAgent安装完成后无需任何额外配置自动加载文件会自动注册解析函数。快速上手函数式 3 行代码调用最经典的函数式用法参考 examples/procedural.php// 自动读取 $_SERVER[HTTP_USER_AGENT] $uaInfo donatj\UserAgent\parse_user_agent(); echo $uaInfo[donatj\UserAgent\PLATFORM]; // 平台如 Windows echo $uaInfo[donatj\UserAgent\BROWSER]; // 浏览器如 Chrome echo $uaInfo[donatj\UserAgent\BROWSER_VERSION]; // 版本如 120.0也支持传入自定义 UserAgent 字符串手动解析方便写测试。面向对象更优雅的 Parser 封装1.x 版本新增了对象式封装 src/UserAgent/UserAgentParser.php返回带方法的 UserAgent 结果对象参考 examples/object-oriented.php$parser new \donatj\UserAgent\UserAgentParser(); $ua $parser-parse(); // 也可以写成 $parser() echo $ua-platform(); // 平台 echo $ua-browser(); // 浏览器 echo $ua-browserVersion(); // 浏览器版本⚠️ 注意0.x 时代的无前缀全局函数parse_user_agent()已标记弃用请使用带命名空间的\donatj\UserAgent\parse_user_agent两者行为完全一致。常见使用场景统计报表按platform()区分移动端 / 桌面端访客按browser()统计浏览器占比屏蔽爬虫结合 src/UserAgent/Bots.php 常量判断访客是否为 Googlebot 等机器人兼容性适配识别老旧 IE 版本后下发降级 CSS需要知道的限制PhpUserAgent 是解析器而非浏览器知识引擎有几点需要留意❌不提供操作系统版本号——UA 字符串中的 OS 版本不可靠作者有意保持精简❌Brave 无法与 Chrome 区分——这是 Brave 自己的设计决策❌iPadOS 13 与 macOS 无法区分——苹果让两者返回完全相同的 UA 字符串项目结构速览路径说明src/UserAgentParser.php核心解析函数含弃用的全局函数兼容层src/UserAgent/UserAgentParser.php面向对象解析器封装src/UserAgent/UserAgent.php解析结果对象platform/browser/versiontests/user_agents.dist.json100% 覆盖的测试用 UA 数据集phpunit.xml.distPHPUnit 测试配置想为它贡献新浏览器支持阅读 CONTRIBUTING.md 即可上手——项目对代码的极简原则要求很高欢迎提交精巧的实现。【免费下载链接】PhpUserAgentLightning Fast, Minimalist PHP User Agent String Parser.项目地址: https://gitcode.com/gh_mirrors/ph/PhpUserAgent创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考