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:
Leonardo Lara Rodrigues
2026-03-06 13:51:29 -03:00
parent cdbb657509
commit 70a8e0d887
14 changed files with 151 additions and 129 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
appendices/migration85/incompatible.xml
View File

@@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: ec01a42be50e84f192c0b19fc6e9cf40a0f7ac31 Maintainer: leonardolara Status: ready -->
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: f81bbcf9d36c28bf067b5514cffdbc7663357cf3 Maintainer: leonardolara Status: ready -->
<sect1 xml:id="migration85.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Alterações Incompatíveis com Versões Anteriores</title>
@@ -332,9 +332,9 @@
<simpara>
Tentar chamar <methodname>PDOStatement::setFetchMode</methodname> durante
uma chamada para <methodname>PDO::fetch</methodname>,
<methodname>PDO::fetchObject</methodname>,
<methodname>PDO::fetchAll</methodname>, por exemplo, usando truques como
uma chamada para <methodname>PDOStatement::fetch</methodname>,
<methodname>PDOStatement::fetchObject</methodname>,
<methodname>PDOStatement::fetchAll</methodname>, por exemplo, usando truques como
passar o objeto de instrução como um argumento do construtor ao buscar em um
objeto, agora lançará um <exceptionname>Error</exceptionname>.
</simpara>
@@ -357,7 +357,7 @@
<simpara>
Agora, uma exceção <exceptionname>ValueError</exceptionname> é lançada se
<constant>PDO::FETCH_INTO</constant> for usada como modo de busca em
<methodname>PDO::fetchAll</methodname>,
<methodname>PDOStatement::fetchAll</methodname>,
similar a <constant>PDO::FETCH_LAZY</constant>.
</simpara>

28
appendices/transports.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1268a5eebbd09dbc4c4d5272c2bcdc0b035c256c Maintainer: ae Status: ready --><!-- CREDITS: vagnerstrapassongmail.com,duan.trabalhohotmail.com,narigone,ae -->
<!-- EN-Revision: ae90ecc9328f3abea16a9af69a5f18b24d530832 Maintainer: leonardolara Status: ready --><!-- CREDITS: narigone,ae,leonardolara -->
<appendix xml:id="transports" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Lista de Transportes via Soquete Suportados</title>
<para>
@@ -22,6 +22,13 @@
<literal>ssl://</literal>, <literal>tls://</literal>,
<literal>sslv2://</literal> &amp; <literal>sslv3://</literal>.
</simpara>
<note>
<simpara>
Os transportes <literal>sslv2://</literal> e <literal>sslv3://</literal>
são obsoletos e não devem ser usados. Eles estão documentados apenas
para compatibilidade com versões anteriores.
</simpara>
</note>
<note>
<simpara>
@@ -38,8 +45,6 @@
<listitem><simpara><literal>tcp://www.example.com</literal></simpara></listitem>
<listitem><simpara><literal>udp://www.example.com</literal></simpara></listitem>
<listitem><simpara><literal>ssl://www.example.com</literal></simpara></listitem>
<listitem><simpara><literal>sslv2://www.example.com</literal></simpara></listitem>
<listitem><simpara><literal>sslv3://www.example.com</literal></simpara></listitem>
<listitem><simpara><literal>tls://www.example.com</literal></simpara></listitem>
</itemizedlist>
@@ -78,11 +83,18 @@
</simpara>
<simpara>
<literal>ssl://</literal> tentará negociar uma conexão SSL V2
ou SSL V3, dependendo das capacidades e preferências do
host remoto. <literal>sslv2://</literal> e
<literal>sslv3://</literal> selecionará o protocolo de maneira
explícita.
<literal>ssl://</literal> tentará negociar uma conexão SSL/TLS segura
dependendo das capacidades e preferências do
host remoto e do cliente. Os protocolos reais que podem ser usados são
determinados pela configuração OpenSSL e pelas opções fornecidas
através da função <function>stream_context_create</function>, tal como
<literal>ssl.crypto_method</literal>.
</simpara>
<simpara>
Os protocolos SSLv2 e SSLv3 são obsoletos e inseguros. O uso deles é
fortemente desencorajado e eles não estão mais habilitados por padrão nas
versões modernas do PHP e do OpenSSL.
</simpara>
</section>

