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-01-06 15:08:57 -03:00
parent d095372919
commit 55bc81d567
19 changed files with 250 additions and 189 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
install/pie.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3bc709a20a52a12d7e0e4736a8f332517acb199c Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: b759662494d44aafa74356de0e1a0bb5684ca22d Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<chapter xml:id="install.pie" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="chunk:false">
<title>Instalação do PIE e extensões de terceiros</title>
@@ -29,7 +29,7 @@ pie install mongodb/mongodb-extension
</programlisting>
</example>
<simpara>
A <link xlink:href="&url.pie;/blob/main/docs/usage.md">documentação "PIE
A <link xlink:href="&url.pie.usage;">documentação "PIE
Usage"</link> aborda isso com mais detalhes.
</simpara>

1
language/predefined/attributes/allowdynamicproperties.xml
View File

@@ -18,6 +18,7 @@
<classsynopsis class="class">
<ooclass>
<modifier role="attribute">#[\Attribute]</modifier>
<modifier>final</modifier>
<classname>AllowDynamicProperties</classname>
</ooclass>

3
language/predefined/attributes/attribute.xml
View File

@@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 05b314c2ae84456def6a56777b05d0645fb3e11e Maintainer: leonardolara Status: ready --><!-- CREDITS: adaiasmagdiel, leonardolara -->
<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 77325b622f91355b118e8f3bc9ff940e8201f55d Maintainer: leonardolara Status: ready --><!-- CREDITS: adaiasmagdiel, leonardolara -->
<reference xml:id="class.attribute" 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>O atributo Attribute</title>
<titleabbrev>Attribute</titleabbrev>
@@ -23,6 +23,7 @@
<classsynopsis class="class">
<ooclass>
<modifier role="attribute">#[\Attribute]</modifier>
<modifier>final</modifier>
<classname>Attribute</classname>
</ooclass>

3
language/predefined/attributes/deprecated.xml
View File

@@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: e890e4a7f97a9ea85e60a38443e7c8eb7ae9383f Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 77325b622f91355b118e8f3bc9ff940e8201f55d Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<reference xml:id="class.deprecated" 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>O atributo Deprecated</title>
<titleabbrev>Deprecated</titleabbrev>
@@ -18,6 +18,7 @@
<classsynopsis class="class">
<ooclass>
<modifier role="attribute">#[\Attribute]</modifier>
<modifier>final</modifier>
<classname>Deprecated</classname>
</ooclass>

3
language/predefined/attributes/override.xml
View File

@@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 2c62a677639fb5bac320601d21f4a48a93b91e17 Maintainer: leonardolara Status: ready -->
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 77325b622f91355b118e8f3bc9ff940e8201f55d Maintainer: leonardolara Status: ready -->
<reference xml:id="class.override" 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>O atributo Override</title>
<titleabbrev>Override</titleabbrev>
@@ -29,6 +29,7 @@
<classsynopsis class="class">
<ooclass>
<modifier role="attribute">#[\Attribute]</modifier>
<modifier>final</modifier>
<classname>Override</classname>
</ooclass>

3
language/predefined/attributes/returntypewillchange.xml
View File

@@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 05b314c2ae84456def6a56777b05d0645fb3e11e Maintainer: leonardolara Status: ready --><!-- CREDITS: adaiasmagdiel, leonardolara -->
<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 77325b622f91355b118e8f3bc9ff940e8201f55d Maintainer: leonardolara Status: ready --><!-- CREDITS: adaiasmagdiel, leonardolara -->
<reference xml:id="class.returntypewillchange" 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>O atributo ReturnTypeWillChange</title>
<titleabbrev>ReturnTypeWillChange</titleabbrev>
@@ -23,6 +23,7 @@
<classsynopsis class="class">
<ooclass>
<modifier role="attribute">#[\Attribute]</modifier>
<modifier>final</modifier>
<classname>ReturnTypeWillChange</classname>
</ooclass>

3
language/predefined/attributes/sensitiveparameter.xml
View File

