Download the PHP package larva/agent without Composer

Agent

桌面端 / 移动端 User-Agent 解析库，基于 Mobile Detect 扩展了桌面设备识别、浏览器与操作系统识别等能力，并对 Laravel 提供开箱即用的支持。

关于本仓库

本项目 Fork 自 jenssegers/agent。原仓库已停止维护，本仓库在其基础上继续维护，主要变更：

• 包名由 jenssegers/agent 改为 larva/agent，命名空间由 Jenssegers\Agent 改为 Larva\Agent
• 底层依赖升级到 Mobile Detect 4.x，最低要求 PHP 8.2，全量补齐强类型声明
• 支持 Laravel 包自动发现（无需手动注册 ServiceProvider 与 Facade）
• 新增 deviceType() 方法，一次性返回设备类型
• 补充完整测试套件与 GitHub Actions CI

环境要求

• PHP >= 8.4
• ext-mbstring

安装

Laravel 集成

本包已支持 Laravel 包自动发现，安装后即可直接使用 Agent Facade，无需任何额外配置。

如果你禁用了自动发现，请在 config/app.php 中手动注册：

基本用法

默认会自动从 $_SERVER 读取当前请求的 HTTP 头。在 CLI 脚本或需要解析指定 UA 时，使用 setUserAgent() 或 setHttpHeaders()：

如果不希望自动读取 $_SERVER（例如在测试或队列任务中），可以关闭自动初始化：

注意：未设置 User-Agent 就调用 isMobile()、isTablet()、is() 等方法会抛出 Detection\Exception\MobileDetectException。

Mobile Detect 的原生方法依然可用，更多示例见 Mobile Detect Code Examples。

属性判断

检查 User-Agent 是否命中某条规则：

也可以使用等价的魔术方法：

设备类型判断

一次性获取设备类型，返回 desktop / phone / tablet / robot：

正则匹配

扩展功能

以下方法在未识别时统一返回 false。

语言偏好

解析 Accept-Language，按优先级从高到低返回：

设备名称

如 iPhone、iPad、Macintosh、Nexus 等：

操作系统名称

如 Windows、OS X、Ubuntu、AndroidOS、iOS、ChromeOS 等：

浏览器名称

如 Chrome、Firefox、Safari、Edge、Opera、Vivaldi、UCBrowser、IE 等：

爬虫名称

爬虫识别基于 jaybizzle/crawler-detect：

版本号

版本号提取依赖 UA 字符串中的特征片段，部分设备或浏览器可能无法准确返回。

从 jenssegers/agent 迁移

除了替换 composer 依赖和命名空间（Jenssegers\Agent → Larva\Agent），还需注意以下由 Mobile Detect 4.x 引入的破坏性变更：

测试

贡献

欢迎提交 Issue 与 Pull Request。提交 PR 前请确保测试通过，并为新增行为补充对应用例。

许可协议

本项目基于 MIT License 开源。