Skip to content

Commit 70a8e0d

Browse files
leonardolaraleonardolara
committed
sync with en rev
1 parent cdbb657 commit 70a8e0d

File tree

14 files changed

+151
-129
lines changed

14 files changed

+151
-129
lines changed

‎appendices/migration85/incompatible.xml‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: ec01a42be50e84f192c0b19fc6e9cf40a0f7ac31 Maintainer: leonardolara Status: ready -->
1+
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: f81bbcf9d36c28bf067b5514cffdbc7663357cf3 Maintainer: leonardolara Status: ready -->
22
<sect1 xml:id="migration85.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
33
<title>Alterações Incompatíveis com Versões Anteriores</title>
44

@@ -332,9 +332,9 @@
332332

333333
<simpara>
334334
Tentar chamar <methodname>PDOStatement::setFetchMode</methodname> durante
335-
uma chamada para <methodname>PDO::fetch</methodname>,
336-
<methodname>PDO::fetchObject</methodname>,
337-
<methodname>PDO::fetchAll</methodname>, por exemplo, usando truques como
335+
uma chamada para <methodname>PDOStatement::fetch</methodname>,
336+
<methodname>PDOStatement::fetchObject</methodname>,
337+
<methodname>PDOStatement::fetchAll</methodname>, por exemplo, usando truques como
338338
passar o objeto de instrução como um argumento do construtor ao buscar em um
339339
objeto, agora lançará um <exceptionname>Error</exceptionname>.
340340
</simpara>
@@ -357,7 +357,7 @@
357357
<simpara>
358358
Agora, uma exceção <exceptionname>ValueError</exceptionname> é lançada se
359359
<constant>PDO::FETCH_INTO</constant> for usada como modo de busca em
360-
<methodname>PDO::fetchAll</methodname>,
360+
<methodname>PDOStatement::fetchAll</methodname>,
361361
similar a <constant>PDO::FETCH_LAZY</constant>.
362362
</simpara>
363363

‎appendices/transports.xml‎

Lines changed: 20 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 1268a5eebbd09dbc4c4d5272c2bcdc0b035c256c Maintainer: ae Status: ready --><!-- CREDITS: vagnerstrapassongmail.com,duan.trabalhohotmail.com,narigone,ae -->
2+
<!-- EN-Revision: ae90ecc9328f3abea16a9af69a5f18b24d530832 Maintainer: leonardolara Status: ready --><!-- CREDITS: narigone,ae,leonardolara -->
33
<appendix xml:id="transports" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
44
<title>Lista de Transportes via Soquete Suportados</title>
55
<para>
@@ -22,6 +22,13 @@
2222
<literal>ssl://</literal>, <literal>tls://</literal>,
2323
<literal>sslv2://</literal> &amp; <literal>sslv3://</literal>.
2424
</simpara>
25+
<note>
26+
<simpara>
27+
Os transportes <literal>sslv2://</literal> e <literal>sslv3://</literal>
28+
são obsoletos e não devem ser usados. Eles estão documentados apenas
29+
para compatibilidade com versões anteriores.
30+
</simpara>
31+
</note>
2532

2633
<note>
2734
<simpara>
@@ -38,8 +45,6 @@
3845
<listitem><simpara><literal>tcp://www.example.com</literal></simpara></listitem>
3946
<listitem><simpara><literal>udp://www.example.com</literal></simpara></listitem>
4047
<listitem><simpara><literal>ssl://www.example.com</literal></simpara></listitem>
41-
<listitem><simpara><literal>sslv2://www.example.com</literal></simpara></listitem>
42-
<listitem><simpara><literal>sslv3://www.example.com</literal></simpara></listitem>
4348
<listitem><simpara><literal>tls://www.example.com</literal></simpara></listitem>
4449
</itemizedlist>
4550

@@ -78,11 +83,18 @@
7883
</simpara>
7984

