README

PHP port of ua-parser-modern - detect Browser, Engine, OS, CPU, and Device type/model from User-Agent strings.

All regex patterns are ported 1:1 from the original JavaScript source to ensure identical detection behavior.

Requirements

PHP 8.2+
ext-mbstring

Installation

composer require flycro/ua-parser-modern-php

Usage

Parse everything at once

use UaParserModern\UserAgentParser;

$result = UserAgentParser::parse($userAgent);

$result->browser->name;    // 'Chrome'
$result->browser->version; // '120.0.0.0'
$result->browser->major;   // '120'

$result->os->name;         // 'Windows'
$result->os->version;      // '10'

$result->device->model;    // null
$result->device->type;     // null
$result->device->vendor;   // null

$result->engine->name;     // 'Blink'
$result->engine->version;  // '120.0.0.0'

$result->cpu->architecture; // 'amd64'

Parse individual components

Only parse what you need:

$browser = UserAgentParser::parseBrowser($userAgent);
$browser->name;    // 'Chrome'
$browser->version; // '120.0.0.0'
$browser->major;   // '120'

$os = UserAgentParser::parseOS($userAgent);
$os->name;    // 'Windows'
$os->version; // '10'

$device = UserAgentParser::parseDevice($userAgent);
$engine = UserAgentParser::parseEngine($userAgent);
$cpu    = UserAgentParser::parseCPU($userAgent);

JSON serialization

All result objects implement JsonSerializable:

$result = UserAgentParser::parse($userAgent);

json_encode($result);
// {"ua":"...","browser":{"name":"Chrome","version":"120.0.0.0","major":"120"},...}

Convert to array

$result->toArray();          // Full nested array
$result->browser->toArray(); // ['name' => 'Chrome', 'version' => '120.0.0.0', 'major' => '120']

Result Types

All results are readonly value objects:

Method	Return Type	Properties
`parse()`	`ParseResult`	`ua`, `browser`, `device`, `engine`, `os`, `cpu`
`parseBrowser()`	`BrowserResult`	`name`, `version`, `major`
`parseDevice()`	`DeviceResult`	`model`, `type`, `vendor`
`parseEngine()`	`EngineResult`	`name`, `version`
`parseOS()`	`OSResult`	`name`, `version`
`parseCPU()`	`CPUResult`	`architecture`

Testing

composer test

Credits

This is a PHP port of ua-parser-modern by Anthony Fu, which was forked from my-ua-parser by Matteo Collina, which was a fork of ua-parser-js by Faisal Salman.

License

The MIT License (MIT). Please see License File for more information.

flycro / ua-parser-modern-php

Maintainers

Package info

Statistics

Security