9
features/commandline.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 74ba8fee2972b6ba4f955392d760dea54e757a95 Maintainer: leonardolara Status: ready --><!-- CREDITS: ThamaraHessel,pauloelr,royopa,ae,geekcom,leonardolara -->
<!-- EN-Revision: 96b10a98853e3b8236504e5775f95eb4a15c82c3 Maintainer: leonardolara Status: ready --><!-- CREDITS: ThamaraHessel,pauloelr,royopa,ae,geekcom,leonardolara -->
<chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Usando PHP a partir da linha de comando</title>
<titleabbrev>Uso da linha de Comando</titleabbrev>
@@ -1755,6 +1755,13 @@ php >
<note>
<simpara>Este recurso não é suportado no Windows.</simpara>
</note>
<note>
<simpara>
Para informações sobre o uso e as opções do PHP em linha de comando, execute
<command>php --help</command> ou <command>man php</command>. Nem todas
as opções se aplicam quando o PHP está sendo executado como servidor web.
</simpara>
</note>
<warning>
<para>
Este recurso <emphasis>experimental</emphasis> <emphasis>não</emphasis>

96
features/http-auth.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bdf9a4e40204c805f2c2a5c94c2f2f8f5556195a Maintainer: ae Status: ready --><!-- CREDITS: rfoliveira,ae,leonardolara -->
<!-- EN-Revision: cd4180557a185469a64a7eb26f7be98d0a5f1ebb Maintainer: leonardolara Status: ready --><!-- CREDITS: rfoliveira,ae,leonardolara -->
<chapter xml:id="features.http-auth" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Autenticação HTTP com PHP</title>
@@ -29,8 +29,8 @@
<![CDATA[
<?php
if (!isset($_SERVER['PHP_AUTH_USER'])) {
header('HTTP/1.1 401 Unauthorized');
header('WWW-Authenticate: Basic realm="My Realm"');
header('HTTP/1.0 401 Unauthorized');
echo 'Texto enviado caso o usuário clique no botão Cancelar';
exit;
} else {
@@ -44,13 +44,13 @@ if (!isset($_SERVER['PHP_AUTH_USER'])) {
</para>
<note>
<title>Nota sobre compatibilidade</title>
<title>Compatibilidade</title>
<para>
Por favor, seja cauteloso ao codificar as linhas do cabeçalho HTTP. Para garantir máxima
compatibilidade com todos os clientes, a palavra-chave "Basic" deve ser escrita com um
"B" maiúsculo, a string realm deve ser envolvida por aspas duplas (nunca por aspas simples),
e apenas um espaço deve preceder o código <emphasis>401</emphasis> na linha do cabeçalho
<emphasis>HTTP/1.0 401</emphasis>. Parâmetros de autenticação precisam ser separados por
<emphasis>HTTP/1.1 401</emphasis>. Parâmetros de autenticação precisam ser separados por
vírgula.
</para>
</note>
@@ -63,16 +63,8 @@ if (!isset($_SERVER['PHP_AUTH_USER'])) {
o usuário em um arquivo dbm.
</para>
<para>
Cuidado com navegadores Internet Explorer bugados por aí. Eles
parecem muito minuciosos sobre a ordem dos cabeçalhos. Enviar
o cabeçalho <emphasis>WWW-Authenticate</emphasis> antes do
cabeçalho <literal>HTTP/1.0 401</literal> parece resolver isso
por enquanto.
</para>
<note>
<title>Nota de configuração</title>
<title>Configuração do Apache</title>
<para>
O PHP usa uma diretiva chamada <literal>AuthType</literal>
para determinar se a autenticação externa está em efeito.
@@ -84,68 +76,34 @@ if (!isset($_SERVER['PHP_AUTH_USER'])) {
controle uma URL não autenticada roube senhas de
URLs autenticadas no mesmo servidor.
</simpara>
<simpara>
Tanto o Netscape Navigator quanto o Internet Explorer apagarão o cache de
autenticação da janela local do navegador para o realm após receber uma
resposta 401 do servidor. Isso pode efetivamente "deslogar" um usuário,
forçando o mesmo a re-entrar seu nome de usuário e senha. Algumas pessoas
usam isso para delimitar o tempo de um login, ou prover um botão de "log-out".
</simpara>
<para>
<example>
<title>Exemplo de Autenticação HTTP forçando um novo nome/senha</title>
<programlisting role="php">
<![CDATA[
<?php
function authenticate() {
header('WWW-Authenticate: Basic realm="Test Authentication System"');
header('HTTP/1.0 401 Unauthorized');
echo "Você deve digitar um login e senha válidos para acessar este recurso\n";
exit;
}
if (!isset($_SERVER['PHP_AUTH_USER']) ||
($_POST['SeenBefore'] == 1 && $_POST['OldAuth'] == $_SERVER['PHP_AUTH_USER'])) {
authenticate();
} else {
echo "<p>Bem-vindo: " . htmlspecialchars($_SERVER['PHP_AUTH_USER']) . "<br />";
echo "Antigo: " . htmlspecialchars($_REQUEST['OldAuth']);
echo "<form action='' method='post'>\n";
echo "<input type='hidden' name='SeenBefore' value='1' />\n";
echo "<input type='hidden' name='OldAuth' value=\"" . htmlspecialchars($_SERVER['PHP_AUTH_USER']) . "\" />\n";
echo "<input type='submit' value='Re-autenticar' />\n";
echo "</form></p>\n";
}
?>
]]>
</programlisting>
</example>
</para>
<simpara>
Este comportamento não é requerido pelo padrão de autenticação <literal>HTTP Basic</literal>,
então nunca se deve depender dele. Testes com
<literal>Lynx</literal> tem mostrado que <literal>Lynx</literal> não apaga
as credenciais de autenticação com uma resposta 401 do servidor, assim, ao pressionar "Voltar"
e então "Ir" novamente abrirá o recurso contanto que os requerimento de credenciais
não tenha mudado. Contudo, o usuário pode pressionar a tecla
<literal>'_'</literal> para apagar suas informações de autenticação.
</simpara>
<simpara>
Para fazer com que a autenticação HTTP funcione utilizando um servidor IIS com a versão CGI
do PHP é necessário editar a configuração "<literal>Directory Security</literal>" do IIS.
Clique em "<literal>Edit</literal>" e marque somente
"<literal>Anonymous Access</literal>",
deixe todos os outros campos desmarcados.
</simpara>
<note>
<title>Nota sobre IIS:</title>
<title>Comportamento do navegador</title>
<simpara>
Para que a autenticação HTTP funcione com IIS, a diretiva do PHP
<link linkend="ini.cgi.rfc2616-headers">cgi.rfc2616_headers</link> deve
ser definida como <literal>0</literal> (o valor default).
A autenticação básica HTTP é realmente básica e não foi projetada para suportar
logouts. Como o HTTP é um protocolo sem estado, a maioria dos navegadores armazena em cache as
credenciais fornecidas assim que um código de status <literal>2xx</literal> é detectado,
e as envia em todas as requisições, até que o navegador seja fechado. Não há
uma maneira definida para um servidor solicitar uma nova solicitação de credenciais.
Ao longo dos anos, várias soluções alternativas para isso se espalharam como conselhos na internet,
mas todas dependem de como diferentes navegadores optaram por lidar com casos extremos indefinidos
(ou mesmo violações do padrão HTTP). É melhor evitar essas
soluções alternativas e não usar a autenticação básica para nada sério.
</simpara>
</note>
<note>
<title>Configuração do IIS</title>
<simpara>
Para que a autenticação HTTP funcione no servidor IIS com a versão CGI do
PHP, a diretiva php.ini <link linkend="ini.cgi.rfc2616-headers">cgi.rfc2616_headers</link>
deve ser definida como <literal>0</literal> (o valor padrão) e a configuração do IIS
em "<literal>Directory Security</literal>" (ou "Segurança do Diretório" / "Autenticação") deve ser editada.
Clique em "<literal>Edit</literal>" (ou "Editar") e marque apenas "<literal>Anonymous Access</literal>" (ou "Acesso Anônimo"),
deixando todos os outros campos desmarcados.
</simpara>
</note>
</chapter>
<!-- Keep this comment at the end of the file

14
reference/image/functions/getimagesize.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f8d1e172bd6d11986f0dfeb11756b90c039a39bc Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,marcosmarcolin,leonardolara -->
<!-- EN-Revision: 6bb90d24b240a0b81e4b203cd8b7ed56bd54033a Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,marcosmarcolin,leonardolara -->
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.getimagesize">
<refnamediv>
<refname>getimagesize</refname>
@@ -185,6 +185,10 @@ if ($size && $fp) {
<function>getimagesize</function> gerará um erro de nível
<constant>E_NOTICE</constant>.
</para>
<para>
A partir do PHP 8.0.0, um <exceptionname>ValueError</exceptionname> é lançado
se <parameter>filename</parameter> estiver vazio.
</para>
</refsect1>
<refsect1 role="changelog">
@@ -207,6 +211,14 @@ if ($size && $fp) {
e bits e channels não eram relatados de forma alguma.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Um <exceptionname>ValueError</exceptionname> agora é lançado se
<parameter>filename</parameter> estiver vazio; anteriormente, um
<constant>E_WARNING</constant> era emitido e a função retornava &false;.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>

19
reference/intl/grapheme/grapheme-str-split.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ee94fd0c20566ec20b0dbfa5ab639d6bb0e9f890 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 122d5d09692db103ef8e7b2e2fc31583ff3807e2 Maintainer: leonardolara Status: ready -->
<refentry xml:id="function.grapheme-str-split" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>grapheme_str_split</refname>
@@ -60,23 +60,6 @@
</simpara>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&intl.changelog.grapheme.locale;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>

4
reference/intl/intlchar.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5e36b489fc67bd0b5c424c7d1cd131c2e982bc5c Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 63bd68a3fd48950db6f5349e24eaaea8ebeef880 Maintainer: leonardolara Status: ready -->
<reference xml:id="class.intlchar" 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>IntlChar</title>
@@ -10721,7 +10721,7 @@
<entry>8.4.0</entry>
<entry>
Adicionadas as constantes <constant>IntlChar::PROPERTY_IDS_UNARY_OPERATOR</constant>, <constant>IntlChar::PROPERTY_ID_COMPAT_MATH_START</constant> e
<constant>IntlChar::PROPERTY_ID_COMPAT_MATH_START</constant>.
<constant>IntlChar::PROPERTY_ID_COMPAT_MATH_CONTINUE</constant>.
</entry>
</row>
<row>

7
reference/json/functions/json-last-error.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7100979e254970cef72c6f91b32352e7c7898635 Maintainer: leonardolara Status: ready --><!-- CREDITS: Jefersson Nathan,willian-rosa,leonardolara -->
<!-- EN-Revision: 058ea1e8420b9c1b24402af52545e8313428e1d1 Maintainer: leonardolara Status: ready --><!-- CREDITS: Jefersson Nathan,willian-rosa,leonardolara -->
<refentry xml:id="function.json-last-error" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>json_last_error</refname>
@@ -100,6 +100,11 @@
<entry>Caracteres UTF-16 malformados, possivelmente codificados incorretamente</entry>
<entry></entry>
</row>
<row>
<entry><constant>JSON_ERROR_NON_BACKED_ENUM</constant></entry>
<entry>Valor contém uma enumeração não apoiada que não pode ser serializada. Disponível a partir do PHP 8.1.0.</entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>

5
reference/math/functions/fmod.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 761d72245071f89a626903c9bcdc6aaff1252d54 Maintainer: leonardolara Status: ready --><!-- CREDITS: royopa,leonardolara -->
<!-- EN-Revision: 54a788ca59d95ff2b4189406437345a21b489435 Maintainer: leonardolara Status: ready --><!-- CREDITS: royopa,leonardolara -->
<refentry xml:id="function.fmod" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>fmod</refname>
@@ -50,7 +50,8 @@
&reftitle.returnvalues;
<para>
O resto em ponto flutuante de
<parameter>num1</parameter>/<parameter>num2</parameter>
<parameter>num1</parameter>/<parameter>num2</parameter>.
<constant>NAN</constant> (<type>float</type>) se o segundo argumento for 0.
</para>
</refsect1>
<refsect1 role="examples">

11
reference/random/random/randomizer/getfloat.xml
View File

@@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: c142be811735a5542c8a2e4c4ed2f81e8cc3acc6 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 423a1da63f8265c57827234807709232afd274ec Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="random-randomizer.getfloat" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Random\Randomizer::getFloat</refname>
@@ -341,6 +341,15 @@ Lat: +69.244304 Lng: -53.548951
para obter as propriedades comportamentais desejadas.
</para>
</note>
<caution>
<para>
O underflow é intencionalmente deixado sem tratamento no algoritmo de seção γ.
Isso pode resultar em valores incorretos sendo retornados para intervalos com
limites na faixa subnormal de números de ponto flutuante, ou seja,
para limites com um valor absoluto menor que aproximadamente
<literal>2<superscript>-1020</superscript></literal> (cerca de <literal>8,9e-308</literal>).
</para>
</caution>
</refsect1>
<refsect1 role="seealso">

4
reference/soap/soapfault.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5e36b489fc67bd0b5c424c7d1cd131c2e982bc5c Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto -->
<!-- EN-Revision: cdb9b8afa58e676e9c7844a892aa6eca152f916d Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto -->
<reference xml:id="class.soapfault" 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 SoapFault</title>
@@ -153,7 +153,7 @@
</listitem>
</varlistentry>
<varlistentry xml:id="soapfault.props.lang">
<term><varname>headerfault</varname></term>
<term><varname>lang</varname></term>
<listitem>
<simpara>
Atributo xml:lang do texto de motivo do SOAP 1.2.

18
reference/stream/functions/stream-filter-append.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: a684294e0b7ce0c18e2212b002b442b6ceba321d Maintainer: leonardolara Status: ready -->
<refentry xml:id="function.stream-filter-append" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>stream_filter_append</refname>
@@ -10,12 +10,12 @@
<methodsynopsis>
<type>resource</type><methodname>stream_filter_append</methodname>
<methodparam><type>resource</type><parameter>stream</parameter></methodparam>
<methodparam><type>string</type><parameter>filtername</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>read_write</parameter></methodparam>
<methodparam><type>string</type><parameter>filter_name</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>params</parameter></methodparam>
</methodsynopsis>
<para>
Adiciona o nome do filtro <parameter>filtername</parameter> à lista de filtros
Adiciona o nome do filtro <parameter>filter_name</parameter> à lista de filtros
anexados ao fluxo <parameter>stream</parameter>.
</para>
</refsect1>
@@ -33,7 +33,7 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>filtername</parameter></term>
<term><parameter>filter_name</parameter></term>
<listitem>
<para>
O nome do filtro.
@@ -41,7 +41,7 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>read_write</parameter></term>
<term><parameter>mode</parameter></term>
<listitem>
<para>
Por padrão, <function>stream_filter_append</function> irá
@@ -54,7 +54,7 @@
As constantes <constant>STREAM_FILTER_READ</constant>,
<constant>STREAM_FILTER_WRITE</constant> e/ou
<constant>STREAM_FILTER_ALL</constant> também podem ser passadas ao parâmetro
<parameter>read_write</parameter> para substituir este comportamento.
<parameter>mode</parameter> para substituir este comportamento.
</para>
</listitem>
</varlistentry>
@@ -84,7 +84,7 @@
<para>
&false; é retornado se o parâmetro <parameter>stream</parameter> não for um recurso ou
se o nome do filtro <parameter>filtername</parameter> não puder ser localizado.
se o nome do filtro <parameter>filter_name</parameter> não puder ser localizado.
</para>
</refsect1>
@@ -139,7 +139,7 @@ Grfgr qr svygeb
<title>Usando filtros personalizados (do usuário)</title>
<simpara>
<function>stream_filter_register</function> deve ser chamado em primeiro lugar
de maneira a registrar o filtro de usuário desejado para o valor de <parameter>filtername</parameter>.
de maneira a registrar o filtro de usuário desejado para o valor de <parameter>filter_name</parameter>.
</simpara>
</note>
<note>

18
reference/stream/functions/stream-filter-prepend.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: a684294e0b7ce0c18e2212b002b442b6ceba321d Maintainer: leonardolara Status: ready -->
<refentry xml:id="function.stream-filter-prepend" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>stream_filter_prepend</refname>
@@ -10,12 +10,12 @@
<methodsynopsis>
<type>resource</type><methodname>stream_filter_prepend</methodname>
<methodparam><type>resource</type><parameter>stream</parameter></methodparam>
<methodparam><type>string</type><parameter>filtername</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>read_write</parameter></methodparam>
<methodparam><type>string</type><parameter>filter_name</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>params</parameter></methodparam>
</methodsynopsis>
<para>
Adiciona o nome do filtro <parameter>filtername</parameter> à lista de filtros
Adiciona o nome do filtro <parameter>filter_name</parameter> à lista de filtros
anexados ao fluxo <parameter>stream</parameter>.
</para>
</refsect1>
@@ -33,7 +33,7 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>filtername</parameter></term>
<term><parameter>filter_name</parameter></term>
<listitem>
<para>
O nome do filtro.
@@ -41,7 +41,7 @@
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>read_write</parameter></term>
<term><parameter>mode</parameter></term>
<listitem>
<para>
Por padrão, <function>stream_filter_prepend</function> irá
@@ -54,7 +54,7 @@
As constantes <constant>STREAM_FILTER_READ</constant>,
<constant>STREAM_FILTER_WRITE</constant> e/ou
<constant>STREAM_FILTER_ALL</constant> também podem ser passadas ao parâmetro
<parameter>read_write</parameter> para substituir este comportamento.
<parameter>mode</parameter> para substituir este comportamento.
Consulte a função <function>stream_filter_append</function> para um exemplo de
uso deste parâmetro.
</para>
@@ -85,7 +85,7 @@
<para>
&false; é retornado se o parâmetro <parameter>stream</parameter> não for um recurso ou
se o nome do filtro <parameter>filtername</parameter> não puder ser localizado.
se o nome do filtro <parameter>filter_name</parameter> não puder ser localizado.
</para>
</refsect1>
@@ -95,7 +95,7 @@
<title>Usando filtros personalizados (do usuário)</title>
<simpara>
<function>stream_filter_register</function> deve ser chamado em primeiro lugar
de maneira a registrar o filtro de usuário desejado para o valor de <parameter>filtername</parameter>.
de maneira a registrar o filtro de usuário desejado para o valor de <parameter>filter_name</parameter>.
</simpara>
</note>
<note>

37
reference/var/functions/settype.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d816a0fad6c458d9515f697cc89e26ca9d8069f5 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,leonardolara -->
<!-- EN-Revision: 8d49e302b484f0e5c237dd16ca1afef3b7515f46 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,leonardolara -->
<refentry xml:id="function.settype" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>settype</refname>
@@ -87,6 +87,41 @@
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
Lança um <exceptionname>ValueError</exceptionname> se o valor de
<parameter>type</parameter> não for um tipo válido, a partir do PHP 8.0.0.
Antes do PHP 8.0.0, um <constant>E_WARNING</constant> era emitido e
a função retornava &false;.
</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.0.0</entry>
<entry>
Agora lança um <exceptionname>ValueError</exceptionname> quando um tipo
inválido é passado ao parâmetro <parameter>type</parameter>. Anteriormente, um
<constant>E_WARNING</constant> era emitido e a função retornava
&false;.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>