user agent

FlameCore-Benutzeragent

Diese Bibliothek bietet eine einfache Browsererkennung für PHP. Es verwendet einen einfachen und schnellen Algorithmus, um die wichtigsten Browser zu erkennen.

Das UserAgent-Paket wurde für unser Spam-Schutzsystem Gatekeeper entwickelt.

Warum Sie es verwenden sollten

PHP bietet eine native Funktion zur Erkennung des Benutzerbrowsers: get_browser() . Für diese Funktion ist die Datei browscap.ini mit einer Größe von über 300 KB erforderlich. Das Laden und Verarbeiten dieser Datei wirkt sich auf die Skriptleistung aus. Und manchmal stellt der Produktionsserver browscap.ini einfach nicht bereit.

Obwohl get_browser() sicherlich hervorragende Erkennungsergebnisse liefert, kann in den meisten Fällen eine viel einfachere Methode genauso effektiv sein. Die FlameCore UserAgent-Bibliothek hat den Vorteil, dass sie kompakt und einfach zu erweitern ist.

Verwendung

Um die API zu nutzen, schließen Sie den Autoloader des Anbieters ein und verwenden Sie die folgenden Klassen:

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 ();

Anschließend können die geparsten Werte mit den Getter-Methoden abgerufen werden:

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

Wenn Sie ein UserAgent Objekt erstellen, wird die aktuelle user agent verwendet. Sie können eine andere user agent angeben:

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

Über Composer installieren

Erstellen Sie in Ihrem Projektverzeichnis eine Datei mit dem Namen composer.json und fügen Sie Folgendes ein:

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

Installieren Sie Composer, falls Sie es noch nicht auf Ihrem System haben:

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

Verwenden Sie Composer, um die Anbieterbibliotheken herunterzuladen und die Datei „vendor/autoload.php“ zu generieren:

 $ php composer.phar install

Anforderungen

• Auf Ihrem System muss mindestens PHP Version 5.4 installiert sein.

Mitwirkende

Wenn Sie einen Beitrag leisten möchten, sehen Sie sich bitte zuerst die Datei „CONTRIBUTING“ an.

Vielen Dank an die Mitwirkenden:

• Christian Neff (zweite Wahrheit)