user agent

FlameCore ユーザーエージェント

このライブラリは、PHP の簡単なブラウザ検出を提供します。シンプルで高速なアルゴリズムを使用して主要なブラウザを認識します。

UserAgent パッケージは、スパム保護システム Gatekeeper 用に開発されました。

なぜそれを使うべきなのか

PHP は、ユーザーのブラウザを検出するネイティブ関数get_browser()を提供します。この機能には、300KB 以上のサイズのbrowscap.iniファイルが必要です。このファイルをロードして処理すると、スクリプトのパフォーマンスに影響します。また、運用サーバーがbrowscap.ini提供していない場合もあります。

get_browser()確かに優れた検出結果を提供しますが、ほとんどの場合、より単純な方法でも同様に効果的です。 FlameCore UserAgent ライブラリには、コンパクトで拡張が簡単であるという利点があります。

使用法

API を利用するには、ベンダー オートローダーを組み込み、クラスを使用します。

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

その後、ゲッター メソッドを使用して、解析された値を取得できます。

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

UserAgentオブジェクトを作成するときは、現在のuser agent文字列が使用されます。別の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 ();

インストール

Composer 経由でインストールする

プロジェクト ディレクトリにcomposer.jsonというファイルを作成し、その中に次の内容を入れます。

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

Composer がシステムにまだ存在していない場合は、インストールします。

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

Composer を使用してベンダー ライブラリをダウンロードし、vendor/autoload.php ファイルを生成します。

 $ php composer.phar install

要件

• システムには少なくとも PHP バージョン 5.4 がインストールされている必要があります。

貢献者

貢献したい場合は、まず CONTRIBUTING ファイルをご覧ください。

貢献者に感謝します:

• クリスチャン・ネフ（二番目の真実）