Need help with phpbrowscap?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

GaretJax
433 Stars 76 Forks MIT License 62 Commits 34 Opened issues

Description

Standalone replacement for php's native get_browser() function

Services available

!
?

Need anything else?

Contributors list

# 357,048
PHP
10 commits
# 78,625
Django
HTML
Shell
ta-lib
10 commits
# 264,880
JavaScr...
HTML
skeleto...
silex
5 commits
# 278,765
PHP
psr-7
Python
Shell
4 commits
# 73,548
word2ve...
Symfony
XML
rtf
3 commits
# 71,137
Compose...
Laravel
securit...
TypeScr...
1 commit
# 551,979
PHP
1 commit
# 57,233
HTML
cms-det...
TypeScr...
Koa
1 commit

Browser Capabilities PHP Project

Hacking around with PHP to have a better solution than `getbrowser()`_

Build Status

Changes (new version - 2.0)

Please see changelog for a list of recent changes. (huge performance improvements!)

Introduction

The browscap.ini file is a database which provides a lot of details about browsers and their capabilities, such as name, versions, Javascript support and so on.

Please note: browscap.ini was maintained by Gary Keith and is now maintained by RAD Moose. More information about the transfer of owners can be found here. Browscap.ini source files are currently available at a temporary location (http://tempdownloads.browserscap.com/). All the links in

Browscap
class are updated, but if you use custom links remember to change them!

PHP's native get_browser() function parses this file and provides you with a complete set of information about every browser's details, But it requires the path to the browscap.ini file to be specified in the php.ini browscap directive which is flagged as

PHP_INI_SYSTEM
.

Since in most shared hosting environments you have not access to the php.ini file, the browscap directive cannot be modified and you are stuck with either and outdated database or without browscap support at all.

Browscap is a standalone class for PHP >=5.3 that gets around the limitations of

get_browser()
and manages the whole thing. It offers methods to update, cache, adapt and get details about every supplied user agent on a standalone basis. It's also much faster than
get_browser()
while still returning the same results.

Browscap is a Composer package.

Quick start

A quick start guide is available on the GitHub wiki, at the following address: https://github.com/GaretJax/phpbrowscap/wiki/QuickStart

Features

Here is a non-exhaustive feature list of the Browscap class:

  • Very fast
    • at least 3 times faster than get_browser() when not using opcache
    • 20 or more times faster than get_browser() when using opcache (see tests)
  • Standalone and fully PHP configuration independent (no need for php.ini setting)
  • Fully getbrowser() compatible (with some getbrowser() bugs fixed)
  • User agent auto-detection
  • Returns object or array
  • Parsed .ini file cached directly into PHP arrays (leverages opcache)
  • Accepts any .ini file (even ASP and lite versions)
  • Auto updated browscap.ini file and cache from remote server with version checking
  • Fully configurable, including configurable remote update server and update schedules
  • PHP >= 5.3
    compatible
  • Released under the MIT License

Issues and feature requests

Please report your issues and ask for new features on the GitHub Issue Tracker at https://github.com/GaretJax/phpbrowscap/issues

Please report incorrectly identified User Agents and browser detect in the browscap.ini file on Google Groups here: https://groups.google.com/forum/#!forum/browscap

Please note that the Browscap class only parses and queries the browscap.ini database provided by RAD Moose (previously by Gary Keith). If a browser is wrongly identified or a results presents erroneous properties, please refer directly to the temporary browscap project homepage at: http://tempdownloads.browserscap.com/ or post your misidentified browser and User Agent at the Browscap Google Groups page: https://groups.google.com/forum/#!forum/browscap

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.