sync with en rev

This commit is contained in:
leonardolara
2024-12-09 15:57:29 -03:00
parent 46266c1349
commit ada3e9371e
11 changed files with 82 additions and 48 deletions

View File

@@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 8a9f4bd9d54a809d66f32d35ec60eb2b7353f76e Maintainer: leonardolara Status: ready -->
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 4edd2166e1121cd17ae942458baa532edf4d70e1 Maintainer: leonardolara Status: ready -->
<sect1 xml:id="migration84.new-features">
<title>Novos Recursos</title>
@@ -354,17 +354,17 @@ $object = $reflector->newLazyGhost($initializer);
<!-- RFC: https://wiki.php.net/rfc/pdo_driver_specific_subclasses -->
<simpara>
Adicionado suporte para subclasses de drivers específicos.
Esta RFC adiciona subclasses para PDO afim de suportar melhor as
funcionalidades específicas de cada bancos de dados.
Adicionado suporte para subclasses de drivers específicos para suportar melhor
as funcionalidades específicas de cada bancos de dados.
As novas classes são instanciáveis tanto pela chamada ao método
<methodname>PDO::connect</methodname> quanto pela instanciação direta
da subclasse específica do driver.
de uma das subclasses específicas do driver.
</simpara>
<!-- RFC: https://wiki.php.net/rfc/pdo_driver_specific_parsers -->
<para>
Adicionado suporte para analisadores SQL específicos de drivers.
Quando um analisador específico do driver não está disponível, o analisador padrão é usado.
Os analisador padrão suporta:
<simplelist>
<member>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c1c803cf6a83feb30a444c90787c88cd1946e3f6 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 1eec5a5abad2e54d02eb49161d5e7beffa632308 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<sect1 xml:id="language.oop5.traits" xmlns="http://docbook.org/ns/docbook">
<title>Traits</title>
<para>
@@ -25,23 +25,43 @@
<programlisting role="php">
<![CDATA[
<?php
trait ezcReflectionReturnInfo {
function getReturnType() { /*1*/ }
function getReturnDescription() { /*2*/ }
trait TraitA {
public function sayHello() {
echo 'Olá,';
}
}
class ezcReflectionMethod extends ReflectionMethod {
use ezcReflectionReturnInfo;
/* ... */
trait TraitB {
public function sayWorld() {
echo 'mundo';
}
}
class ezcReflectionFunction extends ReflectionFunction {
use ezcReflectionReturnInfo;
/* ... */
class MyHelloWorld
{
use TraitA, TraitB; // A class can use multiple traits
public function sayHelloWorld() {
$this->sayHello();
echo ' ';
$this->sayWorld();
echo "!\n";
}
}
$myHelloWorld = new MyHelloWorld();
$myHelloWorld->sayHelloWorld();
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Olá, mundo!
]]>
</screen>
</example>
<sect2 xml:id="language.oop5.traits.precedence">

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 26c2a159a4a875a29cd528aad16ea2c1c1051bd2 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe, fabioluciano, leonardolara -->
<!-- EN-Revision: 130701dd4e64351d38da565ab3043a8f795698f8 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe, fabioluciano, leonardolara -->
<appendix xml:id="datetime.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
<para>
@@ -119,8 +119,8 @@
<simpara>
Este formato permite intervalos de anos fora dos limites padrão da ISO-8601
de <literal>0000</literal>-<literal>9999</literal> através da inclusão
se um caractere de sinal. Ele também endereça a parte de fuso horário
(<literal>+01:00</literal>) para que seja compatível com a ISO-8601.
se um caractere de sinal. Ele também garante que a parte de fuso horário
(<literal>+01:00</literal>) seja compatível com a ISO-8601.
</simpara>
</note>
</listitem>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 576c7c43febb2eec5718d8320f92606423413983 Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano, leonardolara -->
<!-- EN-Revision: 130701dd4e64351d38da565ab3043a8f795698f8 Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano, leonardolara -->
<reference xml:id="class.datetimeinterface" 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>A interface DateTimeInterface</title>
@@ -212,7 +212,7 @@
<simpara>
Este formato permite valores de ano fora do intervalo normal da ISO-8601
de <literal>0000</literal>-<literal>9999</literal> porque sempre
inclui um caractere de sinal. Ele também faz com que que a parte do fuso horário
inclui um caractere de sinal. Ele também garante que a parte do fuso horário
(<literal>+01:00</literal>) seja compatível com a ISO-8601.
</simpara>
</note>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 67ca0d930c95a85ea49aff456409409f6ae06c1b Maintainer: thiago Status: ready --><!-- CREDITS: diogo, rarruda, ae, leonardolara -->
<!-- EN-Revision: 130701dd4e64351d38da565ab3043a8f795698f8 Maintainer: leonardolara Status: ready --><!-- CREDITS: diogo, rarruda, ae, leonardolara, thiago -->
<refentry xml:id="function.dirname" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dirname</refname>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: thiago Status: ready --><!-- CREDITS: rdiogo,arruda,ae,leonardolara -->
<!-- EN-Revision: cc735f9ff7aaa32e5ed2eae501f9942c0d05493c Maintainer: leonardolara Status: ready --><!-- CREDITS: rdiogo,arruda,ae,leonardolara,thiago -->
<refentry xml:id="function.fseek" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>fseek</refname>
@@ -47,9 +47,9 @@
A posição.
</para>
<para>
Para mover até uma posição anterior ao fim-do-arquivo, você precisa passar
um valor negativo no <parameter>offset</parameter> e
definir o parâmetro <parameter>whence</parameter>
Para mover até uma posição anterior ao fim-do-arquivo,
um valor negativo em <parameter>offset</parameter> deve ser passado
e o parâmetro <parameter>whence</parameter> deve ser definido
para <constant>SEEK_END</constant>.
</para>
</listitem>
@@ -60,9 +60,9 @@
<para>
Valores de <parameter>whence</parameter> são:
<simplelist>
<member><constant>SEEK_SET</constant> - Define a posição igual ao <parameter>offset</parameter> bytes.</member>
<member><constant>SEEK_CUR</constant> - Define a posição para a atual localização mais <parameter>offset</parameter>.</member>
<member><constant>SEEK_END</constant> - Define a posição para o final do arquivo mais <parameter>offset</parameter>.</member>
<member><constant>SEEK_SET</constant> - Define a posição igual ao número de bytes informado em <parameter>offset</parameter> desde o início do arquivo.</member>
<member><constant>SEEK_CUR</constant> - Define a posição para a localização atual mais o número de bytes informado em <parameter>offset</parameter>.</member>
<member><constant>SEEK_END</constant> - Define a posição para o final do arquivo mais o número de bytes informado em <parameter>offset</parameter>.</member>
</simplelist>
</para>
</listitem>
@@ -74,8 +74,16 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Em caso de sucesso, retorna 0; caso contrário, retorna -1.
Em caso de sucesso, retorna <literal>0</literal>;
caso contrário, retorna <literal>-1</literal>.
</para>
<warning>
<simpara>
Esta função foi criada para imitar a função de mesmo nome da linguagem C.
Atenção aos valores de retorno, pois eles diferem do
esperado no PHP.
</simpara>
</warning>
</refsect1>
<refsect1 role="examples">
@@ -107,17 +115,17 @@ fseek($fp, 0);
&reftitle.notes;
<note>
<para>
Se você abriu o arquivo em modo de adição (<literal>a</literal> ou <literal>a+</literal>), quaisquer dados que
você escreva no arquivo serão sempre acrescentados ao final, independente da
posição do arquivo, e o resultado da chamada de
<function>fseek</function> será undefined.
Se o arquivo foi aberto em modo de adição (<literal>a</literal> ou <literal>a+</literal>), quaisquer dados que
sejam escritos no arquivo serão sempre acrescentados ao final, independente da
posição do arquivo, e o resultado da chamada a
<function>fseek</function> será indefinido.
</para>
</note>
<note>
<para>
Nem todos os fluxos (streams) suportam procura (seek). Para aqueles que não suportam,
procuras além da posição atual podem ser feitas através
da leitura e descarte de dados; outras formas de procura vão falhar.
Nem todos os fluxos suportam pesquisa. Para aqueles que não suportam,
pesquisas além da posição atual podem ser feitas através
da leitura e descarte de dados; outras formas de pesquisa irão falhar.
</para>
</note>
</refsect1>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<!-- EN-Revision: bb66ce4d449049730d4967ce74fb68f15a138612 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto -->
<refentry xml:id="function.mb-split" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>mb_split</refname>
@@ -75,6 +75,7 @@
<simplelist>
<member><function>mb_regex_encoding</function></member>
<member><function>mb_ereg</function></member>
<member><function>explode</function></member>
</simplelist>
</para>
</refsect1>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5dd2d0f74e31b4fed751ea3bbed7b4a6b0469228 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<!-- EN-Revision: bb66ce4d449049730d4967ce74fb68f15a138612 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<refentry xml:id="function.mb-str-split" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>mb_str_split</refname>
@@ -90,6 +90,7 @@
<simplelist>
<member><function>str_split</function></member>
<member><function>grapheme_str_split</function></member>
<member><function>explode</function></member>
</simplelist>
</para>
</refsect1>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: leonardolara Status: ready --><!-- CREDITS: rogeriopradoj, marcosmarcolin, leonardolara -->
<!-- EN-Revision: 39b10b2e994f5a39f5face56c5e86ea8507a45a3 Maintainer: leonardolara Status: ready --><!-- CREDITS: rogeriopradoj, marcosmarcolin, leonardolara -->
<chapter xml:id="password.setup" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
@@ -8,9 +8,10 @@
&reftitle.required;
&no.requirement;
<para>
Para o hashing de senha Argon2, é necessário o uso do <link xlink:href="&url.libargon2;">libargon2</link>.
A partir do PHP 7.3.0, é necessário ter a versão 20161029 ou posterior do
libargon2.
Para o hashing de senha Argon2, é necessário o uso do
<link xlink:href="&url.libargon2;">libargon2</link> ou, a partir do
PHP 8.4.0, OpenSSL versão 3.2 ou superior. A partir do PHP 7.3.0, é necessário ter a versão
20161029 ou posterior do libargon2.
</para>
</section>
@@ -18,9 +19,11 @@
&reftitle.install;
&no.install;
<para>
Para habilitar o hash de senha Argon2, no entanto, o PHP deve ser compilado com suporte ao libargon2
utilizando a opção de configuração
<option role="configure">--with-password-argon2</option>.
No entanto, para habilitar o hash de senha Argon2, o PHP deve ser compilado com
suporte ao libargon2 utilizando a
opção de configuração <option role="configure">--with-password-argon2</option> ou
a partir do PHP 8.4.0, com o OpenSSL usando
<option role="configure">--with-openssl</option>.
</para>
<para>
Antes do PHP 8.1.0, era possível especificar o diretório argon2 com

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 41c8533ff5a8f93ba9fdf0732d05dd5ab79864c9 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: bb66ce4d449049730d4967ce74fb68f15a138612 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="function.preg-split" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>preg_split</refname>
@@ -228,7 +228,7 @@ Array
<simplelist>
<member><link linkend="pcre.pattern">Expressões Regulares PCRE</link></member>
<member><function>preg_quote</function></member>
<member><function>implode</function></member>
<member><function>explode</function></member>
<member><function>preg_match</function></member>
<member><function>preg_match_all</function></member>
<member><function>preg_replace</function></member>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3cbeca5d54a188b1b1b0dd2956f575ec0be986fe Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,leonardolara -->
<!-- EN-Revision: b2a7a5fab7231fa8634096f111ae0fa0dc60bcfe Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,leonardolara -->
<section xml:id="ref.pdo-mysql.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&pdo.driver-constants;
@@ -207,6 +207,7 @@
<listitem>
<simpara>
&Alias; <constant>Pdo\Mysql::ATTR_SSL_VERIFY_SERVER_CERT</constant>.
Disponível a partir do PHP 7.0.18 e PHP 7.1.4.
</simpara>
</listitem>
</varlistentry>