php/archived-doc-pt-br
1
0
Fork 0
mirror of https://github.com/php/doc-pt_br.git synced 2026-03-23 22:52:12 +01:00
Code Issues Packages Projects Releases Wiki Activity

sync with en rev

Browse Source
This commit is contained in:
leonardolara
2024-11-22 13:56:25 -03:00
parent 0e8f33b903
commit 790f8717b9
25 changed files with 439 additions and 128 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
appendices/migration80/incompatible.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: ae Status: ready --><!-- CREDITS: geekcom,adiel,lhsazevedo,atomotavio,ae,leonardolara -->
<!-- EN-Revision: b94d63fc0884d83ba43433ab33cc4810d955bf6d Maintainer: ae Status: ready --><!-- CREDITS: geekcom,adiel,lhsazevedo,atomotavio,ae,leonardolara -->
<sect1 xml:id="migration80.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Alterações incompatíveis com versões anteriores</title>
@@ -1645,7 +1645,7 @@ echo file_get_contents('http://example.org', false, $ctx);
<title>XMLReader</title>
<para>
<methodname>XMLReader::open</methodname> e <methodname>XMLReader::xml</methodname> agora são
<methodname>XMLReader::open</methodname> e <methodname>XMLReader::XML</methodname> agora são
métodos estáticos. Eles ainda podem ser chamados como métodos de instância, mas classes herdadas precisam declará-los
como estáticos se elas sobrescrevem esses métodos.
</para>

7
reference/dom/constants.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f44eff3695dbe664b4acf5d32e1643fe6448b51c Maintainer: leonardolara Status: ready --><!-- CREDITS: marabesi,leonardolara -->
<!-- EN-Revision: 38d0723a6e865c163527b252afbca7fc91ac473d Maintainer: leonardolara Status: ready --><!-- CREDITS: marabesi,leonardolara -->
<chapter xml:id="dom.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
@@ -259,7 +259,10 @@
</entry>
<entry>0</entry>
<entry>
Código não pertencente á especificação DOM. Significativa apenas para erros do PHP
Código não pertencente à especificação DOM. Significativa apenas para erros do PHP.
Descontinuada a partir do PHP 8.4.0 por não ser mais usada.
Antes do PHP 8.4.0, era inconsistentemente usada para indicar
situações de falta de memória.
</entry>
</row>
<row xml:id="constant.dom-index-size-err">

24
reference/dom/domdocument.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 0217f85ed26dc9511fb6b44e87d82f4b77adafa1 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<!-- EN-Revision: 38d0723a6e865c163527b252afbca7fc91ac473d Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<reference xml:id="class.domdocument" 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 classe DOMDocument</title>
<titleabbrev>DOMDocument</titleabbrev>
@@ -186,8 +186,8 @@
<term><varname>actualEncoding</varname></term>
<listitem>
<para>
<emphasis>Descontinuado</emphasis>.Codificação real do documento,
é uma leitura apenas equivalente a
<emphasis>Descontinuado a partir do PHP 8.4.0</emphasis>.
Codificação real do documento, é uma equivalente somente-leitura de
<varname linkend="domdocument.props.encoding">encoding</varname>.
</para>
</listitem>
@@ -202,7 +202,8 @@
<term><varname>config</varname></term>
<listitem>
<para>
<emphasis>Descontinuado</emphasis>. Configuração usando quando
<emphasis>Descontinuado a partir do PHP 8.4.0</emphasis>.
Configuração usada quando
<function>DOMDocument::normalizeDocument</function> é
invocada.
</para>
@@ -321,8 +322,8 @@
<term><varname>substituteEntities</varname></term>
<listitem>
<para>
<emphasis>Proprietário</emphasis>. Se deve ou não substituir
entidades. Este atributo não faz parte da
<emphasis>Proprietário</emphasis>. Informa de entidades devem ou não
ser subtituídas. Este atributo não faz parte da
especificação DOM e é específico para o libxml. Padrão é &false;.
</para>
<caution>
@@ -399,11 +400,18 @@
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
<varname>actualEncoding</varname> e
<varname>config</varname> agora estão formalmente descontinuados.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<classname>DOMDocument</classname> implements
<interfacename>DOMParentNode</interfacename> now.
<classname>DOMDocument</classname> agora implementa
<interfacename>DOMParentNode</interfacename>.
</entry>
</row>
<row>

