fix and improve translation

This commit is contained in:
Leonardo Lara Rodrigues
2025-06-04 10:43:47 -03:00
parent aa7e0b150d
commit 0daf9218ca
54 changed files with 212 additions and 212 deletions

View File

@@ -33,8 +33,8 @@
Existem diversos formatos offline do manual, e o formato mais adequado
depende do sistema operacional e do
estilo de leitura pessoal. Para informações de como o manual é gerado em tantos
formatos, veja a seção <link linkend="about.generate">'Como nós geramos os
formatos'</link> deste apêndice.
formatos, veja a seção <link linkend="about.generate">Como os
formatos são gerados</link> deste apêndice.
</para>
<para>
A versão HTML é o formato mais multi-plataforma deste manual. Esta versão
@@ -380,29 +380,29 @@ Retorna o tamanho da string dada.
</sect1>
<sect1 xml:id="about.generate">
<title>Como nós geramos os formatos</title>
<title>Como os formatos são gerados</title>
<para>
Este Manual é escrito em <acronym>XML</acronym> usando o <link
xlink:href="&url.docbook.xml;">DocBook XML DTD</link>, usando <link
Este manual é escrito em <acronym>XML</acronym> usando o <link
xlink:href="&url.docbook.xml;">DocBook XML DTD</link> e o <link
xlink:href="&url.phd;"><acronym>PhD</acronym></link> (The [PH]P based
[D]ocBook renderer) para manutenção e formatação.
</para>
<para>
Usar <acronym>XML</acronym> como formato fonte nos
Usar <acronym>XML</acronym>
a capacidade de gerar diversos formatos de saída a partir
dos arquivos fonte, enquanto apenas um documento fonte é mantido para todos os formatos.
A ferramenta usada para formatar o manual online é <link
A ferramenta usada para formatar o manual online é o <link
xlink:href="&url.phd;">PhD</link>.
Usamos <link xlink:href="&url.winhelp;">Microsoft HTML Help
Workshop</link> para gerar o formato <productname>Windows HTML Help</productname>
do manual e, é claro, o próprio PHP
O <link xlink:href="&url.winhelp;">Microsoft HTML Help
Workshop</link> é usado para gerar o formato <productname>Windows HTML Help</productname>
do manual e, é claro, o próprio PHP é usado
para fazer algumas conversões e formatações.
</para>
<para>
O manual PHP é gerado em vários idiomas e formatos, veja
O manual do PHP é gerado em vários idiomas e formatos, veja
<link xlink:href="&url.php.docs;">&url.php.docs;</link> para maiores detalhes.
O código fonte <acronym>XML</acronym> pode ser baixado do Git e
visualizado em <link xlink:href="&url.php.git.mirror;doc-en">&url.php.git.mirror;doc-en</link>.
visualizado em <link xlink:href="&url.php.git.mirror;doc-en">&url.php.git.mirror;doc-en</link> (ou doc-pt_br para o manual em português do Brasil).
</para>
</sect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 6d46a5549bcb66444ce7a3b34301420ba7552bc8 Maintainer: ae Status: ready --><!-- CREDITS: felipe,rarruda,ae,pasf,fibbarth,adiel,lhsazevedo -->
<appendix xml:id="aliases" xmlns="http://docbook.org/ns/docbook">
<title>Lista de funções sinônimas (aliases)</title>
<title>Lista de funções sinônimas</title>
<para>
Existem algumas poucas funções no PHP que podem ser chamadas com mais de um
nome. Em alguns casos, não existe preferência entres os nomes,
@@ -20,7 +20,7 @@
<tgroup cols="3">
<thead>
<row>
<entry>Nome da função sinônima (alias)</entry>
<entry>Nome da função sinônima</entry>
<entry>Nome da função canônica</entry>
<entry>Extensão usada</entry>
</row>

View File

@@ -528,7 +528,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
</term>
<listitem>
<para>
Duração do tempo (em segundos) pela qual armazenar em cache as informações do realpath
Duração do tempo (em segundos) em que as informações do realpath deve ser armazenadas em cache
para um dado arquivo ou diretório. Para sistemas com arquivos que raramente mudam,
considere aumentar o valor.
</para>

View File

@@ -203,7 +203,7 @@ echo ANIMALS[1]; // imprime "cat"
</sect2>
<sect2 xml:id="migration70.new-features.anonymous-classes">
<title>Classes anônimas</title>
<title>Classes Anônimas</title>
<para>
O suporte a classes anônimas foi adicionado utilizando <literal>new

View File

@@ -287,7 +287,7 @@ foo(...gen());
</sect2>
<sect2 xml:id="migration73.incompatible.spl">
<title>Standard PHP Library (SPL)</title>
<title>Biblioteca Padrão PHP (SPL)</title>
<para>
Se um autoloader <link linkend="book.spl">SPL</link> lançar uma exceção,

View File

@@ -258,7 +258,7 @@
</sect2>
<sect2 xml:id="migration74.incompatible.spl">
<title>Standard PHP Library (SPL)</title>
<title>Biblioteca Padrão PHP (SPL)</title>
<para>
Chamar <function>get_object_vars</function> em uma instância de <classname>ArrayObject</classname>

View File

