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>