43
reference/dom/domentity.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<!-- EN-Revision: 38d0723a6e865c163527b252afbca7fc91ac473d Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<reference xml:id="class.domentity" 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 classe DOMEntity</title>
<titleabbrev>DOMEntity</titleabbrev>
@@ -119,10 +119,8 @@
<term><varname>actualEncoding</varname></term>
<listitem>
<para>
Um atributo que especifica a codificação usada para esta entidade no
momento da análise, quando é uma entidade analisada externa. Isso é
&null; se for uma entidade do subconjunto interno ou se não for
conhecido.
<emphasis>Descontinuada a partir do PHP 8.4.0</emphasis>.
Sempre foi igual a &null;.
</para>
</listitem>
</varlistentry>
@@ -130,9 +128,8 @@
<term><varname>encoding</varname></term>
<listitem>
<para>
Um atributo que especifica, como parte da declaração de texto, a
codificação desta entidade, quando é uma entidade analisada externa. Isso
é &null; caso contrário.
<emphasis>Descontinuada a partir do PHP 8.4.0</emphasis>.
Sempre foi igual a &null;.
</para>
</listitem>
</varlistentry>
@@ -140,9 +137,8 @@
<term><varname>version</varname></term>
<listitem>
<para>
Um atributo que especifica, como parte da declaração de texto, o
número da versão desta entidade, quando é uma entidade analisada
externa. Isso é &null; caso contrário.
<emphasis>Descontinuada a partir do PHP 8.4.0</emphasis>.
Sempre foi igual a &null;.
</para>
</listitem>
</varlistentry>
@@ -150,6 +146,31 @@
</section>
<!-- }}} -->
<section role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
<varname>actualEncoding</varname>,
<varname>encoding</varname> e
<varname>version</varname> agora estão formalmente descontinuadas porque sempre
foram iguais a &null;.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>
<!-- {{{ See also -->
<!--
<section role="seealso">

29
reference/dom/domnode.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f1516b33abc82b59d0b8a52b973d64f4857939cc Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<!-- EN-Revision: 4b6c8a5a9469b5c02585618d5a6e0774ca37530f Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<reference xml:id="class.domnode" 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 classe DOMNode</title>
<titleabbrev>DOMNode</titleabbrev>
@@ -404,6 +404,33 @@
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
O método <methodname>DOMNode::compareDocumentPosition</methodname> foi
adicionado.
</entry>
</row>
<row>
<entry>8.4.0</entry>
<entry>
As constantes <constant>DOMNode::DOCUMENT_POSITION_DISCONNECTED</constant>,
<constant>DOMNode::DOCUMENT_POSITION_PRECEDING</constant>,
<constant>DOMNode::DOCUMENT_POSITION_FOLLOWING</constant>,
<constant>DOMNode::DOCUMENT_POSITION_CONTAINS</constant>,
<constant>DOMNode::DOCUMENT_POSITION_CONTAINED_BY</constant>
e
<constant>DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC</constant>
foram adicionadas.
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>
Os métodos <methodname>DOMNode::contains</methodname> e
<methodname>DOMNode::isEqualNode</methodname> foram adicionados.
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>

71
reference/dom/domxpath/registerphpfunctions.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<!-- EN-Revision: 2bd9a67c8c6c5961189f868364837a5c3ba7e063 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<refentry xml:id="domxpath.registerphpfunctions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>DOMXPath::registerPhpFunctions</refname>
@@ -29,8 +29,11 @@
Use este parâmetro para permitir apenas que certas funções sejam chamadas do XPath.
</para>
<para>
Este parâmetro pode ser uma <type>string</type> (um nome de função) ou
um <type>array</type> de nomes de função.
Este parâmetro pode ser um dos seguintes:
uma <type>string</type> (um nome de função),
um <type>array</type> indexado de nomes de funções
ou um <type>array</type> associativo com chaves nos nomes de funções
e valores associados sendo do tipo <type>callable</type>.
</para>
</listitem>
</varlistentry>
@@ -45,6 +48,30 @@
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Agora é possível usar <type>callable</type>s para funções de retorno
ao usar <parameter>restrict</parameter> com entradas de
<type>array</type>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -144,6 +171,43 @@ foreach ($books as $book) {
echo $book->getElementsByTagName("title")->item(0)->nodeValue . "\n";
}
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Books with multiple authors:
PHP Basics
]]>
</screen>
</example>
</para>
<para>
<example>
<title><methodname>DOMXPath::registerPHPFunctions</methodname> com um <type>callable</type></title>
<programlisting role="php">
<![CDATA[
<?php
$doc = new DOMDocument;
$doc->load('book.xml');
$xpath = new DOMXPath($doc);
// Registra o namespace php: (necessário)
$xpath->registerNamespace("php", "http://php.net/xpath");
// Registra funções PHP (somente has_multiple)
$xpath->registerPHPFunctions(["has_multiple" => fn ($nodes) => count($nodes) > 1]);
// Filtra livros com múltiplos autores
$books = $xpath->query('//book[php:function("has_multiple", author)]');
echo "Livros com múltiplos autores:\n";
foreach ($books as $book) {
echo $book->getElementsByTagName("title")->item(0)->nodeValue . "\n";
}
?>
]]>
</programlisting>
@@ -165,6 +229,7 @@ PHP Basics
<member><methodname>DOMXPath::registerNamespace</methodname></member>
<member><methodname>DOMXPath::query</methodname></member>
<member><methodname>DOMXPath::evaluate</methodname></member>
<member><methodname>XSLTProcessor::registerPHPFunctions</methodname></member>
</simplelist>
</para>
</refsect1>

15
reference/imap/book.xml
View File

@@ -1,16 +1,20 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 34892f82742329af7e7b4b22be6ad21418fd9768 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<!-- State: deprecated -->
<book xml:id="book.imap" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="bundledexternal" ?>
<?phpdoc extension-membership="pecl" ?>
<title>IMAP, POP3 e NNTP</title>
<titleabbrev>IMAP</titleabbrev>
<!-- {{{ preface -->
<preface xml:id="intro.imap">
&reftitle.intro;
<warning>
<simpara>
Esta extesão foi <emphasis>DESCONTINUADA</emphasis> e <emphasis>DESAGREGADA</emphasis> a partir do PHP 8.4.0.
</simpara>
</warning>
<para>
Essas funções permitem que você opere com o protocolo <acronym>IMAP</acronym>,
Essas funções permitem operações com o protocolo <acronym>IMAP</acronym>,
bem como com os métodos de acesso <acronym>NNTP</acronym>, <acronym>POP3</acronym>
e caixa de correio local.
</para>
@@ -32,7 +36,6 @@
&reference.imap.imap.connection;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

67
reference/imap/configure.xml
View File

@@ -1,36 +1,49 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: fc870e6f972ed48069f4c7a5a449c2e843f343a7 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<section xml:id="imap.installation" xmlns="http://docbook.org/ns/docbook">
<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<section xml:id="imap.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.install;
<para>
Para fazer essas funções funcionarem, você precisa compilar o PHP com
<option role="configure">--with-imap[=DIR]</option>, onde DIR é o
prefixo de instalação c-client. Do nosso exemplo acima, você usaria
<option role="configure">--with-imap=/usr/local/imap-2000b</option>.
Este local depende de onde você criou este diretório de acordo com a
descrição acima. Usuários do <productname>Windows</productname> podem incluir a
DLL <filename>php_imap.dll</filename> no &php.ini;.
</para>
<note>
<simpara>
Dependendo de como o c-client foi configurado, talvez você também precise
adicionar <option
role="configure">--with-imap-ssl=/path/to/openssl/</option> e/ou
<option role="configure">--with-kerberos=/path/to/kerberos</option>
à linha de configuração do PHP.
</simpara>
</note>
<section xml:id="imap.installation.php84">
<title>PHP 8.4</title>
<para>
&pecl.moved-ver;8.4.0
</para>
<para>
&pecl.info;
<link xlink:href="&url.pecl.package;imap">&url.pecl.package;imap</link>.
</para>
</section>
<warning>
<simpara>
A extensão IMAP não é segura para threads; ela não deve ser usada com compilações ZTS.
</simpara>
</warning>
<section xml:id="imap.installation.phplt84">
<title>PHP &lt; 8.4</title>
<para>
Para fazer estas funções funcionarem, é necessário compilar o PHP com
<option role="configure">--with-imap[=DIR]</option>, onde DIR é o
prefixo de instalação c-client. Do exemplo acima, seria usada a opção
<option role="configure">--with-imap=/usr/local/imap-2000b</option>.
Este local depende de onde este diretório foi criado de acordo com a
descrição acima. Usuários do <productname>Windows</productname> podem incluir a
DLL <filename>php_imap.dll</filename> no &php.ini;.
</para>
<note>
<simpara>
Dependendo de como o c-client foi configurado, talvez também seja necessário
adicionar <option
role="configure">--with-imap-ssl=/path/to/openssl/</option> e/ou
<option role="configure">--with-kerberos=/path/to/kerberos</option>
à linha de configuração do PHP.
</simpara>
</note>
&warn.imaprecodeyaz;
<warning>
<simpara>
A extensão IMAP não é segura para threads; ela não deve ser usada com compilações ZTS.
</simpara>
</warning>
&warn.imaprecodeyaz;
</section>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

9
reference/oci8/book.xml
View File

@@ -1,14 +1,19 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: b9e6268918813e27972c644897970b0cdbc6f86e Maintainer: ae Status: ready --><!-- CREDITS: felipe, ae -->
<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: ae Status: ready --><!-- CREDITS: felipe, ae, leonardolara -->
<book xml:id="book.oci8" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="bundledexternal" ?>
<?phpdoc extension-membership="pecl" ?>
<title>Oracle OCI8</title>
<titleabbrev>OCI8</titleabbrev>
<!-- {{{ preface -->
<preface xml:id="intro.oci8">
&reftitle.intro;
<warning>
<simpara>
Esta extensão foi <emphasis>DESAGREGADA</emphasis> a partir do PHP 8.4.0.
</simpara>
</warning>
<para>
Essas funções permitem acessar bancos de dados Oracle. Suportam instruções SQL
e PL/SQL. Recursos básicos incluem o controle de transações, vínculo de variáveis PHP

24
reference/outcontrol/functions/flush.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 91ab4f5f898023b0eed0e642e1482ac11f749d20 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 77ae3334a01188bfe7067cf01f1ef6cc19469da3 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.flush">
<refnamediv>
<refname>flush</refname>
@@ -54,6 +54,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>8.4.0</entry>
<entry>
Descarregar cabeçalhos sem um corpo agora terá sucesso no FastCGI.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>

6
reference/pcntl/book.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 508e255fff6c604c31d5617fe9ddf6d776a3b43d Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<!-- EN-Revision: ee8d203f9230b0496f6d69cc1237d9ca63475ad7 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<book xml:id="book.pcntl" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="bundled" ?>
@@ -42,10 +42,12 @@
&reference.pcntl.setup;
&reference.pcntl.constants;
&reference.pcntl.examples;
&reference.pcntl.qosclass;
&reference.pcntl.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

6
reference/pcntl/qosclass.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: cb0823d467ad823ee48a1a32ccd2a799e2ccb85c Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<reference xmlns="http://docbook.org/ns/docbook" xml:id="enum.roundingmode" role="enum">
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: ee8d203f9230b0496f6d69cc1237d9ca63475ad7 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<reference xmlns="http://docbook.org/ns/docbook" xml:id="enum.qosclass" role="enum">
<title>A Enumeração QosClass</title>
<titleabbrev>QosClass</titleabbrev>
@@ -12,7 +12,7 @@
</simpara>
</section>
<section xml:id="enum.roundingmode.synopsis">
<section xml:id="enum.qosclass.synopsis">
&reftitle.enumsynopsis;
<enumsynopsis>
<enumname>QosClass</enumname>

18
reference/pcre/pattern.modifiers.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 288ea761f5a8e7c685fe7f6fce2d7de0a87b31bd Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: c43393d1b64a41be1b8c45f997062b0f645bc91e Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<article xml:id="reference.pcre.pattern.modifiers" xmlns="http://docbook.org/ns/docbook">
<title>Modificadores de Expressão</title>
<titleabbrev>Possíveis modificadores em expressões regulares</titleabbrev>
@@ -187,6 +187,22 @@
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><emphasis>r</emphasis> (<literal>PCRE2_EXTRA_CASELESS_RESTRICT</literal>)</term>
<listitem>
<simpara>
Quando <emphasis>u</emphasis> (<literal>PCRE_UTF8</literal>) e <emphasis>i</emphasis> (<literal>PCRE_CASELESS</literal>)
estão ativos, este modificador evita correspondência entre caracteres ASCII e não-ASCII.
</simpara>
<simpara>
Por exemplo, <code>preg_match('/\x{212A}/iu', "K")</code> corresponde ao símbolo de Kelvin <literal>K</literal> (U+212A).
Quando <emphasis>u</emphasis> é usado (<code>preg_match('/\x{212A}/iur', "K")</code>), não há correspondência.
</simpara>
<simpara>
Disponível a partir do PHP 8.4.0.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</blockquote>
</para>

21
reference/pcre/pattern.syntax.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 77fe733a1ba9c961424adcb7c9af00c1f5443a77 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: c43393d1b64a41be1b8c45f997062b0f645bc91e Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- splitted from ./en/functions/pcre.xml, last change in rev 1.2 -->
<chapter xml:id="reference.pcre.pattern.syntax" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Sintaxe de Expressões</title>
@@ -1573,12 +1573,23 @@
<literal>\d{8}</literal>
corresponde a exatamente 8 dígitos. Uma chave de abertura que
corresponde a exatamente 8 dígitos.
</para>
<simpara>
Antes do PHP 8.4.0, uma chave de abertura que
aparece em uma posição onde um quantificador não é permitido, ou
que não corresponda à sintaxe de um quantificador, é considerada
como um caractere literal, Por exemplo, {,6} não é um quantificador,
mas uma string literal de quatro caracteres.
</para>
como um caractere literal, Por exemplo, <literal>{,6}</literal>
não é um quantificador, mas uma string literal de quatro caracteres.
A partir do 8.4.0, a extensão PCRE é incluída com o PCRE2 versão 10.44,
que permite expressões como <literal>\d{,8}</literal> e elas são
interpretadas como <literal>\d{0,8}</literal>.
Além disso, a partir do PHP 8.4.0, caracteres de espaço em torno de quantificadores como em
<literal>\d{0 , 8}</literal> e <literal>\d{ 0 , 8 }</literal> são permitidos.
</simpara>
<para>
O quantificador {0} é permitido, fazendo com que a expressão se
comporte como se o item anterior e o quantificador não estivessem

48
reference/pdo_oci/configure.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 537e6eeb269cf03277df4c947fccf8e2a8d944bf Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: leonardolara Status: ready -->
<section xml:id="ref.pdo-oci.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.install;
<para>
@@ -9,19 +9,33 @@
<link xlink:href="&url.oracle.instant.client;">Oracle Instant Client</link>.
Para obter detalhes, consulte a seção <link linkend="oci8.requirements">Requisitos do OCI8</link>.
</para>
<para>
Use <option role="configure">--with-pdo-oci[=DIR]</option> para instalar
a extensão PDO Oracle OCI, onde o <literal>[=DIR]</literal> opcional
é o diretório base do Oracle. O padrão de <literal>[=DIR]</literal> é a variável
de ambiente <varname>$ORACLE_HOME</varname>.
</para>
<para>
Use <option role="configure">--with-pdo-oci=instantclient,prefix,version</option>
para um <acronym>SDK</acronym> do Oracle Instant Client, onde o prefixo e
a versão são configurados.
</para>
<para>
<screen>
<section xml:id="pdo-oci.installation.php84">
<title>PHP 8.4</title>
<para>
&pecl.moved-ver;8.4.0
</para>
<para>
&pecl.info;
<link xlink:href="&url.pecl.package;PDO_OCI">&url.pecl.package;PDO_OCI</link>.
</para>
</section>
<section xml:id="pdo-oci.installation.phplt84">
<title>PHP &lt; 8.4</title>
<para>
Use <option role="configure">--with-pdo-oci[=DIR]</option> para instalar
a extensão PDO Oracle OCI, onde o <literal>[=DIR]</literal> opcional
é o diretório base do Oracle. O padrão de <literal>[=DIR]</literal> é a variável
de ambiente <varname>$ORACLE_HOME</varname>.
</para>
<para>
Use <option role="configure">--with-pdo-oci=instantclient,prefix,version</option>
para um <acronym>SDK</acronym> do Oracle Instant Client, onde o prefixo e
a versão são configurados.
</para>
<para>
<screen>
<![CDATA[
// Usando $ORACLE_HOME
$ ./configure --with-pdo-oci
@@ -29,10 +43,10 @@ $ ./configure --with-pdo-oci
// Usando OIC para Linux com RPMs 10.2.0.3 e prefixo /usr
$ ./configure --with-pdo-oci=instantclient,/usr,10.2.0.3
]]>
</screen>
</para>
</screen>
</para>
</section>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

18
reference/pgsql/constants.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 63916fd88a875a56045117e2a60c723bc8e2ee19 Maintainer: leonardolara Status: ready --><!-- CREDITS: lucasr,felipe,leonardolara -->
<!-- EN-Revision: 3c6c95fcfd7d9eaa603df40327693ea8dff89d53 Maintainer: leonardolara Status: ready --><!-- CREDITS: lucasr,felipe,leonardolara -->
<appendix xml:id="pgsql.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
@@ -251,6 +251,22 @@
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-tuples-chunk">
<term>
<constant>PGSQL_TUPLES_CHUNK</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Returnada por <function>pg_result_status</function>.
Indica o término bem sucedido de um comando que retorna dados em modo fragmentado.
Returnada para instruções <literal>SELECT</literal> quando
<function>pg_set_chunked_rows_size</function> está definida.
O conjunto de resultados é dividido em múltiplos fragmentos, cada um contendo um número predefinido de linhas.
Disponível a partir do PHP 8.4.0 e libpq 17.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pgsql-copy-out">
<term>
<constant>PGSQL_COPY_OUT</constant>

4
reference/pgsql/functions/pg-result-status.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<!-- EN-Revision: 3c6c95fcfd7d9eaa603df40327693ea8dff89d53 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.58 -->
<refentry xml:id="function.pg-result-status" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -51,7 +51,7 @@
&reftitle.returnvalues;
<para>
Os possíveis valores de retorno são <constant>PGSQL_EMPTY_QUERY</constant>,
<constant>PGSQL_COMMAND_OK</constant>, <constant>PGSQL_TUPLES_OK</constant>, <constant>PGSQL_COPY_OUT</constant>,
<constant>PGSQL_COMMAND_OK</constant>, <constant>PGSQL_TUPLES_OK</constant>, <constant>PGSQL_TUPLES_CHUNK</constant>, <constant>PGSQL_COPY_OUT</constant>,
<constant>PGSQL_COPY_IN</constant>, <constant>PGSQL_BAD_RESPONSE</constant>, <constant>PGSQL_NONFATAL_ERROR</constant> e
<constant>PGSQL_FATAL_ERROR</constant> se <constant>PGSQL_STATUS_LONG</constant> for
especificado. Caso contrário, uma <type>string</type> contendo a etiqueta de comando do PostgreSQL será retornada.

11
reference/pspell/book.xml
View File

@@ -1,13 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 81b23db050ac0627b056585c16bfe95445ae174e Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<book xml:id="book.pspell" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="bundledexternal" ?>
<?phpdoc extension-membership="pecl" ?>
<title>Pspell</title>
<!-- {{{ preface -->
<preface xml:id="intro.pspell">
&reftitle.intro;
<warning>
<simpara>
Esta extensão foi <emphasis>DESCONTINUADA</emphasis> e <emphasis>DESAGREGADA</emphasis> a partir do PHP 8.4.0.
</simpara>
</warning>
<para>
Essas funções permitem verificar a ortografia de uma palavra e oferecer
sugestões.
@@ -22,7 +26,6 @@
&reference.pspell.pspell.config;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

42
reference/pspell/configure.xml
View File

@@ -1,25 +1,37 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b824e2b1086e94a1077bd071964547283616030a Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<section xml:id="pspell.installation" xmlns="http://docbook.org/ns/docbook">
<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<section xml:id="pspell.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.install;
<para>
Se você tiver as bibliotecas necessárias, adicione a opção
<option role="configure">--with-pspell[=dir]</option>
ao compilar o PHP.
</para>
<note>
<title>Nota para usuários Win32</title>
<section xml:id="pspell.installation.php84">
<title>PHP 8.4</title>
<para>
&ext.windows.path.dll;
<filename>aspell-15.dll</filename> da pasta
<filename>bin</filename> da instalação do aspell.
&pecl.moved-ver;8.4.0
</para>
<para>
O suporte Win32 requer pelo menos a versão 0.50 do aspell.
&pecl.info;
<link xlink:href="&url.pecl.package;pspell">&url.pecl.package;pspell</link>.
</para>
</note>
</section>
</section>
<section xml:id="pspell.installation.phplt84">
<title>PHP &lt; 8.4</title>
<para>
Para habilitar esta extensão, o PHP deve ser compilado com a opção
<option role="configure">--with-pspell[=dir]</option>.
</para>
<note>
<title>Nota para usuários Win32</title>
<para>
&ext.windows.path.dll;
<filename>aspell-15.dll</filename> da pasta
<filename>bin</filename> da instalação do aspell.
</para>
<para>
O suporte Win32 requer pelo menos a versão 0.50 do aspell.
</para>
</note>
</section>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

4
reference/random/book.xml
View File

@@ -1,5 +1,4 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 550b9c3c31a66c18c9303794c12260bf5c684fed Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<book xml:id="book.random" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="core" ?>
<title>Geradores de números aleatórios e funções relacionadas à aleatoriedade</title>
@@ -17,6 +16,7 @@
&reference.random.reference;
&reference.random.random.randomizer;
&reference.random.random.intervalboundary;
&reference.random.random.engine;
&reference.random.random.cryptosafeengine;

9
reference/sockets/functions/socket-create-listen.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e50e79746736dbdfbabe9bd3566793b3ddf38f58 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 0e097419a847a077c7d8a74ebc5237ba9d8ddc90 Maintainer: leonardolara Status: ready -->
<refentry xml:id="function.socket-create-listen" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>socket_create_listen</refname>
@@ -74,6 +74,13 @@
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
O valor padrão de backlog agora é <constant>SOMAXCONN</constant>.
Anteriormente era <literal>128</literal>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>

3
reference/spl/splfileobject/fgetcsv.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 73007ad9889ca2a3d85b0a710b55deb44ac370cc Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<!-- EN-Revision: f1eb91d07d2df082384b3f83c9d2a0dc1e439d32 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<refentry xml:id="splfileobject.fgetcsv" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<refnamediv>
<refname>SplFileObject::fgetcsv</refname>
@@ -51,7 +51,6 @@
<listitem>
<para>
O caractere de escape (no máximo um caractere de um byte).
O caractere de delimitação do campo (apenas um caractere de um byte).
Padrão é uma barra invertida (<literal>\</literal>) ou o valor definido por uma chamada anterior a
<methodname>SplFileObject::setCsvControl</methodname>.
Uma string vazia (<literal>""</literal>) desativa o mecanismo de escape proprietário.

34
reference/stream/functions/stream-context-set-option.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7aa6a0cc6631fc1c67a24e3ede9db849e420a4e5 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: d5859815063bb6d3a0953c773920ce7425cf912e Maintainer: leonardolara Status: ready -->
<refentry xml:id="function.stream-context-set-option" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>stream_context_set_option</refname>
@@ -15,14 +15,18 @@
<methodparam><type>string</type><parameter>option</parameter></methodparam>
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
</methodsynopsis>
<para>
A assinatura alternativa a seguir foi descontinuada a partir do PHP 8.4.0,
use <function>stream_context_set_options</function> em seu lugar.
<methodsynopsis>
<type>bool</type><methodname>stream_context_set_option</methodname>
<methodparam><type>resource</type><parameter>stream_or_context</parameter></methodparam>
<methodparam><type>array</type><parameter>options</parameter></methodparam>
</methodsynopsis>
</para>
<simpara>
Define uma opção para o contexto especificado. <parameter>value</parameter>
é definido para <parameter>option</parameter> para o parâmetro <parameter>wrapper</parameter> (empacotador).
Define uma opção para o contexto especificado. <parameter>value</parameter>
é definido para <parameter>option</parameter> para o parâmetro <parameter>wrapper</parameter> (empacotador).
</simpara>
</refsect1>
@@ -94,8 +98,30 @@
</para>
</refsect1><!-- }}} -->
</refentry>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
A assinatura alternativa de 2 parâmetros agora foi descontinuada.
Use <function>stream_context_set_options</function> em seu lugar.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

43
reference/xsl/xsltprocessor/registerphpfunctions.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1d574504ad4c2a183f6f858694b35168af23de46 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe, adiel, leonardolara -->
<!-- EN-Revision: 2bd9a67c8c6c5961189f868364837a5c3ba7e063 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe, adiel, leonardolara -->
<refentry xml:id="xsltprocessor.registerphpfunctions" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>XSLTProcessor::registerPHPFunctions</refname>
@@ -28,20 +28,49 @@
XSLT.
</para>
<para>
Este parâmetro pode ser uma string (nome de função) ou um array de
funções.
Este parâmetro pode ser um dos seguintes:
uma <type>string</type> (um nome de função),
um <type>array</type> indexado de nomes de funções
ou um <type>array</type> associativo com chaves nos nomes de funções
e valores associados sendo do tipo <type>callable</type>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.void;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.4.0</entry>
<entry>
Agora é possível usar <type>callable</type>s para funções de retorno
ao usar <parameter>restrict</parameter> com entradas de
<type>array</type>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -92,6 +121,14 @@ echo $proc->transformToXML($xmldoc);
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><methodname>DOMXPath::registerPhpFunctions</methodname></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:

7
reference/zlib/setup.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: a0ae28d3bc85f927c22649ebd9a590b921534b7d Maintainer: ae Status: ready --><!-- CREDITS: felipe, ae -->
<!-- EN-Revision: 6bb12514da39d010f2f0beb025dab9ec2459af51 Maintainer: ae Status: ready --><!-- CREDITS: felipe, ae, leonardolara -->
<chapter xml:id="zlib.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
@@ -9,8 +9,9 @@
&reftitle.required;
<para>
Este módulo usa as funções da <link xlink:href="&url.zlib;">zlib</link>
por Jean-loup Gailly e Mark Adler. Você terá que usar uma versão zlib
&gt;= 1.2.0.4 com este módulo.
por Jean-loup Gailly e Mark Adler.
A partir do PHP 8.4.0, a mínima versão da zlib requerida é is 1.2.11.
Antes do PHP 8.4.0, a mínima versão da zlib requerida era 1.2.0.4.
</para>
</section>
<!-- }}} -->