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 で追加されました。