PHPackages                             udger/udger-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. udger/udger-php

ActiveLibrary[Utility & Helpers](/categories/utility)

udger/udger-php
===============

PHP agent string parser based on Udger https://udger.com/products/local\_parser

3.1.5(9mo ago)15158.5k↓21.7%18[2 issues](https://github.com/udger/udger-php/issues)MITPHPPHP >=5.5.0

Since Jan 22Pushed 9mo ago6 watchersCompare

[ Source](https://github.com/udger/udger-php)[ Packagist](https://packagist.org/packages/udger/udger-php)[ RSS](/packages/udger-udger-php/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (10)Dependencies (3)Versions (12)Used By (0)

Udger client for PHP (data ver. 3)
==================================

[](#udger-client-for-php-data-ver-3)

Local parser is very fast and accurate useragent string detection solution. Enables developers to locally install and integrate a highly-scalable product. We provide the detection of the devices (personal computer, tablet, Smart TV, Game console etc.), operating system, client SW type (browser, e-mail client etc.) and devices market name (example: Sony Xperia Tablet S, Nokia Lumia 820 etc.). It also provides information about IP addresses (Public proxies, VPN services, Tor exit nodes, Fake crawlers, Web scrapers, Datacenter name .. etc.)

- Tested with more the 50.000 unique user agents.
- Up to date data provided by

### Requirements

[](#requirements)

- php >= 5.5.0
- ext-sqlite3 ()
- datafile v3 (udgerdb\_v3.dat) from

### Features

[](#features)

- Fast
- LRU cache
- Released under the MIT

### Install

[](#install)

```
composer require udger/udger-php

```

### Usage

[](#usage)

You should review the included examples (`parse.php`, `account.php`)

Here's a quick example:

```
require_once dirname(__DIR__) . '/vendor/autoload.php';
$factory = new Udger\ParserFactory();
$parser = $factory->getParser();
$parser->setDataFile(sys_get_temp_dir() . "/udgercache/udgerdb_v3.dat");
//$parser->setCacheEnable(false);
//$parser->setCacheSize(4000);
$parser->setUA('Mozilla/5.0 (Linux; Android 5.1.1; SAMSUNG SM-A510F Build/LMY47X) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/3.5 Chrome/38.0.2125.102 Mobile Safari/537.36');
$parser->setIP("2A02:598:7000:116:0:0:0:101");
$ret = $parser->parse();
echo "";
print_r($ret);
echo "";

Array
(
        [user_agent] => Array
        (
            [ua_string] => Mozilla/5.0 (Linux; Android 5.1.1; SAMSUNG SM-A510F Build/LMY47X) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/3.5 Chrome/38.0.2125.102 Mobile Safari/537.36
            [ua_class] => Mobile browser
            [ua_class_code] => mobile_browser
            [ua] => Mobile Samsung Browser 3.5
            [ua_version] => 3.5
            [ua_version_major] => 3
            [ua_uptodate_current_version] =>
            [ua_family] => Mobile Samsung Browser
            [ua_family_code] => mobile_samsung_browser
            [ua_family_homepage] => http://developer.samsung.com/internet
            [ua_family_vendor] => SAMSUNG
            [ua_family_vendor_code] => samsung
            [ua_family_vendor_homepage] => http://www.samsung.com/
            [ua_family_icon] => samsung_browser.png
            [ua_family_icon_big] => samsung_browser_big.png
            [ua_family_info_url] => https://udger.com/resources/ua-list/browser-detail?browser=Mobile Samsung Browser
            [ua_engine] => WebKit/Blink
            [os] => Android 5.1 lollipop
            [os_code] => android_5_1
            [os_homepage] => https://en.wikipedia.org/wiki/Android_Lollipop
            [os_icon] => android.png
            [os_icon_big] => android_big.png
            [os_info_url] => https://udger.com/resources/ua-list/os-detail?os=Android 5.1 lollipop
            [os_family] => Android
            [os_family_code] => android
            [os_family_vendor] => Google, Inc.
            [os_family_vendor_code] => google_inc
            [os_family_vendor_homepage] => https://www.google.com/about/company/
            [device_class] => Smartphone
            [device_class_code] => smartphone
            [device_class_icon] => phone.png
            [device_class_icon_big] => phone_big.png
            [device_class_info_url] => https://udger.com/resources/ua-list/device-detail?device=Smartphone
            [device_marketname] => Galaxy A5 (2016)
            [device_vendor] => Samsung
            [device_vendor_code] => samsung
            [device_vendor_homepage] => http://www.samsung.com/
            [device_vendor_icon] => samsung.png
            [crawler_last_seen] =>
            [crawler_category] =>
            [crawler_category_code] =>
            [crawler_respect_robotstxt] =>
        )

    [ip_address] => Array
        (
            [ip] => 2A02:598:7000:116:0:0:0:101
            [ip_ver] => 6
            [ip_classification] => Crawler
            [ip_classification_code] => crawler
            [ip_hostname] =>
            [ip_last_seen] => 2016-02-12 04:28:56
            [ip_country] => Czech Republic
            [ip_country_code] => CZ
            [ip_city] => Prague
            [crawler_name] => SeznamBot/3.2-test1
            [crawler_ver] => 3.2-test1
            [crawler_ver_major] => 3
            [crawler_family] => SeznamBot
            [crawler_family_code] => seznambot
            [crawler_family_homepage] => http://napoveda.seznam.cz/cz/seznambot.html
            [crawler_family_vendor] => Seznam.cz, a.s.
            [crawler_family_vendor_code] => seznam-cz_as
            [crawler_family_vendor_homepage] => http://www.seznam.cz/
            [crawler_family_icon] => seznam.png
            [crawler_family_info_url] => https://udger.com/resources/ua-list/bot-detail?bot=SeznamBot#id12590
            [crawler_last_seen] => 2016-02-15 06:12:28
            [crawler_category] => Search engine bot
            [crawler_category_code] => search_engine_bot
            [crawler_respect_robotstxt] => unknown
            [datacenter_name] =>
            [datacenter_name_code] =>
            [datacenter_homepage] =>
        )

)
```

### Running tests

[](#running-tests)

```
./vendor/bin/codecept run

```

### Automatic updates download

[](#automatic-updates-download)

- for autoupdate data use Udger data updater ()

### Documentation for programmers

[](#documentation-for-programmers)

-

### Author

[](#author)

- The Udger.com Team ()

### old v2 format

[](#old-v2-format)

If you still use the previous format of the db (v2), please see the branch old\_format\_v2

###  Health Score

49

—

FairBetter than 94% of packages

Maintenance55

Moderate activity, may be stable

Popularity42

Moderate usage in the ecosystem

Community20

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 74.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~448 days

Recently: every ~810 days

Total

9

Last Release

274d ago

Major Versions

v1.4.1 → v3.0.02016-07-16

PHP version history (2 changes)v1.4.0PHP >=5.3.0

3.1.5PHP >=5.5.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/729b63540538eaca1afcc429052a9f62ddeda38a0f0097edb7bad09e00592be2?d=identicon)[mallat](/maintainers/mallat)

---

Top Contributors

[![mallat](https://avatars.githubusercontent.com/u/5707281?v=4)](https://github.com/mallat "mallat (26 commits)")[![joewreschnig](https://avatars.githubusercontent.com/u/1330897?v=4)](https://github.com/joewreschnig "joewreschnig (3 commits)")[![moknomo](https://avatars.githubusercontent.com/u/2641095?v=4)](https://github.com/moknomo "moknomo (3 commits)")[![adaamz](https://avatars.githubusercontent.com/u/4347332?v=4)](https://github.com/adaamz "adaamz (1 commits)")[![shawnbayer](https://avatars.githubusercontent.com/u/10172577?v=4)](https://github.com/shawnbayer "shawnbayer (1 commits)")[![tiborb](https://avatars.githubusercontent.com/u/3955068?v=4)](https://github.com/tiborb "tiborb (1 commits)")

---

Tags

bot-detectiondevice-detectormobile-detectionuser-agent-parser

###  Code Quality

TestsCodeception

### Embed Badge

![Health badge](/badges/udger-udger-php/health.svg)

```
[![Health](https://phpackages.com/badges/udger-udger-php/health.svg)](https://phpackages.com/packages/udger-udger-php)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.9k556.2M21.5k](/packages/laravel-framework)[craftcms/cms

Craft CMS

3.6k3.7M3.4k](/packages/craftcms-cms)[tempest/framework

The PHP framework that gets out of your way.

2.3k37.6k21](/packages/tempest-framework)[google/cloud-core

Google Cloud PHP shared dependency, providing functionality useful to all components.

346137.0M127](/packages/google-cloud-core)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.8M674](/packages/shopware-core)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

353.6k](/packages/eslazarev-wildberries-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)