andre_ae Tue Apr 30 10:53:06 2002 EDT
Modified files:
/phpdoc/pt_BR bookinfo.xml language-snippets.ent
/phpdoc/pt_BR/appendices aliases.xml
/phpdoc/pt_BR/chapters config.xml intro.xml
Log:
bookinfo.xml - update/revcheck clean
language-snippets.ent - typos/revcheck clean
intro.xml - remove brief-history & update
config.xml - typos, WS, updates, ...
appendices/about.xml - initial translation
Index: phpdoc/pt_BR/bookinfo.xml
diff -u phpdoc/pt_BR/bookinfo.xml:1.13 phpdoc/pt_BR/bookinfo.xml:1.14
--- phpdoc/pt_BR/bookinfo.xml:1.13 Sat Apr 27 10:44:09 2002
+++ phpdoc/pt_BR/bookinfo.xml Tue Apr 30 10:53:05 2002
@@ -1,7 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.12 Maintainer: rarruda Status: ready -->
-<!-- $Revision: 1.13 $ -->
-
+<!-- EN-Revision: 1.26 Maintainer: andre_ae Status: ready -->
+
<bookinfo id="bookinfo">
<authorgroup id="authors">
@@ -40,7 +39,7 @@
</authorgroup>
<pubdate>&php.build-date;</pubdate>
-
+
<authorgroup id="editors">
<editor>
<firstname>Stig</firstname><surname>Sæther Bakken</surname>
@@ -89,7 +88,7 @@
<title>Copyright</title>
<simpara>
Este manual � © Copyright 1997, 1998, 1999, 2000, 2001, 2002 pelo
- PHP Documentation Group. Os membros deste grupo s�o listados
+ PHP Documentation Group. Os membros deste grupo s�o listados
na primeira p�gina deste manual.
</simpara>
<simpara>
@@ -108,7 +107,7 @@
</legalnotice>
</bookinfo>
-
+
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Index: phpdoc/pt_BR/language-snippets.ent
diff -u phpdoc/pt_BR/language-snippets.ent:1.7 phpdoc/pt_BR/language-snippets.ent:1.8
--- phpdoc/pt_BR/language-snippets.ent:1.7 Fri Apr 19 23:06:02 2002
+++ phpdoc/pt_BR/language-snippets.ent Tue Apr 30 10:53:05 2002
@@ -1,13 +1,27 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.24 Maintainer: rarruda Status: ready -->
-
-<!ENTITY warn.experimental '<warning><simpara>Este m�dulo �
<emphasis>EXPERIMENTAL</emphasis>. Isso quer dizer que o comportamento destas fun��es
e seus nomes, incluindo TUDO o que est� documentado aqui pode mudar em futuras vers�es
do PHP, SEM QUALQUER NOTIFICA��O. Esteja avisado, e use este m�dulo por sua pr�pria
conta e risco.</simpara></warning>'>
-
-<!ENTITY warn.experimental.func '<warning><simpara>Esta fun��o �
<emphasis>EXPERIMENTAL</emphasis>. Isso quer dizer que o comportamento desta fun��o e
seu nome, incluindo TUDO o que est� documentado aqui pode mudar em futuras vers�es do
PHP, SEM QUALQUER NOTIFICA��O. Esteja avisado, e use esta fun��o por sua pr�pria conta
e risco.</simpara></warning>'>
-
-<!ENTITY warn.undocumented.func '<warning><simpara>Esta fun��o n�o est� documentada,
somente a lista de argumentos est� dispon�vel.</simpara></warning>'>
-
-<!ENTITY tip.ob-capture '<tip><simpara>Como toda sa�da � normalmente enviada direto
para o browser, voc� pode usar as <link linkend="ref.outcontrol">Fun��es de Controle
de Output</link> para capturar o resultado e guard�-lo (por exemplo) em uma
<type>string</type>.</simpara></tip>'>
+<!-- EN-Revision: 1.25 Maintainer: andre_ae Status: ready -->
+<!ENTITY warn.experimental '<warning><simpara>Este m�dulo �
+<emphasis>EXPERIMENTAL</emphasis>. Isso quer dizer que o comportamento destas fun��es
+e seus nomes, incluindo TUDO o que est� documentado aqui
+pode mudar em futuras vers�es do PHP, SEM QUALQUER NOTIFICA��O.
+Esteja avisado, e use este m�dulo por sua pr�pria conta e
+risco.</simpara></warning>'>
+
+<!ENTITY warn.experimental.func '<warning><simpara>Esta fun��o �
+<emphasis>EXPERIMENTAL</emphasis>. Isso quer dizer que o comportamento desta fun��o
+e seu nome, incluindo TUDO o que est� documentado aqui
+pode mudar em futuras vers�es do PHP, SEM QUALQUER NOTIFICA��O.
+Esteja avisado, e use esta fun��o por sua pr�pria conta e risco.</simpara></warning>'>
+
+<!ENTITY warn.undocumented.func '<warning><simpara>Esta fun��o
+n�o est� documentada, somente a lista de argumentos est�
+dispon�vel.</simpara></warning>'>
+
+<!ENTITY tip.ob-capture '<tip><simpara>Como toda sa�da � normalmente
+enviada direto para o browser, voc� pode usar as <link
+linkend="ref.outcontrol">Fun��es de Controle de Output</link> para capturar
+o resultado e guard�-lo (por exemplo) em uma
+<type>string</type>.</simpara></tip>'>
<!ENTITY tip.fopen-wrapper '<tip><simpara>Voc� pode usar uma URL com esta
fun��o se "fopen wrappers" estiver habilitado
@@ -15,56 +29,70 @@
<!ENTITY return.success 'Retorna &true; em caso de sucesso ou &false; em falhas.'>
-<!ENTITY return.falseproblem '<warning><simpara>Esta fun��o pode retornar &false;,
mas tamb�m pode retornar um valor avaliado como &false; em uma instru��o simples;,
como <literal>0</literal> ou "". Utilize o <link
linkend="language.operators.comparison">operador ===</link> para testar o valor
retornado por esta fun��o.<simpara></warning>'>
+<!ENTITY return.falseproblem '<warning><simpara>Esta fun��o pode
+retornar o booleano &false;, mas tamb�m pode retornar um valor n�o-booleano que pode
+ser
+avaliado como &false;, como <literal>0</literal> ou
+"". Leia a se��o em <link
+linkend="language.types.boolean">Booleanos</link> para maiores
+informa��es. Utilize o <link linkend="language.operators.comparison">operador ===
+</link> para testar o valor retornado por esta
+fun��o.<simpara></warning>'>
<!-- Notas variadas -->
-<!ENTITY note.not-bin-safe '<warning><simpara>Esta fun��o (ainda) n�o � compat�vel
com dados bin�rios!</simpara></warning>'>
+<!ENTITY note.not-bin-safe '<warning><simpara>Esta fun��o
+(ainda) n�o � compat�vel com dados bin�rios!</simpara></warning>'>
-<!ENTITY note.bin-safe '<note><simpara>Esta fun��o � compat�vel com dados
bin�rios</simpara></note>'>
+<!ENTITY note.bin-safe '<note><simpara>Esta fun��o �
+compat�vel com dados bin�rios</simpara></note>'>
-<!ENTITY note.no-windows '<note><simpara>esta fun��o n�o � implementada na plataforma
Windows</simpara></note>'>
+<!ENTITY note.no-windows '<note><simpara>esta fun��o n�o �
+implementada na plataforma Windows</simpara></note>'>
-<!ENTITY note.func-callback '<note><simpara> Ao invez de um nome de fun��o, um array
contendo uma refer�ncia a um objeto e ao nome de um m�todo tamb�m pode ser
passado.</simpara></note>'>
+<!ENTITY note.func-callback '<note><simpara>Ao invez de um nome de fun��o, um
+array contendo uma refer�ncia de objeto e ao nome de m�todo tamb�m pode ser
+fornecidos.</simpara></note>'>
<!-- Notas das limitacoes do Safe-Mode -->
-
<!ENTITY note.sm.disabled '<note><simpara>&sm.disabled;</simpara></note>'>
-<!ENTITY note.sm.uidcheck '<note><simpara>Quando o <link
-linkend="features.safe-mode">safe-mode</link> est� ativo, o PHP verifica se
-o(s) arquivo(s) e/ou diret�rio(s) que ser�o afetados por esta opera��o tem o mesmo
<literal>UID</literal> do script que est� sendo executado.</simpara></note>'>
+<!ENTITY note.sm.uidcheck '<note><simpara>Quando o <link
+linkend="features.safe-mode">safe-mode</link> est� ativo, o PHP verifica se
+o(s) arquivo(s) e/ou diret�rio(s) que ser�o afetados por esta opera��o tem o mesmo
+<literal>UID</literal>
+do script que est� sendo executado.</simpara></note>'>
-<!ENTITY note.sm.uidcheck.dir '<note><simpara>Quando o <link
-linkend="features.safe-mode">safe-mode</link> est� ativo, o PHP verifica se
+<!ENTITY note.sm.uidcheck.dir '<note><simpara>Quando o <link
+linkend="features.safe-mode">safe-mode</link> est� ativo, o PHP verifica se
o diret�rio que ser� afetado por essa opera��o tem o mesmo <literal>UID</literal>
do script que est� sendo executado.</simpara></note>'>
<!-- Pe�as comuns em features/safe-mode.xml porque o
Jade n�o permite entidades in-lines, ent�o eu coloquei aqui... Assim eles
podem ser in-line no safe-mode.xml -->
-
-<!ENTITY sm.uidcheck 'Verifica se o(s) arquivo(s) e/ou diret�rio(s) que
-ser�o afetados por esta opera��o tem o mesmo <literal>UID</literal> do script
+<!ENTITY sm.uidcheck 'Verifica se o(s) arquivo(s) e/ou diret�rio(s) que
+ser�o afetados por esta opera��o tem o mesmo <literal>UID</literal> do script
que est� sendo executado.'>
-<!ENTITY sm.uidcheck.dir 'Verifica se o diret�rio que
-ser� afetado por esta opera��o tem o mesmo <literal>UID</literal> do scritp
+<!ENTITY sm.uidcheck.dir 'Verifica se o diret�rio que
+ser� afetado por esta opera��o tem o mesmo <literal>UID</literal> do scritp
qu est� sendo executado.'>
-<!ENTITY sm.disabled 'Esta fun��o � desabilitada no <link
+<!ENTITY sm.disabled 'Esta fun��o � desabilitada no <link
linkend="features.safe-mode">safe-mode</link>'>
<!-- Pe�as comuns nas partintro-sections -->
-<!ENTITY no.config '<para>Esta exten��o n�o define nenhum parametro de
configura��o.</para>'>
-<!ENTITY no.resource '<para>Esta extens�o n�o define nenhum tipo de resource.</para>'>
+<!ENTITY no.config '<para>Esta exten��o n�o define nenhum
+parametro de configura��o.</para>'>
+<!ENTITY no.resource '<para>Esta extens�o n�o define nenhum tipo resource.</para>'>
<!ENTITY no.constants '<para>Esta extens�o n�o define nenhuma constante.</para>'>
-<!ENTITY no.requirement '<para>Estas fun��es est�o dipon�veis como parte de um
m�dulo,que s�o sempre dispon�veis.</para>'>
-<!ENTITY no.install '<para>N�o h� nenhuma instala��o nescess�ria para utilizar estas
fun��es, elas fazem parte do n�cleo do PHP.</para>'>
+<!ENTITY no.requirement '<para>Estas fun��es s�o disponibilizadas como parte de um
+m�dulo padr�o, e est�o sempre dispon�veis.</para>'>
+<!ENTITY no.install '<para>N�o h� nenhuma instala��o nescess�ria para utilizar estas
+fun��es, elas fazem parte do n�cleo do PHP.</para>'>
<!-- Utilizadas em reference/$extname/constants.xml -->
<!ENTITY extension.constants '<simpara>
Estas contantes s�o definidas por esta extens�o, e somente
-ser� dispon�vel quando a extens�o foi ou compilada no PHP
+estar�o dispon�veis quando a extens�o foi ou compilada com o PHP
ou carregada dinamicamente durante a execu��o.
</simpara>'>
@@ -73,8 +101,8 @@
<!ENTITY reftitle.intro '<title>Introdu��o</title>'>
<!ENTITY reftitle.required '<title>Requisitos</title>'>
<!ENTITY reftitle.install '<title>Instala��o</title>'>
-<!ENTITY reftitle.runtime '<title>Configura��o durante a Execu��o</title>'>
-<!ENTITY reftitle.resources '<title>Resource Types</title>'>
+<!ENTITY reftitle.runtime '<title>Configura��o durante execu��o</title>'>
+<!ENTITY reftitle.resources '<title>Tipos Resource</title>'>
<!ENTITY reftitle.constants '<title>Constantes Predefinidas</title>'>
<!ENTITY reftitle.examples '<title>Exemplos</title>'>
<!ENTITY reftitle.seealso '<title>Veja Tamb�m</title>'>
Index: phpdoc/pt_BR/appendices/aliases.xml
diff -u phpdoc/pt_BR/appendices/aliases.xml:1.4 phpdoc/pt_BR/appendices/aliases.xml:1.5
--- phpdoc/pt_BR/appendices/aliases.xml:1.4 Sat Apr 27 13:21:23 2002
+++ phpdoc/pt_BR/appendices/aliases.xml Tue Apr 30 10:53:05 2002
@@ -1,12 +1,11 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.17 Maintainer: rarruda Status: ready -->
-<!-- $Revision: 1.4 $ -->
<appendix id="aliases">
- <title>Lista de sin�nimos (aliases)</title>
+ <title>Lista de fun��es sin�nimas (aliases)</title>
<para>
Esta � a lista de fun��es sin�nimas. Todas as fun��es sin�nimas est�o
listadas aqui. Normalmente � uma m� id�ia utiliza-l�s, pois elas
- est�o em vias de ser obsoletas ou ser renomeadas, o que criaria um
+ est�o em vias de ficarem obsoletas ou serem renomeadas, o que criaria um
script n�o port�vel. Esta lista � fornecida para ajudar aqueles que
querem atualizar os seus scripts antigos para a nova sintaxe.
</para>
@@ -20,7 +19,7 @@
</para>
<para>
<table>
- <title>Aliases</title>
+ <title>Sin�nimos</title>
<tgroup cols="3">
<thead>
<row>
Index: phpdoc/pt_BR/chapters/config.xml
diff -u phpdoc/pt_BR/chapters/config.xml:1.10 phpdoc/pt_BR/chapters/config.xml:1.11
--- phpdoc/pt_BR/chapters/config.xml:1.10 Sat Apr 27 01:20:17 2002
+++ phpdoc/pt_BR/chapters/config.xml Tue Apr 30 10:53:05 2002
@@ -10,7 +10,7 @@
O arquivo de configura��o (chamado <filename>php3.ini</filename> no
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
+ isso s� acontece uma vez quando o servidor � iniciado. Para a vers�o
<acronym>CGI</acronym> acontece em cada chamada.</simpara>
<para>
<example>
@@ -37,10 +37,10 @@
</para>
<simpara>
- Usando o PHP como um m�dulo do apache, voc� tamb�m pode mudar
+ 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 (Voc� ir� precisar de privil�gios
- "AllowOverride Options" ou "AllowOverride All" privileges)</simpara>
+ "AllowOverride Options" ou "AllowOverride All")</simpara>
<simpara>
Com o PHP 3.0, existem diretivas Apache que correspondem a cada
@@ -136,17 +136,21 @@
</term>
<listitem>
<para>
- Esta op��o habilita o URL-aware fopen wrappers que possibilitam o acesso a
objetos URL
- como arquivos. Wrappers padr�o s�o fornecidos para o acesso de
+ Esta op��o habilita o URL-aware fopen wrappers que possibilitam
+ o acesso a objetos URL
+ como arquivos. Wrappers padr�o s�o fornecidos para o acesso de
<link linkend="features.remote-files">arquivos remotos</link>
- usando os protocolos ftp ou http, algumas extens�es como zlib podem
registrar wrappers adicionais.
+ usando os protocolos FTP ou HTTP, algumas extens�es como zlib podem
+ registrar wrappers adicionais.
</para>
<note>
<para>
- Esta op��o foi introduzida imediatamente ap�s o lan�amento da vers�o 4.0.3.
- Para vers�es superiores incluindo a 4.0.3 voc� s� pode desabilitar essa
fun��o na
- compila��o usando o argumento
+ Esta op��o foi introduzida imediatamente ap�s o lan�amento da vers�o
+ 4.0.3.
+ Para vers�es superiores incluindo a 4.0.3, voc� s� pode desabilitar essa
+ fun��o na
+ compila��o usando o argumento
<link
linkend="install.configure.disable-url-fopen-wrapper"><parameter>--disable-url-fopen-wrapper</parameter></link>
na configura��o (configure).
</para>
</note>
@@ -163,7 +167,7 @@
<simpara>
Habilita o uso de tags no estilo ASP <% %> em adi��o �s tags
<?php ?> usuais. Isso inclui a impress�o resumida
- de valor de vari�vel <%= $valor %>. Para maiores informa��es
+ de valor de vari�vel <%= $valor %>. Para maiores informa��es
veja <link linkend="language.basic-syntax.phpmode">Saindo do HTML</link>.
</simpara>
@@ -173,7 +177,7 @@
</listitem>
</varlistentry>
-
+
<varlistentry id="ini.auto-append-file">
<term>
<parameter>auto_append_file</parameter>
@@ -183,14 +187,15 @@
<para>
Especifica o nome do arquivo que � automaticamente interpretado
ap�s o arquivo principal. O arquivo � inclu�do como se tivesse sido
- chamado com a fun��o <function>include</function> , logo
+ chamado com a fun��o <function>include</function>, logo
<link linkend="ini.include-path">include_path</link> � usado.</para>
<para>
- O valor especial <systemitem class="constant">none</systemitem> desabilita o
auto-appending.
+ O valor especial <systemitem class="constant">none</systemitem>
+ desabilita o auto-appending.
<note>
<simpara>
Se o script � finalizado com <function>exit</function>,
- auto-append <emphasis>n�o</emphasis> ser� lido.</simpara>
+ auto-append <emphasis>n�o</emphasis> ocorrer�.</simpara>
</note></para>
</listitem>
</varlistentry>
@@ -204,10 +209,11 @@
<para>
Especifica o nome do arquivo que � automaticamente interpretado
antes do arquivo principal. O arquivo � inclu�do como se tivesse sido
- chamado com a fun��o <function>include</function> , logo
+ chamado com a fun��o <function>include</function>, logo
<link linkend="ini.include-path">include_path</link> � usado.</para>
<para>
- O valor especial <systemitem class="constant">none</systemitem> desabilita o
auto-prepending.</para>
+ O valor especial <systemitem class="constant">none</systemitem>
+ desabilita o auto-prepending.</para>
</listitem>
</varlistentry>
@@ -234,7 +240,7 @@
</para>
</listitem>
</varlistentry>
-
+
<varlistentry id="ini.doc-root">
<term>
<parameter>doc_root</parameter>
@@ -243,8 +249,9 @@
<listitem>
<para>
O "root directory" do PHP no servidor. S� � usado se n�o
- estiver vazio. Se o PHP � configurado com <link
linkend="ini.safe-mode">safe mode</link>, nenhum
- arquivo fora desse diret�rio � servido.
+ estiver vazio. Se o PHP � configurado com <link
+ linkend="ini.safe-mode">safe mode</link>, nenhum
+ arquivo acima desse diret�rio � acess�vel.
</para>
</listitem>
</varlistentry>
@@ -257,16 +264,16 @@
<listitem>
<para>
Essa diretiva s� � realmente �til com a vers�o de m�dulo Apache
- do PHP. � usado por sites que queiram habilitar ou desabiliar
- a interpreta��o PHP num servidor baseado por-diret�rio ou
- por-virtual. Colocando <userinput>engine
+ do PHP. � usado por sites que queiram habilitar ou desabiliar
+ a interpreta��o PHP num servidor por diret�rio ou
+ por dom�nio virtual. Colocando <userinput>engine
off</userinput> nos devidos lugares no arquivo
- <filename>httpd.conf</filename> , o PHP pode ser habilitado ou
+ <filename>httpd.conf</filename>, o PHP pode ser habilitado ou
desabilitado.
</para>
</listitem>
</varlistentry>
-
+
<varlistentry id="ini.error-log">
<term>
<parameter>error_log</parameter>
@@ -274,10 +281,10 @@
</term>
<listitem>
<para>
- Nome do arquivo onde erros de script devem ser guardados. Se o
+ Nome do arquivo onde erros de script devem ser guardados. Se o
valor especial <literal>syslog</literal> for usado, os erros ser�o
- enviados para o logger do sistema. No UNIX, isto significa
- syslog(3) e no Windows NT isto significa event log. O
+ enviados para o logger do sistema. No UNIX, isto significa
+ syslog(3) e no Windows NT isto significa o event log. O
system logger n�o � suportado no Windows 95.</para>
</listitem>
</varlistentry>
@@ -289,8 +296,8 @@
</term>
<listitem>
<para>
- Define o n�vel de publica��o de erros. O par�metro � um inteiro
- representado um campo de bits. Adicione os valores que voc�
+ Define o n�vel de publica��o de erros. O par�metro � um inteiro
+ representado um campo de bits. Adicione os valores que voc�
queira do n�vel de publica��o de erros.
<table>
<title>N�veis de Publica��o de Erros</title>
@@ -338,7 +345,7 @@
</para>
</listitem>
</varlistentry>
-
+
<varlistentry id="ini.open-basedir">
<term>
<parameter>open_basedir</parameter>
@@ -364,14 +371,14 @@
<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
+ os caminhos de open_basedir de diret�rios pais agora s�o
automaticamente herdados.
</para>
<para>
- A restri��o especificada com open_basedir � na verdade um prefixo, e
+ A restri��o imposta 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
+ se eles existem. Quando voc� deseja restringir o acesso somente
ao diret�rio espec�fico, o termine com uma barra. Por exemplo:
"open_basedir = /dir/incl/"
</para>
@@ -391,11 +398,11 @@
</term>
<listitem>
<para>
- Define a ordem de interpreta��o da vari�vel GET/POST/COOKIE . A
- defini��o padr�o para essa diretiva � "GPC". Definindo-a para
+ Define a ordem de interpreta��o da vari�vel GET/POST/COOKIE . A
+ defini��o padr�o para essa diretiva � "GPC". Definindo-a para
"GP", por exemplo, far� com que o PHP ignore completamente cookies
- e ir� sobescrever quaisquer vari�veis com o m�todo GET por vari�veis com
- o m�todo POST com o mesmo nome.
+ e ir� sobescrever quaisquer vari�veis enviadas com o m�todo GET por vari�veis
+ do m�todo POST com o mesmo nome.
</para>
<para>
Note que esta op��o n�o est� dispon�vel no PHP 4.
@@ -412,11 +419,11 @@
</term>
<listitem>
<para>
- Definir a ordem do parsing das vari�veis EGPCS (Environment,
+ Define a ordem de prioridade 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
+ far� com que o PHP ignore completamente as vari�veis de ambiente
+ (environment) cookies e server, e sobrescrever qualquer
variavel do metodo GET com variaveis do modo POST com o mesmo nome.
</para>
<para>
@@ -434,12 +441,12 @@
<listitem>
<para>
Habilitado (On) por padr�o. Se desabilitado (Off) os scripts ir�o ser
finalizados
- t�o cedo quanto ele tentar imprimir algo ap�s o cliente ter abortado a
conex�o.
- <function>ignore_user_abort</function>.
+ t�o logo quanto ele tentar imprimir algo e descobrir que o usu�rio cancelou
+a conex�o.
+ Veja tamb�m <function>ignore_user_abort</function>.
</para>
</listitem>
</varlistentry>
-
+
<varlistentry id="ini.include-path">
<term>
<parameter>include_path</parameter>
@@ -450,7 +457,7 @@
Especifica uma lista de diret�rios onde as fun��es
<function>require</function>, <function>include</function>
e <function>fopen_with_path</function> procuram por
- arquivos. O formato � como a vari�vel de ambiente <envar>PATH</envar>
+ arquivos. O formato � o mesmo da vari�vel de ambiente <envar>PATH</envar>
do sistema: uma lista de diret�rios separados por
dois pontos no UNIX ou ponto-e-v�rgula no Windows.
<example>
@@ -493,7 +500,7 @@
<listitem>
<para>
Diz se as mensagens de erro devem ser salvas no
- arquivo de log do servidor. Logo, esta op��o � espec�fica do servidor.</para>
+ arquivo de log do servidor. Logo, esta op��o � espec�fica por
+servidor.</para>
</listitem>
</varlistentry>
@@ -504,10 +511,10 @@
</term>
<listitem>
<para>
- Define o estado de magic_quotes para as opera��es
- GPC (Get/Post/Cookie). Quando os magic_quotes est�o habilitados (on),
- todas ' (aspas simples), " (aspas duplas), \ (barra invetida) e NUL's
s�o
- automaticamente escapadas com a barra invertida. Se magic_quotes_sybase is
+ Define o estado de magic_quotes para as opera��es
+ GPC (Get/Post/Cookie). Quando os magic_quotes est�o habilitados (on),
+ todas ' (aspas simples), " (aspas duplas), \ (barra invetida) e NULL's
+s�o
+ automaticamente prefixadas (escaped) com a barra invertida. Se
+magic_quotes_sybase
tamb�m est� habilitado (on), uma aspa simples � escapada como aspa simples
ao inv�s da barra invertida.
</para>
@@ -539,7 +546,7 @@
<listitem>
<para>
Se <parameter>magic_quotes_sybase</parameter> tamb�m estiver habilitado (on),
- aspa simples � escapada como aspa simples ao inv�s de barra invertida
+ aspas simples � escapada como aspa simples ao inv�s de barra invertida
se <parameter>magic_quotes_gpc</parameter> ou
<parameter>magic_quotes_runtime</parameter> estiverem habilitados.
</para>
@@ -554,8 +561,9 @@
<listitem>
<para>
Isto define a quantide m�xima de tempo em segundos que um script � permitido
- ter antes de ser finalizado pelo interpretador. Isto previne
- scripts mal escritos de travar o servidor. O valor padr�o �
<literal>30</literal>.
+ rodar 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,
@@ -565,7 +573,7 @@
</para>
</listitem>
</varlistentry>
-
+
<varlistentry id="ini.memory-limit">
<term>
<parameter>memory_limit</parameter>
@@ -579,7 +587,7 @@
</para>
</listitem>
</varlistentry>
-
+
<varlistentry id="ini.nsapi-ext">
<term>
<parameter>nsapi_ext</parameter>
@@ -590,7 +598,7 @@
</para>
</listitem>
</varlistentry>
-
+
<varlistentry id="ini.precision">
<term>
<parameter>precision</parameter>
@@ -606,7 +614,7 @@
<varlistentry id="ini.register-argc-argv">
<term>
<parameter>register_argc_argv</parameter>
- <type>boolean</type>
+ <type>booleano</type>
</term>
<listitem>
<simpara>
@@ -614,8 +622,8 @@
(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
+ Veja tamb�m <link linkend="commandline">PHP em linha de comando</link>.
+ Esta diretiva se tornou dispon�vel no PHP 4.0.0 e
estava sempre habilitanda antes desta vers�o.
</simpara>
</listitem>
@@ -628,16 +636,16 @@
</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>.
+ Define o tamanho m�ximo dos dados informados via POST. Esse par�metro afeta
+ o upload de arquivos. Para poder receber arquivos grandes, este valor
+precisa ser maior
+ que o <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
+ Se o limite de mem�ria foi informado no script de configura��o, <link
+ linkend="ini.memory-limit">memory_limit</link> afetar� o
+ upload de arquivos. Ou seja, o <link
+ linkend="ini.memory-limit">memory_limit</link> tamb�m precisa
+ maior que <link
linkend="ini.post-max-size">post_max_size</link>.
</simpara>
</listitem>
@@ -648,25 +656,29 @@
<parameter>register_globals</parameter>
<type>booleano</type>
</term>
- <listitem>
+ <listitem>
<para>
Diz quando registrar as vari�veis EGPCS (Environment, GET,
POST, Cookie, Server) como globais ou n�o. Voc� pode
desabilitar isso se voc� n�o quer misturar o escopo global do seu script
com dados de usu�rio. Isto faz mais senso
quando usado juntamente com <link
- linkend="ini.track-vars">track_vars</link> - neste caso
+ linkend="ini.track-vars">track_vars</link>. Neste caso
voc� pode acessar todas as vari�veis EGPCS atrav�s das matrizes
- <varname>$HTTP_ENV_VARS</varname>,
- <varname>$HTTP_GET_VARS</varname>,
- <varname>$HTTP_POST_VARS</varname>,
- <varname>$HTTP_COOKIE_VARS</varname>, e
- <varname>$HTTP_SERVER_VARS</varname>
+ <varname>$_ENV</varname>,
+ <varname>$_GET</varname>,
+ <varname>$_POST</varname>,
+ <varname>$_COOKIE</varname> e
+ <varname>$_SERVER</varname>
no escopo global.
</para>
- </listitem>
+ <para>
+ Please note that you need to set AllowOveride All in your
+ Directory block in the apache config file for this to work.
+ </para>
+ </listitem>
</varlistentry>
-
+
<varlistentry id="ini.short-open-tag">
<term>
<parameter>short_open_tag</parameter>
@@ -714,11 +726,11 @@
<para>
Se habilitado, ent�o as vari�veis Environment, GET, POST, Cookie,
e Server poder�o ser encontradas nas matrizes associativas globais
- <varname>$HTTP_ENV_VARS</varname>,
- <varname>$HTTP_GET_VARS</varname>,
- <varname>$HTTP_POST_VARS</varname>,
- <varname>$HTTP_COOKIE_VARS</varname>, e
- <varname>$HTTP_SERVER_VARS</varname>.
+ <varname>$_ENV</varname>,
+ <varname>$_GET</varname>,
+ <varname>$_POST</varname>,
+ <varname>$_COOKIE</varname> e
+ <varname>$_SERVER</varname>.
</para>
<para>
Note que no PHP 4.0.3, <systemitem
@@ -735,8 +747,22 @@
<listitem>
<para>
O diret�rio tempor�rio usado para armazenar arquivos
- durante o upload de arquivos. Deve ser grav�vel por qualquer usu�rio em
- que o PHP esteja sendo rodado.</para>
+ durante o upload de arquivos. Deve ter permiss�o de escrita para qualquer
+usu�rio em
+ que o PHP esteja sendo rodado.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.upload-max-filesize">
+ <term>
+ <parameter>upload_max_filesize</parameter>
+ <type>inteiro</type>
+ </term>
+ <listitem>
+ <para>
+ O tamanho m�ximo de um upload de arquivo. O valor �
+ expresso em bytes.
+ </para>
</listitem>
</varlistentry>
@@ -747,7 +773,7 @@
</term>
<listitem>
<para>
- O nome base do diret�rio usado no diret�rio home de um usu�rio
+ O caminho base do usado como diret�rio home do usu�rio
para arquivos PHP, por exemplo
<literal>public_html</literal>.</para>
</listitem>
@@ -761,7 +787,7 @@
<listitem>
<para>
Se habilitado, esta op��o faz com que o PHP imprima um aviso quando o
operador
- mais (<literal>+</literal>) � usado em strings.
+ mais (<literal>+</literal>) � usado em vari�veis string.
Isto � para tornar mais f�cil encontrar scripts que precisam ser reescritos
para substituir pelo concatenador de strings
(<literal>.</literal>).</para>
Index: phpdoc/pt_BR/chapters/intro.xml
diff -u phpdoc/pt_BR/chapters/intro.xml:1.6 phpdoc/pt_BR/chapters/intro.xml:1.7
--- phpdoc/pt_BR/chapters/intro.xml:1.6 Sat Apr 20 03:18:19 2002
+++ phpdoc/pt_BR/chapters/intro.xml Tue Apr 30 10:53:05 2002
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.2 Maintainer: andre_ae Status: ready -->
-
+<!-- EN-Revision: 1.33 Maintainer: andre_ae Status: ready -->
<chapter id="introduction">
<title>Introdu��o</title>
@@ -8,10 +7,12 @@
<title>O que � PHP?</title>
<para>
PHP (um acr�nimo recursivo para "PHP: Hypertext Preprocessor")
- � uma linguagem de script open-source do lado do servidor embut�vel em HTML.
+ � uma linguagem de script Open Source de uso geral, muito
+ utilizada e especialmente guarnecida para o desenvolvimento
+ de aplica��es Web emb�tivel dentro do HTML.
</para>
<para>
- Uma resposta simples, mas o que isso significa? Um exemplo:
+ Uma resposta simples, mas o que isso significa?
</para>
<para>
<example>
@@ -25,7 +26,7 @@
<body>
<?php
- echo "Ol�, Eu sou um script PHP!";
+ echo "Ol�, Eu sou um script PHP!";
?>
</body>
@@ -48,9 +49,21 @@
� que o c�digo � executado no servidor. Se voc� tivesse um
script similar ao acima em seu servidor, o cliente receberia
os resultados da execu��o desse script, sem nenhum modo de determinar
- qual � o c�digo fonte. Voc� pode inclusive configurar seu servidor
+ como � o c�digo fonte. Voc� pode inclusive configurar seu servidor
para processar todos os seus arquivos HTML como PHP, e ent�o n�o haver�
- nenhum modo dos usu�rios descobrirem que voc� usa essa linguagem.
+ nenhum modo dos usu�rios descobrirem que se voc� usa essa linguagem ou n�o.
+ </para>
+ <para>
+ A melhor coisa em usar PHP est� no fato de ele ser extremamente simples
+ para um iniciante, mas oferece muitos recursos para
+ o programador profissional. N�o se preocupe em ler as longas
+ listas de fun��es do PHP. Voc� pode pular essa parte (por enquanto) e
+ come�ar a escrever scripts em poucas horas.
+ </para>
+ <para>
+ Apesar do desenvolvimento do PHP ser focado nos scripts do lado do servidor,
+ voc� pode fazer muito mais com ele. Veja isso e leia mais na se��o
+ <link linkend="intro-whatcando">O que o PHP pode fazer?</link>.
</para>
</sect1>
@@ -59,7 +72,7 @@
<para>
Qualquer coisa. O PHP � focado para ser uma linguagem de script do lado do
servidor,
portanto, voc� pode fazer qualquer coisa que outro programa CGI pode fazer, como:
- coletar dados de formul�rios, gerar conte�do din�mico de p�ginas ou
+ coletar dados de formul�rios, gerar p�ginas com conte�do din�mico ou
enviar e receber cookies. Mas o PHP pode fazer muito mais.
</para>
<para>
@@ -70,8 +83,8 @@
Script no lado do servidor (server-side). Este � o mais tradicional
e principal campo de atua��o do PHP. Voc� precisa de tr�s coisas
para seu trabalho. O interpretador do PHP (como CGI ou m�dulo),
- um servidor web e um browser. Basta rodar o servidor web
- conectado a um PHP instalado.
+ um servidor web e um browser. Basta
+ rodar o servidor web onectado a um PHP instalado.
Voc� pode acessar os resultados de seu programa PHP com um browser,
visualizando a p�gina PHP atrav�s do servidor web. Veja as
<link linkend="installation">instru��es de instala��o</link>
@@ -84,8 +97,9 @@
funcionar sem um servidor web ou browser.
A �nica coisa necess�ria � o interpretador.
Esse tipo de uso � ideal para script executados
- usando o <literal>cron</literal> (ou o Agendador de Tarefas no Windows),
- ou rotinas de processamento de texto. Veja a se��o
+ usando o <literal>cron</literal> ou o Agendador de Tarefas (no
+ Windows). Esses scripts podem ser usados tamb�m para
+ rotinas de processamento de texto. Veja a se��o
<link linkend="commandline">Utilizando o PHP em
linha de comando</link> para maiores informa��es.
</simpara>
@@ -111,23 +125,22 @@
O PHP pode ser utilizado na maioria dos sistemas operacionais, incluindo
Linux, v�rias variantes Unix (incluindo HP-UX, Solaris e OpenBSD),
Microsoft Windows, Mac OS X, RISC OS, e provavelmente outros.
- O PHP tamb�m � suportado pela maioria dos servidores web atuais, incluindo
- Apache, Microsoft Internet Information Server,
+ O PHP tamb�m � suportado pela maioria dos servidores web atuais,
+ incluindo Apache, Microsoft Internet Information Server,
Personal Web Server, Netscape and iPlanet Servers, Oreilly
Website Pro Server, Caudium, Xitami, OmniHTTPd, e muitos
- outros. O PHP pode ser configurado como um m�dulo para a maioria dos servidores,
- e para os outros como um CGI padr�o.<!--(repetitivo) PHP can work
+ outros. O PHP pode ser configurado como m�dulo para a maioria dos servidores,
+ e para os outros como um CGI comum.<!--(repetitivo) PHP can work
as a CGI processor.-->
</para>
<para>
- Com o PHP, portanto, voc� tem livre arb�trio para escolher o sistema
+ Com o PHP, portanto, voc� tem a liberdade para escolher o sistema
operacional e o servidor web. Do mesmo modo, voc� pode escolher entre
utilizar programa��o estrutural ou programa��o orientada a objeto,
- ou uma mistura deles. Mesmo n�o
+ ou ainda uma mistura deles. Mesmo n�o
desenvolvendo nenhum recurso padr�o de OOP (Object Oriented Programming,
Programa��o Orientada a Objetos) na vers�o atual
do PHP, muitas bibliotecas de c�digo e grandes aplica��es (incluindo a
- <link linkend="pear">biblioteca PEAR</link>) foram escritos somente
- utilizando OOP.
+ biblioteca PEAR) foram escritos somente utilizando OOP.
</para>
<para>
Com PHP voc� n�o est� limitado a gerar somente HTML. As habilidades
@@ -193,7 +206,7 @@
XSLT para transformar documentos XML.
</para>
<para>
- Utilizando o PHP no campo comercial, voc� poder� as
+ Utilizando o PHP no campo do e-commerce, voc� poder� usar as
fun��es espec�ficas para Cybescash, CyberMUT, Verysign Payflow
Pro e CCVS, pr�ticos sistemas de pagamento
online.
@@ -208,68 +221,12 @@
Como voc� pode ver, esta p�gina n�o � suficiente para descrever todos
os recursos e benef�cios que o PHP pode oferecer. Leia nas
se��es sobre a <link linkend="installation">Instala��o do
- PHP</link>, e veja a <link linkend="funcref">lista de
+ PHP</link>, e veja a <link linkend="funcref">refer�ncia das
fun��es</link> para detalhes das extens�es
mencionadas aqui.
</para>
</sect1>
- <sect1 id="intro-history">
- <title>Uma breve hist�ria do PHP</title>
- <simpara>
- O PHP foi concebido em por volta de 1994 por &link.rasmus;.
- Vers�es iniciais n�o lan�adas foram usadas em sua home page para
- rastrear quem estava olhando o seu curr�culo virtual. A primeira vers�o
- utilizada por terceiros ficou dispon�vel em 1995 e era conhecida como
- Personal Home Page Tools. Consistia de um interpretador
- muito simples que apenas entendia algumas macros especiais
- e um conjunto de utilit�rios comuns em home pages
- daquela �poca. Um guestbook (livro de visitantes), um contador, e algumas outras
coisas. O
- interpretador foi rescrito em meados de 1995 e batizado PHP/FI vers�o 2. O
- FI era de outro pacote que Rasmus tinha escrito e interpretava
- dados de formul�rios HTML. Ele combinou os scripts do Personal Home Page Tools
- com o Form Interpreter e adicionou suporte ao mSQL e assim nasceu o
- PHP/FI. O PHP/FI cresceu a um ritmo fant�stico e pessoas come�aram
- a contribuir para seu c�digo.
- </simpara>
- <simpara>
- � dif�cil precisar qualquer estat�stica, mas estima-se
- que ao final de 1996 o PHP/FI estava em uso em pelo menos 15,000 web sites
- ao redor do mundo. Em meados de 1997 este n�mero tinha crescido para mais de
- 50,000. Na metade de 1997 houve uma mudan�a no desenvolvimento do PHP. Ele deixou
- de ser o projeto pessoal de Rasmus ao qual muitas pessoas tinham
- contribu�do, para se tornar o foco de um time mais
- organizado. O interpretador foi rescrito do zero por Zeev Suraski e
- Andi Gutmans e este novo interpretador formou a base do PHP vers�o
- 3. Muito do c�digo dos utilit�rios do PHP/FI foi portado para o PHP 3
- e muito mais dele foi completamente rescrito.
- </simpara>
- <simpara>
- A �ltima vers�o (PHP 4) usa engine de scripting da <ulink
- url="&url.zend;">Zend</ulink> para possibilitar alta
- performance, suportar uma ampla variedade de bibliotecas externas
- e extens�es, e ainda rodar como um m�dulo nativo com todos os
- servidores web populares.
- </simpara>
- <simpara>
- Hoje (1/2001), o PHP 3 ou 4 pode ser encontrado em numerosos
- produtos comerciais como o servidor web Stronghold da Red Hat.
- Uma estimativa conservadora baseada na extrapola��o de
- n�meros fornecidos pela <ulink url="&url.netcraft;">Netcraft</ulink>
- (veja tamb�m <ulink url="&url.netcraft-survey;">Netcraft Web Server
- Survey</ulink>) diria que o PHP est� em uso em mais de 5.100.000
- sites ao redor do mundo. Para colocar isso em perspectiva, este n�mero �
- sensivelmente maior do que o n�mero de sites que rodam o servidor IIS da
Microsoft na Internet
- (5,03 milh�es).
- </simpara>
-<!--
- <figure>
- <title>NetCraft Webserver Survey</title>
- <graphic fileref="&url.php.stats;"/>
- </figure>
--->
- </sect1>
-
</chapter>
<!-- Keep this comment at the end of the file
@@ -288,4 +245,7 @@
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
-->
