torben Tue Mar 12 18:12:28 2002 EDT
Modified files:
/phpdoc/en/language variables.xml
Log:
Added a warning about the register_globals change; added $GLOBALS.
Index: phpdoc/en/language/variables.xml
diff -u phpdoc/en/language/variables.xml:1.38 phpdoc/en/language/variables.xml:1.39
--- phpdoc/en/language/variables.xml:1.38 Mon Mar 11 21:05:59 2002
+++ phpdoc/en/language/variables.xml Tue Mar 12 18:12:28 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.38 $ -->
+<!-- $Revision: 1.39 $ -->
<chapter id="language.variables">
<title>Variables</title>
@@ -121,6 +121,28 @@
<link linkend="reserved.variables">Predefined variables</link>.
</simpara>
+ <warning>
+ <simpara>
+ In PHP 4.1.0 and later, the default set of predefined variables
+ which are available in the global scope has changed. Individual
+ input and server variables are <emphasis>by default</emphasis>no
+ longer placed directly into the global scope; rather, they are
+ placed into the following <link
+ linkend="language.variables.superglobals">superglobal
+ arrays</link>.
+ </simpara>
+ <simpara>
+ You can still force the old behaviour by setting <link
+ linkend="ini.register-globals">register_globals</link> to 'On' in
+ your <filename>php.ini</filename> file.
+ </simpara>
+ <simpara>
+ For more information and background on this change, please see
+ the <ulink url="&url.php.release4.1.0;">PHP 4.1.0 Release
+ Announcement</ulink>.
+ </simpara>
+ </warning>
+
<simpara>
From version 4.1.0 onward, PHP provides a set of predefined arrays
containing variables from the web server (if applicable), the
@@ -134,8 +156,18 @@
<link linkend="reserved.variables">Predefined variables</link>.
</simpara>
- <variablelist>
+ <variablelist id="language.variables.superglobals">
<title>PHP Superglobals</title>
+ <varlistentry>
+ <term><link linkend="reserved.variables.globals">$GLOBALS</link></term>
+ <listitem>
+ <simpara>
+ Contains a reference to every variable which is currently
+ available within the global scope of the script. The keys of
+ this array are the names of the global variables.
+ </simpara>
+ </listitem>
+ </varlistentry>
<varlistentry>
<term><link linkend="reserved.variables.server">$_SERVER</link></term>
<listitem>
