Download the PHP package whichbrowser/parser without Composer

On this page you can find all versions of the php package whichbrowser/parser. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?
whichbrowser/parser
Rate from 1 - 5
Rated 5.00 based on 2 reviews

Example code of whichbrowser/parser

Informations about the package parser

This is an extremely complicated and almost completely useless browser sniffing library. Useless because you shouldn't use browser sniffing. So stop right now and go read something about feature detecting instead. I'm serious. Go away. You'll thank me later.

WhichBrowser/Parser-PHP

The PHP version of WhichBrowser for use on a server. Fully compatible with PHP 7.0 or higher, including PHP 8.

Build Coverage Status License Latest Stable Version

Twitter Follow

Also available:

About WhichBrowser

But why almost completely useless and not completely useless? Well, there is always an exception to the rule. There are valid reasons to do browser sniffing: to improve the user experience or to gather intelligence about which browsers are used on your website. My website is html5test.com and I wanted to know which score belongs to which browser. And to do that you need a browser sniffing library.

Why is it extremely complicated?
Because everybody lies. Seriously, there is not a single browser that is completely truthful. Almost all browsers say they are Netscape 5 and almost all WebKit browsers say they are based on Gecko. Even Internet Explorer 11 now no longer claims to be IE at all, but instead an unnamed browser that is like Gecko. And it gets worse. That is why it is complicated.

What kind of information does it give? You get a nice object which has information about the browser, rendering engine, os and device. It gives you names and versions and even device manufacturer and model. And WhichBrowser is pretty tenacious. It gives you info that others don't. For example:

JUC (Linux; U; 2.3.6; zh-cn; GT-I8150; 480*800) UCWEB8.7.4.225/145/800  
UC Browser 8.7 on a Samsung Galaxy W running Android 2.3.6

Android is never mentioned

Mozilla/5.0 (Series40; Nokia501/10.0.2; Profile/MIDP-2.1 Configuration/CLDC-1.1) Gecko/20100401 S40OviBrowser/3.0.0.0.73  
Nokia Xpress 3.0.0 on a Nokia Asha 501 running Nokia Asha Platform

Despite the useragent header claiming to be a Series40 device, we know it's actually running the Asha Platform and we also know that OviBrowser has been renamed to Nokia Xpress.

Opera/9.80 (X11; Linux zvav; U; zh) Presto/2.8.119 Version/11.10  
Opera Mini on a Nokia 5230 running Series60 5.0

The useragent header looks like Opera 11.10 on Linux, but we know it's Opera Mini. We can even figure out the real operating system and device model from other headers.

Requirements

WhichBrowser requires with PHP 7.0 or higher and supports PHP 8. WhichBrowser is compatible with the PSR-4 autoloading standard and follows PSR-1 and PSR-2 coding style.

How to install it

You can install WhichBrowser by using Composer - the standard package manager for PHP. The package is called whichbrowser/parser.

composer require whichbrowser/parser

You can easily update WhichBrowser by running a simple command.

composer update whichbrowser/parser

You should run this command as often as possible. You might even want to consider setting up a cron job for this purpose.

How to use it

The first step require the Composer autoloader:

The second step is to create a new WhichBrowser\Parser object. This object will contain all the information the library could find about the browser. The object has a required parameter, either the headers send by the browser, or a useragent string. Using the headers is preferable, because it will allow a better detection, but if you have just the useragent string, this will also work.

For example:

or:

The variable $result now contains an object which you can query for information. There are various ways to access the information.

First of all, you can call to toString() function to get a human readable identification:

Another possiblity is to query the object:

You can also access these properties directly:

Or access parts of these properties directly:

Finally you can also query versions directly:

Options

It is possible to set additional options by passing an array as the second parameter when creating the Parser object.

Disabling detection of bots

In some cases you may want to disable the detection of bots. This allows the bot the deliberately fool WhichBrowser, so you can pick up the identity of useragent what the bot tries to mimic. This is especially handy when you want to use WhichBrowser to switch between different variants of your website and want to make sure crawlers see the right variant of the website. For example, a bot that mimics a mobile device will see the mobile variant of you site.

Enable result caching

WhichBrowser supports PSR-6 compatible cache adapters for caching results between requests. Using a cache is especially useful if you use WhichBrowser on every page of your website and a user visits multiple pages. During the first visit the headers will be parsed and the result will be cached. Upon further visits, the cached results will be used, which is much faster than having to parse the headers again and again.

There are adapters available for other types of caches, such as APC, Doctrine, Memcached, MongoDB, Redis and many more. The configuration of these adapters all differ from each other, but once configured, all you have to do is pass it as an option when creating the Parser object, or use the setCache() function to set it afterwards. WhichBrowser has been tested to work with the adapters provided by PHP Cache. For a list of other packages that provide adapters see Packagist.

For example, if you want to enable a memcached based cache you need to install an extra composer package:

composer require cache/memcached-adapter

And change the call to WhichBrowser/Parser as follows:

or

You can also specify after how many seconds a cached result should be discarded. The default value is 900 seconds or 15 minutes. If you think WhichBrowser uses too much memory for caching, you should lower this value. You can do this by setting the cacheExpires option or passing it as a second parameter to the setCache() function.

