sync with en rev

This commit is contained in:
Leonardo Lara Rodrigues
2025-03-06 14:42:55 -03:00
parent b1e722968f
commit 7842519cbf
14 changed files with 236 additions and 211 deletions

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: leonardolara Status: ready --><!-- CREDITS: geekcom,leonardolara -->
<!-- EN-Revision: e150cc645a17588282e5e6b5e43e600a2f345549 Maintainer: leonardolara Status: ready --><!-- CREDITS: geekcom,leonardolara -->
<sect1 xml:id="migration74.new-features" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Novos Recursos</title>
@@ -77,6 +77,33 @@ class ChildProducer extends Producer {
O suporte completo à variação só está disponível se o carregamento automático for usado. Dentro de
um único arquivo, apenas as referências de tipo não cíclico são possíveis, porque todas
as classes precisam estar disponíveis antes de serem referenciadas.
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
/**
* Essas classes satisfazem os requisitos do LSP, porque C é um subtipo de A.
* No entanto, no momento em que a classe B é declarada, a classe C ainda não está disponível
*/
class A
{
public function method(): A {}
}
class B extends A
{
// Erro fatal: Não foi possível verificar a compatibilidade entre B::method():C e
// A::method(): A, porque a classe C não está disponível
public function method(): C {}
}
class C extends B {}
?>
]]>
</programlisting>
</informalexample>
</para>
</sect3>

View File

