Agent クラス
Agent クラスは、ブラウザ種別、バージョン、プラットフォーム、OSなど、クライアントのユーザーエージェント文字列に関する情報を取得可能にします。
使用方法
指定したキャラクタセットを、ブラウザが受け入れ可能かチェックします。
静的 |
はい |
パラメータ |
パラメータ |
デフォルト |
説明 |
$charset |
string |
キャラクタセットの名前 |
|
返り値 |
boolean |
例 |
if (Agent::accepts_charset('iso-8859-1'))
{
echo "大丈夫です、お使いのブラウザはこのキャラクタセットを受け入れ可能です!";
}
|
指定した ISO 言語コードをブラウザが受け入れ可能かチェックします。
静的 |
はい |
パラメータ |
パラメータ |
デフォルト |
説明 |
$language |
string |
ISO 言語コード |
|
返り値 |
boolean |
例 |
if (Agent::accepts_language('nl_BE'))
{
echo "大丈夫です、お使いのブラウザはフラマン語に設定されています!";
}
|
正規化されたブラウザ名を、ユーザーエージェント文字列から取得し、返す。
静的 |
はい |
パラメータ |
None |
返り値 |
string |
例 |
switch (Agent::browser())
{
case 'Firefox':
break;
case 'IE':
break;
case 'Chrome':
break;
case 'Unknown':
break;
default:
break;
}
|
ユーザーエージェント文字列から正規化されたプラットフォーム名を取得して返す。
静的 |
はい |
パラメータ |
None |
返り値 |
string |
例 |
switch (Agent::platform())
{
case 'Win95':
case 'Win98':
case 'WinNT':
case 'WinME':
case 'Win2000':
break;
case 'WinXP':
case 'WinVista':
case 'Win7':
break;
case 'Linux':
break;
case 'MacOSX':
case 'MacPPC':
break;
case 'SunOS':
case 'FreeBSD':
case 'Debian':
case 'HP-UX':
case 'IRIX64':
break;
case 'unknown':
break;
default:
break;
}
|
ブラウザのバージョンを返す。
静的 |
はい |
パラメータ |
None |
返り値 |
float |
例 |
if (Agent::browser() == 'IE' and Agent::version() < 7)
{
echo "ごめんなさい、旧世代のブラウザはサポートしてません!";
}
|
ブラウザが受け入れ可能な全てのキャラクタセットを配列で返す。
静的 |
はい |
パラメータ |
None |
返り値 |
array |
例 |
$sets = Agent::charsets();
if (in_array('iso-8859-1', $sets))
{
echo "大丈夫です!お使いのブラウザはこのキャラクタセットを受け入れ可能です!";
}
|
ブラウザが受け入れ可能な全ての ISO 言語コードを配列で返す。
静的 |
はい |
パラメータ |
None |
返り値 |
array |
例 |
$lang = Agent::languages();
if (in_array('nl_BE', $lang))
{
echo "大丈夫です、お使いのブラウザはフラマン語に設定されています!";
}
|
検出されたブラウザの全てのプロパティを配列で返す。
静的 |
はい |
パラメータ |
None |
返り値 |
array |
例 |
$properties = Agent::properties();
|
指定したブラウザのプロパティを返す。 properties() でサポートされているプロパティのリストを見てみて下さい。
静的 |
はい |
パラメータ |
パラメータ |
デフォルト |
説明 |
$property |
string |
取得したいプロパティの名前。プロパティ名は大文字小文字を区別します! |
|
返り値 |
mixed |
例 |
if (Agent::property('cookies') === true)
{
echo "大丈夫です、このブラウザはクッキーをサポートしています!";
}
|
ブラウザがモバイルデバイス上で実行されているかチェックします。
静的 |
はい |
パラメータ |
None |
返り値 |
boolean |
例 |
if (Agent::is_mobiledevice())
{
$content = View::forge('mobile/viewname');
}
else
{
$content = View::forge('standard/viewname');
}
|
訪問者がロボット、またはクローラーであるかを、ブラウザエージェントが示しているかチェックする
静的 |
はい |
パラメータ |
None |
返り値 |
boolean |
例 |
if (Agent::is_robot())
{
$content = View::forge('robot/viewname');
}
else
{
$content = View::forge('standard/viewname');
}
|