user agent

Agent utilisateur FlameCore

Cette bibliothèque fournit une détection simple du navigateur pour PHP. Il utilise un algorithme simple et rapide pour reconnaître les principaux navigateurs.

Le package UserAgent a été développé pour notre système de protection anti-spam Gatekeeper.

Pourquoi devriez-vous l'utiliser

PHP fournit une fonction native pour détecter le navigateur de l'utilisateur : get_browser() . Cette fonction nécessite le fichier browscap.ini d'une taille de plus de 300 Ko. Le chargement et le traitement de ce fichier ont un impact sur les performances du script. Et parfois, le serveur de production ne fournit tout simplement pas browscap.ini .

Bien que get_browser() fournisse sûrement d’excellents résultats de détection, dans la plupart des cas, une méthode beaucoup plus simple peut être tout aussi efficace. La bibliothèque FlameCore UserAgent présente l'avantage d'être compacte et facile à étendre.

Usage

Pour utiliser l'API, incluez le chargeur automatique du fournisseur et utilisez les classes :

user agent object $userAgent = UserAgent::createFromGlobal();">

 namespace Acme  MyApplication ;

use FlameCore  UserAgent  UserAgent ;

require ' vendor/autoload.php ' ;

// Create a user agent object
$ userAgent = UserAgent:: createFromGlobal ();

Ensuite, les valeurs analysées peuvent être récupérées à l'aide des méthodes getter :

 $ userAgent -> getBrowserName ();      // firefox
$ userAgent -> getBrowserVersion ();   // 3.6
$ userAgent -> getBrowserEngine ();    // gecko
$ userAgent -> getOperatingSystem ();  // linux

Lorsque vous créez un objet UserAgent , la chaîne actuelle user agent est utilisée. Vous pouvez spécifier une autre chaîne user agent :

user agent string $userAgent = UserAgent::create('msnbot/2.0b (+http://search.msn.com/msnbot.htm)'); $userAgent->getBrowserName(); // msnbot // Use current user agent string $userAgent = UserAgent::create($_SERVER['HTTP_USER_AGENT']); // ... which is equivalent to: $userAgent = UserAgent::createFromGlobal();">

 // Use another user agent string
$ userAgent = UserAgent:: create ( ' msnbot/2.0b (+http://search.msn.com/msnbot.htm) ' );
$ userAgent -> getBrowserName (); // msnbot

// Use current user agent string
$ userAgent = UserAgent:: create ( $ _SERVER [ ' HTTP_USER_AGENT ' ]);
// ... which is equivalent to:
$ userAgent = UserAgent:: createFromGlobal ();

Installation

Installer via Composer

Créez un fichier appelé composer.json dans le répertoire de votre projet et insérez-y les éléments suivants :

 {
    "require": {
        "flamecore/user-agent": "dev-master"
    }
}

Installez Composer si vous ne l'avez pas déjà présent sur votre système :

 $ curl -sS https://getcomposer.org/installer | php

Utilisez Composer pour télécharger les bibliothèques des fournisseurs et générer le fichier supplier/autoload.php :

 $ php composer.phar install

Exigences

• Vous devez avoir au moins PHP version 5.4 installé sur votre système.

Contributeurs

Si vous souhaitez contribuer, veuillez d'abord consulter le fichier CONTRIBUTION.

Merci aux contributeurs :

• Christian Neff (seconde vérité)