get_browser

get_browser -- ユーザのブラウザの機能を取得する

説明

object get_browser(string [user_agent]);

get_browser は、ユーザーのブラウザの機能を 定義します。これは、browscap.ini ファイルの ブラウザ情報を調べることにより行います。 デフォルトでは、$HTTP_USER_AGENT の値が使用されます。しかし、 オプションの user_agent パラメータを get_browser に渡すことにより、 これを変える(すなわち、他のブラウザの情報を調べる)ことが可能です。

返される情報はオブジェクトであり、例えば、ブラウザのメジャーおよび マイナーバージョン暗号やID文字列、 といった様々なデータ要素を含んでいます。 フレーム、JavaScript、クッキー等のような機能に 関する true/false の値、 マイナーバージョン暗号やID文字列、 といった様々なデータ要素を含んでいます。

browscap.ini は多くのブラウザに関する情報を 有していますが、データベースを最新に保つのはユーザーによる更新 に依存しています。 ファイルのフォーマット自体を見ればおおよそのことがわかります。

次の例では、ユーザーのブラウザに関する全ての取得可能な情報 の一覧を作成する手法に関するものです。

例 1. get_browser の例


<?php
function list_array( $array ) {
   while ( list( $key, $value ) = each( $array ) ) {
	  $str .= "<b>$key:</b> $value<br>\n";
   }
   return $str;
}
echo "$HTTP_USER_AGENT<hr>\n";
$browser = get_browser();
echo list_array( (array) $browser );
?>
	  

上のスクリプトの出力は、次のようになります。


Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)<hr>
<b>browser_name_pattern:</b> Mozilla/4\.5.*<br>
<b>parent:</b> Netscape 4.0<br>
<b>platform:</b> Unknown<br>
<b>majorver:</b> 4<br>
<b>minorver:</b> 5<br>
<b>browser:</b> Netscape<br>
<b>version:</b> 4<br>
<b>frames:</b> 1<br>
<b>tables:</b> 1<br>
<b>cookies:</b> 1<br>
<b>backgroundsounds:</b> <br>
<b>vbscript:</b> <br>
<b>javascript:</b> 1<br>
<b>javaapplets:</b> 1<br>
<b>activexcontrols:</b> <br>
<b>beta:</b> <br>
<b>crawler:</b> <br>
<b>authenticodeupdate:</b> <br>
<b>msn:</b> <br>
	

これを動作させるためには、設定ファイルの browscap を正しく browscap.ini の場所に設定しておく必要があります。

(browscap.ini ファイルを取得できる場所を含む) より詳細な情報については、http://www.php.net/FAQ.html にある PHP FAQ を参照下さい。

注意: browscap サポートは、PHP バージョン 4.0b2 で追加されました。