php-doc-en/language/predefined/variables/request.xml
Hannes Magnusson cb0630b149 add version info
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@312956 c90b9560-bf6c-de11-be94-00142212c4b1
2011-07-05 20:42:29 +00:00

116 lines
3.1 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<phpdoc:varentry xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="reserved.variables.request" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>$_REQUEST</refname>
<refpurpose>HTTP Request variables</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>
An associative <type>array</type> that by default contains the contents of
<varname>$_GET</varname>,
<varname>$_POST</varname>&listendand;
<varname>$_COOKIE</varname>.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>5.3.0</entry>
<entry>
Introduced <link linkend="ini.request-order">request_order</link>.
This directive affects the contents of <varname>$_REQUEST</varname>.
</entry>
</row>
<row>
<entry>4.3.0</entry>
<entry>
<varname>$_FILES</varname> information
was removed from <varname>$_REQUEST</varname>.
</entry>
</row>
<row>
<entry>4.1.0</entry>
<entry>
Introduced <varname>$_REQUEST</varname>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
&note.is-superglobal;
<note>
<para>
When running on the <link linkend="features.commandline">command line
</link>, this will <emphasis>not</emphasis> include the
<link linkend="reserved.variables.argv">argv</link> and
<link linkend="reserved.variables.argc">argc</link> entries; these are
present in the <varname>$_SERVER</varname>
<type>array</type>.
</para>
</note>
<note>
<para>
The variables in <varname>$_REQUEST</varname> are provided to the
script via the GET, POST, and COOKIE input mechanisms and
therefore could be modified by the remote user and cannot be
trusted. The presence and order of variables listed in this array
is defined according to the
PHP <link linkend="ini.variables-order">variables_order</link>
configuration directive.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>import_request_variables</function></member>
<member><link linkend="language.variables.external">Handling external variables</link></member>
<member><link linkend="book.filter">The filter extension</link></member>
</simplelist>
</refsect1>
</phpdoc:varentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->