ae Mon May 13 22:41:13 2002 EDT Modified files: /phpdoc-pt_BR translation.xml /phpdoc-pt_BR/chapters intro.xml config.xml /phpdoc-pt_BR/language basic-syntax.xml /phpdoc-pt_BR/appendices aliases.xml about.xml Log: small update
Index: phpdoc-pt_BR/translation.xml diff -u phpdoc-pt_BR/translation.xml:1.11 phpdoc-pt_BR/translation.xml:1.12 --- phpdoc-pt_BR/translation.xml:1.11 Sun May 5 14:43:04 2002 +++ phpdoc-pt_BR/translation.xml Mon May 13 22:41:13 2002 @@ -21,5 +21,6 @@ <file name="language/variables.xml" person="cpereira" type="translation" date=""/> <file name="reference/math/reference.xml" person="kappu" type="translation" date="02.02.2002"/> <file name="reference/pgsql/reference.xml" person="phaser" type="translation" date="04.26.2002"/> + <file name="language/*" person="andre_ae" type="review (1 of 9)" +date="05.12.2002"/> </work-in-progress> </translation> Index: phpdoc-pt_BR/chapters/intro.xml diff -u phpdoc-pt_BR/chapters/intro.xml:1.8 phpdoc-pt_BR/chapters/intro.xml:1.9 --- phpdoc-pt_BR/chapters/intro.xml:1.8 Wed May 1 22:14:08 2002 +++ phpdoc-pt_BR/chapters/intro.xml Mon May 13 22:41:13 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.33 Maintainer: andre_ae Status: ready --> +<!-- EN-Revision: 1.34 Maintainer: andre_ae Status: ready --> <chapter id="introduction"> <title>Introdução</title> @@ -100,7 +100,7 @@ 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 + <link linkend="features.commandline">Utilizando o PHP em linha de comando</link> para maiores informações. </simpara> </listitem> Index: phpdoc-pt_BR/chapters/config.xml diff -u phpdoc-pt_BR/chapters/config.xml:1.11 phpdoc-pt_BR/chapters/config.xml:1.12 --- phpdoc-pt_BR/chapters/config.xml:1.11 Tue Apr 30 10:53:05 2002 +++ phpdoc-pt_BR/chapters/config.xml Mon May 13 22:41:13 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.50 Maintainer: afortaleza Status: working --> +<!-- EN-Revision: 1.52 Maintainer: andre_ae Status: ready --> <chapter id="configuration"> <title>Configuração</title> @@ -441,12 +441,36 @@ <listitem> <para> Habilitado (On) por padrão. Se desabilitado (Off) os scripts irão ser finalizados - tão logo quanto ele tentar imprimir algo e descobrir que o usuário cancelou a conexão. + 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.implicit-flush"> + <term> + <parameter>implicit_flush</parameter> + <type>booleano</type> + </term> + <listitem> + <para> + &false; por default. Alterando para &true, diz ao PHP para chamar as + rotinas de impressão/output automaticamente depois de cada comando de saída. + Isto é equivalente a chamar a função + <function>flush</function> depois de cada chamada a + <function>print</function> ,<function>echo</function> ou depois de qualquer +outro + bloco <literal>HTML</literal>. + </para> + <para> + Quanto utilizando o <literal>PHP</literal> em um ambiente Web, ativar + esta opção tem sérias implicações na performance e é geralmente + recomendado para propósitos de debug. Este valor é &true; por + default quando operando sobre a <literal>CLI SAPI</literal>. + </para> + </listitem> + </varlistentry> + <varlistentry id="ini.include-path"> <term> <parameter>include_path</parameter> @@ -622,7 +646,7 @@ (que conteriam a informação do GET). </simpara> <simpara> - Veja também <link linkend="commandline">PHP em linha de comando</link>. + Veja também <link linkend="features.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> Index: phpdoc-pt_BR/language/basic-syntax.xml diff -u phpdoc-pt_BR/language/basic-syntax.xml:1.3 phpdoc-pt_BR/language/basic-syntax.xml:1.4 --- phpdoc-pt_BR/language/basic-syntax.xml:1.3 Wed Dec 12 15:56:34 2001 +++ phpdoc-pt_BR/language/basic-syntax.xml Mon May 13 22:41:13 2002 @@ -1,124 +1,278 @@ <?xml version="1.0" encoding="iso-8859-1"?> - <chapter id="language.basic-syntax"> - <title>Sintaxe básica</title> - - <sect1 id="language.basic-syntax.phpmode"> - <title>Escapes do HTML</title> - - <para> - Há quatro meios de escapes do HTML para entrar no modo "código - PHP":</para> +<!-- EN-Revision: 1.33 Maintainer: andre_ae Status: ready --> + <chapter id="language.basic-syntax"> + <title>Sintaxe básica</title> + + <!-- + + NOTE: Last modified: 2001-05-16 13:00 GMT + + the language part is currently under heavy revision. Please do not + not make any heavy (i.e. structural) modifications to this part + for a moment. + + You'd also better not start any translation yet. + + Comments are always welcome at [EMAIL PROTECTED] + + Progress: + + intro : DOESN'T EXIST - yet? + new chapter, with some introductionary remarks? + Will be discussed on the ML soon. + basic-syntax: + FINISHED + except maybe moving the 'advanced escaping' + to a better place? + TODO: + - nada + types : Being revised. Added all new types + Boolean and Integer are more or less finished. + The rest isn't. + TODO: + - why is $foo[bar] bad syntax? + - what's the difference between unset($bla) and + $bla = NULL; (it is different!) + - $obj->{expr} syntax + - (unset) cast????? + - $bla = unset <== should've been nuked, don't mention it + - $str{offset} syntax, rather than $str[offset] + - read notes and apply when any of them are useful + - remove notes which have been included here. + - ... + the rest: Not yet started with. + TODO: + - ? + oop : has been revised by Kristian, DONE. + --> + + <sect1 id="language.basic-syntax.phpmode"> + <title>Alternado/Escaping do HTML</title> + + <para> + Quando o PHP interpreta um arquivo, ele simplesmente repassa o texto do arquivo + até encontrar uma das tags especiais que lhe diz para + começar a interpretar o texto como código PHP. O interpretador então + executa todo o código que encontra, até chegar em uma tag de + fechamento PHP, que novamente o coloca simplesmente repassando + texto novamente. Este é o mecanismo que permite a inclusão de código + PHP dentro do HTML: qualquer coisa fora das tags PHP é deixado como + encontrado, enquanto tudo dentro é interpretado e executado. + </para> + + <para> + Há quatro conjuntos de tags que podem ser usadas para marcar blocos de + código PHP. Delas, somente duas (<?php. . .?> e <script + language="php">. . .</script>) são sempre disponíveis. As + outras podem ser ativadas ou desativadas a partir do arquivo de configuração + &php.ini;. Enquanto as + formas reduzidas das tags ou no seu estilo ASP serem convenientes, elas não + são portáveis em todas as versões. Além disso, se você pretende incluir + código PHP em XML ou XHTML, você precisará usar a forma + <?php ... ?> para compatibilidade com o padrão XML. + </para> + + <para> + As tags suportadas pelo PHP são: + </para> <para> <example> - <title>Meios de escape do HTML</title> - <programlisting> -1. <? echo ("esta é a mais simples, uma instrução de processamento SGML\n"); ?> - -2. <?php echo("se você quer servir documentos XML, faça assim\n"); ?> - -3. <script language="php"> - echo ("alguns editores (como o FrontPage) não gostam de - instruções de processamento"); - </script> - -4. <% echo ("Você pode, opcionalmente, usar tags com estilo ASP"); %> - <%= $variable; # Este é um atalho para "<%echo .." %> + <title>Maneiras de alternar do HTML</title> + <programlisting role="php"> +<![CDATA[ +1. <?php echo("se você precisa dispor documentos XHTML ou XML, use assim\n"); ?> + +2. <? echo ("este é o mais simples, como uma instrução de processamento SGML\n"); ?> + <?= espressao ?> Uma redução de "<? echo expressao ?>" + +3. <script language="php"> + echo ("alguns editores (como o FrontPage) não + gostam de processas instruções"); + </script> + +4. <% echo ("Você também pode usar tags ASP opcionalmente"); %> + <%= $variavel; # Uma redução para "<% echo ..." %> +]]> </programlisting> - </example></para> - - <para> - O primeiro meio só é disponível se tags curtas foram habilitadas. - Isto pode ser feito através da função <function>short_tags</function>, - habilitando a configuração <link linkend="ini.short-open-tag">short_open_tag</link> - no arquivo de configuração do PHP, ou compilando o PHP com a opção - --enable-short-tags em <command>configure</command>.</para> + </example> + </para> - <para> - O quarto meio só é disponível se tags com estilo ASP foram habilitadas, usando - a configuração <link linkend="ini.asp-tags">asp_tags</link>. + <para> + O primeiro método, <?php. . .?>, é o preferencial, já + que ele permite o uso do PHP em códigos padrão XML como o XHTML. + </para> + + <para> + O segundo método pode não estar sempre disponível. Tags curtas estão disponíveis + apenas quando ativadas. Isto pode ser realizando através da função + <function>short_tags</function> (PHP 3 somente), ativando + a diretiva de configuração <link +linkend="ini.short-open-tag">short_open_tag</link> + no arquivo de configuração do PHP ou compilando o PHP + com a opção --enable-short-tags no + <command>configure</command>. Mesmo que ele esteja configurado por default no + php.ini-dist, o uso de tags curtas é desencorajado. + </para> + + <para> + A quarta maneira só está disponível se a tag estilo ASP for + ativada utilizando a diretiva <link linkend="ini.asp-tags">asp_tags</link> + no arquivo de configuração. <note> - <para>O suporte para tags com estilo ASP foram acrescentadas em 3.0.4.</para> - </note></para> + <para>O suporte as tags estilo APS foi incorporada na versão 3.0.4.</para> + </note> + </para> + <note> <para> - A tag de fechamento para o bloco incluirá a nova linha imediatamente - seguinte, se uma estiver presente.</para></sect1> - - <sect1 id="language.basic-syntax.instruction-separation"> - <title>Separação de instrução</title> - - <simpara> - Instruções são separadas da mesma forma que em C ou perl - terminando - cada comando com um ponto-e-vírgula.</simpara> + A utilização das tags curtas deve ser evitada quando do desenvolvimento de +aplicações + ou bibliotecas com intenção de redistribuição ou no desenvolvimento de + serviços em PHP que não ficarão sob seu controle, uma vez que as tags curtas + podem não estar disponíveis no servidor de instalação. Para portabilidade + de código para distribuição, tenha certeza de não usar tags curtas. + </para> + </note> + + <para> + A tag de fechamento incluirá uma linha nova linha em branco + automaticamente se uma não estiver presente. Além, a tag de fechamento + automaticamente implica num ponto e vírgula: você não precisa ter um + ponto e vírgula no fim da última linha de código PHP. + </para> <para> - A tag de fechamento (?>) também implica no fim do comando, de forma que - os seguintes itens são equivalentes: - - <informalexample> - <programlisting> -<?php - echo "Este é um teste"; + O PHP também suporta a utilização de estruturas como essa: + <example><title>Alternagem avançada</title> + <programlisting role="php"> +<![CDATA[ +<?php +if ($expression) { + ?> + <strong>Isso é verdadeiro.</strong> + <?php +} else { + ?> + <strong>Isto é falso.</strong> + <?php +} +?> +]]> + </programlisting> + </example> + Isso funciona como esperado porque quando o PHP encontra a tag de fechamento + ?>, ele simplesmente começa a imprimir tudo até encontrar + outra tag de abertura. Obviamente, o exemplo acima se aplica + a exibição de grandes blocos de texto, uma vez que sair do + modo de interpretação do PHP é geralmente mais eficiente que + imprimir todo o texto através de funções como <function>echo</function>, + <function>print</function> e outras. + </para> + </sect1> + + <sect1 id="language.basic-syntax.instruction-separation"> + <title>Separador de instruções</title> + + <simpara> + Instruções são separadas da mesma forma que o C ou o Perl - cada + instrução termina com um ponto e vírgula.</simpara> + + <para> + A tag de fechamento (?>) também implica no fim de uma instrução, então + os exemplos seguintes são equivalentes: + + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + echo "Isto é um teste"; ?> -<?php echo "Este é um teste" ?> - </programlisting> - </informalexample></para></sect1> - - <sect1 id="language.basic-syntax.comments"> - <title>Comentários</title> - - <para> - O PHP suporta comentários com os estilos 'C', 'C++' e shell do Unix. Por exemplo: - - <informalexample><programlisting> -<?php - echo "Este é um teste"; // Esta linha é um comentário de uma linha com estilo c++ - /* Este é um comentário de múltiplas linhas - ainda outra linha de comentário */ - echo "Este é ainda outro teste"; - echo "Um Teste Final"; # Este é um comentário com estilo shell +<?php echo "Isto é um outro teste" ?> +]]> + </programlisting> + </informalexample> + </para> + </sect1> + + <sect1 id="language.basic-syntax.comments"> + <title>Comentários</title> + + <para> + O PHP suporta comentários do 'C', 'C++' e Unix shell. Por exemplo + + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + echo "Isto é um teste"; //Comentário de uma linha no C++ + /* Isto é um comentário de mais de uma linha + e aqui temos outra linha */ + echo "Isto é um outro teste"; + echo "O último teste"; #Comentário no estilo Unix shell ?> +]]> </programlisting> - </informalexample></para> + </informalexample> + </para> - <simpara> - Os estilos de comentário de uma linha só funcionam até o fim da linha ou o fim - do bloco de código PHP corrente, o que vier primeiro.</simpara> - <informalexample><programlisting> -<h1>Este é um exemplo <?# echo "simples";?>.</h1> -<p>O cabeçalho acima dirá 'Este é um exemplo'. -</programlisting></informalexample> - - <simpara> - Você deve ter o cuidado de não aninhar comentários com estilo 'C', o que pode - acontecer quando se comenta grandes blocos.</simpara> - - <informalexample><programlisting> -<?php - /* - echo "Este é um teste"; /* Este comentário causará um problema */ + <simpara> + Os comentário de uma linha só tem efeito até o fim da + linha ou fim do bloco de código PHP atual, o que ocorrer + primeiro. + </simpara> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<h1>Isto é um <?php # echo " simples";?> exemplo.</h1> +<p>No título acima você lerá 'Isto é um exemplo'. +]]> + </programlisting> + </informalexample> + + <simpara> + Você precisa ser cuidadoso com comentários estilo 'C' encadeados, pois + eles podem causar problemas em grandes blocos. + </simpara> + + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php + /* + echo "Isto é um teste"; /* Este comentário causará um erro */ */ ?> - </programlisting></informalexample></sect1> - </chapter> - - <!-- Keep this comment at the end of the file - Local variables: - mode: sgml - sgml-omittag:t - sgml-shorttag:t - sgml-minimize-attributes:nil - sgml-always-quote-attributes:t - sgml-indent-step:1 - sgml-indent-data:t +]]> + </programlisting> + </informalexample> + + <simpara> + Os comentários de uma linha somente agem até o fim da linha + atual ou o fim do bloco de código PHP, o que ocorrer primeiro. + Isto significa que código HTML após <literal>// ?></literal> SERÁ impresso: ?> +continuará + desligando o modo PHP, retornando para o modo HTML, e o // não pode influenciar +isso. + </simpara> + </sect1> + </chapter> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t indent-tabs-mode:nil - sgml-parent-document:nil - sgml-default-dtd-file:"../manual.ced" - sgml-exposed-tags:nil - sgml-local-catalogs:nil - sgml-local-ecat-files:nil - End: - --> +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +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 +--> Index: phpdoc-pt_BR/appendices/aliases.xml diff -u phpdoc-pt_BR/appendices/aliases.xml:1.5 phpdoc-pt_BR/appendices/aliases.xml:1.6 --- phpdoc-pt_BR/appendices/aliases.xml:1.5 Tue Apr 30 10:53:05 2002 +++ phpdoc-pt_BR/appendices/aliases.xml Mon May 13 22:41:13 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.17 Maintainer: rarruda Status: ready --> +<!-- EN-Revision: 1.18 Maintainer: rarruda Status: ready --> <appendix id="aliases"> <title>Lista de funções sinônimas (aliases)</title> <para> @@ -29,6 +29,11 @@ </row> </thead> <tbody> +<row> + <entry>_</entry> + <entry><function>gettext</function></entry> + <entry><link linkend="ref.gettext">Gettext</link></entry> +</row> <row> <entry>add</entry> <entry><function>swfmovie_add</function></entry> Index: phpdoc-pt_BR/appendices/about.xml diff -u phpdoc-pt_BR/appendices/about.xml:1.4 phpdoc-pt_BR/appendices/about.xml:1.5 --- phpdoc-pt_BR/appendices/about.xml:1.4 Wed May 1 22:54:26 2002 +++ phpdoc-pt_BR/appendices/about.xml Mon May 13 22:41:13 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.12 Maintainer: andre_ae Status: ready --> +<!-- EN-Revision: 1.13 Maintainer: andre_ae Status: ready --> <!-- TODO: add manual conventions section (eg. how to read