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

贡献者

如果您想贡献，请先查看贡献文件。

感谢贡献者：

• 克里斯蒂安·内夫（第二个真相）