user agent

FlameCore 用戶代理

該程式庫為 PHP 提供簡單的瀏覽器檢測。它使用簡單快速的演算法來識別主要瀏覽器。

UserAgent 軟體包是為我們的垃圾郵件防護系統 Gatekeeper 開發的。

為什麼你應該使用它

PHP 提供了一個本機函數來偵測使用者瀏覽器： get_browser() 。此功能需要browscap.ini檔案大小超過 300KB。載入和處理此文件會影響腳本效能。有時，生產伺服器不提供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 ();

然後可以使用 getter 方法檢索解析的值：

 $ 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 版本。

貢獻者

如果您想貢獻，請先查看貢獻文件。

感謝貢獻者：

• 克里斯蒂安·內夫（第二個真相）