API reference

The Parser object

After a new WhichBrowser\Parser object is created, it contains a number of properties and functions. All of these properties are guaranteed to be present.

Properties:

Functions:

getType()
Returns the type and subtype property of the device object. If a subtype is present it is concatenated to the type and seperated by a semicolor, for example: mobile:smart or gaming:portable. If the subtype is not applicable, it just return the type, for example: desktop or ereader.

isType($type [,$type [,$type [,$type]]])
If a single argument is used, the function returns true if the argument matches the type propery of device object. The argument can optionally also provide a subtype by concatenating it to the type and seperating it with a semicolon. It can use multiple arguments in which case the function returns true if one of the arguments matches. If none of the arguments matches, it returns false

isMobile()
Return true if the browser is a mobile device, like a phone, tablet, ereader, camera, portable media player, watch or portable gaming console. Otherwise it returns false.

isBrowser($name [, $comparison, $version])
Is used to query the name and version property of the browser object. The funcion can contain a single argument to a simple comparison based on name, or three arguments to compare both name and version. The first argument always contains the name of the browser. The second arguments is a string that can container either <, <=, =, => or >. The third is an integer, float or string that contains the version. You can use versions like 10, 10.7 or '10.7.4'. For more information about how version comparisons are performed, please see the is() function of the Version object.

isEngine($name [, $comparison, $version])
Is used to query the name and version property of the engine object. This function works in exactly the same way as isBrowser.

isOs($name [, $comparison, $version])
Is used to query the name and version property of the os object. This function works in exactly the same way as isBrowser.

isDetected()
Is there actually some browser detected, or did we fail to detect anything?

toString()
Get a human readable representation of the detected browser, including operating system and device information.

The browser object

An object of the WhichBrowser\Model\Browser class is used for the browser property of the main WhichBrowser\Parser object and contains a number of properties. If a property is not applicable in this situation it will be null or undefined.

Properties:

Functions:

isFamily($name)
Does the family of this browser have this name, or does the browser itself have this name.

isUsing($name)
Is the browser using a webview using with the provided name.

getName()
Get the name of the browser

getVersion()
Get the version of the browser

toString()
Get a human readable representation of the detected browser

The engine object

An object of the WhichBrowser\Model\Engine class is used for the engine property of the main WhichBrowser\Parser object and contains a number of properties. If a property is not applicable in this situation it will be null or undefined.

Properties:

Functions:

getName()
Get the name of the rendering engine

getVersion()
Get the version of the rendering engine

toString()
Get a human readable representation of the detected rendering engine

The os object

An object of the WhichBrowser\Model\Os class is used for the os property of the main WhichBrowser\Parser object and contains a number of properties. If a property is not applicable in this situation it will be null or undefined.

Properties:

Functions:

isFamily($name)
Does the family of this operating system have this name, or does the operating system itself have this name.

getName()
Get the name of the operating system

getVersion()
Get the version of the operating system

toString()
Get a human readable representation of the detected operating system

The device object

An object of the WhichBrowser\Model\Device class is used for the device property of the main WhichBrowser\Parser object and contains a number of properties. If a property is not applicable in this situation it will be null or undefined.

Properties:

The type property can contain any value from the following list:

If the type is "mobile", the subtype property can contain any value from the following list:

If the type is "gaming", the subtype property can contain any value from the following list:

Functions:

getManufacturer()
Get the name of the manufacturer

getModel()
Get the name of the model

toString()
Get a human readable representation of the detected device

The family object

An object of the WhichBrowser\Model\Family class is used for the family property of the WhichBrowser\Model\Browser and WhichBrowser\Model\Os object and contains a number of properties. If a property is not applicable in this situation it will be null or undefined.

Properties:

Functions:

getName()
Get the name of the family

getVersion()
Get the version of the family

toString()
Get a human readable representation of the family

The using object

An object of the WhichBrowser\Model\Using class is used for the using property of the WhichBrowser\Model\Browser object and contains a number of properties. If a property is not applicable in this situation it will be null or undefined.

Properties:

Functions:

getName()
Get the name of the webview

getVersion()
Get the version of the webview

toString()
Get a human readable representation of the webview

The version object

An object of the WhichBrowser\Model\Version class is used for the version property of the browser, engine and os object and contains a number of properties and functions. If a property is not applicable in this situation it will be null or undefined.

Properties:

Functions:

is($version) or is($comparison, $version)
Using this function it is easy to compare a version to another version. If you specify only one argument, this function will return if the versions are the same. You can also specify two arguments, in that case the first argument contains the comparison operator, such as <, <=, =, => or >. The second argument is the version you want to compare it to. You can use versions like 10, 10.7 or '10.7.4', but be aware that 10 is not the same as 10.0. For example if our OS version is 10.7.4:

All versions of parser with dependencies

PHP Build Version
Package Version
Requires php Version >=5.4.0
psr/cache Version ^1.0 || ^2.0 || ^3.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package whichbrowser/parser contains the following files

Loading the files please wait ....