@@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 05b314c2ae84456def6a56777b05d0645fb3e11e Maintainer: leonardolara Status: ready --><!-- CREDITS: adaiasmagdiel, leonardolara -->
<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 77325b622f91355b118e8f3bc9ff940e8201f55d Maintainer: leonardolara Status: ready --><!-- CREDITS: adaiasmagdiel, leonardolara -->
<reference xml:id="class.sensitiveparameter" 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>O atributo SensitiveParameter</title>
<titleabbrev>SensitiveParameter</titleabbrev>
@@ -19,6 +19,7 @@
<classsynopsis class="class">
<ooclass>
<modifier role="attribute">#[\Attribute]</modifier>
<modifier>final</modifier>
<classname>SensitiveParameter</classname>
</ooclass>

3
language/predefined/php-incomplete-class.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c0e48705eb88453af785e0e4a6cbd526085dfe3a Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 77325b622f91355b118e8f3bc9ff940e8201f55d Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<reference xml:id="class.php-incomplete-class" 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 __PHP_Incomplete_Class</title>
@@ -28,6 +28,7 @@
<classsynopsis class="class">
<ooclass>
<modifier role="attribute">#[\AllowDynamicProperties]</modifier>
<modifier>final</modifier>
<classname>__PHP_Incomplete_Class</classname>
</ooclass>

3
language/predefined/stdclass.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: 77325b622f91355b118e8f3bc9ff940e8201f55d Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<reference xml:id="class.stdclass" 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 stdClass</title>
@@ -42,6 +42,7 @@
<classsynopsis class="class">
<ooclass>
<modifier role="attribute">#[\AllowDynamicProperties]</modifier>
<classname>stdClass</classname>
</ooclass>
</classsynopsis>

6
language/types/array.xml
View File

@@ -1,8 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 094816bd170e26abf0e057dae1cfb498dd6aad88 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,fabioluciano,rogeriopradoj,geekcom,ae,gabrielsanva,leonardolara -->
<!-- EN-Revision: 3061900171d4ae84d532571bfd6eda823726dad4 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,fabioluciano,rogeriopradoj,geekcom,ae,gabrielsanva,leonardolara -->
<sect1 xml:id="language.types.array">
<title>Arrays</title>
<para>
Para uma lista de todas as funções de array, consulte o capítulo sobre <link linkend="ref.array">funções de array</link> na documentação.
</para>
<para>
Um <type>array</type> no PHP é na verdade um mapa ordenado. Um mapa é um tipo que
relaciona <emphasis>valores</emphasis> a <emphasis>chaves</emphasis>. Este tipo

8
reference/array/functions/array-key-exists.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 73048c75fbe328342b74f0ffb0a0c85c477f5cde Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,lucasr,fabioluciano,lhsazevedo,leonardolara -->
<!-- EN-Revision: faa17c20aa7cdada1806b5b60d2c1b3bbcfff0d9 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,lucasr,fabioluciano,lhsazevedo,leonardolara -->
<refentry xml:id="function.array-key-exists" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_key_exists</refname>
@@ -69,6 +69,12 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Usar <type>null</type> no parâmetro <parameter>key</parameter> foi descontinuado, use uma string vazia no lugar.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>

9
reference/dir/directory.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<!-- EN-Revision: ff7eeb11a79400328c67727335240cfc4355e93d Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<reference xml:id="class.directory" 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 Directory</title>
@@ -23,6 +23,7 @@
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>Directory</classname>
</ooclass>
@@ -91,6 +92,12 @@
As propriedades <varname>path</varname> e <varname>handle</varname> agora são somente-leitura.
</entry>
</row>
<row>
<entry>8.5.0</entry>
<entry>
A class agora é final.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>

18
reference/mongodb/configure.xml
View File

@@ -1,9 +1,25 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ec7d2da818c8122d35b7e40a455efa1dce4b031d Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<!-- EN-Revision: 6536bde9ac873428828d7c62cc8d0d04b1a24267 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
<section xml:id="mongodb.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.install;
<section xml:id="mongodb.installation.pie">
<title>Instalando a extensão MongoDB PHP com PIE</title>
&pecl.moving.to.pie;
<para>
Para instalar a extensão MongoDB usando PIE, execute o seguinte comando:
<programlisting role="shell">
<![CDATA[
pie install mongodb/mongodb-extension
]]>
</programlisting>
</para>
</section>
<section xml:id="mongodb.installation.pecl">
<title>Instalando a extensão MongoDB PHP com PECL</title>