8085
<simpara>
81-
<literal>ssl://</literal> tentará negociar uma conexão SSL V2
82-
ou SSL V3, dependendo das capacidades e preferências do
83-
host remoto. <literal>sslv2://</literal> e
84-
<literal>sslv3://</literal> selecionará o protocolo de maneira
85-
explícita.
86+
<literal>ssl://</literal> tentará negociar uma conexão SSL/TLS segura
87+
dependendo das capacidades e preferências do
88+
host remoto e do cliente. Os protocolos reais que podem ser usados são
89+
determinados pela configuração OpenSSL e pelas opções fornecidas
90+
através da função <function>stream_context_create</function>, tal como
91+
<literal>ssl.crypto_method</literal>.
92+
</simpara>
93+
94+
<simpara>
95+
Os protocolos SSLv2 e SSLv3 são obsoletos e inseguros. O uso deles é
96+
fortemente desencorajado e eles não estão mais habilitados por padrão nas
97+
versões modernas do PHP e do OpenSSL.
8698
</simpara>
8799
</section>
88100

‎features/commandline.xml‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 74ba8fee2972b6ba4f955392d760dea54e757a95 Maintainer: leonardolara Status: ready --><!-- CREDITS: ThamaraHessel,pauloelr,royopa,ae,geekcom,leonardolara -->
2+
<!-- EN-Revision: 96b10a98853e3b8236504e5775f95eb4a15c82c3 Maintainer: leonardolara Status: ready --><!-- CREDITS: ThamaraHessel,pauloelr,royopa,ae,geekcom,leonardolara -->
33
<chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
44
<title>Usando PHP a partir da linha de comando</title>
55
<titleabbrev>Uso da linha de Comando</titleabbrev>
@@ -1755,6 +1755,13 @@ php >
17551755
<note>
17561756
<simpara>Este recurso não é suportado no Windows.</simpara>
17571757
</note>
1758+
<note>
1759+
<simpara>
1760+
Para informações sobre o uso e as opções do PHP em linha de comando, execute
1761+
<command>php --help</command> ou <command>man php</command>. Nem todas
1762+
as opções se aplicam quando o PHP está sendo executado como servidor web.
1763+
</simpara>
1764+
</note>
17581765
<warning>
17591766
<para>
17601767
Este recurso <emphasis>experimental</emphasis> <emphasis>não</emphasis>

‎features/http-auth.xml‎

Lines changed: 27 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: bdf9a4e40204c805f2c2a5c94c2f2f8f5556195a Maintainer: ae Status: ready --><!-- CREDITS: rfoliveira,ae,leonardolara -->
2+
<!-- EN-Revision: cd4180557a185469a64a7eb26f7be98d0a5f1ebb Maintainer: leonardolara Status: ready --><!-- CREDITS: rfoliveira,ae,leonardolara -->
33
<chapter xml:id="features.http-auth" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
44
<title>Autenticação HTTP com PHP</title>
55

