PHPackages bogddan/agent - 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. bogddan/agent ActiveLibrary[Utility & Helpers](/categories/utility) bogddan/agent ============= Desktop/mobile user agent parser with support for Laravel, based on Mobiledetect 11.5k2[2 PRs](https://github.com/bogddan/agent/pulls)PHP Since Jun 1Pushed 2y agoCompare [ Source](https://github.com/bogddan/agent)[ Packagist](https://packagist.org/packages/bogddan/agent)[ RSS](/packages/bogddan-agent/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) Agent ===== [](#agent) [![Latest Stable Version](https://camo.githubusercontent.com/c467dfe5b393fa66b3e1a04162868c2afe280e95a100e58230b6748a25e258ec/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f426f676464616e2f6167656e742e737667)](https://packagist.org/packages/Bogddan/agent) [![Total Downloads](https://camo.githubusercontent.com/a54beb065d34f8641ce13ab2a6b869b185a23039c00d238a280ac79ccc064e87/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f426f676464616e2f6167656e742e737667)](https://packagist.org/packages/Bogddan/agent) [![Build Status](https://camo.githubusercontent.com/7062dc384ec20110151ded1921d661c12f63a57d370e2b84c7de53029f7120d8/687474703a2f2f696d672e736869656c64732e696f2f7472617669732f426f676464616e2f6167656e742e737667)](https://travis-ci.org/Bogddan/agent) [![Coverage Status](https://camo.githubusercontent.com/5441ae2e4af951a225cd066cdd588385ce76cacaab0dc98f380a677f515df7f0/687474703a2f2f696d672e736869656c64732e696f2f636f766572616c6c732f426f676464616e2f6167656e742e737667)](https://coveralls.io/r/Bogddan/agent) [![Donate](https://camo.githubusercontent.com/d47cdb766a100070d38a702d9c7760ccc8052063484e1478a26bcd16680d33af/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f6e6174652d70617970616c2d626c75652e737667)](https://www.paypal.me/Bogddan) A PHP desktop/mobile user agent parser with support for Laravel, based on [Mobile Detect](https://github.com/serbanghita/Mobile-Detect) with desktop support and additional functionality. [![](https://camo.githubusercontent.com/70074e6cbff3fb2a7dff681d8c51b0eb4adcefc997963e8cac6105948d70b3cb/68747470733a2f2f426f676464616e2e636f6d2f7374617469632f6d656469612f6167656e742e706e67)](https://camo.githubusercontent.com/70074e6cbff3fb2a7dff681d8c51b0eb4adcefc997963e8cac6105948d70b3cb/68747470733a2f2f426f676464616e2e636f6d2f7374617469632f6d656469612f6167656e742e706e67) Installation ------------ [](#installation) Install using composer: ``` composer require Bogddan/agent ``` Laravel (optional) ------------------ [](#laravel-optional) Add the service provider in `config/app.php`: ``` Bogddan\Agent\AgentServiceProvider::class, ``` And add the Agent alias to `config/app.php`: ``` 'Agent' => Bogddan\Agent\Facades\Agent::class, ``` Basic Usage ----------- [](#basic-usage) Start by creating an `Agent` instance (or use the `Agent` Facade if you are using Laravel): ``` use Bogddan\Agent\Agent; $agent = new Agent(); ``` If you want to parse user agents other than the current request in CLI scripts for example, you can use the `setUserAgent` and `setHttpHeaders` methods: ``` $agent->setUserAgent('Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/537.13+ (KHTML, like Gecko) Version/5.1.7 Safari/534.57.2'); $agent->setHttpHeaders($headers); ``` All of the original [Mobile Detect](https://github.com/serbanghita/Mobile-Detect) methods are still available, check out some original examples at ### Is? [](#is) Check for a certain property in the user agent. ``` $agent->is('Windows'); $agent->is('Firefox'); $agent->is('iPhone'); $agent->is('OS X'); ``` ### Magic is-method [](#magic-is-method) Magic method that does the same as the previous `is()` method: ``` $agent->isAndroidOS(); $agent->isNexus(); $agent->isSafari(); ``` ### Mobile detection [](#mobile-detection) Check for mobile device: ``` $agent->isMobile(); $agent->isTablet(); ``` ### Match user agent [](#match-user-agent) Search the user agent with a regular expression: ``` $agent->match('regexp'); ``` Additional Functionality ------------------------ [](#additional-functionality) ### Accept languages [](#accept-languages) Get the browser's accept languages. Example: ``` $languages = $agent->languages(); // ['nl-nl', 'nl', 'en-us', 'en'] ``` ### Device name [](#device-name) Get the device name, if mobile. (iPhone, Nexus, AsusTablet, ...) ``` $device = $agent->device(); ``` ### Operating system name [](#operating-system-name) Get the operating system. (Ubuntu, Windows, OS X, ...) ``` $platform = $agent->platform(); ``` ### Browser name [](#browser-name) Get the browser name. (Chrome, IE, Safari, Firefox, ...) ``` $browser = $agent->browser(); ``` ### Desktop detection [](#desktop-detection) Check if the user is using a desktop device. ``` $agent->isDesktop(); ``` *This checks if a user is not a mobile device, tablet or robot.* ### Phone detection [](#phone-detection) Check if the user is using a phone device. ``` $agent->isPhone(); ``` ### Robot detection [](#robot-detection) Check if the user is a robot. This uses [jaybizzle/crawler-detect](https://github.com/JayBizzle/Crawler-Detect) to do the actual robot detection. ``` $agent->isRobot(); ``` ### Robot name [](#robot-name) Get the robot name. ``` $robot = $agent->robot(); ``` ### Browser/platform version [](#browserplatform-version) MobileDetect recently added a `version` method that can get the version number for components. To get the browser or platform version you can use: ``` $browser = $agent->browser(); $version = $agent->version($browser); $platform = $agent->platform(); $version = $agent->version($platform); ``` *Note, the version method is still in beta, so it might not return the correct result.* License ------- [](#license) Laravel User Agent is licensed under [The MIT License (MIT)](LICENSE). Security contact information ---------------------------- [](#security-contact-information) To report a security vulnerability, follow [these steps](https://tidelift.com/security). ### Health Score 20 — LowBetter than 14% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity18 Limited adoption so far Community20 Small or concentrated contributor base Maturity22 Early-stage or recently created project Bus Factor1 Top contributor holds 76.4% 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/9ebd8160e19b4dd4fbb18ac41537a6186681d9f1a2e2635ddf3c255191882ef6?d=identicon)[bogddan](/maintainers/bogddan) --- Top Contributors [![jenssegers](https://avatars.githubusercontent.com/u/194377?v=4)](https://github.com/jenssegers "jenssegers (155 commits)")[![bogddan](https://avatars.githubusercontent.com/u/7372065?v=4)](https://github.com/bogddan "bogddan (5 commits)")[![Skaronator](https://avatars.githubusercontent.com/u/2886913?v=4)](https://github.com/Skaronator "Skaronator (5 commits)")[![mpetty](https://avatars.githubusercontent.com/u/1807888?v=4)](https://github.com/mpetty "mpetty (4 commits)")[![vinkla](https://avatars.githubusercontent.com/u/499192?v=4)](https://github.com/vinkla "vinkla (3 commits)")[![ThaDafinser](https://avatars.githubusercontent.com/u/533017?v=4)](https://github.com/ThaDafinser "ThaDafinser (3 commits)")[![ElfSundae](https://avatars.githubusercontent.com/u/526008?v=4)](https://github.com/ElfSundae "ElfSundae (3 commits)")[![JayBizzle](https://avatars.githubusercontent.com/u/340752?v=4)](https://github.com/JayBizzle "JayBizzle (3 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (3 commits)")[![sebastiaanspeck](https://avatars.githubusercontent.com/u/12570668?v=4)](https://github.com/sebastiaanspeck "sebastiaanspeck (2 commits)")[![jwpage](https://avatars.githubusercontent.com/u/52687?v=4)](https://github.com/jwpage "jwpage (2 commits)")[![loclv](https://avatars.githubusercontent.com/u/6302717?v=4)](https://github.com/loclv "loclv (2 commits)")[![BertKooij](https://avatars.githubusercontent.com/u/3949189?v=4)](https://github.com/BertKooij "BertKooij (2 commits)")[![yaoshanliang](https://avatars.githubusercontent.com/u/5028569?v=4)](https://github.com/yaoshanliang "yaoshanliang (1 commits)")[![CaddyDz](https://avatars.githubusercontent.com/u/13698160?v=4)](https://github.com/CaddyDz "CaddyDz (1 commits)")[![dan-har](https://avatars.githubusercontent.com/u/8581476?v=4)](https://github.com/dan-har "dan-har (1 commits)")[![doggieliu](https://avatars.githubusercontent.com/u/66601667?v=4)](https://github.com/doggieliu "doggieliu (1 commits)")[![evrard-c](https://avatars.githubusercontent.com/u/23173851?v=4)](https://github.com/evrard-c "evrard-c (1 commits)")[![jonathan-bird](https://avatars.githubusercontent.com/u/1510001?v=4)](https://github.com/jonathan-bird "jonathan-bird (1 commits)")[![KikoPalomares](https://avatars.githubusercontent.com/u/6002391?v=4)](https://github.com/KikoPalomares "KikoPalomares (1 commits)") ### Embed Badge ![Health badge](/badges/bogddan-agent/health.svg) ``` [![Health](https://phpackages.com/badges/bogddan-agent/health.svg)](https://phpackages.com/packages/bogddan-agent) ``` ### Alternatives [prooph/php-cs-fixer-config PHP CS Fixer config for prooph components 2474.8k65](/packages/prooph-php-cs-fixer-config) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)