4
reference/mongodb/setup.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3e871fe7eab38f9b0398569c57a1dd0c21e69652 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<!-- EN-Revision: 6536bde9ac873428828d7c62cc8d0d04b1a24267 Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandowobeto, leonardolara -->
<chapter xml:id="mongodb.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
@@ -7,7 +7,7 @@
<section xml:id="mongodb.requirements">
&reftitle.required;
<para>
A partir da versão 1.16.0, a extensão requer PHP 7.2 ou superior. Versões
A partir da versão 1.21.0, a extensão requer PHP 8.1 ou superior. Versões
anteriores da extensão permitem compatibilidade com versões mais antigas do PHP.
</para>
<para>

329
reference/network/functions/setcookie.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1ad4e2d550953000e2441b663226300596962ef2 Maintainer: ae Status: ready --><!-- CREDITS: adiel,thiago,ae,leonardolara -->
<!-- EN-Revision: 9434c9439bb8f86d92ba5f227151432ea0b90b8f Maintainer: leonardolara Status: ready --><!-- CREDITS: adiel,thiago,ae,leonardolara -->
<refentry xml:id="function.setcookie" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>setcookie</refname>
@@ -18,27 +18,27 @@
<methodparam choice="opt"><type>bool</type><parameter>secure</parameter><initializer>&false;</initializer></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>httponly</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>Assinatura alternativa disponível a partir do PHP 7.3.0 (sem suporte a parâmetros nomeados):</para>
<simpara>Assinatura alternativa disponível a partir do PHP 7.3.0 (sem suporte a parâmetros nomeados):</simpara>
<methodsynopsis>
<type>bool</type><methodname>setcookie</methodname>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>value</parameter><initializer>""</initializer></methodparam>
<methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
A função <function>setcookie</function> define um cookie para ser enviado juntamente
com os cabeçalhos HTTP. Como outros cabeçalhos, os cookies devem ser enviados
<emphasis>antes</emphasis> de qualquer saída do script (isso é
uma restrição do protocolo). Isso significa que as chamadas a essa função devem ser colocadas antes de qualquer
uma restrição do protocolo). Isso requer que esta função seja chamada antes de qualquer
saída, incluindo as tags <literal>&lt;html&gt;</literal> e
<literal>&lt;head&gt;</literal>, assim como espaços em branco.
</para>
<para>
</simpara>
<simpara>
Uma vez que os cookies foram definidos, eles podem ser acessados no próximo carregamento da página
através do array <varname>$_COOKIE</varname>.
Os valores dos cookies também podem existir no
array <varname>$_REQUEST</varname>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -51,26 +51,26 @@
<varlistentry>
<term><parameter>name</parameter></term>
<listitem>
<para>
<simpara>
O nome do cookie.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
<simpara>
O valor do cookie. Esse valor é armazenado no computador do cliente; não
deve ser armazenada informação sensível. Supondo que o <parameter>name</parameter> seja
<literal>'cookiename'</literal>, o valor pode ser lido através de
<varname>$_COOKIE['cookiename']</varname>
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>expires_or_options</parameter></term>
<listitem>
<para>
<simpara>
O tempo para o cookie expirar. Esse valor é um timestamp Unix,
portanto é o número de segundos desde a época Unix.
Uma maneira de configurar esse valor é adicionando o número de segundos em que o cookie deve
@@ -80,23 +80,21 @@
Outra opção é usar a função <function>mktime</function>.
Se configurado para <literal>0</literal> ou omitido, o cookie vai expirar
no final da sessão (quando o navegador fechar).
</para>
<para>
<note>
<para>
O parâmetro <parameter>expires_or_options</parameter> recebe
uma timestamp Unix, ao contrário do formato de data <literal>Wdy,
DD-Mon-YYYY HH:MM:SS GMT</literal>, isso acontece porque o PHP faz essa
conversão internamente.
</para>
</note>
</para>
</simpara>
<note>
<simpara>
O parâmetro <parameter>expires_or_options</parameter> recebe
um timestamp Unix, ao contrário do formato de data <literal>Wdy, DD-Mon-YYYY
HH:MM:SS GMT</literal>, isso acontece porque o PHP faz essa conversão
internamente.
</simpara>
</note>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>path</parameter></term>
<listitem>
<para>
<simpara>
O caminho no servidor onde o cookie estará disponível. Se configurado
para <literal>'/'</literal>, o cookie estará disponível para todo o
<parameter>domain</parameter>. Se configurado para o diretório
@@ -105,44 +103,44 @@
<literal>/foo/bar/</literal> do <parameter>domain</parameter>.
O valor padrão é o
diretório atual onde o cookie está sendo configurado.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>domain</parameter></term>
<listitem>
<para>
<simpara>
O (sub)domínio para qual o cookie estará disponível. Definindo para um
subdomínio (como <literal>'www.example.com'</literal>) deixará o cookie
disponível para aquele subdomínio e todos os outros sub-domínios abaixo dele
(exemplo w2.www.example.com). Para deixar o cookie disponível para todo o
domínio (incluindo todos os subdomínios dele), basta definir o valor
para o nome do domínio (<literal>'example.com'</literal>, nesse caso).
</para>
<para>
</simpara>
<simpara>
Navegadores antigos ainda implementam a
<link xlink:href="&url.rfc;2109">RFC 2109</link> e podem requerer um
<literal>.</literal> no início para funcionar com todos os subdomínios.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>secure</parameter></term>
<listitem>
<para>
<simpara>
Indica que o cookie só poderá ser transmitido sob uma conexão
segura HTTPS do cliente. Quando configurado para &true;, o
cookie será enviado somente se uma conexão segura existir.
No lado do servidor, fica por conta do programador enviar esse
tipo de cookie somente sob uma conexão segura (ex
respeitando <varname>$_SERVER["HTTPS"]</varname>).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>httponly</parameter></term>
<listitem>
<para>
<simpara>
Quando for &true;, o cookie será acessível somente sob o protocolo HTTP.
Isso significa que o cookie não será acessível por linguagens de
script, como JavaScript. É dito que essa configuração pode ajudar a
@@ -150,13 +148,13 @@
(entretanto ela não é suportada por todos os navegadores), mas essa informação
é constantemente discutida. Foi adicionada no PHP 5.2.0.
&true; ou &false;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
<simpara>
Um <type>array</type> associativo que pode ter qualquer uma das chaves
<literal>expires</literal>, <literal>path</literal>, <literal>domain</literal>,
<literal>secure</literal>, <literal>httponly</literal> e <literal>samesite</literal>.
@@ -169,15 +167,20 @@
mesmos valores padrão dos parâmetros explícitos. Se
<literal>samesite</literal> for omitido, o atributo SameSite do cookie
não será atribuído.
</para>
<para>
<note>
<para>
Para definir um cookie que inclui atributos que não estão entre as chaves listadas,
use a função <function>header</function>.
</para>
</note>
</para>
</simpara>
<note>
<simpara>
Para definir um cookie que inclui atributos que não estão entre as chaves listadas,
use a função <function>header</function>.
</simpara>
</note>
<note>
<simpara>
Se <literal>samesite</literal> for igual a <literal>"None"</literal> então
<literal>secure</literal> também precisa ser habilitado senão o cookie será
bloqueado pelo cliente.
</simpara>
</note>
</listitem>
</varlistentry>
</variablelist>
@@ -186,81 +189,83 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Se houver saída antes da chamada dessa função,
<function>setcookie</function> irá falhar e retornará &false;. Se a função
<function>setcookie</function> for executada com sucesso, ela retornará &true;.
Isso não indica que o usuário aceitou o cookie.
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.2.0</entry>
<entry>
O formato de data do cookie agora é <literal>'D, d M Y H:i:s \G\M\T'</literal>;
anteriormente era <literal>'D, d-M-Y H:i:s T'</literal>.
</entry>
</row>
<row>
<entry>7.3.0</entry>
<entry>
Uma assinatura alternativa para suportar o array <parameter>options</parameter>
foi adicionado. Essa assinatura também permite configurar o atributo
SameSite do cookie.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.2.0</entry>
<entry>
O formato de data do cookie agora é <literal>'D, d M Y H:i:s \G\M\T'</literal>;
anteriormente era <literal>'D, d-M-Y H:i:s T'</literal>.
</entry>
</row>
<row>
<entry>7.3.0</entry>
<entry>
Uma assinatura alternativa para suportar o array <parameter>options</parameter>
foi adicionado. Essa assinatura também permite configurar o atributo
SameSite do cookie.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
Os exemplos a seguir demonstram algumas formas de enviar cookies.
<example>
<title>Exemplo de <function>setcookie</function> para enviar cookies</title>
<programlisting role="php">
<![CDATA[
<simpara>
Os efeitos dos exemplos a seguir podem ser observados usando a lista de cookies
da ferramenta de desenvolvedor do navegador (normalmente na aba de Armazenamento ou Aplicação).
</simpara>
<example>
<title>Exemplo de <function>setcookie</function> para enviar cookies</title>
<programlisting role="php">
<![CDATA[
<?php
$value = 'alguma coisa de algum lugar';
// Define um "cookie de sessão" que expira quando o navegador é fechado
setcookie("CookieTeste", $value);
setcookie("CookieTeste", $value, time()+3600); /* expira em 1 hora */
// Define um cookie que expira em 1 hora
setcookie("CookieTeste", $value, time()+3600);
// Define um cookie que se aplica somente a um caminho específico de um domnínio específico
// Observe que o domínio usado deve corresponder ao domínio do site
setcookie("CookieTeste", $value, time()+3600, "/~rasmus/", "example.com", true);
?>
]]>
</programlisting>
</example>
</para>
<para>
Note que a porção do valor do cookie será automaticamente codificada em
URL quando o cookie for enviado, e quando ele for recebido, será
automaticamente decodificado e atribuído a uma variável com o mesmo nome do
cookie. Se esta não for a intenção, pode ser utilizada em seu lugar a
função <function>setrawcookie</function>. Para ver
o conteúdo do cookie de teste em um script, simplesmente
utilize um dos exemplos abaixo:
</para>
<para>
<informalexample>
<programlisting role="php">
<![CDATA[
</programlisting>
</example>
<simpara>
Observe que a porção do valor do cookie será automaticamente codificada em
URL e decodificada pelo PHP. Isto pode ser evitado usando
<function>setrawcookie</function> em seu lugar.
</simpara>
<simpara>
Para ver o conteúdo dos cookies definidos no exemplo acima em uma requisição
posterior:
</simpara>
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
// Mostra um cookie individual
echo $_COOKIE["CookieTeste"];
@@ -269,47 +274,45 @@ echo $_COOKIE["CookieTeste"];
print_r($_COOKIE);
?>
]]>
</programlisting>
</informalexample>
</para>
<para>
<example>
<title>Exemplo de <function>setcookie</function> para apagar cookies</title>
<para>
Quando um cookie estiver sendo excluído, deve-se garantir que a data de
expiração dele está no passado, para acionar o mecanismo de remoção no navegador.
O exemplo a seguir mostra como excluir os cookies enviados no exemplo anterior:
</para>
<programlisting role="php">
<![CDATA[
</programlisting>
</informalexample>
<example>
<title>Exemplo de <function>setcookie</function> para apagar cookies</title>
<simpara>
Para excluir um cookie, defina a data de expiração para uma data no passado
(porém diferente de zero, que é reservado para cookies de sessão).
</simpara>
<simpara>
Para excluir os cookies definidos no exemplo anterior:
</simpara>
<programlisting role="php">
<![CDATA[
<?php
// Configura a data de expiração para uma hora atrás
setcookie("CookieTeste", "", time() - 3600);
setcookie("CookieTeste", "", time() - 3600, "/~rasmus/", ".example.com", 1);
?>
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title><function>setcookie</function> e arrays</title>
<para>
Cookies de array também podem ser enviados, utilizando a notação de array
no nome dele. Isso tem o efeito de enviar tantos cookies quantos
elementos houver no array, mas quando o cookie for recebido pelo
script, os valores serão todos colocados em um array com o nome do
cookie:
</para>
<programlisting role="php">
<![CDATA[
</programlisting>
</example>
<example>
<title><function>setcookie</function> e arrays</title>
<simpara>
"Arrays de cookies" podem ser definidos usando a notação de array
no nome do cookie. Isso tem o efeito de definir tantos cookies quantos
elementos houver no array, mas quando o cookie for recebido pelo
script, os valores serão todos colocados em um array com o nome do
cookie:
</simpara>
<programlisting role="php">
<![CDATA[
<?php
// envia os cookies
// define os cookies
setcookie("cookie[tres]", "cookietres");
setcookie("cookie[dois]", "cookiedois");
setcookie("cookie[um]", "cookieum");
// Mostra os cookies depois que a página recarregar
// Exibe os cookies depois que a página recarregar
if (isset($_COOKIE['cookie'])) {
foreach ($_COOKIE['cookie'] as $nome => $valor) {
$nome = htmlspecialchars($nome);
@@ -319,38 +322,37 @@ if (isset($_COOKIE['cookie'])) {
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
</programlisting>
&example.outputs;
<screen>
<![CDATA[
tres : cookietres
dois : cookiedois
um : cookieum
]]>
</screen>
</example>
<note>
<simpara>
Utilizar caracteres como <literal>[</literal> e <literal>]</literal>
no nome do cookie não é válido conforme a RFC 6265, seção 4, mas deve
ser suportado por navegadores conforme a RFC 6265, seção 5.
</simpara>
</note>
</para>
</screen>
</example>
<note>
<simpara>
Utilizar caracteres como <literal>[</literal> e <literal>]</literal>
no nome do cookie não é válido conforme a RFC 6265, seção 4, mas deve
ser suportado por navegadores conforme a RFC 6265, seção 5.
</simpara>
</note>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Você pode utilizar o buffer de saída para enviar a saída antes de
chamar essa função, com o custo de toda a saída para o
navegador ser armazenada em buffer no servidor até que seja enviada. Isso pode ser feito
<simpara>
Buffer de saída pode ser usado para permitir saída do script antes de
chamar essa função. Toda a saída será armazenada em buffer até que seja enviada
(explicitamente ou ao final da execução do script). Isso é feito
chamando <function>ob_start</function> e
<function>ob_end_flush</function> no script, ou configurando a
diretiva <literal>output_buffering</literal> no
&php.ini; ou em arquivos de configuração do servidor.
</para>
&php.ini; ou nos arquivos de configuração do servidor.
</simpara>
</note>
<para>
Problemas comuns:
@@ -377,19 +379,18 @@ um : cookieum
</listitem>
<listitem>
<simpara>
Quando um cookie for configurado com o valor &false;, será realizada uma tentativa de
excluir o cookie. Portanto, evite utilizar valores booleanos. No lugar deles,
utilize <emphasis>0</emphasis> para &false; e <emphasis>1</emphasis> para &true;.
Quando um cookie for configurado com o valor &false;, será realizada uma tentativa de excluí-lo.
Por isso, valores booleanos não devem ser usados. No lugar deles, utilize <emphasis>0</emphasis> para &false;
e <emphasis>1</emphasis> para &true;.
</simpara>
</listitem>
<listitem>
<simpara>
Nomes de cookies podem ser configurados como arrays e estarão disponíves
para os scripts PHP como arrays, mas cookies separados serão armazenados
no sistema do usuário. Deve ser considerado utilizar <function>explode</function>
para enviar um cookie com nomes e valores múltiplos. Não é recomendado o
uso da função <function>serialize</function> para esse propósito, pois
pode resultar em furos de segurança.
Nomes de cookies podem ser definidos como nomes de arrays e estarão disponíves para
os scripts PHP como arrays, mas cookies separados serão armazenados pelo navegador.
Considere utilizar <function>json_encode</function> para definir um cookie com nomes e
valores múltiplos. Não é recomendado usar <function>serialize</function>
para esse propósito pois pode resultar em furos de segurança.
</simpara>
</listitem>
</itemizedlist>
@@ -401,15 +402,13 @@ um : cookieum
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>header</function></member>
<member><function>setrawcookie</function></member>
<member><link linkend="features.cookies">Seção de cookies</link></member>
<member><link xlink:href="&url.rfc;6265">RFC 6265</link></member>
<member><link xlink:href="&url.rfc;2109">RFC 2109</link></member>
</simplelist>
</para>
<simplelist>
<member><function>header</function></member>
<member><function>setrawcookie</function></member>
<member><link linkend="features.cookies">Seção de cookies</link></member>
<member><link xlink:href="&url.rfc;6265">RFC 6265</link></member>
<member><link xlink:href="&url.rfc;2109">RFC 2109</link></member>
</simplelist>
</refsect1>
</refentry>

6
reference/pdo/pdo/quote.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 661e6858acade9f5a08fc8f9c07b605f42f4a700 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: a58aa95a35db6f3c5bebd8e4cff5c4abeea1441b Maintainer: leonardolara Status: ready -->
<refentry xml:id="pdo.quote" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>PDO::quote</refname>
@@ -16,8 +16,8 @@
</methodsynopsis>
<para>
<methodname>PDO::quote</methodname> coloca aspas na string de entrada (se
necessário) e escapa caracteres especiais dentro da string de entrada, usando um
<methodname>PDO::quote</methodname> coloca aspas na string de entrada
e escapa caracteres especiais dentro da string de entrada, usando um
estilo de aspas (ex.: simples ou duplas) apropriado ao driver subjacente.
</para>
<para>

25
reference/reflection/reflectionconstant.xml
View File

@@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: c477749c82111cbbdd657a0e98eeaeeec0d90c91 Maintainer: leonardolara Status: ready -->
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: ff7eeb11a79400328c67727335240cfc4355e93d Maintainer: leonardolara Status: ready -->
<reference xml:id="class.reflectionconstant" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>A classe ReflectionConstant</title>
<titleabbrev>ReflectionConstant</titleabbrev>
@@ -17,7 +17,6 @@
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>ReflectionConstant</classname>
</ooclass>
@@ -59,6 +58,28 @@
</variablelist>
</section>
<section 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>
A classe não é mais final.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>
<section role="seealso" xml:id="reflectionconstant.seealso">
&reftitle.seealso;
<simplelist>

4
reference/uodbc/functions/odbc-connect.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c39225b6dd23f358824f44f5b8c733517b11830b Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: c68bcb2af14260247d8afe5e13d957e10e44c4af Maintainer: leonardolara Status: ready -->
<refentry xml:id="function.odbc-connect" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>odbc_connect</refname>
@@ -12,7 +12,7 @@
<type class="union"><type>Odbc\Connection</type><type>false</type></type><methodname>odbc_connect</methodname>
<methodparam><type>string</type><parameter>dsn</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>user</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>password</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><modifier role="attribute">#[\SensitiveParameter]</modifier><type class="union"><type>string</type><type>null</type></type><parameter>password</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>cursor_option</parameter><initializer><constant>SQL_CUR_USE_DRIVER</constant></initializer></methodparam>
</methodsynopsis>
<simpara>

4
reference/uodbc/functions/odbc-pconnect.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c39225b6dd23f358824f44f5b8c733517b11830b Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: c68bcb2af14260247d8afe5e13d957e10e44c4af Maintainer: leonardolara Status: ready -->
<refentry xml:id="function.odbc-pconnect" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>odbc_pconnect</refname>
@@ -12,7 +12,7 @@
<type class="union"><type>Odbc\Connection</type><type>false</type></type><methodname>odbc_pconnect</methodname>
<methodparam><type>string</type><parameter>dsn</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>user</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>password</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><modifier role="attribute">#[\SensitiveParameter]</modifier><type class="union"><type>string</type><type>null</type></type><parameter>password</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>cursor_option</parameter><initializer><constant>SQL_CUR_USE_DRIVER</constant></initializer></methodparam>
</methodsynopsis>
<para>