 |
 |
 |
 |
|
|
Date: 08/02/00
- Next message: Daniel Beckham: "[PHP-DOC] Errata notes... the end of the world is nigh"
- Previous message: Ricardo: "Re: [PHP-DOC] pt_BR translation"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
soneca Wed Aug 2 06:15:53 2000 EDT
Added files:
/phpdoc/pt_BR/functions apache.xml
/phpdoc/pt_BR/language basic-syntax.xml constants.xml
Log:
Updated pt_BR translations.
Index: phpdoc/pt_BR/functions/apache.xml
+++ phpdoc/pt_BR/functions/apache.xml
<reference id="ref.apache">
<title>Funções específicas para Apache</title>
<titleabbrev>Apache</titleabbrev>
<refentry id="function.apache-lookup-uri">
<refnamediv>
<refname>apache_lookup_uri</refname>
<refpurpose>
Realiza uma requisição parcial para a URI especificada e retorna todas
as informações sobre ela
</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<funcsynopsis>
<funcprototype>
<funcdef>class <function>apache_lookup_uri</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Isto realiza uma requisição parcial para uma URI. Trabalha o suficiente para
obter todas as informações importantes sobre o recurso dado e retorna esta
informação em uma classe. As propriedades da classe retornada
são:
<simplelist>
<member>status</member>
<member>the_request</member>
<member>status_line</member>
<member>method</member>
<member>content_type</member>
<member>handler</member>
<member>uri</member>
<member>filename</member>
<member>path_info</member>
<member>args</member>
<member>boundary</member>
<member>no_cache</member>
<member>no_local_copy</member>
<member>allowed</member>
<member>send_bodyct</member>
<member>bytes_sent</member>
<member>byterange</member>
<member>clength</member>
<member>unparsed_uri</member>
<member>mtime</member>
<member>request_time</member>
</simplelist>
</para>
<note>
<simpara>
<function>Apache_lookup_uri</function> somente funciona quando o PHP
está instalado como um módulo do Apache.
</simpara>
</note>
</refsect1>
</refentry>
<refentry id="function.apache-note">
<refnamediv>
<refname>apache_note</refname>
<refpurpose>Obtém e seta notas de requisição</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>apache_note</function></funcdef>
<paramdef>string <parameter>note_name</parameter></paramdef>
<paramdef>string
<parameter>
<optional>note_value</optional>
</parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>Apache_note</function> é uma função específica do Apache que
obtém e seta valores em uma tabela de
<literal>notas</literal> de requisição. Se for chamada com um argumento, ela
retorna o valor corrente da nota
<literal>note_name</literal>. Se for chamada com dois argumentos, ela
seta o valor da nota <literal>note_name</literal> para
<literal>note_value</literal> e retorna o valor anterior da nota
<literal>note_name</literal>.
</para>
</refsect1>
</refentry>
<refentry id="function.getallheaders">
<refnamediv>
<refname>getallheaders</refname>
<refpurpose>Busca todas os cabeçalhos de requisições HTTP</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<funcsynopsis>
<funcprototype>
<funcdef>array <function>getallheaders</function></funcdef>
<paramdef>void<parameter></parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Esta função retorna uma matriz associativa de todos os cabeçalhos HTTP
na requisição corrente.
</para>
<para>
<note>
<para>
Você também pode obter isso no valor das variáveis comuns do CGI, lendo-os
a partir do ambiente, que funciona se você estiver ou não usando
o PHP como um módulo Apache. Use
<function>phpinfo</function> para ver uma lista de todas as variáveis
de ambiente definidas desta forma.
</para>
</note>
</para>
<para>
<example>
<title>Exemplo de <function>getallheaders</function></title>
<programlisting role="php">
$headers = getallheaders();
while (list ($header, $value) = each ($headers)) {
echo "$header: $value<br>\n";
}
</programlisting>
</example>
</para>
<para>
Este exemplo mostrará todos os cabeçalhos de requisição da requisição corrente.
<note>
<simpara>
<function>Getallheaders</function> só é suportada atualmente
quando o PHP roda como um módulo do <productname>Apache</productname>.
</simpara>
</note>
</para>
</refsect1>
</refentry>
<refentry id="function.virtual">
<refnamediv>
<refname>virtual</refname>
<refpurpose>Realiza uma sub-requisição no Apache</refpurpose>
</refnamediv>
<refsect1>
<title>Descrição</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>virtual</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>Virtual</function> é uma função específica do Apache que
é equivalente a <!--#include virtual...--> em mod_include.
Ela realiza uma sub-requisição do Apache sub-request. Ela é útil para incluir
scripts de CGI ou arquivos .shtml, ou qualquer outra coisa que você possa analisar
através do Apache. Note que para um script CGI, o script precisa gerar um cabeçalho
CGI válido. Isto significa que, no mínimo, ele precisa
gerar um cabeçalho Content-type. Para arquivos PHP, você precisa usar
<function>include</function> ou <function>require</function>;
<function>virtual</function> não pode ser usado para incluir um documento
que é um arquivo PHP.
</para>
</refsect1>
</refentry>
</reference>
<!-- 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
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/pt_BR/language/basic-syntax.xml
+++ phpdoc/pt_BR/language/basic-syntax.xml
<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>
<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 .." %>
</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>
<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>.
<note>
<para>O suporte para tags com estilo ASP foram acrescentadas em 3.0.4.</para>
</note></para>
<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>
<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";
?>
<?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
?>
</programlisting>
</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 */
*/
?>
</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
sgml-parent-document:nil
sgml-default-dtd-file:"../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
Index: phpdoc/pt_BR/language/constants.xml
+++ phpdoc/pt_BR/language/constants.xml
<chapter id="language.constants">
<title>Constantes</title>
<simpara>
O PHP define várias constantes e fornece um mecanismo para definir outras mais
em tempo de execução. Constantes são bem parecidos com variáveis, exceto pelos fatos
de que constantes precisam ser definidas usando a função
<function>define</function>, e que elas não podem ser redefinidas para outro valor,
mais tarde.
</simpara>
<para>
As constantes pré-definidas (sempre disponíveis) são:
<variablelist>
<varlistentry>
<term>__FILE__</term>
<listitem>
<simpara>
O nome do arquivo de script que está sendo analisado atualmente. Se for usado
dentro de um arquivo que foi incluído ou requerido, então o nome do arquivo
incluído é dado, e não o nome do arquivo pai.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>__LINE__</term>
<listitem>
<simpara>
O número da linha dentro do arquivo de script corrente que está sendo analisado.
Se for usado dentro de um arquivo que foi incluído ou requerido, então é dada a posição
dentro do arquivo de inclusão.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>PHP_VERSION</term>
<listitem>
<simpara>
A representação de string da versão do analisador PHP atualmente em uso;
por exemplo '3.0.8-dev'.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>PHP_OS</term>
<listitem>
<simpara>
O nome do sistema operacional no qual o analisador PHP está sendo executado;
por exemplo 'Linux'.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>TRUE</term>
<listitem>
<simpara>
Um valor verdadeiro.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>FALSE</term>
<listitem>
<simpara>
Um valor falso.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>E_ERROR</term>
<listitem>
<simpara>
Denota um erro diferente de um erro de análise, no qual a recuperação não é
possível.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>E_WARNING</term>
<listitem>
<simpara>
Denota uma condição onde o PHP sabe que algo está errado, mas seguirá assim
mesmo; isto pode ser percebido pelo próprio script. Um exemplo seria
uma expressão regular inválida em <function>ereg</function>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>E_PARSE</term>
<listitem>
<simpara>
O analisador verificou uma sintaxe inválida no arquivo de script.
A recuperação não é possível.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>E_NOTICE</term>
<listitem>
<simpara>
Aconteceu algo que pode ou não ser um erro. A execução continua. Os exemplos
incluem o uso de uma string sem aspas como índice de 'hashing', ou o acesso
a uma variável que não foi setada.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>E_NOTICE</term>
<listitem>
<simpara>
Aconteceu algo que pode ou não ser um erro. A execução continua. Os exemplos
incluem o uso de uma string sem aspas como índice de 'hashing', ou o acesso
a uma variável que não foi setada.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>E_ALL</term>
<listitem>
<simpara>
Todas as constantes E_* reunidas em uma. Se for usado com
<function>error_reporting</function>, fará com que todo e qualquer
problema notificado pelo PHP seja relatado.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
As constantes E_* são usadas tipicamente com a função
<function>error_reporting</function> para configurar o nível de
reportagem de erros.</para>
<para>
Você pode definir constantes adicionais usando a função <function>define</function>.</para>
<para>
Note que estas são constantes, e não macros com estilo C; somente
dados escalares válidos podem ser representados por uma constante.
<example>
<title>Definindo Constantes</title>
<programlisting>
<?php
define("CONSTANT", "Alô mundo.");
echo CONSTANT; // imprime "Alô mundo."
?>
</programlisting>
</example>
<example>
<title>Usando __FILE__ e __LINE__</title>
<programlisting>
<?php
function report_error($file, $line, $message) {
echo "Ocorreu um erro em $file na linha $line: $message.";
}
report_error(__FILE__,__LINE__, "Algo deu errado!");
?>
</programlisting>
</example></para>
</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
sgml-parent-document:nil
sgml-default-dtd-file:"../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
- Next message: Daniel Beckham: "[PHP-DOC] Errata notes... the end of the world is nigh"
- Previous message: Ricardo: "Re: [PHP-DOC] pt_BR translation"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]