@@ -31,10 +31,10 @@ class User {
</sect3>
<sect3 xml:id="migration74.new-features.core.arrow-functions">
<title>Arrow functions</title>
<title>Funções de Seta</title>
<para>
<link linkend="functions.arrow">Arrow functions</link> fornecem uma
<link linkend="functions.arrow">Funções de seta</link> fornecem uma
sintaxe abreviada para definir funções
com ligação implícita por valor de escopo.

View File

@@ -61,7 +61,7 @@
</sect2>
<sect2 xml:id="migration74.new-functions.pcntl">
<title>Process Control</title>
<title>Controle de Processos</title>
<itemizedlist>
<listitem>

View File

@@ -161,8 +161,8 @@ class Test {
<programlisting role="php">
<![CDATA[
<?php
$fn = fn() => throw new Exception('Exception in arrow function');
$user = $session->user ?? throw new Exception('Must have user');
$fn = fn() => throw new Exception('Exceção na função de seta');
$user = $session->user ?? throw new Exception('É necessário haver um usuário.');
]]>
</programlisting>
<!-- RFC: https://wiki.php.net/rfc/throw_expression -->

View File

@@ -87,10 +87,10 @@ $arr2 = [...$arr1, 'c' => 'd']; //[1, 'a' => 'b', 'c' => 'd']
</sect3>
<sect3 xml:id="migration81.new-features.core.callable-syntax">
<title>Sintaxe de Callable de Primeira Classe</title>
<title>Sintaxe de Chamáveis de Primeira Classe</title>
<para>
Closures para callables agora podem ser criadas usando <link linkend="functions.first_class_callable_syntax">a sintaxe <code>myFunc(...)</code></link>,
Closures para chamáveis agora podem ser criadas usando <link linkend="functions.first_class_callable_syntax">a sintaxe <code>myFunc(...)</code></link>,
que é idêntica a <code>Closure::fromCallable('myFunc')</code>.
<!-- RFC: https://wiki.php.net/rfc/first_class_callable_syntax -->
</para>

View File

@@ -132,7 +132,7 @@
</sect3>
<sect3 xml:id="migration83.other-changes.functions.calendar">
<title>Calendar</title>
<title>Calendário</title>
<para>
A função <function>easter_date</function> agora suporta anos de 1970 a

View File

@@ -12,7 +12,7 @@
</para>
<sect1 xml:id="reserved.keywords">
<title>Lista de Palavras-chave (Keywords)</title>
<title>Lista de Palavras-chave</title>
<simpara>
Estas palavras têm um significado especial no PHP. Algumas delas representam coisas
que parecem funções, algumas parecem constantes, e assim por diante - mas

View File

@@ -62,7 +62,7 @@ PHP por vários critérios.</para>'>
<!-- ======================================================================= -->
<!ENTITY extcat.membership '<title xmlns="http://docbook.org/ns/docbook">Sociedade</title>'>
<!ENTITY extcat.membership '<title xmlns="http://docbook.org/ns/docbook">Classificadas por Pertencimento</title>'>
<!ENTITY extcat.membership.core '<title xmlns="http://docbook.org/ns/docbook">Extensões Principais</title><para xmlns="http://docbook.org/ns/docbook">Essas
não são de fato extensões. Eles são parte do núcleo do PHP e não podem ser
@@ -76,14 +76,14 @@ compilar essas extensões é preciso ter bibliotecas externas.</para>'>
<!ENTITY extcat.membership.pecl '<title xmlns="http://docbook.org/ns/docbook">Extensões
PECL</title>
<para xmlns="http://docbook.org/ns/docbook">Essas extensões estão disponíveis em
<para xmlns="http://docbook.org/ns/docbook">Essas extensões estão disponíveis no
&link.pecl;. Elas podem requerer bibliotecas externas. Existem outras extensões PECL mas
elas não estão documentadas no manual do PHP.</para>'>
<!-- ======================================================================= -->
<!ENTITY extcat.state '<title xmlns="http://docbook.org/ns/docbook">Estado</title><para xmlns="http://docbook.org/ns/docbook">Essa parte lista as extensões
não destinadas para uso de produção - elas são ou muito velhas (descontinuadas) ou
<!ENTITY extcat.state '<title xmlns="http://docbook.org/ns/docbook">Classificadas por status de desenvolvimento</title><para xmlns="http://docbook.org/ns/docbook">Essa parte lista as extensões
não destinadas para uso em produção - elas são ou muito antigas (descontinuadas) ou
muito novas (experimentais).</para>'>
<!ENTITY extcat.state.deprecated '<title xmlns="http://docbook.org/ns/docbook">Extensões Descontinuadas</title><para xmlns="http://docbook.org/ns/docbook">Essas
@@ -91,6 +91,6 @@ extensões tornaram-se descontinuadas normalmente em favor de outras extensões.
<!ENTITY extcat.state.experimental '<title xmlns="http://docbook.org/ns/docbook">Extensões Experimentais</title><para xmlns="http://docbook.org/ns/docbook">O
comportamento dessas extensões - incluindo os nomes das suas funções e qualquer
outra coisa documentada sobre essas extensões - podem mudar sem aviso em versões futuras
outra coisa documentada sobre essas extensões - pode mudar sem aviso em versões futuras
do PHP. Use essas funções a seu próprio risco.</para>'>

View File

@@ -4,7 +4,7 @@
<refentry xml:id="context.zip" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_context_option">
<refnamediv>
<refname>Opções de contexto para Zip</refname>
<refpurpose>Listagem de opções de contexto para Zip</refpurpose>
<refpurpose>Lista de opções de contexto de Zip</refpurpose>
</refnamediv>
<refsect1 role="description"><!-- {{{ -->

View File

@@ -4,7 +4,7 @@
<refentry xml:id="context.zlib" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_context_option">
<refnamediv>
<refname>Opções de contexto Zlib</refname>
<refpurpose>Listagem de opções de contexto Zlib</refpurpose>
<refpurpose>Lista de opções de contexto de Zlib</refpurpose>
</refnamediv>
<refsect1 role="description">

View File

@@ -12,24 +12,24 @@
</para>
<para>
Enums aparecem em muitas linguagens com uma variedade de recursos diferentes. No PHP,
Enums são um tipo especial de objeto. A Enum em si é uma classe, e seus possíveis
casos são todos objetos de instância única dessa classe. Isso significa que casos Enum são
Enumerações aparecem em muitas linguagens com uma variedade de recursos diferentes. No PHP,
Enumerações são um tipo especial de objeto. A enumeração em si é uma classe, e seus possíveis
casos são todos objetos de instância única dessa classe. Isso significa que casos de enumeração são
objetos válidos e podem ser usados em qualquer lugar em que um objeto pode ser usado, incluindo verificações de tipo.
</para>
<para>
O exemplo mais popular de enumerações é o tipo embutido booleano, que é um
tipo enumerado com valores válidos &true; e &false;.
Enums permitem que os desenvolvedores definam suas próprias enumerações robustas.
Enumerações permitem que os desenvolvedores definam suas próprias enumerações robustas.
</para>
</sect1>
<sect1 xml:id="language.enumerations.basics">
<title>Enumerações básicas</title>
<title>Enumerações Básicas</title>
<para>
Enums são similares às classes, e compartilham o mesmo namespaces que as classes, interfaces, e traits.
Elas também podem ser carregadas automaticamente da mesma maneira. Uma Enum define um novo tipo, que possui um número fixo
Enumerações são similares às classes e compartilham o mesmo namespaces que classes, interfaces, e traits.
Elas também podem ser carregadas automaticamente da mesma maneira. Uma Enumeração define um novo tipo, que possui um número fixo
e limitado de valores legais possíveis.
</para>
@@ -82,7 +82,7 @@ pegar_uma_carta('Espadas');
<para>
Uma enumeração pode ter zero ou mais definições <literal>case</literal>, sem limite máximo.
Uma enum sem nenhum caso é sintaticamente válida, embora inútil.
Uma enumeração sem nenhum caso é sintaticamente válida, embora inútil.
</para>
<para>
@@ -110,18 +110,18 @@ $a instanceof Naipe; // true
</programlisting>
<para>
Isso também significa que os valores enum nunca são <literal>&lt;</literal> ou <literal>&gt;</literal> do que o outro,
Isso também significa que os valores de enumeração nunca são <literal>&lt;</literal> ou <literal>&gt;</literal> do que o outro,
uma vez que essas comparações não fazem sentido em objetos. Essas comparações sempre retornarão
&false; ao trabalhar com valores enum.
&false; ao trabalhar com valores de enumeração.
</para>
<para>
Esse tipo de caso, sem dados relacionados, é chamado de "Caso Puro". Uma Enum que contém
apenas Casos Puros é chamada de Pure Enum (enum pura).
Esse tipo de caso, sem dados relacionados, é chamado de "Caso Puro". Uma enumeração que contém
apenas Casos Puros é chamada de Enumeração Pura.
</para>
<para>
Todos os Casos Puros são implementados como instâncias de seus tipos enum. O tipo enum é representado internamente como uma classe.
Todos os Casos Puros são implementados como instâncias de seus tipos 'enum'. O tipo 'enum' é representado internamente como uma classe.
</para>
<para>
@@ -141,15 +141,15 @@ print Naipe::Espadas->name;
<para>
É possível também utilizar as funções <function>defined</function> e <function>constant</function>
para verificar a existência ou ler um item de enum se o nome for obtido dinamicamente.
Isto é desencorajado, já que utilizar <link linkend="language.enumerations.backed">Backed enums</link>
para verificar a existência ou ler um item de enumeração se o nome for obtido dinamicamente.
Isto é desencorajado, já que utilizar <link linkend="language.enumerations.backed">Enumerações Apoiadas</link>
funciona para a maioria dos casos.
</para>
</sect1>
<sect1 xml:id="language.enumerations.backed">
<title>Backed enums</title>
<title>Enumerações Apoiadas</title>
<para>
Por padrão, os Casos não possuem um equivalente escalar. Eles são apenas objetos singleton. No entanto,
@@ -176,19 +176,19 @@ enum Naipe: string
</programlisting>
<para>
Um caso que possui um equivalente escalar é chamado de Backed Case, sendo "Backed" no sentido de lastreado, suportado,
por um valor mais simples. Uma Enum que possui todos Casos Lastreados é chamada Backed Enum.
Uma Backed Enum pode conter apenas Backed Case. Uma Enum Pura pode conter apenas Casos Puros.
Um caso que possui um equivalente escalar é chamado de Caso Apoiado, sendo "Apoiado" no sentido de lastreado, suportado,
por um valor mais simples. Uma enumeração que possui todos Casos Apoiados é chamada Enumeração Apoiada.
Uma Enumeração Apoiada pode conter apenas Casos Apoiados. Uma Enumeração Pura pode conter apenas Casos Puros.
</para>
<para>
Uma Backed Enum pode associar valores de tipos <literal>int</literal> ou <literal>string</literal>,
Uma Enumeração Apoiada pode associar valores de tipos <literal>int</literal> ou <literal>string</literal>,
e uma determinada enumeração suporta apenas um único tipo de cada vez (isto é, sem união de <literal>int|string</literal>).
Se uma enumeração for marcada como tendo um equivalente escalar, então todos os casos devem possuir um escalar equivalente
único definido explicitamente. Não existem equivalentes escalares gerados automaticamente
(p. ex.: inteiros sequenciais). Casos lastreados devem ser únicos; dois casos enum lastreados não podem
(p. ex.: inteiros sequenciais). Casos apoiados devem ser únicos; dois casos apoiados não podem
ter o mesmo equivalente escalar. No entanto, uma constante pode se referir a um caso, efetivamente
criando um apelido. Veja <link linkend="language.enumerations.constants">Constantes de enumeração</link>.
criando um apelido. Veja as <link linkend="language.enumerations.constants">constantes de enumeração</link>.
</para>
<para>
@@ -200,7 +200,7 @@ enum Naipe: string
</para>
<para>
Backed Cases possuem uma propriedade somente leitura adicional, <literal>value</literal>, que é o valor
Casos Apoiados possuem uma propriedade somente leitura adicional, <literal>value</literal>, que é o valor
especificado na definição.
</para>
@@ -231,20 +231,20 @@ $ref = &$naipe->value;
</programlisting>
<para>
Backed Enums implementam uma interface interna <interfacename>BackedEnum</interfacename>,
Enumerações Apoiadas implementam uma interface interna <interfacename>BackedEnum</interfacename>,
que expõe dois métodos adicionais:
</para>
<simplelist>
<member>
<literal>from(int|string): self</literal> recebe uma escalar e retornará o Caso Enum
correspondente. Se um não for encontrado, ela lançará um <classname>ValueError</classname>. Isso é útil
principalmente nas situações somente valores previstos são permitidos e um valor enum ausente deve ser
<literal>from(int|string): self</literal> recebe um escalar e retornará o caso
correspondente da enumeração. Se não for encontrado, ela lançará um <classname>ValueError</classname>. Isso é útil
principalmente nas situações somente valores previstos são permitidos e um valor de enumeração ausente deve ser
considerado um erro de interrupção de aplicação.
</member>
<member>
<literal>tryFrom(int|string): ?self</literal> recebe uma escalar e retornará o
Caso Enum correspondente. Se um não for encontrado, ela retornará <literal>null</literal>.
caso de enumeração correspondente. Se um não for encontrado, ela retornará <literal>null</literal>.
Isso é útil principalmente em casos onde o escalar de entrada não é confiável e o chamador quer
implementar sua própria lógica de manipulação de erros ou de valor padrão.
</member>
@@ -255,7 +255,7 @@ $ref = &$naipe->value;
padrão de tipagem fraca/forte. No modo de tipagem fraca, passar um inteiro ou string é aceitável
e o sistema irá coagir o valor de acordo. Passar um float também irá funcionar e será
convertido. No modo de tipagem estrita, passar um inteiro para <literal>from()</literal> em uma
enum associada a strings (ou vice-versa) irá resultar em um <classname>TypeError</classname>,
enumeração associada a strings (ou vice-versa) irá resultar em um <classname>TypeError</classname>,
assim como um float irá lançar um erro em todas as circunstâncias. Todos os outros tipos de parâmetro lançarão um TypeError
em ambos os modos.
</para>
@@ -278,7 +278,7 @@ print $naipe->value;
]]>
</programlisting>
<para>Definir manualmente um método <literal>from()</literal> ou <literal>tryFrom()</literal> em uma Backed Enum irá resultar em um erro fatal.</para>
<para>Definir manualmente um método <literal>from()</literal> ou <literal>tryFrom()</literal> em uma Enumeração Apoiada irá resultar em um erro fatal.</para>
</sect1>
@@ -286,9 +286,9 @@ print $naipe->value;
<title>Métodos de enumerações</title>
<para>
Enums (tanto Puras quanto Backed) podem conter métodos, e podem implementar interfaces.
Se uma Enum implementa uma interface, então qualquer verificação de tipo para aquela interface também aceitará
todos os casos daquela Enum.
Enumerações (tanto Puras quanto Apoiadas) podem conter métodos e podem implementar interfaces.
Se uma enumeração implementa uma interface, qualquer verificação de tipo para aquela interface também aceitará
todos os casos daquela enumeração.
</para>
<programlisting role="php">
@@ -342,7 +342,7 @@ print Naipe::Ouros->shape(); // imprime "Retângulo"
</para>
<para>
Em uma Backed Enum, a declaração de interface vai após a declaração do tipo de lastro.
Em uma Enumeração Apoiada, a declaração de interface vai após a declaração do tipo de lastro.
</para>
<programlisting role="php">
@@ -386,7 +386,7 @@ enum Naipe: string implements Colorido
<para>
Note que nesse caso, uma prática melhor de modelagem de dados seria definir também um
Tipo Enum <literal>CorDeNaipe</literal> com valores Preto e Vermelho e retornar isso no seu lugar.
Tipo 'enum' <literal>CorDeNaipe</literal> com valores Preto e Vermelho e retornar isso no seu lugar.
No entanto, isso complicaria esse exemplo.
</para>
@@ -428,7 +428,7 @@ final class Naipe implements UnitEnum, Colorido
public static function cases(): array
{
// Método ilegal, porque definir manualmente um método cases() em uma Enum não é permitido.
// Método ilegal, porque definir manualmente um método cases() em uma enumeração não é permitido.
// Veja também a seção "Listagem de valores".
}
}
@@ -489,7 +489,7 @@ enum Tamanho
apesar das privadas e protegidas são equivalentes na prática, pois herança não é permitida.
</para>
<para>Uma constante de enum pode se referir a um caso enum:</para>
<para>Uma constante de enumeração pode se referir a um caso de enumeração:</para>
<programlisting role="php">
<![CDATA[
@@ -511,9 +511,9 @@ enum Tamanho
<sect1 xml:id="language.enumerations.traits">
<title>Traits</title>
<para>Enumerações podem utilizar traits, que se comportam da mesma maneira que nas classes.
A limitação é que usados com <literal>use</literal> em uma enum não podem conter propriedades.
Eles podem incluir apenas métodos, métodos estáticos e constantes. Um trait com propriedades
<para>Enumerações podem utilizar Traits, que se comportam da mesma maneira que nas classes.
A limitação é que usados com <literal>use</literal> em uma enumeração não podem conter propriedades.
Eles podem incluir apenas métodos, métodos estáticos e constantes. Um Trait com propriedades
resultará em um erro fatal.
</para>
@@ -556,17 +556,17 @@ enum Naipe implements Colorido
</sect1>
<sect1 xml:id="language.enumerations.expressions">
<title>Valores enum em expressões constantes</title>
<title>Valores de enumeração em expressões constantes</title>
<para>
Como os casos são representados como constantes no próprio enum, eles podem ser usados como valores
Como os casos são representados como constantes na própria enumeração, eles podem ser usados como valores
estáticos na maioria das expressões constantes: padrões de propriedades, padrões de variáveis estáticas, padrões
de parâmetros, valores constantes globais e de classes. Eles não podem ser usados em outros valores de caso enum, mas
constantes normais podem se referir a um caso enum.
de parâmetros, valores constantes globais e de classes. Eles não podem ser usados em outros valores de caso de enumeração, mas
constantes normais podem se referir a um caso.
</para>
<para>
No entanto, chamadas implícitas de métodos mágicos como <classname>ArrayAccess</classname> em enums não são permitidas em definições estáticas
No entanto, chamadas implícitas de métodos mágicos como <classname>ArrayAccess</classname> em enumerações não são permitidas em definições estáticas
ou de constantes já que não podemos garantir absolutamente que o valor resultante é determinístico
ou que a invocação do método é livre de efeitos colaterais. Chamadas de funções, chamadas de métodos e
acesso às propriedades continuam a ser operações inválidas em expressões constantes.
@@ -576,7 +576,7 @@ enum Naipe implements Colorido
<![CDATA[
<?php
// Esta é uma definição de Enum perfeitamente legal.
// Esta é uma definição de enumeração perfeitamente legal.
enum Direcao implements ArrayAccess
{
case Cima;
@@ -627,17 +627,17 @@ $foo = new Foo();
<title>Diferenças de objetos</title>
<para>
Apesar de Enums serem construídas sobre classes e objetos, elas não suportam todas as funcionalidades relacionadas a objetos.
Em particular, casos Enum são proibidos de ter estado.
Apesar de enumerações serem construídas sobre classes e objetos, elas não suportam todas as funcionalidades relacionadas a objetos.
Em particular, casos de enumeração são proibidos de ter estado.
</para>
<simplelist>
<member>Construtores e Destrutores são proibidos.</member>
<member>Herança não é suportada. Enums não podem estender ou ser estendidos.</member>
<member>Herança não é suportada. Enumerações não podem estender ou ser estendidas.</member>
<member>Propriedades estáticas ou de objeto não são permitidas.</member>
<member>Clonar um caso Enum não é suportado, pois os casos devem ser instâncias singleton.</member>
<member>Clonar um caso de enumeração não é suportado, pois os casos devem ser instâncias únicas.</member>
<member><link linkend="language.oop5.magic">Métodos mágicos</link>, exceto para aqueles listados abaixo, não são permitidos.</member>
<member>Enums sempre precisam ser declarados antes de serem utilizados.</member>
<member>Enumerações sempre precisam ser declaradas antes de serem utilizadas.</member>
</simplelist>
<para>As seguintes funcionalidades de objeto estão disponíveis, e se comportam exatamente como em qualquer outro objeto:</para>
@@ -646,12 +646,12 @@ $foo = new Foo();
<member>Métodos públicos, privados e protegidos.</member>
<member>Métodos estáticos públicos, privados e protegidos.</member>
<member>Constantes públicas, privadas e protegidas.</member>
<member>Enums podem implementar qualquer número de interfaces.</member>
<member>Enumerações podem implementar qualquer número de interfaces.</member>
<member>
Enums e casos podem ter <link linkend="language.attributes">atributos</link> anexados
Enumerações e casos podem ter <link linkend="language.attributes">atributos</link> anexados
a eles. O filtro de alvo <constant>TARGET_CLASS</constant>
inclui as próprias Enums. O filtro de alvo <constant>TARGET_CLASS_CONST</constant>
inclui Casos Enum.
inclui as próprias enumerações. O filtro de alvo <constant>TARGET_CLASS_CONST</constant>
inclui Casos de Enumeração.
</member>
<member>
Os métodos mágicos <link linkend="object.call">__call</link>, <link linkend="object.callstatic">__callStatic</link>,
@@ -661,9 +661,9 @@ $foo = new Foo();
</simplelist>
<para>
A constante mágica <literal>::class</literal> em um tipo Enum avalia ao nome
A constante mágica <literal>::class</literal> em um tipo 'enum' avalia ao nome
do tipo incluindo qualquer namespace, exatamente o mesmo que um objeto. A constante mágica <literal>::class</literal>
em uma instância de Caso também avalia para o tipo Enum, pois ele é uma
em uma instância de Caso também avalia para o tipo 'enum', pois ele é uma
instância daquele tipo.
</para>
@@ -690,7 +690,7 @@ $ferraduras = (new ReflectionClass(Naipe::class))->newInstanceWithoutConstructor
<title>Listagem de valores</title>
<para>
Tanto Pure Enums quanto Backed Enums implementam uma interface interna chamada
Tanto Enumerações Puras quanto Enumerações Apoiadas implementam uma interface interna chamada
<interfacename>UnitEnum</interfacename>. <literal>UnitEnum</literal> inclui um método estático
<literal>cases()</literal>. <literal>cases()</literal> retorna um array embalado com
todos os Casos definidos na ordem de declaração.
@@ -706,7 +706,7 @@ Naipe::cases();
]]>
</programlisting>
<para>Definir manualmente um método <literal>cases()</literal> em uma Enum resultará em um erro fatal.</para>
<para>Definir manualmente um método <literal>cases()</literal> em uma enumeração resultará em um erro fatal.</para>
</sect1>
<sect1 xml:id="language.enumerations.serialization">
@@ -714,7 +714,7 @@ Naipe::cases();
<para>
As enumerações são serializadas de maneira diferente dos objetos. Especificamente, elas têm um novo código de serialização,
<literal>"E"</literal>, que especifica o nome do caso enum. A rotina de desserialização pode
<literal>"E"</literal>, que especifica o nome do caso de enumeração. A rotina de desserialização pode
então usar isso para definir uma variável para o valor singleton existente. Isso garante que:
</para>
@@ -731,17 +731,17 @@ print serialize(Naipe::Copas);
</programlisting>
<para>
Na desserialização, se uma enum e caso não podem ser encontrados para combinar com um valor
Na desserialização, se uma enumeração e um caso não podem ser encontrados para combinar com um valor
serializado, um aviso será emitido e &false; retornado.</para>
<para>
Se uma Pure Enum for serializada para JSON, um erro será lançado. Se uma Backed Enum
Se uma Enumeração Pura for serializada para JSON, um erro será lançado. Se uma Enumeração Apoiada
for serializada para JSON, ela será representada apenas por seu valor escalar, no
tipo apropriado. O comportamento de ambas pode ser sobrescrito ao implementar
<classname>JsonSerializable</classname>.
</para>
<para>Para <function>print_r</function>, a saída de um caso enum é ligeiramente diferente
<para>Para <function>print_r</function>, a saída de um caso de enumeração é ligeiramente diferente
dos objetos para minimizar confusões.
</para>
@@ -777,7 +777,7 @@ Baz Enum:int {
<sect1 xml:id="language.enumerations.object-differences.inheritance">
<title>Porque enums não são extensíveis</title>
<title>Porque enumerações não são extensíveis</title>
<simpara>
Classes possuem contratos em seus métodos:
@@ -806,7 +806,7 @@ function bar(B $b) {
</simpara>
<simpara>
Enums possuem contratos em seus itens, não em seus métodos:
Enumerações possuem contratos em seus itens, não em seus métodos:
</simpara>
<programlisting role="php">
@@ -835,7 +835,7 @@ function quux(ErrorCode $errorCode)
</simpara>
<simpara>
Mas imagine que seja possível estender enums, assim:
Mas imagine que seja possível estender enumerações, assim:
</simpara>
@@ -843,7 +843,7 @@ function quux(ErrorCode $errorCode)
<![CDATA[
<?php
// Apenas para o exemplo onde enums não são finais.
// Apenas para o exemplo onde enumerações não são finais.
// Isto *não* funciona no PHP.
enum MoreErrorCode extends ErrorCode {
case PEBKAC;
@@ -870,7 +870,7 @@ fot(MoreErrorCode::PEBKAC);
</simpara>
<simpara>
Por conta disso, enums são finais e não podem ser estendidos.
Por conta disso, enumerações são finais e não podem ser estendidos.
</simpara>
</sect1>

View File

@@ -972,7 +972,7 @@ Foo::$variable(); // Isto chama $foo->Variable(), lendo a $variable no escopo d
</para>
<para>
<example>
<title>Callables complexos</title>
<title>Chamáveis complexos</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -1014,7 +1014,7 @@ $func(); // prints "bar"
</sect1>
<sect1 xml:id="functions.internal">
<title>Funções internas (built-in)</title>
<title>Funções internas</title>
<para>
O PHP vem por padrão com muitas funções e construtores. Também existem
@@ -1111,8 +1111,8 @@ var_dump(str_contains("foobar", null));
<simpara>
Funções anônimas, também conhecidas como <literal>closures</literal>, permitem a criação
de funções que não tem o nome especificado. Elas são mais úteis
como o valor de parâmetros <type>callable</type>,
de funções que não têm o nome especificado. Elas são mais úteis
como o valor de parâmetros do tipo <type>callable</type>,
mas podem ter vários outros usos.
</simpara>
<simpara>
@@ -1459,38 +1459,38 @@ Warning: Cannot bind an instance to a static closure in %s on line %d
</sect1>
<sect1 xml:id="functions.arrow">
<title>Arrow Functions</title>
<title>Funções de Seta</title>
<simpara>
Arrow functions foram introduzidos a partir do PHP 7.4 como uma sintaxe mais concisa para
Funções de seta foram introduzidas a partir do PHP 7.4 como uma sintaxe mais concisa para
<link linkend="functions.anonymous">funções anônimas</link>.
</simpara>
<simpara>
Funções anônimas e arrow functions são implementadas usando a classe
Funções anônimas e funções de seta são implementadas usando a classe
<link linkend="class.closure"><classname>Closure</classname></link>.
</simpara>
<simpara>
Arrow functions tem a forma básica
Funções de seta têm a forma básica
<code>fn (argument_list) =&gt; expr</code>.
</simpara>
<simpara>
Arrow functions possuem a mesmas características das
Funções de seta possuem a mesmas características das
<link linkend="functions.anonymous">funções anônimas</link>,
exceto que o uso de variáveis do escopo pai é sempre automático.
</simpara>
<simpara>
Quando uma variável usada na expressão é definida no escopo pai
ele será implicitamente capturado por valor.
Quando uma variável usada na expressão é definida no escopo pai,
ela será implicitamente capturada por valor.
No exemplo a seguir, as funções <varname>$fn1</varname> e
<varname>$fn2</varname>comportam-se da mesma maneira.
</simpara>
<para>
<example>
<title>Arrow functions capturam variáveis por valor automaticamente</title>
<title>Funções de seta capturam variáveis por valor automaticamente</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -1516,11 +1516,11 @@ var_export($fn1(3));
</example>
</para>
<simpara>
Isso também funciona se as arrow de functions estiverem aninhadas:
Isso também funciona se as funções de seta estiverem aninhadas:
</simpara>
<para>
<example>
<title>Arrow functions capturam variáveis por valor automaticamente, mesmo quando aninhadas</title>
<title>Funções de seta capturam variáveis por valor automaticamente, mesmo quando aninhadas</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -1536,14 +1536,14 @@ var_export($fn(5)(10));
</para>
<simpara>
Da mesma forma que funções anônimas,
a sintaxe das arrow functions permitem assinaturas de função arbitrária,
a sintaxe das funções de seta permitem assinaturas de função arbitrária,
incluindo parâmetros e tipos de retorno, valores padrão, variadics,
bem como por referência passando e retornando.
Todos os exemplos válidos de arrow functions:
Todos os exemplos válidos de funções de seta:
</simpara>
<para>
<example>
<title>Exemplos de arrow functions</title>
<title>Exemplos de funções de seta</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -1561,9 +1561,9 @@ fn($x, ...$rest) => $rest;
</example>
</para>
<simpara>
Arrow functions usam vinculação de variável por valor.
Funções de seta usam vinculação de variável por valor.
Isso é aproximadamente equivalente a realizar um <code>use($x)</code> para cada
variável <varname>$x</varname> usada dentro da arrow function.
variável <varname>$x</varname> usada dentro da funções de seta.
Uma passagem de variável por valor, significa que não é possível modificar quaisquer valores
do escopo externo.
<link linkend="functions.anonymous">Funções anônimas</link>
@@ -1571,7 +1571,7 @@ fn($x, ...$rest) => $rest;
</simpara>
<para>
<example>
<title>Valores do escopo externo não podem ser modificados por arrow functions</title>
<title>Valores do escopo externo não podem ser modificados por funções de seta</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -1602,7 +1602,7 @@ var_export($x); // Imprime 1
<row>
<entry>7.4.0</entry>
<entry>
Arrow functions tornou-se disponível.
Funções de seta tornaram-se disponíveis.
</entry>
</row>
</tbody>
@@ -1617,25 +1617,25 @@ var_export($x); // Imprime 1
<simpara>
É possível usar <function>func_num_args</function>,
<function>func_get_arg</function>, e <function>func_get_args</function>
de dentro de uma arrow functions.
de dentro de uma função de seta.
</simpara>
</note>
</sect2>
</sect1>
<sect1 xml:id="functions.first_class_callable_syntax">
<title>Sintaxe de Callable de Primeira Classe</title>
<title>Sintaxe de Chamáveis de Primeira Classe</title>
<para>
A sintaxe de callable de primeira classe é introduzida a partir do PHP 8.1.0, como uma maneira de criar <link linkend="functions.anonymous">funções anônimas</link> a partir de <link linkend="language.types.callable">callable</link>.
Ela substitui a sintaxe de callable existente usando strings e arrays.
A vantagem dessa sintaxe é que ela é acessível à análise estática, e usa o escopo no ponto onde o callable é adquirido.
A sintaxe de chamáveis de primeira classe é introduzida a partir do PHP 8.1.0, como uma maneira de criar <link linkend="functions.anonymous">funções anônimas</link> a partir de um <link linkend="language.types.callable">chamável</link>.
Ela substitui a sintaxe de chamáveis existente usando strings e arrays.
A vantagem dessa sintaxe é que ela é acessível à análise estática, e usa o escopo no ponto onde o chamável é adquirido.
</para>
<para>
A sintaxe <code>CallableExpr(...)</code> é usada para criar um objeto <classname>Closure</classname> a partir de callable. <code>CallableExpr</code> aceita qualquer expressão que possa ser diretamente chamada na gramática do PHP:
A sintaxe <code>CallableExpr(...)</code> é usada para criar um objeto <classname>Closure</classname> a partir de um chamável. <code>CallableExpr</code> aceita qualquer expressão que possa ser diretamente chamada na gramática do PHP:
<example>
<title>Sintaxe de callable de primeira classe simples</title>
<title>Sintaxe de chamável de primeira classe simples</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -1653,13 +1653,13 @@ $strMetodoestatico = 'metodoestatico';
$f1 = strlen(...);
$f2 = $obj(...); // objeto invocável
$f2 = $obj(...); // objeto chamável
$f3 = $obj->metodo(...);
$f4 = $obj->$strMetodo(...);
$f5 = Foo::metodoestatico(...);
$f6 = $strClasse::$strMetodoestatico(...);
// Callable tradicional usando string, array
// Chamável tradicional usando string, array
$f7 = 'strlen'(...);
$f8 = [$obj, 'metodo'](...);
$f9 = [Foo::class, 'metodoestatico'](...);
@@ -1677,9 +1677,9 @@ $f9 = [Foo::class, 'metodoestatico'](...);
<para>
<code>CallableExpr(...)</code> tem a mesma semântica que <methodname>Closure::fromCallable</methodname>.
Isto é, That is, ao contrário de callable usando string e array, <code>CallableExpr(...)</code> respeita o escopo no ponto onde ela é criada:
Isto é, That is, ao contrário de um chamável usando string e array, <code>CallableExpr(...)</code> respeita o escopo no ponto onde ela é criada:
<example>
<title>Comparação de escopo de <code>CallableExpr(...)</code> e callable tradicional</title>
<title>Comparação de escopo de <code>CallableExpr(...)</code> e chamável tradicional</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -1702,7 +1702,7 @@ $metodoPrivado();
class Foo1 {
public function obterMetodoPrivado() {
// Usa o escopo onde o callable é adquirido.
// Usa o escopo onde o chamável é adquirido.
return $this->metodoPrivado(...); // Idêntico a Closure::fromCallable([$this, 'metodoPrivado']);
}

View File

@@ -785,8 +785,8 @@ use const algum\namespace\{ConstA, ConstB, ConstC};
</sect2>
</sect1>
<sect1 xml:id="language.namespaces.global">
<title>Espaço global</title>
<titleabbrev>Espaço global</titleabbrev>
<title>Espaço Global</title>
<titleabbrev>Espaço Global</titleabbrev>
<?phpdoc print-version-for="namespaces"?>
<para>
Quando um namespace não é definido, todas as definições de classes e funções são

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d6f54016d62904cfd8200604aadd5e3f0d9bad97 Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano,geekcom,lhsazevedo,leonardolara -->
<sect1 xml:id="language.oop5.anonymous" xmlns="http://docbook.org/ns/docbook">
<title>Classes anônimas</title>
<title>Classes Anônimas</title>
<para>
Classes anônimas são úteis quando objetos simples e descartáveis precisarem ser criados.
@@ -154,7 +154,7 @@ same class
<note>
<para>
Classes anônimas tem nomes atribuídos automaticamente
Classes anônimas têm nomes atribuídos automaticamente
como demonstrado no exemplo a seguir. Este nome deve ser
considerado apenas um detalhe não confiável na implementação.
</para>

View File

@@ -2,7 +2,7 @@
<!-- EN-Revision: c1f37a6c270aadbbb3da56a3973ffd62197adf2b Maintainer: leonardolara Status: ready --><!-- CREDITS: ae,amandavale,narigone,fabioluciano,lhsazevedo,leonardolara -->
<sect1 xml:id="language.oop5.basic" xmlns="http://docbook.org/ns/docbook">
<title>O básico</title>
<title>O Básico</title>
<sect2 xml:id="language.oop5.basic.class">
<title>class</title>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 28529d3539b850e870e3aa97570f4db0e53daa03 Maintainer: ae Status: ready --><!-- CREDITS: narigone,ae,fabioluciano -->
<!-- EN-Revision: 28529d3539b850e870e3aa97570f4db0e53daa03 Maintainer: ae Status: ready --><!-- CREDITS: narigone,ae,fabioluciano,leonardolara -->
<sect1 xml:id="language.oop5.cloning" xmlns="http://docbook.org/ns/docbook">
<title>Clonando objetos</title>
<title>Clonando Objetos</title>
<para>
Criar uma cópia de um objeto com propriedades totalmente replicadas nem sempre
@@ -30,7 +30,7 @@ $copia_do_objeto = clone $objeto;
</informalexample>
<para>
Ao se clonar um objeto, o PHP fará uma cópia superficial de todas as
Ao clonar um objeto, o PHP fará uma cópia superficial de todas as
propriedades do objeto. Qualquer propriedade que seja referência a outra variável,
permanecerá como referência.
</para>
@@ -72,8 +72,8 @@ class MyCloneable
function __clone()
{
// Force a copy of this->object, otherwise
// it will point to same object.
// Força uma cópia de this->object, caso contrário
// aponta para o mesmo objeto.
$this->object1 = clone $this->object1;
}
}
@@ -86,10 +86,10 @@ $obj->object2 = new SubObject();
$obj2 = clone $obj;
print "Original Object:\n";
print "Objeto original:\n";
print_r($obj);
print "Cloned Object:\n";
print "Objeto clonado:\n";
print_r($obj2);
?>
@@ -98,7 +98,7 @@ print_r($obj2);
&example.outputs;
<screen role="php">
<![CDATA[
Original Object:
Objeto original:
MyCloneable Object
(
[object1] => SubObject Object
@@ -112,7 +112,7 @@ MyCloneable Object
)
)
Cloned Object:
Objeto clonado:
MyCloneable Object
(
[object1] => SubObject Object

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5e15a6c3e4d5819102361ae78e73c90a06238c8a Maintainer: ae Status: ready --><!-- CREDITS: narigone,felipe,lcobucci,fabioluciano,ae,github:GabrielGabriel197 -->
<sect1 xml:id="language.oop5.magic" xmlns="http://docbook.org/ns/docbook">
<title>Métodos mágicos</title>
<title>Métodos Mágicos</title>
<para>
Métodos mágicos são métodos especiais que sobrescrever o comportamento padrão do PHP
quando certas operações são realizadas em um objeto.

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: a9edd62d087ab1eb6292c795b7256e14ff9f1234 Maintainer: ae Status: ready --><!-- CREDITS: narigone, felipe, ae, fabioluciano, cviniciussdias -->
<sect1 xml:id="language.oop5.object-comparison" xmlns="http://docbook.org/ns/docbook">
<title>Comparando objetos</title>
<title>Comparando Objetos</title>
<para>
Ao usar o operador de comparação (<literal>==</literal>),
as variáveis dos objetos são comparadas de maneira simples, nominalmente: Duas instâncias

View File

@@ -3,7 +3,7 @@
<refentry xml:id="closure.fromcallable" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Closure::fromCallable</refname>
<refpurpose>Converte um callable em uma closure</refpurpose>
<refpurpose>Converte um chamável em uma closure</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -21,7 +21,7 @@
</para>
<note>
<para>
A partir do PHP 8.1.0, <link linkend="functions.first_class_callable_syntax">Sintaxe de callable de primeira classe</link> possui a mesma semântica que este método.
A partir do PHP 8.1.0, <link linkend="functions.first_class_callable_syntax">Sintaxe de chamáveis de primeira classe</link> possui a mesma semântica que este método.
</para>
</note>
</refsect1>
@@ -33,7 +33,7 @@
<term><parameter>callback</parameter></term>
<listitem>
<para>
O callable para converter.
O chamável a ser convertido.
</para>
</listitem>
</varlistentry>
@@ -53,7 +53,7 @@
&reftitle.seealso;
<simplelist>
<member><link linkend="functions.anonymous">Funções anônimas</link></member>
<member><link linkend="functions.first_class_callable_syntax">Sintaxe de callable de primeira classe</link></member>
<member><link linkend="functions.first_class_callable_syntax">Sintaxe de chamável de primeira classe</link></member>
</simplelist>
</refsect1>

View File

@@ -2,7 +2,7 @@
<!-- EN-Revision: 267a3d4e60d8a6da941e72d195386b5841052cca Maintainer: leonardolara Status: ready -->
<reference xml:id="class.countable" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Interface Countable</title>
<title>A interface Countable</title>
<titleabbrev>Countable</titleabbrev>
<partintro>

View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 20b4b383127faaf37495d7746885f2bb674a1a33 Maintainer: ae Status: ready --><!-- CREDITS: royopa,ae,leonardolara -->
<!-- EN-Revision: 20b4b383127faaf37495d7746885f2bb674a1a33 Maintainer: leonardolara Status: ready --><!-- CREDITS: royopa,ae,leonardolara -->
<reference xml:id="class.iteratoraggregate" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The IteratorAggregate interface</title>
<title>A interface IteratorAggregate</title>
<titleabbrev>IteratorAggregate</titleabbrev>
<partintro>
@@ -42,7 +42,7 @@
<section xml:id="iteratoraggregate.examples">
&reftitle.examples;
<example xml:id="iteratoraggregate.example.basic"><!-- {{{ -->
<title>Basic usage</title>
<title>Uso básico</title>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,ae -->
<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano,ae,leonardolara -->
<reference xml:id="class.serializable" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The Serializable interface</title>
<title>A interface Serializable</title>
<titleabbrev>Serializable</titleabbrev>
<partintro>
@@ -17,12 +17,12 @@
<para>
Classes que implementam esta intarface não possuem mais suporte aos métodos
<link linkend="object.sleep">__sleep()</link> and
<link linkend="object.wakeup">__wakeup()</link>. O método serialize é
<link linkend="object.wakeup">__wakeup()</link>. O método de serialização é
chamado não importando se uma instância possui a necessidade de ser serializada. Não invoca o método __destruct(),
ou possui qualquer outro efeito colateral a não ser que programado no método. Quando os dados são
deserializados, a classe toma conhecimento e o método unserialize() apropriado é chamado como
um construtor, em vez de chamar o método __construct(). Se necessitar executar o construtor
padrão, pode-se fazer no método.
desserializados, a classe toma conhecimento e o método unserialize() apropriado é chamado como
um construtor, em vez de chamar o método __construct(). Se for necessário executar o construtor
padrão, pode-se fazer isso no método.
</para>
<warning>
@@ -54,7 +54,7 @@
<section xml:id="serializable.examples">
&reftitle.examples;
<example xml:id="serializable.example.basic"><!-- {{{ -->
<title>Basic usage</title>
<title>Uso básico</title>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -2,7 +2,7 @@
<!-- EN-Revision: 09caff9ea664f7154a7d37e92b2c332c28462404 Maintainer: ae Status: ready --><!-- CREDITS: fabioluciano,ae -->
<reference xml:id="class.throwable" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Throwable</title>
<title>A classe Throwable</title>
<titleabbrev>Throwable</titleabbrev>
<partintro>

View File

@@ -1,14 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f4609f913fe6bf4a8b41328df9366726208b7e33 Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
<sect1 xml:id="language.types.enumerations">
<title>Enumerations</title>
<title>Enumerações</title>
<?phpdoc print-version-for="enumerations"?>
<sect2 xml:id="language.types.enumerations.basics">
<title>Enumerações Básicas</title>
<para>
Enumerations são uma camada de restrição sobre classes e constantes de classe,
Enumerações são uma camada de restrição sobre classes e constantes de classe,
destinadas a fornecer uma maneira de definir um conjunto fechado de valores possíveis para um tipo.
</para>
@@ -37,7 +37,7 @@ do_stuff(Suit::Spades);
<simpara>
Para uma discussão completa, consulte o capítulo
<link linkend="language.enumerations">Enumerations.</link>
sobre <link linkend="language.enumerations">enumerações.</link>
</simpara>
</sect2>
@@ -48,9 +48,9 @@ do_stuff(Suit::Spades);
<para>
Se um <type>enum</type> for convertido em um <type>object</type>, ele não será
modificado. Se um <type>enum</type> for convertido em um <type>array</type>,
será criado um array com uma única chave de <literal>name</literal> (para enumerations puras) ou
será criado um array com uma única chave de <literal>name</literal> (para enumerações puras) ou
um array com chaves <literal>name</literal> e <literal>value</literal>
(para enumerations com backup). Todos os outros tipos de conversão resultarão em erro.
(para enumerações com backup). Todos os outros tipos de conversão resultarão em erro.
</para>
</sect2>
</sect1>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 161dde4fe721309398dd324edbf02aec409f127b Maintainer: marcosmarcolin Status: ready --><!-- CREDITS: marcosmarcolin -->
<sect1 xml:id="language.types.mixed">
<title>Mixed</title>
<title>Misto</title>
<para>
O tipo <type>mixed</type> aceita todos os valores. É equivalente ao

View File

@@ -4,7 +4,7 @@
<refentry xml:id="wrappers.audio" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_wrapper">
<refnamediv>
<refname>ogg://</refname>
<refpurpose>Streams de áudio</refpurpose>
<refpurpose>Fluxos de áudio</refpurpose>
</refnamediv>
<refsect1 role="description"><!-- {{{ -->

View File

@@ -3,7 +3,7 @@
<book xml:id="book.bc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="bundled" ?>
<title>BCMath, funções matemáticas de precisão arbitrária</title>
<title>Funções matemáticas de precisão arbitrária</title>
<titleabbrev>BC Math</titleabbrev>
<!-- {{{ preface -->
@@ -35,7 +35,7 @@ $num1 = 0; // (string) 0 => '0'
$num2 = -0.000005; // (string) -0.000005 => '-5.05E-6'
echo bcadd($num1, $num2, 6); // => '0.000000'
setlocale(LC_NUMERIC, 'de_DE'); // uses a decimal comma
setlocale(LC_NUMERIC, 'de_DE'); // usa uma vírgula como separador de decimais
$num2 = 1.2; // (string) 1.2 => '1,2'
echo bcsub($num1, $num2, 1); // => '0.0'
?>

View File

@@ -3,7 +3,7 @@
<book xml:id="book.calendar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="bundled" ?>
<title>Calendar</title>
<title>Calendário</title>
<!-- {{{ preface -->
<preface xml:id="intro.calendar">

View File

@@ -3,8 +3,8 @@
<book xml:id="book.datetime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="core"?>
<title>Data e Hora</title>
<titleabbrev>Data/Hora</titleabbrev>
<title>Data e Horário</title>
<titleabbrev>Data/Horário</titleabbrev>
<!-- {{{ preface -->
<preface xml:id="intro.datetime">
@@ -56,7 +56,7 @@
&reference.datetime.reference;
<article xml:id="datetime.error.tree">
<title>Erros e Exceções de Data/Hora</title>
<title>Erros e Exceções de Data/Horário</title>
<itemizedlist>
<listitem>

View File

@@ -9,7 +9,7 @@
<section xml:id="dateexception.intro">
&reftitle.intro;
<para>
Classe pai das exceções de Data/Hora, para problemas que surgem devido a
Classe pai das exceções de Data/Horário, para problemas que surgem devido a
entradas do usuário ou argumentos texto em formato livre que precisam ser analisados.
</para>
<para>

View File

@@ -9,7 +9,7 @@
<section xml:id="datemalformedstringexception.intro">
&reftitle.intro;
<para>
Disparada quando uma string inválida de Data/Hora é detectada.
Disparada quando uma string inválida de Data/Horário é detectada.
</para>
<para>
Pode ser um valor para

View File

@@ -9,11 +9,11 @@
<section xml:id="dateobjecterror.intro">
&reftitle.intro;
<para>
Disparada quando uma das classe de Data/Hora não foi corretamente
Disparada quando uma das classe de Data/Horário não foi corretamente
inicializada.
</para>
<para>
Como as classes de Data/Hora não são finais, eles podem ser herdadas.
Como as classes de Data/Horário não são finais, eles podem ser herdadas.
Quando um construtor da classe pai não é chamado, este erro é disparado. Este é
sempre um erro de programação.
</para>

View File

@@ -280,7 +280,7 @@
</entry>
</row>
<row>
<entry align="center"><emphasis>Data/Hora completa</emphasis></entry>
<entry align="center"><emphasis>Data/Horário completos</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>

View File

@@ -315,7 +315,7 @@
<entry><literal>-43200</literal> a <literal>50400</literal></entry>
</row>
<row>
<entry align="center"><emphasis>Data/Hora completa</emphasis></entry>
<entry align="center"><emphasis>Data/Horário completos</emphasis></entry>
<entry>---</entry>
<entry>---</entry>
</row>
@@ -331,7 +331,7 @@
</row>
<row>
<entry><literal>U</literal></entry>
<entry>Segundos desde a Era Unix (1 de janeiro de 1970 00:00:00 GMT)</entry>
<entry>Segundos desde a Época Unix (1 de janeiro de 1970 00:00:00 GMT)</entry>
<entry>Veja também <function>time</function></entry>
</row>
</tbody>

View File

@@ -20,7 +20,7 @@
<para>
Retorna o timestamp Unix correspondente aos argumentos informados.
Este timestamp é um inteiro longo contendo o número de segundos
entre a Era Unix (January 1 1970 00:00:00 GMT), e o tempo
entre a Época Unix (January 1 1970 00:00:00 GMT), e o horário
especificado.
</para>
<para>

View File

@@ -5,7 +5,7 @@
&extension.runtime;
<para>
<table>
<title>Opções de Configuração de Data/Hora</title>
<title>Opções de Configuração de Data/Horário</title>
<tgroup cols="4">
<thead>
<row>

View File

@@ -2,7 +2,7 @@
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: felipe Status: ready -->
<reference xml:id="ref.datetime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>&Functions; de Data/Hora</title>
<title>&Functions; de Data/Horário</title>
&reference.datetime.entities.functions;

View File

@@ -3,17 +3,17 @@
<book xml:id="book.dio" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="pecl" ?>
<title>IO Direto</title>
<title>E/S Direta</title>
<!-- {{{ preface -->
<preface xml:id="intro.dio">
&reftitle.intro;
<para>
O PHP oferece suporte às funções de I/O direto, conforme descrito no Padrão Posix
(Seção 6), para realizar funções de I/O em um nível mais baixo do que as funções
de I/O de fluxo da linguagem C
O PHP oferece suporte às funções de E/S Direta, conforme descrito no Padrão Posix
(Seção 6), para realizar funções de E/S em um nível mais baixo do que as funções
de E/S de fluxo da linguagem C
(<function>fopen</function>, <function>fread</function>,..). O uso
das funções DIO deve ser considerado apenas quando é necessário o controle direto
das funções de E/S Direta deve ser considerado apenas quando é necessário o controle direto
de um dispositivo. Em todos os outros casos, as funções padrão do
<link linkend="book.filesystem">sistema de arquivos</link> são mais
do que adequadas.

View File

@@ -2,7 +2,7 @@
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<reference xml:id="ref.dio" xmlns="http://docbook.org/ns/docbook">
<title>IO Direto &Functions;</title>
<title>&Functions; de E/S Direta</title>
&reference.dio.entities.functions;

View File

@@ -4,7 +4,7 @@
<book xml:id="book.imagick" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="pecl" ?>
<title>Processamento de Imagem (ImageMagick)</title>
<title>Processamento de Imagem</title>
<titleabbrev>ImageMagick</titleabbrev>
<!-- {{{ preface -->

View File

@@ -3,14 +3,14 @@
<book xml:id="book.pcntl" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="bundled" ?>
<title>Process Control</title>
<title>Controle de Processos</title>
<titleabbrev>PCNTL</titleabbrev>
<!-- {{{ preface -->
<preface xml:id="intro.pcntl">
&reftitle.intro;
<para>
O suporte ao controle de processos em PHP implementa o estilo Unix de
O suporte ao controle de processos no PHP implementa o estilo Unix de
criação de processos, execução de programas, manipulação de sinais e
encerramento de processos. O Controle de Processo não deve ser ativado em um
ambiente de servidor web e resultados inesperados podem ocorrer se alguma
@@ -27,11 +27,11 @@
<para>
PCNTL agora usa ticks como mecanismo de retorno de chamada de identificador de sinal, que é
muito mais rápido que o mecanismo anterior. Esta mudança segue a mesma
semântica do uso de "user ticks". Você usa a instrução <function>declare</function>
para especificar os locais em seu programa onde os retornos de chamada
semântica do uso de "user ticks". A instrução <function>declare</function> é usada
para especificar os locais na aplicação onde as funções de retorno
podem ocorrer. Isso permite minimizar a sobrecarga do tratamento de
eventos assíncronos. No passado, compilar PHP com pcntl habilitado
sempre incorreria nessa sobrecarga, independentemente de seu script usar
eventos assíncronos. No passado, compilar o PHP com pcntl habilitado
sempre incorreria nessa sobrecarga, independentemente do script usar
pcntl ou não.
</para>

View File

@@ -3,7 +3,7 @@
<book xml:id="book.rar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="pecl" ?>
<title>Rar Archiving</title>
<title>Arquivamento Rar</title>
<titleabbrev>Rar</titleabbrev>
<!-- {{{ preface -->

View File

@@ -60,7 +60,7 @@
&reftitle.seealso;
<para>
<simplelist>
<member><link linkend="language.enumerations">Enumerations</link></member>
<member><link linkend="language.enumerations">Enumerações</link></member>
</simplelist>
</para>
</section>

View File

@@ -78,7 +78,7 @@ enum(Suit::Clubs)
&reftitle.seealso;
<para>
<simplelist>
<member><link linkend="language.enumerations">Enumerations</link></member>
<member><link linkend="language.enumerations">Enumerações</link></member>
<member><methodname>ReflectionEnum::getCases</methodname></member>
<member><methodname>ReflectionEnum::hasCase</methodname></member>
<member><methodname>ReflectionEnum::isBacked</methodname></member>

View File

@@ -75,7 +75,7 @@ enum(Suit::Spades)
&reftitle.seealso;
<para>
<simplelist>
<member><link linkend="language.enumerations">Enumerations</link></member>
<member><link linkend="language.enumerations">Enumerações</link></member>
<member><methodname>ReflectionEnum::getCase</methodname></member>
<member><methodname>ReflectionEnum::isBacked</methodname></member>
</simplelist>

View File

@@ -76,7 +76,7 @@ bool(false)
&reftitle.seealso;
<para>
<simplelist>
<member><link linkend="language.enumerations">Enumerations</link></member>
<member><link linkend="language.enumerations">Enumerações</link></member>
<member><methodname>ReflectionEnum::getCase</methodname></member>
<member><methodname>ReflectionEnum::getCases</methodname></member>
</simplelist>

View File

@@ -63,7 +63,7 @@
&reftitle.seealso;
<para>
<simplelist>
<member><link linkend="language.enumerations">Enumerations</link></member>
<member><link linkend="language.enumerations">Enumerações</link></member>
<member><classname>ReflectionEnumUnitCase</classname></member>
</simplelist>
</para>

View File

@@ -60,7 +60,7 @@
&reftitle.seealso;
<para>
<simplelist>
<member><link linkend="language.enumerations">Enumerations</link></member>
<member><link linkend="language.enumerations">Enumerações</link></member>
<member><classname>ReflectionEnumBackedCase</classname></member>
</simplelist>
</para>

View File

@@ -2,13 +2,13 @@
<!-- EN-Revision: e93feee2870bb551cd11d625271b7f82da3ccb05 Maintainer: leonardolara Status: ready --><!-- CREDITS: diogo,ae,adiel,leonardolara -->
<book xml:id="book.spl" xmlns="http://docbook.org/ns/docbook">
<?phpdoc extension-membership="core" ?>
<title>Standard PHP Library (SPL)</title>
<title>Biblioteca Padrão PHP (SPL)</title>
<titleabbrev>SPL</titleabbrev>
<preface xml:id="intro.spl" annotations="chunk:false">
&reftitle.intro;
<simpara>
A extensão Standard PHP Library (SPL) define interfaces e classes
A extensão SPL - Standard PHP Library (Biblioteca Padrão PHP) define interfaces e classes
destinadas a resolver problemas comuns.
</simpara>
<simpara>