mimmi20/ua-result

This package is abandoned and no longer maintained. No replacement package was suggested.

Library for PHP 7.4+ to handle useragent parser results

9.0.3 2023-08-15 06:58 UTC

Requires

• php: ^8.1.0
• ext-mbstring: *
• mimmi20/browser-detector-version: ^8.0.0
• mimmi20/ua-browser-type: ^9.0.0
• mimmi20/ua-device-type: ^9.0.0

Requires (Dev)

• ext-ctype: *
• ext-dom: *
• ext-simplexml: *
• ext-tokenizer: *
• ext-xml: *
• ext-xmlwriter: *
• infection/infection: ^0.27.0
• mimmi20/coding-standard: ^5.1.10
• nikic/php-parser: ^4.17.1
• phpstan/extension-installer: ^1.3.1
• phpstan/phpstan: ^1.10.29
• phpstan/phpstan-deprecation-rules: ^1.1.4
• phpstan/phpstan-phpunit: ^1.3.13
• phpunit/phpunit: ^10.3.1
• rector/rector: ^0.17.13
• vimeo/psalm: ^5.14.1

MIT

• Thomas Müller
• Contributors

• http
• parser
• browser
• user agent
• user-agent

README

Code Status

Description

This library provides a set of classes representing a result of an useragent detection.

Requirements

This library requires PHP 7.4+. Also a PSR-3 compatible logger is required.

Installation

Run the command below to install via Composer

composer require mimmi20/ua-result

The result object

The result object is the main object and contains only other objects.

The browser object

The browser object represents the detected browser.

// get the result by detection or create it

$browser = $result->getBrowser();

// get the name
$name = $browser->getName();

// get the manufaturer
$manCompany = $browser->getManufacturer()->getName();
$manBrand   = $browser->getManufacturer()->getBrandName();

// get the version
$name = $browser->getVersion()->getVersion();

// get the type
$type  = $browser->getType()->getName();
$isbot = $browser->getType()->isBot();

The engine object

The engine object represents the detected rendering engine.

// get the result by detection or create it

$engine = $result->getEngine();

// get the name
$name = $engine->getName();

// get the manufaturer
$manCompany = $engine->getManufacturer()->getName();
$manBrand   = $engine->getManufacturer()->getBrandName();

// get the version
$name = $engine->getVersion()->getVersion();

The device object

The device object represents the detected device.

// get the result by detection or create it

$device = $result->getDevice();

// get the (code) name
$name = $device->getDeviceName();
// the device may have a different marketing name
$mname = $device->getMarketingName();

// get the manufaturer
$manCompany = $device->getManufacturer()->getName();
$manBrand   = $device->getManufacturer()->getBrandName();
// the device may be a branded version
$brand = $device->getBrand()->getBrandName();

// does the device support dual orientation?
$dualorien = $device->getDualOrientation();

// get the pointing method
$pointing = $device->getPointingMethod();

// get the display dimensions
$height = $device->getResolutionHeight();
$width  = $device->getResolutionWidth();

// get some more information about the device type
$type     = $device->getType()->getName();
$isPhone  = $device->getType()->isPhone();
$isTablet = $device->getType()->isTablet();

The platform object

The os object represents the detected platform.

// get the result by detection or create it

$platform = $result->getOs();

// get the (code) name
$name  = $platform->getName();
// the platform may have a different marketing name
$mname = $platform->getMarketingName();

// get the manufaturer
$manCompany = $platform->getManufacturer()->getName();
$manBrand   = $platform->getManufacturer()->getBrandName();

// get the version
$name = $platform->getVersion()->getVersion();

Issues and feature requests

Please report your issues and ask for new features on the GitHub Issue Tracker at https://github.com/mimmi20/ua-result/issues