@@ -98,7 +98,7 @@
<simpara>
<!-- TODO Does this need a link? -->
A configuração <literal>events.mechanism</literal> do arquivo <filename>/dev/poll</filename>
para Solaris/Illumos foi aposentada.
para Solaris/Illumos foi descontinuada.
</simpara>
</sect3>
</sect2>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 285d4ca5804f106ed3e19d4b0270819b8d38a74b Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano,ae,leonardolara -->
<!-- EN-Revision: 873a99f094902ad72129ab391b1fb80525fab30e Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano,ae,leonardolara -->
<refentry xml:id="generator.rewind" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Generator::rewind</refname>
@@ -16,7 +16,7 @@
O método retrocede o gerador para o ponto antes do primeiro &yield;.
Se o gerador não estiver em uma primeira expressão &yield; quando este método é chamado,
ele primeiramente irá avançar para a primeira expressão &yield; antes de retroceder.
Se o gerador já estiver no ponto de início do segundo yield,
Se o gerador já estiver no ponto de início do segundo &yield;,
uma exceção <classname>Exception</classname> será lançada.
</para>
<note>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 921943ae56241c881c720e26d6bdaaceae48f279 Maintainer: leonardolara Status: ready --><!-- CREDITS: marcosmarcolin,ae,leonardolara -->
<!-- EN-Revision: 68976f0e68dbd2c49eaf5d477b6075864a946593 Maintainer: leonardolara Status: ready --><!-- CREDITS: marcosmarcolin,ae,leonardolara -->
<sect1 xml:id="language.types.declarations">
<title>Declarações de tipo</title>
@@ -128,18 +128,6 @@
O suporte para tipos anuláveis foi adicionado.
</entry>
</row>
<row>
<entry>7.0.0</entry>
<entry>
O suporte para tipos escalares foi adicionado.
</entry>
</row>
<row>
<entry>7.0.0</entry>
<entry>
O suporte para tipos de retorno foi adicionado.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 6846ebb4e33d51faee4a1e99c241a7a24861e0e4 Maintainer: leonardolara Status: ready --><!-- CREDITS: surfmax,leonardolara -->
<!-- EN-Revision: 57c38808e4eed7fce33992a32b2ffee78dd8004e Maintainer: leonardolara Status: ready --><!-- CREDITS: surfmax,leonardolara -->
<refentry xml:id="function.method-exists" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>method_exists</refname>
@@ -49,6 +49,28 @@
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>7.4.0</entry>
<entry>
As verificações de classe em relação aos métodos privados herdados agora retornam <parameter>false</parameter>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -91,6 +113,14 @@ bool(true)
<refsect1 role="notes">
&reftitle.notes;
&note.uses-autoload;
<note>
<simpara>
A função <function>method_exists</function> não pode detectar métodos
que são magicamente acessíveis usando o
método mágico
<link linkend="language.oop5.overloading.methods"><literal>__call</literal></link>.
</simpara>
</note>
</refsect1>
<refsect1 role="seealso">

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: af2996a5a23265aa56ca8a97a0e79c626ca54395 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<!-- EN-Revision: af2996a5a23265aa56ca8a97a0e79c626ca54395 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto -->
<reference xml:id="oldaliases.cubrid" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Apelidos e funções obsoletas do CUBRID</title>
<title>Funções e sinônimos obsoletos do CUBRID</title>
&reference.cubrid.entities.oldaliases;

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 06313c3bb195d974aeba8f4364a6739833b18768 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,felipe,leonardolara -->
<!-- EN-Revision: f112cc1ec6335a62d03a3de0da4f03ea3f5d0e03 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,felipe,leonardolara -->
<refentry xml:id="function.restore-include-path" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>restore_include_path</refname>
@@ -37,32 +37,30 @@
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
&removed.function;
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
&deprecated.function;
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
&removed.function;
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
&deprecated.function;
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 06313c3bb195d974aeba8f4364a6739833b18768 Maintainer: leonardolara Status: ready --><!-- CREDITS: surfmax,felipe,leonardolara -->
<!-- EN-Revision: f112cc1ec6335a62d03a3de0da4f03ea3f5d0e03 Maintainer: leonardolara Status: ready --><!-- CREDITS: surfmax,felipe,leonardolara -->
<!-- splitted from ./en/functions/mail.xml, last change in rev 1.6 -->
<refentry xml:id="function.ezmlm-hash" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -48,32 +48,30 @@
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
&removed.function;
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
&deprecated.function;
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
&removed.function;
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
&deprecated.function;
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bd788d13db9448d2077d82ee357082d0fbc2da88 Maintainer: leonardolara Status: ready -->
<reference xml:id="oldaliases.oci8" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Sinônimos e Funções Obsoletas do OCI8</title>
<title>Funções e sinônimos e obsoletos do OCI8</title>
&reference.oci8.entities.oldaliases;

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9b2c572997cd1ff2f9ef98bd56b2daf24172b4b6 Maintainer: leonardolara Status: ready --><!-- CREDITS: rogeriopradoj,lisaldo,rogeriopradoj,leonardolara -->
<!-- EN-Revision: 5003a6ea92eb50ac92121782eedfc5ad3fe9d061 Maintainer: leonardolara Status: ready --><!-- CREDITS: rogeriopradoj,lisaldo,rogeriopradoj,leonardolara -->
<refentry xml:id="function.password-hash" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>password_hash</refname>
@@ -29,14 +29,14 @@
Perceba que essa constante foi desenhada para mudar ao longo do tempo a medida que novos algoritmos mais fortes forem adicionados
ao PHP. Por essa razão, o comprimento do resultado da utilização desse identificador pode mudar ao longo
do tempo. Por isso, é recomendado que armazene o resultado em uma coluna do banco de dados que possa ser expandida
além dos 60 caracteres (255 caracteres seria uma boa escolha).
além dos 60 bytes (255 bytes seria uma boa escolha).
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PASSWORD_BCRYPT</constant> - Usa o algoritmo bcrypt para
criar o hash. Produzirá um hash compatível com o padrão <function>crypt</function> usando
o identificador <literal>$2y$</literal>. O resultado será sempre uma string de 60 caracteres, &return.falseforfailure;.
o identificador <literal>$2y$</literal>.
</simpara>
</listitem>
<listitem>
@@ -82,7 +82,7 @@
</para>
<para>
Se omitido, um valor padrão <literal>12</literal> será usado. Este é um bom
patamar de custo, mas pode-se considerar ajuste nesse valor dependendo do hardware.
patamar de custo, mas deve ser ajustado dependendo do equipamento em uso.
</para>
</listitem>
</itemizedlist>
@@ -255,13 +255,6 @@
<programlisting role="php">
<![CDATA[
<?php
/**
* O objetivo é calcular o hash da senha usando o algortimo PASSWORD_DEFAULT atual.
* Atualmente é BCRYPT, e resultará em uma string de 60 caracteres.
*
* Fique ciente que PASSWORD_DEFAULT pode mudar com o tempo, por isso deve-se
* preparar para permitir strings com mais de 60 caracteres (255 é um bom número)
*/
echo password_hash("rasmuslerdorf", PASSWORD_DEFAULT);
?>
]]>
@@ -280,10 +273,8 @@ $2y$12$4Umg0rCJwMswRw/l.SwHvuQV01coP0eWmGzd61QH2RvAOMANUBGC.
<programlisting role="php">
<![CDATA[
<?php
/**
* Neste caso, o objetivo é aumentar o custo padrão de BCRYPT para 13.
*/
$options = [
// Aumenta o custo bcrypt de 12 para 13.
'cost' => 13,
];
echo password_hash("rasmuslerdorf", PASSWORD_BCRYPT, $options);
@@ -301,16 +292,17 @@ $2y$13$xeDfQumlmdm0Sco.4qmH1OGfUUmOcuRmfae0dPJhjX1Bq0yYhqbNi
<para>
<example>
<title>Exemplo de busca de um bom custo para <function>password_hash</function></title>
<simpara>
Este código fará um benchmark da máquina para determinar o quão alto um custo pode ser usado
sem deteriorar a experiência do usuário. É recomendado definir o custo mais alto
que não desacelere outras operações que a máquina precisa executar. 11 é uma
boa linha de base, e mais é melhor se a máquina for rápida o suficiente. O código abaixo
visa um tempo de alongamento ≤ 350 milissegundos, que é um atraso apropriado para
sistemas que lidam com logins interativos.
</simpara>
<programlisting role="php">
<![CDATA[
<?php
/**
* Este código irá verificar o desempenho do servidor para determinar o quanto pode-se aumentar
* o custo. O objetivo é aumentar o custo ao valor mais alto possível sem deixar o servidor
* muito lento. 11 é um bom ponto de partida, e um valor maior será bom se o servidor for
* rápido o suficiente. O código abaix mira em ≤ 350 milissegundos de tempo adicional,
* que é um atraso adequado para sistemas que lidam com logins interativos.
*/
$timeTarget = 0.350; // 350 milissegundos
$cost = 11;
@@ -357,21 +349,21 @@ Argon2i hash: $argon2i$v=19$m=1024,t=2,p=2$YzJBSzV4TUhkMzc3d3laeg$zqU/1IN0/AogfP
&reftitle.notes;
<caution>
<para>
É fortemente recomendado que não seja gerado um salt próprio para esta
função. Ela criará um salt seguro automaticamente se um não for
especificado.
É fortemente recomendado fornecer um salt explícito para esta função.
Ela criará um salt seguro automaticamente se um não for especificado.
</para>
<para>
Como apontado acima, fornecer a opção <literal>salt</literal> no PHP 7.0
gerará um erro deprecation warning. O suporte para fornecer um salt manualmente
Como apontado acima, fornecer a opção <literal>salt</literal> no PHP 7.0.0
gerará um alerta de descontinuação. O suporte para fornecer um salt explicitamente
foi removido no PHP 8.0.
</para>
</caution>
<note>
<para>
É recomendado que você teste esta função sem seus servidores, e ajuste o parâmetro custo
É recomendado testar esta função na máquina usada, ajustando o parâmetro custo
para que a execução da função leve menos do que 350 milissegundos em sistemas interativos.
O script do exemplo acima ajudará a escolher um bom valor de custo para seu hardware.
O script do exemplo acima ajudará a escolher um custo bcrypt apropriado para uma determinada
máquina.
</para>
</note>
<note>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 06313c3bb195d974aeba8f4364a6739833b18768 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<!-- EN-Revision: d8c71db13e6862906439f16b3cede5134492c163 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<refentry xml:id="reflectionmethod.export" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -65,32 +65,30 @@
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
&removed.function;
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
&deprecated.function;
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
&removed.function;
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
&deprecated.function;
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 06313c3bb195d974aeba8f4364a6739833b18768 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<!-- EN-Revision: f112cc1ec6335a62d03a3de0da4f03ea3f5d0e03 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<refentry xml:id="reflector.export" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -39,32 +39,30 @@
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
&removed.function;
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
&deprecated.function;
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
&removed.function;
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
&deprecated.function;
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 06313c3bb195d974aeba8f4364a6739833b18768 Maintainer: leonardolara Status: ready --><!-- CREDITS: surfmax,fernandoc,leonardolara -->
<!-- EN-Revision: f112cc1ec6335a62d03a3de0da4f03ea3f5d0e03 Maintainer: leonardolara Status: ready --><!-- CREDITS: surfmax,fernandoc,leonardolara -->
<refentry xml:id="function.convert-cyr-string" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>convert_cyr_string</refname>
@@ -99,32 +99,30 @@
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
&removed.function;
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
&deprecated.function;
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
&removed.function;
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
&deprecated.function;
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="notes">

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 06313c3bb195d974aeba8f4364a6739833b18768 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: f112cc1ec6335a62d03a3de0da4f03ea3f5d0e03 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.hebrevc">
<refnamediv>
<refname>hebrevc</refname>
@@ -60,32 +60,30 @@
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
&removed.function;
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
&deprecated.function;
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
&removed.function;
</entry>
</row>
<row>
<entry>7.4.0</entry>
<entry>
&deprecated.function;
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">