@@ -29,8 +29,8 @@
2929
<![CDATA[
3030
<?php
3131
if (!isset($_SERVER['PHP_AUTH_USER'])) {
32+
header('HTTP/1.1 401 Unauthorized');
3233
header('WWW-Authenticate: Basic realm="My Realm"');
33-
header('HTTP/1.0 401 Unauthorized');
3434
echo 'Texto enviado caso o usuário clique no botão Cancelar';
3535
exit;
3636
} else {
@@ -44,13 +44,13 @@ if (!isset($_SERVER['PHP_AUTH_USER'])) {
4444
</para>
4545

4646
<note>
47-
<title>Nota sobre compatibilidade</title>
47+
<title>Compatibilidade</title>
4848
<para>
4949
Por favor, seja cauteloso ao codificar as linhas do cabeçalho HTTP. Para garantir máxima
5050
compatibilidade com todos os clientes, a palavra-chave "Basic" deve ser escrita com um
5151
"B" maiúsculo, a string realm deve ser envolvida por aspas duplas (nunca por aspas simples),
5252
e apenas um espaço deve preceder o código <emphasis>401</emphasis> na linha do cabeçalho
53-
<emphasis>HTTP/1.0 401</emphasis>. Parâmetros de autenticação precisam ser separados por
53+
<emphasis>HTTP/1.1 401</emphasis>. Parâmetros de autenticação precisam ser separados por
5454
vírgula.
5555
</para>
5656
</note>
@@ -63,16 +63,8 @@ if (!isset($_SERVER['PHP_AUTH_USER'])) {
6363
o usuário em um arquivo dbm.
6464
</para>
6565

66-
<para>
67-
Cuidado com navegadores Internet Explorer bugados por aí. Eles
68-
parecem muito minuciosos sobre a ordem dos cabeçalhos. Enviar
69-
o cabeçalho <emphasis>WWW-Authenticate</emphasis> antes do
70-
cabeçalho <literal>HTTP/1.0 401</literal> parece resolver isso
71-
por enquanto.
72-
</para>
73-
7466
<note>
75-
<title>Nota de configuração</title>
67+
<title>Configuração do Apache</title>
7668
<para>
7769
O PHP usa uma diretiva chamada <literal>AuthType</literal>
7870
para determinar se a autenticação externa está em efeito.
@@ -84,68 +76,34 @@ if (!isset($_SERVER['PHP_AUTH_USER'])) {
8476
controle uma URL não autenticada roube senhas de
8577
URLs autenticadas no mesmo servidor.
8678
</simpara>
87-
<simpara>
88-
Tanto o Netscape Navigator quanto o Internet Explorer apagarão o cache de
89-
autenticação da janela local do navegador para o realm após receber uma
90-
resposta 401 do servidor. Isso pode efetivamente "deslogar" um usuário,
91-
forçando o mesmo a re-entrar seu nome de usuário e senha. Algumas pessoas
92-
usam isso para delimitar o tempo de um login, ou prover um botão de "log-out".
93-
</simpara>
94-
<para>
95-
<example>
96-
<title>Exemplo de Autenticação HTTP forçando um novo nome/senha</title>
97-
<programlisting role="php">
98-
<![CDATA[
99-
<?php
100-
function authenticate() {
101-
header('WWW-Authenticate: Basic realm="Test Authentication System"');
102-
header('HTTP/1.0 401 Unauthorized');
103-
echo "Você deve digitar um login e senha válidos para acessar este recurso\n";
104-
exit;
105-
}
10679

107-
if (!isset($_SERVER['PHP_AUTH_USER']) ||
108-
($_POST['SeenBefore'] == 1 && $_POST['OldAuth'] == $_SERVER['PHP_AUTH_USER'])) {
109-
authenticate();
110-
} else {
111-
echo "<p>Bem-vindo: " . htmlspecialchars($_SERVER['PHP_AUTH_USER']) . "<br />";
112-
echo "Antigo: " . htmlspecialchars($_REQUEST['OldAuth']);
113-
echo "<form action='' method='post'>\n";
114-
echo "<input type='hidden' name='SeenBefore' value='1' />\n";
115-
echo "<input type='hidden' name='OldAuth' value=\"" . htmlspecialchars($_SERVER['PHP_AUTH_USER']) . "\" />\n";
116-
echo "<input type='submit' value='Re-autenticar' />\n";
117-
echo "</form></p>\n";
118-
}
119-
?>
120-
]]>
121-
</programlisting>
122-
</example>
123-
</para>
124-
<simpara>
125-
Este comportamento não é requerido pelo padrão de autenticação <literal>HTTP Basic</literal>,
126-
então nunca se deve depender dele. Testes com
127-
<literal>Lynx</literal> tem mostrado que <literal>Lynx</literal> não apaga
128-
as credenciais de autenticação com uma resposta 401 do servidor, assim, ao pressionar "Voltar"
129-
e então "Ir" novamente abrirá o recurso contanto que os requerimento de credenciais
130-
não tenha mudado. Contudo, o usuário pode pressionar a tecla
131-
<literal>'_'</literal> para apagar suas informações de autenticação.
132-
</simpara>
133-
<simpara>
134-
Para fazer com que a autenticação HTTP funcione utilizando um servidor IIS com a versão CGI
135-
do PHP é necessário editar a configuração "<literal>Directory Security</literal>" do IIS.
136-
Clique em "<literal>Edit</literal>" e marque somente
137-
"<literal>Anonymous Access</literal>",
138-
deixe todos os outros campos desmarcados.
139-
</simpara>
14080
<note>
141-
<title>Nota sobre IIS:</title>
81+
<title>Comportamento do navegador</title>
14282
<simpara>
143-
Para que a autenticação HTTP funcione com IIS, a diretiva do PHP
144-
<link linkend="ini.cgi.rfc2616-headers">cgi.rfc2616_headers</link> deve
145-
ser definida como <literal>0</literal> (o valor default).
83+
A autenticação básica HTTP é realmente básica e não foi projetada para suportar
84+
logouts. Como o HTTP é um protocolo sem estado, a maioria dos navegadores armazena em cache as
85+
credenciais fornecidas assim que um código de status <literal>2xx</literal> é detectado,
86+
e as envia em todas as requisições, até que o navegador seja fechado. Não há
87+
uma maneira definida para um servidor solicitar uma nova solicitação de credenciais.
88+
89+
Ao longo dos anos, várias soluções alternativas para isso se espalharam como conselhos na internet,
90+
mas todas dependem de como diferentes navegadores optaram por lidar com casos extremos indefinidos
91+
(ou mesmo violações do padrão HTTP). É melhor evitar essas
92+
soluções alternativas e não usar a autenticação básica para nada sério.
14693
</simpara>
14794
</note>
14895

96+
<note>
97+
<title>Configuração do IIS</title>
98+
<simpara>
99+
Para que a autenticação HTTP funcione no servidor IIS com a versão CGI do
100+
PHP, a diretiva php.ini <link linkend="ini.cgi.rfc2616-headers">cgi.rfc2616_headers</link>
101+
deve ser definida como <literal>0</literal> (o valor padrão) e a configuração do IIS
102+
em "<literal>Directory Security</literal>" (ou "Segurança do Diretório" / "Autenticação") deve ser editada.
103+
Clique em "<literal>Edit</literal>" (ou "Editar") e marque apenas "<literal>Anonymous Access</literal>" (ou "Acesso Anônimo"),
104+
deixando todos os outros campos desmarcados.
105+
</simpara>
106+
</note>
149107
</chapter>
150108

151109
<!-- Keep this comment at the end of the file

‎reference/image/functions/getimagesize.xml‎

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: f8d1e172bd6d11986f0dfeb11756b90c039a39bc Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,marcosmarcolin,leonardolara -->
2+
<!-- EN-Revision: 6bb90d24b240a0b81e4b203cd8b7ed56bd54033a Maintainer: leonardolara Status: ready --><!-- CREDITS: fernandoc,marcosmarcolin,leonardolara -->
33
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.getimagesize">
44
<refnamediv>
55
<refname>getimagesize</refname>
@@ -185,6 +185,10 @@ if ($size && $fp) {
185185
<function>getimagesize</function> gerará um erro de nível
186186
<constant>E_NOTICE</constant>.
187187
</para>
188+
<para>
189+
A partir do PHP 8.0.0, um <exceptionname>ValueError</exceptionname> é lançado
190+
se <parameter>filename</parameter> estiver vazio.
191+
</para>
188192
</refsect1>
189193

190194
<refsect1 role="changelog">
@@ -207,6 +211,14 @@ if ($size && $fp) {
207211
e bits e channels não eram relatados de forma alguma.
208212
</entry>
209213
</row>
214+
<row>
215+
<entry>8.0.0</entry>
216+
<entry>
217+
Um <exceptionname>ValueError</exceptionname> agora é lançado se
218+
<parameter>filename</parameter> estiver vazio; anteriormente, um
219+
<constant>E_WARNING</constant> era emitido e a função retornava &false;.
220+
</entry>
221+
</row>
210222
<row>
211223
<entry>7.1.0</entry>
212224
<entry>

‎reference/intl/grapheme/grapheme-str-split.xml‎

Lines changed: 1 addition & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: ee94fd0c20566ec20b0dbfa5ab639d6bb0e9f890 Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 122d5d09692db103ef8e7b2e2fc31583ff3807e2 Maintainer: leonardolara Status: ready -->
33
<refentry xml:id="function.grapheme-str-split" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
44
<refnamediv>
55
<refname>grapheme_str_split</refname>
@@ -60,23 +60,6 @@
6060
</simpara>
6161
</refsect1>
6262

63-
<refsect1 role="changelog">
64-
&reftitle.changelog;
65-
<informaltable>
66-
<tgroup cols="2">
67-
<thead>
68-
<row>
69-
<entry>&Version;</entry>
70-
<entry>&Description;</entry>
71-
</row>
72-
</thead>
73-
<tbody>
74-
&intl.changelog.grapheme.locale;
75-
</tbody>
76-
</tgroup>
77-
</informaltable>
78-
</refsect1>
79-
8063
<refsect1 role="seealso">
8164
&reftitle.seealso;
8265
<simplelist>

‎reference/intl/intlchar.xml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 5e36b489fc67bd0b5c424c7d1cd131c2e982bc5c Maintainer: leonardolara Status: ready -->
2+
<!-- EN-Revision: 63bd68a3fd48950db6f5349e24eaaea8ebeef880 Maintainer: leonardolara Status: ready -->
33
<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">
44

55
<title>IntlChar</title>
@@ -10721,7 +10721,7 @@
1072110721
<entry>8.4.0</entry>
1072210722
<entry>
1072310723
Adicionadas as constantes <constant>IntlChar::PROPERTY_IDS_UNARY_OPERATOR</constant>, <constant>IntlChar::PROPERTY_ID_COMPAT_MATH_START</constant> e
10724-
<constant>IntlChar::PROPERTY_ID_COMPAT_MATH_START</constant>.
10724+
<constant>IntlChar::PROPERTY_ID_COMPAT_MATH_CONTINUE</constant>.
1072510725
</entry>
1072610726
</row>
1072710727
<row>

‎reference/json/functions/json-last-error.xml‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 7100979e254970cef72c6f91b32352e7c7898635 Maintainer: leonardolara Status: ready --><!-- CREDITS: Jefersson Nathan,willian-rosa,leonardolara -->
2+
<!-- EN-Revision: 058ea1e8420b9c1b24402af52545e8313428e1d1 Maintainer: leonardolara Status: ready --><!-- CREDITS: Jefersson Nathan,willian-rosa,leonardolara -->
33
<refentry xml:id="function.json-last-error" xmlns="http://docbook.org/ns/docbook">
44
<refnamediv>
55
<refname>json_last_error</refname>
@@ -100,6 +100,11 @@
100100
<entry>Caracteres UTF-16 malformados, possivelmente codificados incorretamente</entry>
101101
<entry></entry>
102102
</row>
103+
<row>
104+
<entry><constant>JSON_ERROR_NON_BACKED_ENUM</constant></entry>
105+
<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>
106+
<entry></entry>
107+
</row>
103108
</tbody>
104109
</tgroup>
105110
</table>

‎reference/math/functions/fmod.xml‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 761d72245071f89a626903c9bcdc6aaff1252d54 Maintainer: leonardolara Status: ready --><!-- CREDITS: royopa,leonardolara -->
2+
<!-- EN-Revision: 54a788ca59d95ff2b4189406437345a21b489435 Maintainer: leonardolara Status: ready --><!-- CREDITS: royopa,leonardolara -->
33
<refentry xml:id="function.fmod" xmlns="http://docbook.org/ns/docbook">
44
<refnamediv>
55
<refname>fmod</refname>
@@ -50,7 +50,8 @@
5050
&reftitle.returnvalues;
5151
<para>
5252
O resto em ponto flutuante de
53-
<parameter>num1</parameter>/<parameter>num2</parameter>
53+
<parameter>num1</parameter>/<parameter>num2</parameter>.
54+
<constant>NAN</constant> (<type>float</type>) se o segundo argumento for 0.
5455
</para>
5556
</refsect1>
5657
<refsect1 role="examples">

‎reference/random/random/randomizer/getfloat.xml‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: c142be811735a5542c8a2e4c4ed2f81e8cc3acc6 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
1+
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 423a1da63f8265c57827234807709232afd274ec Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
22
<refentry xml:id="random-randomizer.getfloat" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
33
<refnamediv>
44
<refname>Random\Randomizer::getFloat</refname>
@@ -341,6 +341,15 @@ Lat: +69.244304 Lng: -53.548951
341341
para obter as propriedades comportamentais desejadas.
342342
</para>
343343
</note>
344+
<caution>
345+
<para>
346+
O underflow é intencionalmente deixado sem tratamento no algoritmo de seção γ.
347+
Isso pode resultar em valores incorretos sendo retornados para intervalos com
348+
limites na faixa subnormal de números de ponto flutuante, ou seja,
349+
para limites com um valor absoluto menor que aproximadamente
350+
<literal>2<superscript>-1020</superscript></literal> (cerca de <literal>8,9e-308</literal>).
351+
</para>
352+
</caution>
344353
</refsect1>
345354

346355
<refsect1 role="seealso">

0 commit comments

Comments
 (0)