PHP Home Page

Manual Table of Contents
Up to Misc.
Quick Reference
* connection_aborted
* connection_status
* connection_timeout
* define
* defined
* die
* eval
* exit
* func_get_arg
* func_get_args
* func_num_args
* function_exists
* get_browser
* ignore_user_abort
* iptcparse
* leak
* pack
* register_shutdown_function
* serialize
* sleep
* uniqid
* unpack
* unserialize
* usleep
Manual: get_browser
View the source code for this pageSearch the site

Previous page
Next page


(PHP3 , PHP4 )

get_browser --  Tells what the user's browser is capable of


object get_browser ([string user_agent])

get_browser() attempts to determine the capabilities of the user's browser. This is done by looking up the browser's information in the browscap.ini file. By default, the value of $HTTP_USER_AGENT is used; however, you can alter this (i.e., look up another browser's info) by passing the optional user_agent parameter to get_browser().

The information is returned in an object, which will contain various data elements representing, for instance, the browser's major and minor version numbers and ID string; true/false values for features such as frames, JavaScript, and cookies; and so forth.

While browscap.ini contains information on many browsers, it relies on user updates to keep the database current. The format of the file is fairly self-explanatory.

The following example shows how one might list all available information retrieved about the user's browser.

Example 1. Get_browser() example

  2 <?php
  3 function list_array ($array) {
  4     while (list ($key, $value) = each ($array)) {
  5         $str .= "<b>$key:</b> $value<br>\n";
  6     }
  7     return $str;
  8 }
  9 echo "$HTTP_USER_AGENT<hr>\n";
 10 $browser = get_browser();
 11 echo list_array ((array) $browser);
 12 ?>

The output of the above script would look something like this:

  2 Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)<hr>
  3 <b>browser_name_pattern:</b> Mozilla/4\.5.*<br>
  4 <b>parent:</b> Netscape 4.0<br>
  5 <b>platform:</b> Unknown<br>
  6 <b>majorver:</b> 4<br>
  7 <b>minorver:</b> 5<br>
  8 <b>browser:</b> Netscape<br>
  9 <b>version:</b> 4<br>
 10 <b>frames:</b> 1<br>
 11 <b>tables:</b> 1<br>
 12 <b>cookies:</b> 1<br>
 13 <b>backgroundsounds:</b> <br>
 14 <b>vbscript:</b> <br>
 15 <b>javascript:</b> 1<br>
 16 <b>javaapplets:</b> 1<br>
 17 <b>activexcontrols:</b> <br>
 18 <b>beta:</b> <br>
 19 <b>crawler:</b> <br>
 20 <b>authenticodeupdate:</b> <br>
 21 <b>msn:</b> <br>

In order for this to work, your browscap configuration file setting must point to the correct location of the browscap.ini file.

For more information (including locations from which you may obtain a browscap.ini file), check the PHP FAQ at

Note: Browscap support was added to PHP in version 3.0b2.

 About Notes

Previous page
Next page

Who's responsible for this?
Top of this page


Located in
United States
Elements of this website are subject to copyright.
Questions about installing or using PHP should be directed to one of the mailing lists.
Only questions about the website should be directed to