Skip to content

Sync with en rev #813

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
leonardolara merged 2 commits into from
Nov 11, 2026
+176 −53
Merged

Sync with en rev #813

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3557a73
Sync with en rev
leonardolara Nov 11, 2026
594ae2b
fix para tags
leonardolara Nov 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 32 additions & 1 deletion reference/classobj/functions/class-exists.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 42bd1bfed391b287e55e47fed1b8f8d22a033ee0 Maintainer: felipe Status: ready --><!-- CREDITS: surfmax, adiel, leonardolara -->
<!-- EN-Revision: dae065a26aa3bb4223fcc0989d51147047e6fa02 Maintainer: leonardolara Status: ready --><!-- CREDITS: surfmax, adiel, leonardolara, felipe -->
<refentry xml:id="function.class-exists" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>class_exists</refname>
Expand Down Expand Up @@ -47,6 +47,37 @@
caso contrário retorna &false;.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<simpara>
Se <parameter>autoload</parameter> for &true; e a classe carregada automaticamente
precisa de uma classe pai, uma interface ou um trait que não pode ser
encontrado, mesmo após o carregamento automático, um <exceptionname>Error</exceptionname>
é lançado em vez de retornar &false;.
</simpara>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Um trait ausente agora lança um <exceptionname>Error</exceptionname>
em vez de gerar um <constant>E_ERROR</constant> fatal.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down
22 changes: 17 additions & 5 deletions reference/zlib/functions/deflate_add.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e8ac70bf549a723cb36465667a6109d9933b8619 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<!-- EN-Revision: 47ea59c86c44c54034c322b6b16b41a5d9865c44 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<refentry xml:id="function.deflate-add" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>deflate_add</refname>
Expand Down Expand Up @@ -67,10 +67,14 @@

<refsect1 role="errors"><!-- {{{ -->
&reftitle.errors;
<para>
Se argumentos inválidos forem fornecidos, um erro de nível
<constant>E_WARNING</constant> é gerado.
</para>
<simpara>
Lança um <exceptionname>ValueError</exceptionname> se <parameter>flush_mode</parameter>
não for uma das constantes listadas acima.
</simpara>
<simpara>
Se os dados não puderem ser comprimidos, um <constant>E_WARNING</constant> é gerado
e &false; é retornado.
</simpara>
</refsect1><!-- }}} -->

<refsect1 role="changelog">
Expand All @@ -84,6 +88,14 @@
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Agora lança um <exceptionname>ValueError</exceptionname> se <parameter>flush_mode</parameter>
for inválido. Anteriormente, um <constant>E_WARNING</constant> era gerado
e &false; era retornado.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Expand Down
39 changes: 29 additions & 10 deletions reference/zlib/functions/deflate_init.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: aa120f36c5762e99f9ee121d8caf910e0a67121e Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<!-- EN-Revision: 47ea59c86c44c54034c322b6b16b41a5d9865c44 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<refentry xml:id="function.deflate-init" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>deflate_init</refname>
Expand Down Expand Up @@ -106,19 +106,29 @@

<refsect1 role="returnvalues"><!-- {{{ -->
&reftitle.returnvalues;
<para>
Retorna um recurso de contexto de compressão (<literal>zlib.deflate</literal>) em
caso de sucesso, &return.falseforfailure;.
</para>
<simpara>
Retorna uma instância de <classname>DeflateContext</classname> em caso de sucesso,
&return.falseforfailure;.
</simpara>
</refsect1><!-- }}} -->

<refsect1 role="errors"><!-- {{{ -->
&reftitle.errors;
<para>
Se uma opção inválida for passada para <parameter>options</parameter> ou o
contexto não puder ser criado, um erro de nível <constant>E_WARNING</constant>
é gerado.
</para>
<simpara>
Lança um <exceptionname>ValueError</exceptionname> se <parameter>encoding</parameter>
for inválido, se a opção <literal>level</literal>, <literal>memory</literal>,
<literal>window</literal> ou <literal>strategy</literal> estiver fora do intervalo,
or se a opção <literal>dictionary</literal> for um <type>array</type>
que contém uma string vazia ou uma string com bytes nulos.
</simpara>
<simpara>
Lança um <exceptionname>TypeError</exceptionname> se a opção <literal>dictionary</literal>
não for um <type>string</type> nem um <type>array</type>.
</simpara>
<simpara>
Se o contexto não puder ser criado, um <constant>E_WARNING</constant> é emitido
e &false; é retornado.
</simpara>
</refsect1><!-- }}} -->

