rarruda Sat Apr 27 01:20:18 2002 EDT
Modified files:
/phpdoc/pt_BR/chapters config.xml
Log:
fixed this file so now the pt_BR docs can be built. also updated a part of this file
(not done yet with sync'ing with en/)
Index: phpdoc/pt_BR/chapters/config.xml
diff -u phpdoc/pt_BR/chapters/config.xml:1.9 phpdoc/pt_BR/chapters/config.xml:1.10
--- phpdoc/pt_BR/chapters/config.xml:1.9 Sat Apr 20 03:18:19 2002
+++ phpdoc/pt_BR/chapters/config.xml Sat Apr 27 01:20:17 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.11 Maintainer: afortaleza Status: ready -->
+<!-- EN-Revision: 1.50 Maintainer: afortaleza Status: working -->
<chapter id="configuration">
<title>Configura��o</title>
@@ -8,15 +8,39 @@
<simpara>
O arquivo de configura��o (chamado <filename>php3.ini</filename> no
- PHP 3.0, e simplesmente <filename>php.ini</filename> no PHP 4.0)
+ PHP 3.0, e simplesmente &php.ini; no PHP 4.0)
� lido quando o PHP inicia. Para as vers�es de m�dulos de servidor do PHP,
isso s� acontece uma vez quando o servidor � iniciado. Para a vers�o
<acronym>CGI</acronym> acontece em cada chamada.</simpara>
+ <para>
+ <example>
+ <title>&php.ini; example</title>
+ <programlisting role="ini">
+<![CDATA[
+; any text on a line after an unquoted semicolon (;) is ignored
+[php] ; section markers (text within square brackets) are also ignored
+; Boolean values can be set to either:
+; true, on, yes
+; or false, off, no, none
+register_globals = off
+magic_quotes_gpc = yes
+
+; you can enclose strings in double-quotes
+include_path = ".:/usr/local/lib/php"
+
+; backslashes are treated the same as any other character
+include_path = ".;c:\php\lib"
+]]>
+</programlisting>
+<!-- TODO: add more details about values and expressions -->
+ </example>
+ </para>
<simpara>
Usando o PHP como um m�dulo do apache, voc� tamb�m pode mudar
as defini��es de configura��o usando diretivas na configura��o dos arquivos
- Apache e dos arquivos .htaccess.</simpara>
+ Apache e dos arquivos .htaccess (Voc� ir� precisar de privil�gios
+ "AllowOverride Options" ou "AllowOverride All" privileges)</simpara>
<simpara>
Com o PHP 3.0, existem diretivas Apache que correspondem a cada
@@ -24,8 +48,8 @@
exceto o nome predefinido por "php3_".</simpara>
<para>
- Com o PHP 4.0, existem apenas poucas diretivas Apache que lhe permitem
- mudar as defini��es de configura��o PHP.
+ Com o PHP 4.0, existem v�rias diretivas do Apache que lhe permitem
+ mudar a configura��o PHP dentro do arquivo de configura��o do Apache.
<variablelist>
<varlistentry>
<term>
@@ -60,8 +84,7 @@
Isto define o valor da vari�vel especificada. Defini��es de
configura��o "Admin" s� podem ser definidas a partir dos
arquivos principais de configura��o do Apache, e n�o
- dos arquivos .htaccess.
- </para>
+ dos arquivos .htaccess.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -75,13 +98,32 @@
Isto � usado para definir uma op��o de configura��o Booleana.</para>
</listitem>
</varlistentry>
- </variablelist></para>
+ </variablelist>
+ </para>
+ <para>
+ <example>
+ <title>Exemplo de configura��o do Apache</title>
+ <programlisting role="ini">
+<![CDATA[
+<IfModule mod_php4.c>
+ php_value include_path ".:/usr/local/lib/php"
+ php_flag safe_mode on
+</IfModule>
+<IfModule mod_php3.c>
+ php3_include_path ".:/usr/local/lib/php"
+ php3_safe_mode on
+</IfModule>
+]]>
+</programlisting>
+ </example>
+ </para>
<simpara>
Voc� pode visualizar as defini��es dos valores de configura��o na
sa�da de <function>phpinfo</function>. Voc� tamb�m pode acessar
os valores de defini��es de configura��o originais usando
- <function>get_cfg_var</function>.</simpara>
+ <function>get_cfg_var</function>.
+ </simpara>
<sect2 id="ini.sect.general">
<title>Diretivas Gerais de Configura��o</title>
@@ -284,6 +326,18 @@
</para>
</listitem>
</varlistentry>
+
+ <varlistentry id="ini.html-errors">
+ <term>
+ <parameter>html_errors</parameter>
+ <type>booleano</type>
+ </term>
+ <listitem>
+ <para>
+ Desabilita tags HTML nas mensagens de erro.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry id="ini.open-basedir">
<term>
@@ -309,10 +363,18 @@
</para>
<para>
No Windows, separe os diret�rios com ponto-e-v�rgula. Em todos os outros
- sistemas, separe os diret�rios com dois pontos. Como um m�dulo Apache
- ,os paths de open_basedir de dret�rios parentes agora s�o
+ sistemas, separe os diret�rios com dois pontos. Como um m�dulo Apache,
+ os paths de open_basedir de dret�rios parentes agora s�o
automaticamente herdados.
</para>
+ <para>
+ A restri��o especificada com open_basedir � na verdade um prefixo, e
+ n�o um nome de diret�rio. Isso significa que "open_basedir =
+ /dir/incl" tamb�m permite acesso a "/dir/include" e "/dir/incls"
+ se eles existem. Quando voc� deseja restringir o casso somente
+ ao diret�rio espec�fico, o termine com uma barra. Por exemplo:
+ "open_basedir = /dir/incl/"
+ </para>
<note>
<para>O supporte para m�ltiplos diret�rios foi adicionado na vers�o
3.0.7.</para>
</note>
@@ -335,6 +397,32 @@
e ir� sobescrever quaisquer vari�veis com o m�todo GET por vari�veis com
o m�todo POST com o mesmo nome.
</para>
+ <para>
+ Note que esta op��o n�o est� dispon�vel no PHP 4.
+ Use <link linkend="ini.variables-order">variables_order</link>
+ ao invez.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.variables-order">
+ <term>
+ <parameter>variables_order</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <para>
+ Definir a ordem do parsing das vari�veis EGPCS (Environment,
+ GET, POST, Cookie, Server). A defini��o padr�o para essa
+ diretiva � "EGPCS". Definindo como "GP", por exemplo,
+ faria que o PHP completamente ignorasse as vari�veis de ambiente
+ (environment), cookies e server, e sobre escrever qualquer
+ variavel do metodo GET com variaveis do modo POST com o mesmo nome.
+ </para>
+ <para>
+ Veja tamb�m <link
+linkend="ini.register-globals">register_globals</link>.
+ </para>
</listitem>
</varlistentry>
@@ -368,14 +456,18 @@
<example>
<title>include_path no UNIX</title>
<programlisting role="php3.ini">
+<![CDATA[
include_path=.:/home/httpd/php-lib
-</programlisting>
+]]>
+ </programlisting>
</example>
<example>
<title>include_path no Windows</title>
<programlisting role="php3.ini">
+<![CDATA[
include_path=".;c:\www\phplib"
-</programlisting>
+]]>
+ </programlisting>
</example>
O valor padr�o para essa diretiva � <literal>.</literal>
(apenas o diret�rio atual).</para>
@@ -465,6 +557,12 @@
ter antes de ser finalizado pelo interpretador. Isto previne
scripts mal escritos de travar o servidor. O valor padr�o �
<literal>30</literal>.
</para>
+ <para>
+ O tempo m�ximo de execu��o n�o � afetado por qualquer system calls,
+ a fun��o <function>sleep</function>, etc. Veja a fun��o
+ <function>set_time_limit</function> para mais
+ detalhes.
+ </para>
</listitem>
</varlistentry>
@@ -493,6 +591,58 @@
</listitem>
</varlistentry>
+ <varlistentry id="ini.precision">
+ <term>
+ <parameter>precision</parameter>
+ <type>inteiro</type>
+ </term>
+ <listitem>
+ <simpara>
+ O n�mero de digitos significativos mostrado em n�meros de ponto flutuante.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.register-argc-argv">
+ <term>
+ <parameter>register_argc_argv</parameter>
+ <type>boolean</type>
+ </term>
+ <listitem>
+ <simpara>
+ Diz ao PHP se declara as variaveis argv & argc
+ (que conteriam a informa��o do GET).
+ </simpara>
+ <simpara>
+ Veja tamb�m <link linkend="commandline">linha de comando</link>.
+ Tamb�m, esta diretiva se tornou dispon�vel no PHP 4.0.0 e
+ estava sempre habilitanda antes desta vers�o.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.post_max_size">
+ <term>
+ <parameter>post_max_size</parameter>
+ <type>integer</type>
+ </term>
+ <listitem>
+ <simpara>
+ Sets max size of post data allowed. This setting also affects
+ file upload. To upload large files, this value must be larger
+ than <link linkend="upload-max-filesize">upload_max_filesize</link>.
+ </simpara>
+ <simpara>
+ If memory limit is enabled by configure script, <link
+ linkend="ini.memory-limit">memory_limit</link> also affects
+ file uploading. Generally speaking, <link
+ linkend="ini.memory-limit">memory_limit</link> should be
+ larger than <link
+ linkend="ini.post-max-size">post_max_size</link>.
+ </simpara>
+ </listitem>
+ </varlistentry>
+
<varlistentry id="ini.register-globals">
<term>
<parameter>register_globals</parameter>
@@ -805,90 +955,6 @@
</variablelist>
</sect2>
- <sect2 id="ini.sect.mysql">
- <title>Diretivas de Configura��o MySQL</title>
- <variablelist>
-
- <varlistentry id="ini.mysql.allow-persistent">
- <term>
- <parameter>mysql.allow_persistent</parameter>
- <type>booleano</type>
- </term>
- <listitem>
- <para>
- Permite ou n�o conec��es MySQL persistentes.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.mysql.default-host">
- <term>
- <parameter>mysql.default_host</parameter>
- <type>string</type>
- </term>
- <listitem>
- <para>
- A m�quina de servidor padr�o ao conectar a um servidor de banco de dados
- se n�o for especificado.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.mysql.default-user">
- <term>
- <parameter>mysql.default_user</parameter>
- <type>string</type>
- </term>
- <listitem>
- <para>
- O usu�rio padr�o a ser usado ao se conectar a um servidor de banco de dados
- se n�o for especificado.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.mysql.default-password">
- <term>
- <parameter>mysql.default_password</parameter>
- <type>string</type>
- </term>
- <listitem>
- <para>
- A senha padr�o a ser usada ao se conectar a um servidor de banco de dados
- se n�o for especificada.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.mysql.max-persistent">
- <term>
- <parameter>mysql.max_persistent</parameter>
- <type>inteiro</type>
- </term>
- <listitem>
- <para>
- O n�mero m�ximo de conec��es persistentes MySQL por
- processo.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.mysql.max-links">
- <term>
- <parameter>mysql.max_links</parameter>
- <type>inteiro</type>
- </term>
- <listitem>
- <para>
- O n�mero m�ximo de conex�es MySQL por processo, incluindo
- conex�es persistentes.
- </para>
- </listitem>
- </varlistentry>
-
- </variablelist>
- </sect2>
-
<sect2 id="ini.sect.msql">
<title>Diretivas de Configura��o mSQL</title>
<variablelist>
@@ -1411,92 +1477,6 @@
<para>
Nome do arquivo de capacidade do navegador. Veja tamb�m
<function>get_browser</function>.
- </para>
- </listitem>
- </varlistentry>
-
- </variablelist>
- </sect2>
-
- <sect2 id="ini.sect.uodbc">
- <title>Diretivas de Configura��o Unified ODBC</title>
- <variablelist>
-
- <varlistentry id="ini.uodbc.default-db">
- <term>
- <parameter>uodbc.default_db</parameter>
- <type>string</type>
- </term>
- <listitem>
- <para>
- Fonte de dados ODBC a ser usada se nenhuma for especificada em
- <function>odbc_connect</function> ou
- <function>odbc_pconnect</function>.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.uodbc.default-user">
- <term>
- <parameter>uodbc.default_user</parameter>
- <type>string</type>
- </term>
- <listitem>
- <para>
- Nome de usu�rio a usar de nenhum foi especificado em
- <function>odbc_connect</function> ou
- <function>odbc_pconnect</function>.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.uodbc.default-pw">
- <term>
- <parameter>uodbc.default_pw</parameter>
- <type>string</type>
- </term>
- <listitem>
- <para>
- Senha a ser usada se nenhuma foi especificada em
- <function>odbc_connect</function> ou
- <function>odbc_pconnect</function>.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.uodbc.allow-persistent">
- <term>
- <parameter>uodbc.allow_persistent</parameter>
- <type>booleano</type>
- </term>
- <listitem>
- <para>
- Permitir ou n�o conex�es ODBC persistentes.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.uodbc.max-persistent">
- <term>
- <parameter>uodbc.max_persistent</parameter>
- <type>inteiro</type>
- </term>
- <listitem>
- <para>
- O n�mero m�ximo de conex�es persistentes ODBC por processo.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.uodbc.max-links">
- <term>
- <parameter>uodbc.max_links</parameter>
- <type>inteiro</type>
- </term>
- <listitem>
- <para>
- O n�mero m�ximo de conex�es ODBC por processo, incluindo
- conex�es persistentes.
</para>
</listitem>
</varlistentry>
