PHP 如何识别手机、爬虫、浏览器?这个开源库帮你少写上千行正则

还在手写正则解析 User‑Agent 识别设备？jenssegers/agent 这款 Laravel 生态热门开源库，帮你一行代码完成客户端识别。

在 PHP Web 开发中，我们经常需要判断访问者是手机、平板、电脑还是爬虫。手写正则容易出错，维护成本高。

今天从程序员视角拆解 star4.7k 的开源项目 jenssegers/agent。

源代码：

https://github.com/jenssegers/agent

基于 Mobile‑Detect 二次封装，专门解析 HTTP User‑Agent 请求头字符串。

• 判断设备类型：手机、平板、桌面电脑，区分爬虫机器人；

• 提取浏览器名称、版本号、操作系统、设备型号；

• 获取浏览器语言列表，支持 Laravel 门面调用，也支持 CLI 手动传入 UA 字符串解析历史日志GitHub。

1. 服务端根据设备返回差异化内容，移动端输出精简页面，桌面端展示完整功能；

2. 过滤爬虫流量，统计真实用户访问数据，防止爬虫污染业务统计报表；

3. 做浏览器兼容判断，对老旧浏览器给出提示，记录访问设备用于日志埋点、用户行为分析；

4. Laravel 项目零成本接入，不用自己维护一堆复杂正则规则，降低业务代码量。

1. 原生 Mobile‑Detect 只侧重移动端识别，对桌面端、浏览器版本识别能力弱，项目补齐桌面设备检测能力；

2. 手写 User‑Agent 正则维护痛苦，浏览器、设备迭代快，正则经常失效，BUG 多；

3. 爬虫识别需要额外引入组件，该库内置爬虫检测，不用再集成别的包；

4. Laravel 生态缺少开箱即用的设备识别组件，原生框架没有相关能力。

1. 填补 Laravel 生态一体化设备识别组件空白，把移动、桌面、爬虫识别整合为一套 API；

2. 在 Mobile‑Detect 基础上，补齐桌面浏览器、操作系统信息提取，不只是简单判断是否手机；

3. 兼顾 Web 请求和离线日志解析场景，支持手动传入 UA 字符串，可用于分析历史访问日志；

4. 提供统一简洁的面向对象 API，开发者不用理解底层复杂的正则匹配细节。

普通人这里指 PHP/Laravel 开发人员

1. Composer 一行命令安装，Laravel 项目注册服务提供者与门面，业务代码直接调用 Agent::isMobile()；

2. Web 请求场景直接自动读取 header，在控制器中间件做设备判断，跳转不同视图；

3. 日志分析、脚本任务，使用 setUserAgent() 传入历史 UA 字符串做批量解析；

4. 高并发场景，把解析结果做缓存，避免每次请求重复解析字符串，提升接口性能。

示例代码片段

$agent = new Jenssegers\Agent\Agent(); if ($agent->isMobile()){     // 返回移动端页面 } if ($agent->isRobot()){     // 识别爬虫 }

1. 现状：项目最后正式版本 2020 年，近年更新停滞，底层依赖 Mobile‑Detect 版本老旧，新型 UA 识别会出现不准的情况，老项目稳定可用，新项目需要评估风险GitHub；

2. 短期复用价值：存量 Laravel 老系统首选，业务改动小，无需大规模重构；可以自行维护本地规则补丁，适配新设备、浏览器；

3. 长期演进方向：如果继续迭代，需要升级底层 Mobile‑Detect 依赖库，适配新一代移动端、UA‑Client‑Hints；

4. 替代方案：新项目可以考虑浏览器 Client‑Hints、其他活跃维护的 UA 解析库；现有业务不建议盲目升级，优先打规则补丁。

jenssegers/agent 是 Laravel 生态非常经典的 User‑Agent 解析库，把设备、浏览器、爬虫识别做了高度封装，大幅减少手写正则的工作量。 虽然官方已经很久没有大版本迭代，存量 PHP 老项目依然非常好用，新项目则要权衡设备规则更新问题，可自行扩展规则来适配新型设备。

源代码：https://github.com/jenssegers/agent

你们项目里会在服务端做设备识别吗？遇到过 User‑Agent 解析踩坑吗？欢迎留言聊聊你的实战经历。