<refsect1 role="changelog">
Expand All @@ -132,6 +142,15 @@
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Agora lança um <exceptionname>ValueError</exceptionname> ou um
<exceptionname>TypeError</exceptionname> para uma opção ou um <parameter>encoding</parameter>
inválidos. Anteriormente, um <constant>E_WARNING</constant> era emitido
e &false; era retornado.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Expand Down
39 changes: 33 additions & 6 deletions reference/zlib/functions/gzinflate.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b9d23bbb94e5e0b71c3f4a8c12f3671f64516370 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<!-- EN-Revision: 47ea59c86c44c54034c322b6b16b41a5d9865c44 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<refentry xml:id="function.gzinflate" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>gzinflate</refname>
Expand Down Expand Up @@ -44,11 +44,38 @@
<para>
Os dados não comprimidos originais ou &false; em caso de erro.
</para>
<para>
A função retornará um erro se o tamanho dos dados não comprimidos for maior que
32.768 vezes o comprimento da entrada comprimida <parameter>data</parameter>
ou, a menos que <parameter>max_length</parameter> seja <literal>0</literal>, se for maior que o parâmetro opcional <parameter>max_length</parameter>.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lança um <exceptionname>ValueError</exceptionname> se <parameter>max_length</parameter>
for negativo. Se <parameter>data</parameter> não for um dado comprimido válido, ou se os
dados não comprimidos forem muito grandes para <parameter>max_length</parameter> quando não for
<literal>0</literal>, um <constant>E_WARNING</constant> é gerado e &false; é retornado.
</simpara>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Agora lança um <exceptionname>ValueError</exceptionname> se <parameter>max_length</parameter>
for negativo. Anteriormente, um <constant>E_WARNING</constant> era gerado
e &false; era retornado.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
Expand Down
11 changes: 6 additions & 5 deletions reference/zlib/functions/gzpassthru.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 15352977cfdac48a100c50b85674b8e31b8d0abc Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<!-- EN-Revision: 47ea59c86c44c54034c322b6b16b41a5d9865c44 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<refentry xml:id="function.gzpassthru" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>gzpassthru</refname>
Expand Down Expand Up @@ -51,10 +51,11 @@
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
O número de caracteres não comprimidos lidos de <parameter>gz</parameter>
e passados para a entrada.
</para>
<simpara>
O número de caracteres não comprimidos lidos de <parameter>stream</parameter>
e passados para a saída, ou <literal>-1</literal> se <parameter>stream</parameter>
não puder ser lido, por exemplo, porque foi aberto para escrita.
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
Expand Down
39 changes: 33 additions & 6 deletions reference/zlib/functions/gzuncompress.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 02ba67b51f2bde571b6ce07026e935f4e81019af Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<!-- EN-Revision: 47ea59c86c44c54034c322b6b16b41a5d9865c44 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<refentry xml:id="function.gzuncompress" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>gzuncompress</refname>
Expand Down Expand Up @@ -44,11 +44,38 @@
<para>
Os dados descomprimidos originais ou &false; em caso de erro.
</para>
<para>
A função retornará um erro se os dados descomprimidos forem mais do que
32768 vezes o comprimento dos dados comprimidos de entrada <parameter>data</parameter>
ou mais do que o parâmetro opcional <parameter>max_length</parameter>.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lança um <exceptionname>ValueError</exceptionname> se <parameter>max_length</parameter>
for negativo. Se <parameter>data</parameter> não for um dado comprimido válido, ou se os
dados não comprimidos forem muito grandes para <parameter>max_length</parameter> quando não for
<literal>0</literal>, um <constant>E_WARNING</constant> é gerado e &false; é retornado.
</simpara>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Agora lança um <exceptionname>ValueError</exceptionname> se <parameter>max_length</parameter>
for negativo. Anteriormente, um <constant>E_WARNING</constant> era gerado
e &false; era retornado.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
Expand Down
25 changes: 12 additions & 13 deletions reference/zlib/functions/inflate-get-read-len.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<!-- EN-Revision: 47ea59c86c44c54034c322b6b16b41a5d9865c44 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<refentry xml:id="function.inflate-get-read-len" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>inflate_get_read_len</refname>
Expand All @@ -12,12 +12,11 @@
<type>int</type><methodname>inflate_get_read_len</methodname>
<methodparam><type>InflateContext</type><parameter>context</parameter></methodparam>
</methodsynopsis>
<para>

</para>

&warn.undocumented.func;

<simpara>
Retorna o número de bytes comprimidos lidos até o momento do fluxo atual.
A contagem é redefinida para <literal>0</literal> pela primeira chamada de
<function>inflate_add</function> após o término do fluxo anterior.
</simpara>
</refsect1>

<refsect1 role="parameters">
Expand All @@ -26,19 +25,19 @@
<varlistentry>
<term><parameter>context</parameter></term>
<listitem>
<para>

</para>
<simpara>
Um contexto criado com <function>inflate_init</function>.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retorna o número de bytes lidos até o momento&return.falseforfailure;.
</para>
<simpara>
Retorna o número de bytes lidos até o momento do fluxo atual.
</simpara>
</refsect1>

<refsect1 role="changelog">
Expand Down
21 changes: 14 additions & 7 deletions reference/zlib/functions/zlib-get-coding-type.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 435885e2f78afd591a0b201a3bb7e8c8d1260165 Maintainer: ae Status: ready --><!-- CREDITS: fernandoc,felipe,ae -->
<!-- EN-Revision: 47ea59c86c44c54034c322b6b16b41a5d9865c44 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,felipe,ae,leonardolara -->
<refentry xml:id="function.zlib-get-coding-type" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>zlib_get_coding_type</refname>
Expand All @@ -12,9 +12,13 @@
<type class="union"><type>string</type><type>false</type></type><methodname>zlib_get_coding_type</methodname>
<void/>
</methodsynopsis>
<para>
<simpara>
Retorna o tipo de codificação para a compressão de saída.
</para>
Ele é escolhido a partir do cabeçalho de requisição <literal>Accept-Encoding</literal>:
quando <link linkend="ini.zlib.output-compression">zlib.output_compression</link>
está ativado (no início da requisição ou com <function>ini_set</function>), ou
na primeira vez que <function>ob_gzhandler</function> é executado.
</simpara>
</refsect1>

<refsect1 role="parameters">
Expand All @@ -24,10 +28,13 @@

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Possíveis valores de retorno são <literal>gzip</literal>, <literal>deflate</literal>,
ou &false;.
</para>
<simpara>
Retorna <literal>"gzip"</literal> se o cabeçalho de requisição <literal>Accept-Encoding</literal>
contiver <literal>gzip</literal>, caso contrário
<literal>"deflate"</literal> se contiver <literal>deflate</literal>.
Retorna &false; se nenhum tipo de codificação tiver sido escolhido ainda, por exemplo porque
a compressão de saída não está ativada ou o cabeçalho não contém nenhum dos dois.
</simpara>
</refsect1>

<refsect1 role="seealso">
Expand Down
Loading