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 -->