andre_ae Sun May 5 14:42:26 2002 EDT
Modified files:
/phpdoc-pt_BR/appendices reserved.xml
Log:
update
Index: phpdoc-pt_BR/appendices/reserved.xml
diff -u phpdoc-pt_BR/appendices/reserved.xml:1.3
phpdoc-pt_BR/appendices/reserved.xml:1.4
--- phpdoc-pt_BR/appendices/reserved.xml:1.3 Sat Apr 27 13:33:41 2002
+++ phpdoc-pt_BR/appendices/reserved.xml Sun May 5 14:42:25 2002
@@ -1,230 +1,1083 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
-<appendix id="reserved">
- <title>Palavras reservadas do PHP</title>
- <para>
- Esta � a lista de palavras reservadas do PHP,
- normalmente <link linkend="language.constants">constantes</link>
- e <link linkend="language.variables.predefined">variav�is pr�-definidas</link>.
- Voc� n�o deve encontrar nenhuma fun��o aqui, mas contru��es da linguagem.
- Voc� nao deve usar estes nomes como vari�veis, fun��es, constantes ou
- metodos, pois certamente o levar� a confus�o.
- <simplelist columns="3">
- <member>
- <link linkend="language.operators.logical">and</link>
- </member>
- <member>
- <link linkend="language.variables.predefined.php">$argv</link>
- </member>
- <member>
- <link linkend="control-structures.foreach">as</link>
- </member>
- <member>
- <link linkend="language.variables.predefined.php">$argc</link>
- </member>
- <member>
- <link linkend="control-structures.break">break</link>
- </member>
- <member>
- <link linkend="control-structures.switch">case</link>
- </member>
- <member>
- <link linkend="functions.old-syntax">cfunction</link>
- </member>
- <member>
- <link linkend="keyword.class">class</link>
- </member>
- <member>
- <link linkend="control-structures.continue">continue</link>
- </member>
- <member>
- <link linkend="control-structures.declare">declare</link>
- </member>
- <member>
- <link linkend="control-structures.switch">default</link>
- </member>
- <member>
- <link linkend="control-structures.do.while">do</link>
- </member>
- <member>
- <function>die</function>
- </member>
- <member>
- <function>echo</function>
- </member>
- <member>
- <link linkend="control-structures.else">else</link>
- </member>
- <member>
- <link linkend="control-structures.elseif">elseif</link>
- </member>
- <member>
- <function>empty</function>
- </member>
- <member>
- <link linkend="control-structures.declare">enddeclare</link>
- </member>
- <member>
- <link linkend="control-structures.alternative-syntax">endfor</link>
- </member>
- <member>
- <link linkend="control-structures.alternative-syntax">endforeach</link>
- </member>
- <member>
- <link linkend="control-structures.alternative-syntax">endif</link>
- </member>
- <member>
- <link linkend="control-structures.alternative-syntax">endswitch</link>
- </member>
- <member>
- <link linkend="control-structures.alternative-syntax">endwhile</link>
- </member>
- <member>
- <link linkend="language.constants">E_ALL</link>
- </member>
- <member>
- <link linkend="language.constants">E_PARSE</link>
- </member>
- <member>
- <link linkend="language.constants">E_ERROR</link>
- </member>
- <member>
- <link linkend="language.constants">E_WARNING</link>
- </member>
- <member>
- <link linkend="function.eval">eval</link>
- </member>
- <member>
- <function>exit</function>
- </member>
- <member>
- <link linkend="keyword.class">extends</link>
- </member>
- <member>
- <link linkend="language.constants">&false;</link>
- </member>
- <member>
- <link linkend="control-structures.for">for</link>
- </member>
- <member>
- <link linkend="control-structures.foreach">foreach</link>
- </member>
- <member>
- <link linkend="functions.user-defined">function</link>
- </member>
- <member>
- <link linkend="language.variables.predefined.php">$HTTP_COOKIE_VARS</link>
- </member>
- <member>
- <link linkend="language.variables.predefined.php">$HTTP_GET_VARS</link>
- </member>
- <member>
- <link linkend="language.variables.predefined.php">$HTTP_POST_VARS</link>
- </member>
- <member>
- <link linkend="language.variables.predefined.php">$HTTP_POST_FILES</link>
- </member>
- <member>
- <link linkend="language.variables.predefined.php">$HTTP_ENV_VARS</link>
- </member>
- <member>
- <link linkend="language.variables.predefined.php">$HTTP_SERVER_VARS</link>
- </member>
- <member>
- <link linkend="control-structures.if">if</link>
- </member>
- <member>
- <function>include</function>
- </member>
- <member>
- <function>include_once</function>
- </member>
- <member>
- <link linkend="language.variables.scope">global</link>
- </member>
- <member>
- <function>list</function>
- </member>
- <member>
- <link linkend="keyword.class">new</link>
- </member>
- <member>
- <link linkend="language.operators.logical">not</link>
- </member>
- <member>
- <link linkend="language.constants.predefined">NULL</link>
- </member>
- <member>
- <link linkend="functions.old-syntax">old_function</link>
- </member>
- <member>
- <link linkend="language.operators.logical">or</link>
- </member>
- <member>
- <link linkend="keyword.parent">parent</link>
- </member>
- <member>
- <link linkend="language.constants">PHP_OS</link>
- </member>
- <member>
- <link linkend="language.variables.predefined.php">$PHP_SELF</link>
- </member>
- <member>
- <link linkend="language.constants">PHP_VERSION</link>
- </member>
- <member>
- <function>print</function>
- </member>
- <member>
- <function>require</function>
- </member>
- <member>
- <function>require_once</function>
- </member>
- <member>
- <link linkend="functions.user-defined">return</link>
- </member>
- <member>
- <link linkend="language.variables.scope">static</link>
- </member>
- <member>
- <link linkend="control-structures.switch">switch</link>
- </member>
- <member>
- <link linkend="keyword.class">stdClass</link>
- </member>
- <member>
- <link linkend="keyword.class">$this</link>
- </member>
- <member>
- <link linkend="language.constants">&true;</link>
- </member>
- <member>
- <link linkend="keyword.class">var</link>
- </member>
- <member>
- <link linkend="language.operators.logical">xor</link>
- </member>
- <member>
- <function>virtual</function>
- </member>
- <member>
- <link linkend="control-structures.while">while</link>
- </member>
- <member>
- <link linkend="language.constants">__FILE__</link>
- </member>
- <member>
- <link linkend="language.constants">__LINE__</link>
- </member>
- <member>
- <link linkend="language.oop.magic-functions">__sleep</link>
- </member>
- <member>
- <link linkend="language.oop.magic-functions">__wakeup</link>
- </member>
- </simplelist>
- </para>
+<!-- EN-Revision: 1.20 Maintainer: andre_ae Status: ready -->
+
+ <appendix id="reserved">
+ <title>Palavras reservadas do PHP</title>
+ <para>
+ Esta � uma lista de identificadores predefinidos do PHP. Nenhum
+ dos identificadores listados aqui pode ser utilizado como seus identificadores
+ nos scripts. Esta lista inclui palavras-chave e vari�veis predefinidas,
+ constantes e nomes de classes. Esta lista ainda n�o est�
+ completa.
+ <para>
+
+ <sect1 id="reserved.keywords">
+ <title>Lista de palavras-chave (keywords)</title>
+ <simpara>
+ Estas palavras tem um significado especial no PHP. Algumas delas representam
+coisas
+ que parecem fun��es, algumas parecem constantes mas na verdade n�o o s�o
+ realmente: elas s�o construtores de linguagem. Voc� n�o pode usar nenhuma
+ das seguintes palavras como constantes, nomes de classes ou de fun��es.
+ Utilizar como nome de vari�veis geralmente n�o causa erros, mas pode levar a
+confus�o.
+ </simpara>
+
+ <table>
+ <title>Palavras-chave do PHP</title>
+ <tgroup cols="4">
+ <tbody>
+ <row>
+ <entry>
+ <link linkend="language.operators.logical">and</link>
+ </entry>
+ <entry>
+ <link linkend="language.operators.logical">or</link>
+ </entry>
+ <entry>
+ <link linkend="language.operators.logical">xor</link>
+ </entry>
+ <entry>
+ __FILE__
+ </entry>
+ </row>
+ <row>
+ <entry>
+ __LINE__
+ </entry>
+ <entry>
+ <function>array</function>
+ </entry>
+ <entry>
+ <link linkend="control-structures.foreach">as</link>
+ </entry>
+ <entry>
+ <link linkend="control-structures.break">break</link>
+ </entry>
+ <entry>
+ <link linkend="control-structures.switch">case</link>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <link linkend="functions.old-syntax">cfunction</link>
+ </entry>
+ <entry>
+ <link linkend="keyword.class">class</link>
+ </entry>
+ <entry>
+ const
+ </entry>
+ <entry>
+ <link linkend="control-structures.continue">continue</link>
+ </entry>
+ <entry>
+ <link linkend="control-structures.declare">declare</link>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <link linkend="control-structures.switch">default</link>
+ </entry>
+ <entry>
+ <function>die</function>
+ </entry>
+ <entry>
+ <link linkend="control-structures.do.while">do</link>
+ </entry>
+ <entry>
+ <function>echo</function>
+ </entry>
+ <entry>
+ <link linkend="control-structures.else">else</link>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <link linkend="control-structures.elseif">elseif</link>
+ </entry>
+ <entry>
+ <function>empty</function>
+ </entry>
+ <entry>
+ <link linkend="control-structures.declare">enddeclare</link>
+ </entry>
+ <entry>
+ <link linkend="control-structures.alternative-syntax">endfor</link>
+ </entry>
+ <entry>
+ <link linkend="control-structures.alternative-syntax">endforeach</link>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <link linkend="control-structures.alternative-syntax">endif</link>
+ </entry>
+ <entry>
+ <link linkend="control-structures.alternative-syntax">endswitch</link>
+ </entry>
+ <entry>
+ <link linkend="control-structures.alternative-syntax">endwhile</link>
+ </entry>
+ <entry>
+ <link linkend="function.eval">eval</link>
+ </entry>
+ <entry>
+ <function>exit</function>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <link linkend="keyword.class">extends</link>
+ </entry>
+ <entry>
+ <link linkend="control-structures.for">for</link>
+ </entry>
+ <entry>
+ <link linkend="control-structures.foreach">foreach</link>
+ </entry>
+ <entry>
+ <link linkend="functions.user-defined">function</link>
+ </entry>
+ <entry>
+ <link linkend="language.variables.scope">global</link>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <link linkend="control-structures.if">if</link>
+ </entry>
+ <entry>
+ <function>include</function>
+ </entry>
+ <entry>
+ <function>include_once</function>
+ </entry>
+ <entry>
+ <function>isset</function>
+ </entry>
+ <entry>
+ <function>list</function>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <link linkend="keyword.class">new</link>
+ </entry>
+ <entry>
+ <link linkend="functions.old-syntax">old_function</link>
+ </entry>
+ <entry>
+ <function>print</function>
+ </entry>
+ <entry>
+ <function>require</function>
+ </entry>
+ <entry>
+ <function>require_once</function>
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <function>return</function>
+ </entry>
+ <entry>
+ <link linkend="language.variables.scope">static</link>
+ </entry>
+ <entry>
+ <link linkend="control-structures.switch">switch</link>
+ </entry>
+ <entry>
+ <function>unset</function>
+ </entry>
+ <entry>
+ use
+ </entry>
+ </row>
+ <row>
+ <entry>
+ <link linkend="keyword.class">var</link>
+ </entry>
+ <entry>
+ <link linkend="control-structures.while">while</link>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect1>
+
+ <sect1 id="reserved.variables">
+ <title>Vari�veis predefinidas</title>
+
+ <sect2 id="reserved.variables.server">
+ <title>Vari�veis do servidor: <varname>$_SERVER</varname></title>
+ <note>
+ <simpara>
+ Introduzida na vers�o 4.1.0. Em vers�es anteriores, use
+ <varname>$HTTP_SERVER_VARS</varname>.
+ </simpara>
+ </note>
+
+ <simpara>
+ <varname>$_SERVER</varname> � um array contendo informa��es
+ como headers, caminhos e localiza��es do script. Os itens deste
+ array s�o criados pelo servidor web. N�o h� garantias que
+ todos os servidores web geram todas elas: alguns servidores talvez omitam
+algumas ou
+ geram outras que n�o est�o listadas aqui. Mesmo assim, um grande n�mero
+ dessas vari�veis est�o de acordo com a <ulink
+ url="&url.cgispec;">especifica��o CGI 1.1</ulink>, ent�o voc� pode
+ esperar encontr�-las nesse array.
+ </simpara>
+
+ <simpara>
+ Esta � uma vari�vel 'superglobal', ou automaticamente global. Isto
+ significa que ela � dispon�vel em todos os escopos (n�veis) de um
+ script. Voc� n�o precisa fazer um <command>global
+ $_SERVER;</command> para pode acess�-la dentro de fun��es ou m�todos, como
+ era necess�rio com <varname>$HTTP_SERVER_VARS</varname>.
+ </simpara>
+
+ <simpara>
+ <varname>$HTTP_SERVER_VARS</varname> cont�m a mesmas
+ informa��es, mas ela n�o � uma superglobal.
+ </simpara>
+
+ <simpara>
+ Se a diretiva <link
+ linkend="ini.register-globals">register_globals</link>
+ est� ativa, ent�o essas vari�veis tornam-se dispon�veis no
+ escopo global do script (por exemplo, separados dos arrays
+ <varname>$_SERVER</varname> e <varname>$HTTP_SERVER_VARS</varname>.
+ Para maiores informa��es, veja o cap�tulo de seguran�a entitulado
+ <link linkend="security.registerglobals">Utilizando registradores
+ globais</link>. Estas vari�veis globais individuais n�o s�o superglobais.
+ </simpara>
+
+ <simpara>
+ Voc� poder� ou n�o encontrar qualquer um dos seguintes elementos dentro de
+ $_SERVER. Note que poucos (ou nenhum) deles est�o dispon�veis (ou
+ n�o ter�o qualquer sentido) se voc� estiver rodando o PHP na linha de comando.
+ </simpara>
+
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term>'<varname>PHP_SELF</varname>'</term>
+ <listitem>
+ <simpara>
+ O nome do arquivo do script atualmente em uso, relativo ao
+ document root. Por exemplo,
+ <varname>$_SERVER['PHP_SELF']</varname> em um script com o
+ endere�o <filename>http://example.com/test.php/foo.bar</filename>
+ pode ser <filename>/test.php/foo.bar</filename>.
+ </simpara>
+ <simpara>
+ Se estiver rodando o PHP em linha de comando, esta vari�vel
+ n�o est� dispon�vel.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>argv</varname>'</term>
+ <listitem>
+ <simpara>
+ Array de argumentos passado para o script. Quando o script
+ � executado na linha de comando, isto permite um acesso aos par�metros
+ de linha de comando no estilo do C. Quando chamado via m�todo GET, ele
+ conter� a query string.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>argc</varname>'</term>
+ <listitem>
+ <simpara>
+ Cont�m o n�mero de par�metros da linha de comando passados para o
+ script (se executando da linha de comando).
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>GATEWAY_INTERFACE</varname>'</term>
+ <listitem>
+ <simpara>
+ O n�mero de revis�o da especifica��o CGI que o servidor est� utilizando,
+ por exemplo : '<literal>CGI/1.1</literal>'.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>SERVER_NAME</varname>'</term>
+ <listitem>
+ <simpara>
+ O nome host do servidor onde o script atual �
+ executado. Se o script est� rodando em um host virtual, este
+ ser� o valor definido para aquele host virtual.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>SERVER_SOFTWARE</varname>'</term>
+ <listitem>
+ <simpara>
+ A string de identifica��o do servidor, fornecida nos headers quando
+ respondendo a requests.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>SERVER_PROTOCOL</varname>'</term>
+ <listitem>
+ <simpara>
+ Nome e n�mero de revis�o do protocolo de informa��o pelo qual a
+ p�gina foi requerida, por exemplo '<literal>HTTP/1.0</literal>';
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>REQUEST_METHOD</varname>'</term>
+ <listitem>
+ <simpara>
+ Cont�m o m�todo de request utilizando para acessar a p�gina. Geralmente
+'<literal>GET</literal>',
+ '<literal>HEAD</literal>', '<literal>POST</literal>' ou
+'<literal>PUT</literal>'.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>QUERY_STRING</varname>'</term>
+ <listitem>
+ <simpara>
+ A query string (string de solicita��o), se houver, pela qual a p�gina foi
+acessada.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>DOCUMENT_ROOT</varname>'</term>
+ <listitem>
+ <simpara>
+ O diret�rio raiz sob onde o script atual �
+ executado, como definido no arquivos de configura��o do servidor.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>HTTP_ACCEPT</varname>'</term>
+ <listitem>
+ <simpara>
+ O conte�do do header <literal>Accept:</literal> da
+ requisi��o atual, se houver.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>HTTP_ACCEPT_CHARSET</varname>'</term>
+ <listitem>
+ <simpara>
+ O conte�do do header <literal>Accept-Charset:</literal>
+ da requisi��o atual, se houver. Exemplo:
+ '<literal>iso-8859-1,*,utf-8</literal>'.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>HTTP_ACCEPT_ENCODING</varname>'</term>
+ <listitem>
+ <simpara>
+ O conte�do do header <literal>Accept-Encoding:</literal>
+ da requisi��o atual, se houver. Exemplo: '<literal>gzip</literal>'.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>HTTP_ACCEPT_LANGUAGE</varname>'</term>
+ <listitem>
+ <simpara>
+ O conte�do do header <literal>Accept-Language:</literal>
+ da requisi��o atual, se houver. Exemplo '<literal>en</literal>'.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>HTTP_CONNECTION</varname>'</term>
+ <listitem>
+ <simpara>
+ O conte�do do header <literal>Connection:</literal> da
+ requisi��o atual, se houver. Exemplo: '<literal>Keep-Alive</literal>'.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>HTTP_HOST</varname>'</term>
+ <listitem>
+ <simpara>
+ O conte�do do header <literal>Host:</literal> da
+ requisi��o atual, se houver.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>HTTP_REFERER</varname>'</term>
+ <listitem>
+ <simpara>
+ O endere�o da p�gina (se houver) atrav�s da qual o agente do
+ usu�rio acessou a p�gina atual. Essa diretiva � informada pelo agente do
+usu�rio. Nem
+ todos os browsers geram esse header, e alguns ainda possuem a habilidade
+ de modificar o conte�do do <varname>HTTP_REFERER</varname> como recurso. Em
+ poucas palavras, n�o � confi�vel.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>HTTP_USER_AGENT</varname>'</term>
+ <listitem>
+ <simpara>
+ O conte�do do header <literal>User_Agent:</literal> da
+ requisi��o atual, se houver. � uma string
+ denotando o agente de usu�rio pelo qual a p�gina � acessada. Um
+ exemplo t�pico �: <computeroutput>Mozilla/4.5 [en] (X11; U;
+ Linux 2.2.9 i586)</computeroutput>. Al�m de outras coisas, voc�
+ pode utilizar este valor com <function>get_browser</function> para
+ personalizar a gera��o de suas p�ginas para as capacidades do agente do
+ usu�rio.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>REMOTE_ADDR</varname>'</term>
+ <listitem>
+ <simpara>
+ O endere�o IP de onde o usu�rio est� visualizado a p�gina
+ atual.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>REMOTE_PORT</varname>'</term>
+ <listitem>
+ <simpara>
+ A porta TCP na m�quina do usu�rio utilizada para comunica��o com
+ o servidor web.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>SCRIPT_FILENAME</varname>'</term>
+ <listitem>
+ <simpara>
+ O caminho absoluto o script atualmente em execu��o.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>SERVER_ADMIN</varname>'</term>
+ <listitem>
+ <simpara>
+ O valor fornecido pela diretiva SERVER_ADMIN (do Apache) no
+ arquivo de configura��o do servidor. Se o script est� sendo executado
+ em um host virtual, este ser� os valores definidos para aquele
+ host virtual.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>SERVER_PORT</varname>'</term>
+ <listitem>
+ <simpara>
+ A porta na m�quina servidora utilizada pelo servidor web
+ para comunica��o. Como default, este valor � '<literal>80</literal>'.
+ Utilizando SSL, entretanto, mudar� esse valor para a porta de comunica��o
+ segura HTTP.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>SERVER_SIGNATURE</varname>'</term>
+ <listitem>
+ <simpara>
+ String contendo a vers�o do servidor e nome do host virtual
+ que � adicionado �s p�ginas geradas no servidor, se ativo.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>PATH_TRANSLATED</varname>'</term>
+ <listitem>
+ <simpara>
+ O caminho real do script relativo ao sistema de arquivos
+ (n�o o document root), depois realizou todos os mapeamentos
+ de caminhos (virtual-to-real).
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>SCRIPT_NAME</varname>'</term>
+ <listitem>
+ <simpara>
+ Cont�m o caminho completo do script atual. �til para p�ginas
+ que precisam apontar para elas mesmas (dinamicamente).
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>'<varname>REQUEST_URI</varname>'</term>
+ <listitem>
+ <simpara>
+ O URI fornecido para acessar a p�gina atual, por
+ exemplo, '<literal>/index.html</literal>'.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </para>
+
+ </sect2>
+
+ <sect2 id="reserved.variables.environment">
+ <title>Vari�veis de ambiente: <varname>$_ENV</varname></title>
+
+ <note>
+ <simpara>
+ Introduzida na vers�o 4.1.0. Em vers�es anteriores, utilize
+ <varname>$HTTP_ENV_VARS</varname>.
+ </simpara>
+ </note>
+
+ <simpara>
+ Estas vari�veis s�o importadas dentro no espa�o global do PHP do
+ ambiente sob qual o interpretador do PHP est� rodando. Muitos s�o
+ s�o criados no shell (terminal) sob o qual o PHP � executado e sistemas
+ diferentes normalmente utilizam v�rios sabores de shells, e
+ uma lista definitiva � imposs�vel. Verifique a documenta��o
+ de sua shell para a lista de vari�veis ambiente definidas.
+ </simpara>
+
+ <simpara>
+ Outras vari�veis ambiente incluem as vari�veis CGI, informadas
+ aqui independente do PHP estar rodando como um m�dulo do servidor ou
+ como processador CGI.
+ </simpara>
+
+ <simpara>
+ Esta � uma vari�vel 'superglobal', ou automaticamente global. Isto
+ significa que ela � dispon�vel em todos os escopos (n�veis) de um
+ script. Voc� n�o precisa fazer um <command>global
+ $_ENV;</command> para pode acess�-la dentro de fun��es ou m�todos, como
+ era necess�rio com <varname>$HTTP_ENV_VARS</varname>.
+ </simpara>
+
+ <simpara>
+ <varname>$HTTP_ENV_VARS</varname> cont�m a mesma
+ informa��o, mas n�o � uma superglobal.
+ </simpara>
+
+ <simpara>
+ Se a diretiva <link
+ linkend="ini.register-globals">register_globals</link>
+ est� ativa, ent�o essas vari�veis tornam-se dispon�veis no
+ escopo global do script (por exemplo, separados dos arrays
+ <varname>$_ENV</varname> e <varname>$HTTP_ENV_VARS</varname>.
+ Para maiores informa��es, veja o cap�tulo de seguran�a entitulado
+ <link linkend="security.registerglobals">Utilizando registradores
+ globais</link>. Estas vari�veis globais individuais n�o s�o superglobais.
+ </simpara>
+ </sect2>
+
+ <sect2 id="reserved.variables.cookies">
+ <title>Cookies HTTP: <varname>$_COOKIE</varname></title>
+
+ <note>
+ <simpara>
+ Introduzida na vers�o 4.1.0. Em vers�es anteriores, utilize
+ <varname>$HTTP_COOKIE_VARS</varname>.
+ </simpara>
+ </note>
+
+ <simpara>
+ Cont�m um array associativo de vari�veis passas para o script atual
+ atrav�s de cookies HTTP.
+ </simpara>
+
+ <simpara>
+ Esta � uma vari�vel 'superglobal', ou automaticamente global. Isto
+ significa que ela � dispon�vel em todos os escopos (n�veis) de um
+ script. Voc� n�o precisa fazer um <command>global
+ $_COOKIE;</command> para pode acess�-la dentro de fun��es ou m�todos, como
+ era necess�rio com <varname>$HTTP_COOKIE_VARS</varname>.
+ </simpara>
+
+ <simpara>
+ <varname>$HTTP_COOKIE_VARS</varname> cont�m as mesmas
+ informa��es, mas n�o � uma superglobal.
+ </simpara>
+
+ <simpara>
+ Se a diretiva <link
+ linkend="ini.register-globals">register_globals</link>
+ est� ativa, ent�o essas vari�veis tornam-se dispon�veis no
+ escopo global do script (por exemplo, separados dos arrays
+ <varname>$_COOKIE</varname> e <varname>$HTTP_COOKIE_VARS</varname>.
+ Para maiores informa��es, veja o cap�tulo de seguran�a entitulado
+ <link linkend="security.registerglobals">Utilizando registradores
+ globais</link>. Estas vari�veis globais individuais n�o s�o superglobais.
+ </simpara>
+ </sect2>
+
+ <sect2 id="reserved.variables.get">
+ <title>Vari�veis HTTP GET: <varname>$_GET</varname></title>
+
+ <note>
+ <simpara>
+ Introduzida na vers�o 4.1.0. Em vers�es anteriores, use
+ <varname>$HTTP_GET_VARS</varname>.
+ </simpara>
+ </note>
+
+ <simpara>
+ Cont�m um array associativo de vari�veis passadas para o script atual
+ atrav�s do m�todo HTTP GET.
+ </simpara>
+
+ <simpara>
+ Esta � uma vari�vel 'superglobal', ou automaticamente global. Isto
+ significa que ela � dispon�vel em todos os escopos (n�veis) de um
+ script. Voc� n�o precisa fazer um <command>global
+ $_GET;</command> para pode acess�-la dentro de fun��es ou m�todos, como
+ era necess�rio com <varname>$HTTP_GET_VARS</varname>.
+ </simpara>
+
+ <simpara>
+ <varname>$HTTP_GET_VARS</varname> cont�m as mesmas
+ informa��es, mas n�o � uma superglobal.
+ </simpara>
+
+ <simpara>
+ Se a diretiva <link
+ linkend="ini.register-globals">register_globals</link>
+ est� ativa, ent�o essas vari�veis tornam-se dispon�veis no
+ escopo global do script (por exemplo, separados dos arrays
+ <varname>$_GET</varname> e <varname>$HTTP_GET_VARS</varname>.
+ Para maiores informa��es, veja o cap�tulo de seguran�a entitulado
+ <link linkend="security.registerglobals">Utilizando registradores
+ globais</link>. Estas vari�veis globais individuais n�o s�o superglobais.
+ </simpara>
+ </sect2>
+
+ <sect2 id="reserved.variables.post">
+ <title>Variaveis HTTP POST: <varname>$_POST</varname></title>
+
+ <note>
+ <simpara>
+ Introduzida na vers�o 4.1.0. Em vers�es anteriores, use
+ <varname>$HTTP_POST_VARS</varname>.
+ </simpara>
+ </note>
+
+ <simpara>
+ Cont�m um array associativo de vari�veis passadas para o script atual
+ atrav�s do m�todo HTTP POST.
+ </simpara>
+
+ <simpara>
+ Esta � uma vari�vel 'superglobal', ou automaticamente global. Isto
+ siginifica que ela � dispon�vel em todos os escopos (n�veis) de um
+ script. Voc� n�o precisa fazer um <command>global
+ $_POST;</command> para pode acess�-la dentro de fun��es ou m�todos, como
+ era necess�rio com <varname>$HTTP_POST_VARS</varname>.
+ </simpara>
+
+ <simpara>
+ <varname>$HTTP_POST_VARS</varname> cont�m as mesmas
+ informa��es, mas n�o � uma superglobal.
+ </simpara>
+
+ <simpara>
+ Se a diretiva <link
+ linkend="ini.register-globals">register_globals</link>
+ est� ativa, ent�o essas vari�veis tornam-se dispon�veis no
+ escopo global do script (por exemplo, separados dos arrays
+ <varname>$_POST</varname> e <varname>$HTTP_POST_VARS</varname>.
+ Para maiores informa��es, veja o cap�tulo de seguran�a entitulado
+ <link linkend="security.registerglobals">Utilizando registradores
+ globais</link>. Estas vari�veis globais individuais n�o s�o superglobais.
+ </simpara>
+ </sect2>
+
+ <sect2 id="reserved.variables.files">
+ <title>Vari�veis de upload de arquivos HTTP: <varname>$_FILES</varname></title>
+
+ <note>
+ <simpara>
+ Introduzida na vers�o 4.1.0. Em vers�es anteriores, use
+ <varname>$HTTP_POST_FILES</varname>.
+ </simpara>
+ </note>
+
+ <simpara>
+ Cont�m um array associativo dos itens carregador no script atual
+ atrav�s do m�todo HTTP POST.
+ </simpara>
+
+ <simpara>
+ Esta � uma vari�vel 'superglobal', ou automaticamente global. Isto
+ significa que ela � dispon�vel em todos os escopos (n�veis) de um
+ script. Voc� n�o precisa fazer um <command>global
+ $_FILES;</command> para pode acess�-la dentro de fun��es ou m�todos, como
+ era necess�rio com <varname>$HTTP_FILES_VARS</varname>.
+ </simpara>
+
+ <simpara>
+ <varname>$HTTP_POST_FILES</varname> cont�m as mesmas
+ informa��es, mas n�o � uma superglobal.
+ </simpara>
+
+ <simpara>
+ Se a diretiva <link
+ linkend="ini.register-globals">register_globals</link>
+ est� ativa, ent�o essas vari�veis tornam-se dispon�veis no
+ escopo global do script (por exemplo, separados dos arrays
+ <varname>$_FILES</varname> e <varname>$HTTP_POST_FILES</varname>.
+ Para maiores informa��es, veja o cap�tulo de seguran�a entitulado
+ <link linkend="security.registerglobals">Utilizando registradores
+ globais</link>. Estas vari�veis globais individuais n�o s�o superglobais.
+ </simpara>
+ </sect2>
+
+ <sect2 id="reserved.variables.request">
+ <title>Vari�veis da requisi��o: <varname>$_REQUEST</varname></title>
+
+ <note>
+ <simpara>
+ Introduzida na vers�o 4.1.0. N�o h� array equivalente em vers�es
+ anteriores.
+ </simpara>
+ </note>
+
+ <simpara>
+ Cont�m um array associativo com os conte�dos de
+ <varname>$_GET</varname>, <varname>$_POST</varname>,
+ <varname>$_COOKIE</varname> e <varname>$_FILES</varname>.
+ </simpara>
+
+ <simpara>
+ Esta � uma vari�vel 'superglobal', ou automaticamente global. Isto
+ significa que ela � dispon�vel em todos os escopos (n�veis) de um
+ script. Voc� n�o precisa fazer um <command>global
+ $_REQUEST;</command> para pode acess�-la dentro de fun��es ou m�todos.
+ </simpara>
+
+ <simpara>
+ Se a diretiva <link
+ linkend="ini.register-globals">register_globals</link>
+ est� ativa, ent�o essas vari�veis tornam-se dispon�veis no
+ escopo global do script (por exemplo, separados dos arrays
+ <varname>$_REQUEST</varname>. Para maiores informa��es, veja
+ o cap�tulo de seguran�a entitulado <link
+ linkend="security.registerglobals">Utilizando registradores
+ globais</link>. Estas vari�veis globais individuais n�o s�o superglobais.
+ </simpara>
+ </sect2>
+
+ <sect2 id="reserved.variables.session">
+ <title>Vari�veis de sess�o: <varname>$_SESSION</varname></title>
+
+ <note>
+ <simpara>
+ Introduzida na vers�o 4.1.0. Em vers�es anteriores, use
+ <varname>$HTTP_SESSION_VARS</varname>.
+ </simpara>
+ </note>
+
+ <simpara>
+ Cont�m um array associativo das vari�veis de sess�o dispon�veis para
+ o script atual. Veja a documenta��o das <link linkend="ref.session">fun��es de
+Sess�es
+ </link> para maiores informa��es de como
+ utiliz�-las.
+ </simpara>
+
+ <simpara>
+ Esta � uma vari�vel 'superglobal', ou automaticamente global. Isto
+ siginifica que ela � dispon�vel em todos os escopos (n�veis) de um
+ script. Voc� n�o precisa fazer um <command>global
+ $_SESSION;</command> para pode acess�-la dentro de fun��es ou m�todos, como
+ era necess�rio com <varname>$HTTP_SESSION_VARS</varname>.
+ </simpara>
+
+ <simpara>
+ <varname>$HTTP_SESSION_VARS</varname> cont�m as mesmas
+ informa��es, mas n�o � uma superglobal.
+ </simpara>
+
+ <simpara>
+ Se a diretiva <link
+ linkend="ini.register-globals">register_globals</link>
+ est� ativa, ent�o essas vari�veis tornam-se dispon�veis no
+ escopo global do script (por exemplo, separados dos arrays
+ <varname>$_SESSION</varname> e <varname>$HTTP_SESSION_VARS</varname>
+ Para maiores informa��es, veja o cap�tulo de seguran�a entitulado
+ <link linkend="security.registerglobals">Utilizando registradores
+ globais</link>. Estas vari�veis globais individuais n�o s�o superglobais.
+ </simpara>
+ </sect2>
+
+ <sect2 id="reserved.variables.globals">
+ <title>Variaveis globais: <varname>$GLOBALS</varname></title>
+
+ <note>
+ <simpara>
+ <varname>$GLOBALS</varname> foi disponibilizada desde a vers�o 3.0.0.
+ </simpara>
+ </note>
+
+ <simpara>
+ Um array associativo contendo refer�ncias para todas as vari�veis
+ atualmente definidas no escopo global do script. Os nomes
+ das vari�veis s�o as chaves do array.
+ </simpara>
+
+ <simpara>
+ Esta � uma vari�vel 'superglobal', ou automaticamente global. Isto
+ significa que ela � dispon�vel em todos os escopos (n�veis) de um
+ script. Voc� n�o precisa fazer um <command>global
+ $GLOBALS;</command> para pode acess�-la dentro de fun��es ou m�todos.
+ </simpara>
+
+ </sect2>
+
+ <sect2 id="reserved.variables.phperrormsg">
+ <title>A mensagem de erro anterior: <varname>$php_errormsg</varname></title>
+ <simpara>
+ <varname>$php_errormsg</varname> � uma vari�vel contendo o
+ texto da �ltima mensagem de erro gerada pelo PHP. Esta vari�vel
+ somente est� dispon�vel no escopo em que o erro
+ ocorreu, e somente se a op��o de configura��o <link
+ linkend="ini.track-errors">track_errors</link>
+ est� ativa (seu default � off).
+ </simpara>
+ </sect2>
+ </sect1>
+
+
+ <sect1 id="reserved.classes">
+ <title>Classes pre-definidas</title>
+
+ <sect2 id="reserved.classes.standard">
+ <title>Classes padr�o</title>
+
+ <simpara>
+ Estas classes s�o definidas dentro do conjunto padr�o de fun��es inclu�das
+ na compila��o do PHP.
+ </simpara>
+
+ <variablelist>
+ <varlistentry>
+ <term><classname>Directory</classname></term>
+ <listitem>
+ <simpara>
+ A classe de onde a fun��o <function>dir</function> � instanciada.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>stdClass</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
+
+ <sect2 id="reserved.classes.ming">
+ <title><link linkend="ref.ming">Classes definidas pelo Ming</link></title>
+
+ <simpara>
+ Estas classes s�o definidas na extens�o
+ <link linkend="ref.ming">Ming</link>,
+ e somente estar�o dispon�veis quando esta extens�o for
+ compilada dento do PHP ou carregada em tempo de execu��o.
+ </simpara>
+
+ <variablelist>
+ <varlistentry>
+ <term><classname>swfshape</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>swffill</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>swfgradient</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>swfbitmap</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>swftext</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>swftextfield</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>swffont</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>swfdisplayitem</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>swfmovie</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>swfbutton</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>swfaction</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>swfmorph</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>swfsprite</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
+
+ <sect2 id="reserved.classes.oci8">
+ <title><link linkend="ref.oci8">Classes definidas pelo Oracle 8</link></title>
+
+ <simpara>
+ Estas classes s�o definidas na extens�o
+ linkend="ref.oci8">Oracle 8</link>,
+ e somente estar�o dispon�veis quando esta extens�o for
+ compilada dento do PHP ou carregada em tempo de execu��o.
+ </simpara>
+
+ <variablelist>
+ <varlistentry>
+ <term><classname>OCI-Lob</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>OCI-Collection</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
+
+ <sect2 id="reserved.classes.qtdom">
+ <title><link linkend="ref.qtdom">Classes definidas pelo qtdom</link></title>
+
+ <simpara>
+ Estas classes s�o definidas na extens�o
+ <link linkend="ref.qtdom">qtdom</link>
+ e somente estar�o dispon�veis quando esta extens�o for
+ compilada dento do PHP ou carregada em tempo de execu��o.
+ </simpara>
+
+ <variablelist>
+ <varlistentry>
+ <term><classname>QDomDocument</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><classname>QDomNode</classname></term>
+ <listitem>
+ <simpara>
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
+
+ </sect1>
+
+ &appendices.reserved.constants;
+
</appendix>
<!-- Keep this comment at the end of the file
