philip Mon Dec 30 11:05:15 2002 EDT
Modified files:
/phpdoc/en/reference/misc/functions get-browser.xml
Log:
Made existence of browscap.ini a little more clear, noted when register_globals
affected it which closes bug #6513, and fixed typo as this still returns an object.
Index: phpdoc/en/reference/misc/functions/get-browser.xml
diff -u phpdoc/en/reference/misc/functions/get-browser.xml:1.5
phpdoc/en/reference/misc/functions/get-browser.xml:1.6
--- phpdoc/en/reference/misc/functions/get-browser.xml:1.5 Sun Dec 29 23:57:52
2002
+++ phpdoc/en/reference/misc/functions/get-browser.xml Mon Dec 30 11:05:14 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/misc.xml, last change in rev 1.2 -->
<refentry id="function.get-browser">
<refnamediv>
@@ -11,7 +11,7 @@
<refsect1>
<title>Description</title>
<methodsynopsis>
- <type>array</type><methodname>get_browser</methodname>
+ <type>object</type><methodname>get_browser</methodname>
<methodparam
choice="opt"><type>string</type><parameter>user_agent</parameter></methodparam>
</methodsynopsis>
<simpara>
@@ -25,7 +25,7 @@
<function>get_browser</function>.
</simpara>
<simpara>
- The information is returned in an array, which will contain
+ The information is returned in an <type>object</type>, 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
@@ -88,9 +88,10 @@
In order for this to work, your <link
linkend="ini.browscap">browscap</link> configuration setting in
&php.ini; must point to the correct location of the
- <filename>browscap.ini</filename> file on your system. An up-to-date
- <filename>browscap.ini</filename> file can be located
- <ulink url="&url.browscap.download;">here</ulink>. By default, this
+ <filename>browscap.ini</filename> file on your system.
+ <filename>browscap.ini</filename> is not bundled with PHP but you
+ may find an up-to-date <ulink url="&url.browscap.download;">
+ browscap.ini file here</ulink>. By default, the
<link linkend="ini.browscap">browscap</link> directive is commented out.
</simpara>
<note>
@@ -100,6 +101,15 @@
enabled the browser to accept cookies or not. The only way to test if
cookies are accepted is to set one with <function>setcookie</function>,
reload, and check for the value.
+ </simpara>
+ </note>
+ <note>
+ <simpara>
+ On versions older than PHP 4.0.6, you will have to pass the
+ user agent in via the optional <parameter>user_agent</parameter>
+ parameter if the PHP directive <link linkend="ini.register-globals">
+ register_globals</link> is <literal>off</literal>. In this case,
+ you will pass in <varname>$HTTP_SERVER_VARS['HTTP_USER_AGENT']</varname>.
</simpara>
</note>
</refsect1>
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
