Updates to outdated pages in reference/network (#407)

2026-03-23 22:52:12 +01:00 · 2023-12-10 23:43:49 -03:00
parent 546ddf6db5
commit 8b631726cf
6 changed files with 139 additions and 93 deletions
--- a/reference/mysqli/mysqli/real-connect.xml
+++ b/reference/mysqli/mysqli/real-connect.xml
@@ -45,7 +45,7 @@
     objeto <classname>mysqli</classname>.
     Isto pode ser obtido chamando-se
     <methodname>mysqli::__construct</methodname> ou
-     <function>mysqli_init</function> sem argumentos.
+     <function>mysqli_connect</function> sem argumentos.
    </para>
   </listitem>
   <listitem>
--- a/reference/network/book.xml
+++ b/reference/network/book.xml
@@ -1,14 +1,15 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: felipe Status: ready -->
+<!-- EN-Revision: 1634a886415d0ab4df195fe49d18a1c150b70758 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe,leonardolara -->

 <book xml:id="book.network" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <?phpdoc extension-membership="core" ?>
 <title>Network</title>

 <!-- {{{ preface -->
 <preface xml:id="intro.network">
  &reftitle.intro;
  <para>
-   Provê várias funções para rede.
+   Fornece várias funções para rede.
  </para>
 </preface>
 <!-- }}} -->
--- a/reference/network/functions/fsockopen.xml
+++ b/reference/network/functions/fsockopen.xml
@@ -1,20 +1,20 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 8b5940cadeb4f1c8492f4a7f70743a2be807cf39 Maintainer: thiago Status: ready -->
-<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fsockopen">
+<!-- EN-Revision: 4e6f0774f03131cbeeb8c21019a690bf97fd22b6 Maintainer: leonardolara Status: ready --><!-- CREDITS: thiago,leonardolara -->
+<refentry xml:id="function.fsockopen" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>fsockopen</refname>
-  <refpurpose>Abre um socket de conexão Internet ou de domínio Unix</refpurpose>
+  <refpurpose>Abre uma conexão socket de domínio Unix ou Internet</refpurpose>
 </refnamediv>
- 
+
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
-   <type>resource</type><methodname>fsockopen</methodname>
+   <type class="union"><type>resource</type><type>false</type></type><methodname>fsockopen</methodname>
   <methodparam><type>string</type><parameter>hostname</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>port</parameter><initializer>-1</initializer></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter role="reference">errno</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter role="reference">errstr</parameter></methodparam>
-   <methodparam choice="opt"><type>float</type><parameter>timeout</parameter><initializer>ini_get("default_socket_timeout")</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter role="reference">error_code</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter role="reference">error_message</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>timeout</parameter><initializer>&null;</initializer></methodparam>
  </methodsynopsis>
  <para>
   Inicia uma conexão socket para o recurso especificado em
@@ -23,17 +23,17 @@
  <para>
   O PHP suporta alvos na Internet ou domínios Unix, conforme descrito em
   <xref linkend="transports"/>. Uma lista dos transportes suportados pode
-   ser encontrada utilizando a função <function>stream_get_transports</function>.
+   ser encontrada utilizando-se a função <function>stream_get_transports</function>.
  </para>
  <para>
-   Por padrão o socket será aberto em modo de bloqueio. Você pode mudar para o
-   modo desbloqueado utilizando a função 
+   Por padrão o socket será aberto em modo de bloqueio. Pode-se mudar para o
+   modo de não-bloqueio utilizando-se a função
   <function>stream_set_blocking</function>.
  </para>
  <para>
-   A função <function>stream_socket_client</function> é similar mas provê um
-   número maior de opções, incluindo conxão não bloqueada e a habilidade de
-   adicionar um contexto de corrente (stream context).
+   A função <function>stream_socket_client</function> é similar mas fornece um
+   número maior de opções, incluindo conexão não bloqueada e a habilidade de
+   fornecer um contexto de fluxo .
  </para>
 </refsect1>
 <refsect1 role="parameters">
@@ -44,11 +44,11 @@
     <term><parameter>hostname</parameter></term>
     <listitem>
      <para>
-       Se você compilou <link linkend="openssl.installation">com suporte</link>
-       a OpenSSL, você pode colocar os prefixos <literal>ssl://</literal> ou 
-       <literal>tls://</literal> ao <parameter>hostname</parameter> para utilizar 
-       SSL ou uma conexão cliente TLS sobre TCP/IP para conectar com o 
-       host remoto.
+       Se o suporte Open SSL <link linkend="openssl.installation">estiver
+       instalado</link>, pode-se prefixar o <parameter>hostname</parameter>
+       com <literal>ssl://</literal> ou <literal>tls://</literal> para utilizar
+       uma conexão SSL ou TLS sobre TCP/IP para conectar-se ao
+       servidor remoto.
      </para>
     </listitem>
    </varlistentry>
@@ -56,33 +56,33 @@
     <term><parameter>port</parameter></term>
     <listitem>
      <para>
-       O número da porta. Pode ser omitido e pulado com
+       O número da porta. Pode ser omitido e ignorado com
       <literal>-1</literal> para transportes que não usam portas, como
       <literal>unix://</literal>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
-     <term><parameter>errno</parameter></term>
+     <term><parameter>error_code</parameter></term>
     <listitem>
      <para>
       Se informado, guarda o número do erro do sistema que aconteceu na chamada de
       <literal>connect()</literal> no nível do sistema.
      </para>
      <para>
-       Se o valor retornado em <parameter>errno</parameter> é
-       <literal>0</literal> e a função retornou &false;, é um indicativo que o
-       erro aconteceu antes da chamada de 
-       <literal>connect()</literal>. É bem provável que isso aconteça por um
-       problema de inicialização de socket.
+       Se o valor retornado em <parameter>error_code</parameter> for
+       <literal>0</literal> e a função retornou &false;, é uma indicação que o
+       erro aconteceu antes da chamada a
+       <literal>connect()</literal>. A causa mais provável é um
+       problema na inicialização do socket.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
-     <term><parameter>errstr</parameter></term>
+     <term><parameter>error_message</parameter></term>
     <listitem>
      <para>
-       A mensagem de erro como string.
+       A mensagem de erro como uma string.
      </para>
     </listitem>
    </varlistentry>
@@ -90,15 +90,16 @@
     <term><parameter>timeout</parameter></term>
     <listitem>
      <para>
-       Timeout de conexão, em segundos.
+       Limite de tempo de conexão, em segundos. Quando igual a &null;, a configuração
+       <link linkend="ini.default-socket-timeout">default_socket_timeout</link> &php.ini; é usada.
      </para>
      <note>
       <para>
-        Se você precisa de um timeout para ler/escrever dados através do
+        Se for necessário um limite de tempo para ler/escrever dados através do
        socket, use <function>stream_set_timeout</function>, já que o
        parâmetro <parameter>timeout</parameter> de
-        <function>fsockopen</function> somente é aplicado enquanto o socket
-        está conectando.
+        <function>fsockopen</function> somente é aplicável enquanto o socket
+        estiver conectando.
       </para>
      </note>
     </listitem>
@@ -110,9 +111,9 @@
  &reftitle.returnvalues;
  <para>
   <function>fsockopen</function> retorna um ponteiro de arquivo que pode ser
-   usado em em conjunto com outras funções de arquivo (como 
+   usado em em conjunto com outras funções de arquivo (como
   <function>fgets</function>, <function>fgetss</function>,
-   <function>fwrite</function>, <function>fclose</function>, e
+   <function>fwrite</function>, <function>fclose</function> e
   <function>feof</function>). Se a chamada falhar, ela retornará &false;.
  </para>
 </refsect1>
@@ -120,14 +121,37 @@
  &reftitle.errors;
  <para>
   Dispara um <constant>E_WARNING</constant> se <parameter>hostname</parameter> não
-   é um domínio válido.
+   for um domínio válido.
  </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>
+       <parameter>timeout</parameter> agora pode ser nulo.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
-    <title><function>fsockopen</function> Exemplo</title>
+    <title>Exemplo de <function>fsockopen</function></title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -153,8 +177,8 @@ if (!$fp) {
   <example>
    <title>Utilizando conexão UDP</title>
    <para>
-     O exemplo abaixo mostra como recuperar o valor de dia e hora do serviço
-     UDP (porta 13) da sua própria máquina.
+     O exemplo abaixo mostra como obter o dia e o horário do serviço
+     UDP (porta 13) da própria máquina.
    </para>
    <programlisting role="php">
 <![CDATA[
@@ -177,18 +201,18 @@ if (!$fp) {
  &reftitle.notes;
  <note>
   <para>
-    Dependedendo do ambiente, o domínio Unix ou o opcional timeout de conexão
-    não estarão disponíveis.
+    Dependedendo do ambiente, o domínio Unix ou o limite opcional de tempo
+    de conexão podem não estar disponíveis.
   </para>
  </note>
  <warning>
   <para>
    Sockets UDP algumas vezes irão parecer que foram abertos sem erro, mesmo
-    que o host remoto seja inalcançável. O erro só se tornará aparente quando
-    você ler ou escrever dados de/para o socket. A razão disso é porque o UDP
-    é um protocolo "sem conexão", o que significa que o sistema operacional
-    não tenta estabelecer uma ligação para o socket até que ele realmente
-    precise enviar ou receber dados.
+    que o servidor remoto seja inalcançável. O erro só se tornará
+    aparente quando dados são lidos ou escritos no socket.
+    A razão disso é porque o UDP é um protocolo "sem conexão",
+    o que significa que o sistema operacional não tenta estabelecer
+    uma ligação para o socket até que ele realmente precise enviar ou receber dados.
   </para>
  </warning>
  &ipv6.brackets;
--- a/reference/network/functions/gethostbyaddr.xml
+++ b/reference/network/functions/gethostbyaddr.xml
@@ -1,21 +1,21 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: felipe Status: ready --><!-- CREDITS: surfmax -->
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: leonardolara Status: ready --><!-- CREDITS: surfmax,felipe,leonardolara -->
 <refentry xml:id="function.gethostbyaddr" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>gethostbyaddr</refname>
  <refpurpose>
-   Obtém nome do host de Internet correspondendo ao endereçõ de IP fornecido.
+   Obtém nome do servidor de Internet correspondente ao endereço de IP fornecido
  </refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
-   <methodsynopsis>
-    <type>string</type><methodname>gethostbyaddr</methodname>
-    <methodparam><type>string</type><parameter>ip_address</parameter></methodparam>
-   </methodsynopsis>
+  <methodsynopsis>
+   <type class="union"><type>string</type><type>false</type></type><methodname>gethostbyaddr</methodname>
+   <methodparam><type>string</type><parameter>ip</parameter></methodparam>
+  </methodsynopsis>
  <para>
-   Retorna o nome do host do host de Internet especificado por
-   <parameter>ip_address</parameter>.
+   Retorna o nome do servidor de Internet especificado por
+   <parameter>ip</parameter>.
  </para>
 </refsect1>

@@ -24,7 +24,7 @@
  <para>
   <variablelist>
    <varlistentry>
-     <term><parameter>ip_address</parameter></term>
+     <term><parameter>ip</parameter></term>
     <listitem>
      <para>
       O endereço IP do host.
@@ -38,8 +38,8 @@
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
-   Retorna o nome do host ou o não modificado <parameter>ip_address</parameter>
-   em falha.
+   Retorna o nome do servidor em caso de sucesso, o <parameter>ip</parameter> não modificado
+   em caso de falha, ou &false; em caso de entrada mal formatada.
  </para>
 </refsect1>

@@ -52,7 +52,7 @@
 <![CDATA[
 <?php
 $hostname = gethostbyaddr($_SERVER['REMOTE_ADDR']);
-  
+
 echo $hostname;
 ?>
 ]]>
@@ -72,7 +72,6 @@ echo $hostname;
 </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
--- a/reference/network/functions/header-remove.xml
+++ b/reference/network/functions/header-remove.xml
@@ -1,17 +1,16 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 40aa01246179c34275aa5794650ccb8017ad833a Maintainer: none Status: ready -->
-
+<!-- EN-Revision: 4e6f0774f03131cbeeb8c21019a690bf97fd22b6 Maintainer: leonardolara Status: ready -->
 <refentry xml:id="function.header-remove" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>header_remove</refname>
-  <refpurpose>Remove os cabeçalhos definidos anteriormente</refpurpose>
+  <refpurpose>Remove cabeçalhos definidos anteriormente</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>void</type><methodname>header_remove</methodname>
-   <methodparam choice="opt"><type>string</type><parameter>name</parameter></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>name</parameter><initializer>&null;</initializer></methodparam>
  </methodsynopsis>
  <para>
   Remove um cabeçalho HTTP previamente definido usando <function>header</function>.
@@ -26,11 +25,11 @@
     <term><parameter>name</parameter></term>
     <listitem>
      <para>
-       O nome do cabeçalho a ser removido.
+       O nome do cabeçalho a ser removido. Quando igual a &null;, todos os cabeçalhos anteriormente definidos são removidos.
      </para>
      <note>
       <simpara>
-        Este parâmetro é case-sensitive
+        Este parâmetro é insensível a maiúsculas/minúsculas.
       </simpara>
      </note>
     </listitem>
@@ -46,6 +45,28 @@
  </para>
 </refsect1>

+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       <parameter>name</parameter> agora pode ser nulo.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
@@ -56,7 +77,7 @@
 <?php
 header("X-Foo: Bar");
 header("X-Bar: Baz");
-header_remove("X-Foo"); 
+header_remove("X-Foo");
 ?>
 ]]>
    </programlisting>
@@ -74,7 +95,7 @@ X-Bar: Baz
 <?php
 header("X-Foo: Bar");
 header("X-Bar: Baz");
-header_remove(); 
+header_remove();
 ?>
 ]]>
    </programlisting>
@@ -91,8 +112,8 @@ header_remove();
  &reftitle.notes;
  <caution>
   <para>
-    Esta função irá remover <emphasis>todos</emphasis> os cabeçalhos setados pelo PHP,
-    incluindo cookies, session e o <literal>X-Powered-By</literal> cabeçalhos.
+    Esta função irá remover <emphasis>todos</emphasis> os cabeçalhos definidos pelo PHP,
+    incluindo cabeçalhos de cookies, session e <literal>X-Powered-By</literal>.
   </para>
  </caution>
  &note.network.header.sapi;
@@ -109,7 +130,6 @@ header_remove();
 </refsect1>

 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -130,4 +150,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->
-
--- a/reference/network/functions/headers-list.xml
+++ b/reference/network/functions/headers-list.xml
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 3a29c12dc213a208e868ba1d1a7b8530e90ab5f3 Maintainer: none Status: ready -->
+<!-- EN-Revision: eecf09080681d1e242b9dc1b8a8148eda66141f8 Maintainer: leonardolara Status: ready -->
 <refentry xml:id="function.headers-list" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>headers_list</refname>
-  <refpurpose>Retorna uma lista de cabeçalhos enviados para o servidor (ou pronto para enviar)</refpurpose>
+  <refpurpose>Retorna uma lista de cabeçalhos de resposta enviados (ou prontos para enviar)</refpurpose>
 </refnamediv>
- 
+
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
@@ -13,16 +13,21 @@
   <void/>
  </methodsynopsis>
  <para>
-   <function>headers_list</function> Irá retornar uma lista de cabeçalhos a serem enviados
-   para o navegador / cliente.  Para determinar se esses cabeçalhos têm ou ainda não
-   foram enviados, use <function>headers_sent</function>.
+   <function>headers_list</function> retornará uma lista de cabeçalhos a serem enviados
+   ao navegador / cliente.  Para determinar se esses cabeçalhos já foram ou não
+   enviados, use <function>headers_sent</function>.
  </para>
 </refsect1>

+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
-   Retorna um array indexado de cabeçalhos.
+   Retorna um array de cabeçalhos indexado numericamente.
  </para>
 </refsect1>

@@ -30,20 +35,20 @@
  &reftitle.examples;
  <para>
   <example>
-    <title>Exemplos usando <function>headers_list</function></title>
+    <title>Exemplo usando <function>headers_list</function></title>
    <programlisting role="php">
 <![CDATA[
 <?php

-/* setcookie() Irá adicionar um cabeçalho de resposta por conta própria */
+/* setcookie() irá adicionar um cabeçalho de resposta por conta própria */
 setcookie('foo', 'bar');

 /* Define um cabeçalho de resposta personalizado
   Isso será ignorado pela maioria dos clientes */
-header("X-Sample-Test: foo");
+header("Example-Test: foo");

-/* Específica o conteúdo de texto simples em nossa resposta */
-header('Content-type: text/plain');
+/* Especifica conteúdo em texto simples na resposta */
+header('Content-Type: text/plain; charset=UTF-8');

 /* Quais cabeçalhos serão enviados? */
 var_dump(headers_list());
@@ -51,18 +56,16 @@ var_dump(headers_list());
 ?>
 ]]>
    </programlisting>
-    &example.outputs;
+    &example.outputs.similar;
    <screen>
 <![CDATA[
-array(4) {
+array(3) {
  [0]=>
-  string(23) "X-Powered-By: PHP/5.1.3"
-  [1]=>
  string(19) "Set-Cookie: foo=bar"
+  [1]=>
+  string(17) "Example-Test: foo"
  [2]=>
-  string(18) "X-Sample-Test: foo"
-  [3]=>
-  string(24) "Content-type: text/plain"
+  string(39) "Content-Type: text/plain; charset=UTF-8"
 }

 ]]>