sync with en rev

php · Dec 4, 2024 · 7457a3f · 7457a3f
1 parent 27a41c9
commit 7457a3f
Show file tree

Hide file tree

Showing 12 changed files with 301 additions and 100 deletions.
diff --git a/appendices/ini.core.xml b/appendices/ini.core.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0ba1c35312f30144fae2cfc290824e6475e71cb0 Maintainer: ae Status: ready --><!-- CREDITS: ae,fibbarth,fabioluciano,rogeriopradoj,adiel,geekcom,rafaelbernard,leonardolara -->
+<!-- EN-Revision: 565582ac3739b56c81ee0206aac9c994ca9fdb5e Maintainer: ae Status: ready --><!-- CREDITS: ae,fibbarth,fabioluciano,rogeriopradoj,adiel,geekcom,rafaelbernard,leonardolara -->
 
  <section xml:id="ini.core" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>Descrição das principais diretivas do &php.ini;</title>
@@ -1265,15 +1265,20 @@ include_path = ".:${USER}/pear/php"
         O padrão é permitir que todos os arquivos sejam abertos.
        </para>
        <note>
-        <para>
+        <simpara>
          open_basedir pode ser restringido em tempo de execução. Isto significa
          que se open_basedir é configurado para <literal>/www/</literal> no &php.ini;
          então um script pode restringir a configuração para
          <literal>/www/tmp/</literal> em tempo de execução com
          <function>ini_set</function>. Ao listar vários diretórios é
          possível utilizar a constante <constant>PATH_SEPARATOR</constant> como um separador
          independentemente do sistema operacional.
-        </para>
+        </simpara>
+        <simpara>
+         A partir do PHP 8.3.0, <option>open_basedir</option> não aceita mais um
+         caminho contendo o diretório superior (<literal>..</literal>) quando
+         definido no momento da execução usando <function>ini_set</function>.
+        </simpara>
        </note>
        <note>
         <para>

diff --git a/reference/calendar/functions/easter-date.xml b/reference/calendar/functions/easter-date.xml
@@ -1,9 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a0fcdcb58023bd4cb017fdba511df29b9f7a25f5 Maintainer: leonardolara Status: ready -->
+<!-- EN-Revision: 7706c4d3877d401e26e7f09b17f765337dd4405c Maintainer: leonardolara Status: ready -->
 <refentry xml:id="function.easter-date" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>easter_date</refname>
-  <refpurpose>Obtém o timestamp Unix para a meia-noite da Páscoa de um ano informado</refpurpose>
+  <refpurpose>Obtém o timestamp Unix para a meia-noite local da Páscoa de um ano informado</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,22 +14,22 @@
    <methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer><constant>CAL_EASTER_DEFAULT</constant></initializer></methodparam>
   </methodsynopsis>
   <para>
-   Retorna o timestamp Unix correspondente à meia-noite de Páscoa do
+   Retorna o timestamp Unix correspondente à meia-noite local da Páscoa do
    ano informado.
   </para>
   <para>
    A data do Dia de Páscoa foi definida pelo Concílio de Niceia no
-   ano 325 D.C. como o domingo após a primeira lua cheia que caia no
-   Equinócio de Primavera ou depois dele. Assume-se que o Equinócio seja sempre
+   ano 325 D.C. como o domingo após a primeira lua cheia que cai no
+   equinócio de primavera ou depois dele. Assume-se que o equinócio seja sempre
    no dia 21 de março, portanto o cálculo se reduz a determinar a data
    da lua cheia e a data do domingo seguinte. O
    algoritmo usado aqui foi introduzido por volta do ano 532 por
-   Dionísio, o Exíguo. Sob o calendário Juliano (para anos anteriores a
-   1753) um ciclo simples de 19 anos é usado para acompanhar as fases da
+   Dionísio, o exíguo. Sob o calendário Juliano (para anos anteriores a
+   1753), um ciclo simples de 19 anos é usado para acompanhar as fases da
    lua. Sob o calendário Gregoriano (para anos posteriores a 1753 -
    concebido por Cristóvão Clávio e Luís Lílio, e introduzido pelo Papa Gregório
    XIII em outubro de 1582, e na Grã-Bretanha e suas então colônias em
-   setembro de 1752) dois fatores de correção são adicionados para deixar
+   setembro de 1752), dois fatores de correção são adicionados para deixar
    o ciclo mais preciso.
   </para>
  </refsect1>
@@ -64,7 +64,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   A data de Páscoa como um timestamp Unix.
+   A data da Páscoa como um timestamp Unix.
   </para>
  </refsect1>
 

diff --git a/reference/classobj/functions/get-class-vars.xml b/reference/classobj/functions/get-class-vars.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: c44475e1fafcbee203ed4935a6d5d7a01379fcdc Maintainer: airtonzanon Status: ready --><!-- CREDITS: surfmax, adiel, felipe, airtonzanon -->
+<!-- EN-Revision: 1debc76060f0c33222789a299df72d0addd7fce3 Maintainer: leonardolara Status: ready --><!-- CREDITS: surfmax, adiel, felipe, airtonzanon, leonardolara -->
 <refentry xml:id="function.get-class-vars" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>get_class_vars</refname>
@@ -49,29 +49,28 @@
 <![CDATA[
 <?php
 
-class myclass {
-
-    var $var1; // sem valor default
-    var $var2 = "xyz";
-    var $var3 = 100;
+class MyClass
+{
+    public $var1; // Esta não tem valor padrão explícito (tecnicamente tem NULL como padrão)...
+    public $var2 = "xyz";
+    public $var3 = 100;
     private $var4;
 
-    // construtor
-    function myclass() {
-        // mudar algumas propriedades
+    public function __construct()
+    {
+        // altera algumas propriedades
         $this->var1 = "foo";
         $this->var2 = "bar";
         return true;
     }
-
 }
 
-$my_class = new myclass();
+$my_class = new MyClass();
 
 $class_vars = get_class_vars(get_class($my_class));
 
 foreach ($class_vars as $name => $value) {
-    echo "$name : $value\n";
+    echo "{$name}: ", var_export($value, true), "\n";
 }
 
 ?>
@@ -80,9 +79,9 @@ foreach ($class_vars as $name => $value) {
     &example.outputs;
     <screen>
 <![CDATA[
-var1 :
-var2 : xyz
-var3 : 100
+var1: NULL
+var2: 'xyz'
+var3: 100
 ]]>
     </screen>
    </example>
@@ -93,6 +92,7 @@ var3 : 100
     <programlisting role="php">
 <![CDATA[
 <?php
+
 function format($array)
 {
     return implode('|', array_keys($array)) . "\r\n";
@@ -112,6 +112,7 @@ class TestCase
 
 TestCase::expose();
 echo format(get_class_vars('TestCase'));
+
 ?>
 ]]>
     </programlisting>

diff --git a/reference/datetime/constants.xml b/reference/datetime/constants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 7913e8b074dfaddff7d8d7446532d8a99f7b9517 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe, fabioluciano, leonardolara -->
+<!-- EN-Revision: 26c2a159a4a875a29cd528aad16ea2c1c1051bd2 Maintainer: leonardolara Status: ready --><!-- CREDITS: felipe, fabioluciano, leonardolara -->
 <appendix xml:id="datetime.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  <para>
@@ -59,10 +59,13 @@
   </varlistentry>
  </variablelist>
 
- <variablelist role="constant_list">
+ <variablelist>
   <title>Constantes <constant>DATE_<replaceable>*</replaceable></constant></title>
   <varlistentry xml:id="constant.date-atom">
-   <term><constant>DATE_ATOM</constant></term>
+   <term>
+    <constant>DATE_ATOM</constant>
+    (<type>string</type>)
+   </term>
    <listitem>
     <simpara>
      Atômico (exemplo: <literal>2005-08-15T15:52:01+00:00</literal>)
@@ -71,7 +74,10 @@
   </varlistentry>
 
   <varlistentry xml:id="constant.date-cookie">
-   <term><constant>DATE_COOKIE</constant></term>
+   <term>
+    <constant>DATE_COOKIE</constant>
+    (<type>string</type>)
+   </term>
    <listitem>
     <simpara>
      Cookies HTTP (exemplo: <literal>Monday, 15-Aug-2005 15:52:01 UTC</literal>)
@@ -80,7 +86,10 @@
   </varlistentry>
 
   <varlistentry xml:id="constant.date-iso8601">
-   <term><constant>DATE_ISO8601</constant></term>
+   <term>
+    <constant>DATE_ISO8601</constant>
+    (<type>string</type>)
+   </term>
    <listitem>
     <simpara>
      ISO-8601 (exemplo: <literal>2005-08-15T15:52:01+0000</literal>)
@@ -98,7 +107,10 @@
   </varlistentry>
 
   <varlistentry xml:id="constant.date-iso8601-expanded">
-   <term><constant>DATE_ISO8601_EXPANDED</constant></term>
+   <term>
+    <constant>DATE_ISO8601_EXPANDED</constant>
+    (<type>string</type>)
+   </term>
    <listitem>
     <simpara>
      ISO-8601 Expandida (exemplo: <literal>+10191-07-26T08:59:52+01:00</literal>)
@@ -115,7 +127,10 @@
   </varlistentry>
 
   <varlistentry xml:id="constant.date-rfc822">
-   <term><constant>DATE_RFC822</constant></term>
+   <term>
+    <constant>DATE_RFC822</constant>
+    (<type>string</type>)
+   </term>
    <listitem>
     <simpara>
      RFC 822 (exemplo: <literal>Mon, 15 Aug 05 15:52:01 +0000</literal>)
@@ -124,7 +139,10 @@
   </varlistentry>
 
   <varlistentry xml:id="constant.date-rfc850">
-   <term><constant>DATE_RFC850</constant></term>
+   <term>
+    <constant>DATE_RFC850</constant>
+    (<type>string</type>)
+   </term>
    <listitem>
     <simpara>
      RFC 850 (exemplo: <literal>Monday, 15-Aug-05 15:52:01 UTC</literal>)
@@ -133,7 +151,10 @@
   </varlistentry>
 
   <varlistentry xml:id="constant.date-rfc1036">
-   <term><constant>DATE_RFC1036</constant></term>
+   <term>
+    <constant>DATE_RFC1036</constant>
+    (<type>string</type>)
+   </term>
    <listitem>
     <simpara>
      RFC 1036 (exemplo: <literal>Mon, 15 Aug 05 15:52:01 +0000</literal>)
@@ -142,7 +163,10 @@
   </varlistentry>
 
   <varlistentry xml:id="constant.date-rfc1123">
-   <term><constant>DATE_RFC1123</constant></term>
+   <term>
+    <constant>DATE_RFC1123</constant>
+    (<type>string</type>)
+   </term>
    <listitem>
     <simpara>
      RFC 1123 (exemplo: <literal>Mon, 15 Aug 2005 15:52:01 +0000</literal>)
@@ -151,17 +175,23 @@
   </varlistentry>
 
   <varlistentry xml:id="constant.date-rfc7231">
-    <term><constant>DATE_RFC7231</constant></term>
-    <listitem>
-     <simpara>
-      RFC 7231 (a partir do PHP 7.0.19 e 7.1.5)
-      (exemplo: <literal>Sat, 30 Apr 2016 17:52:13 GMT</literal>)
-     </simpara>
-    </listitem>
+   <term>
+    <constant>DATE_RFC7231</constant>
+    (<type>string</type>)
+   </term>
+   <listitem>
+    <simpara>
+     RFC 7231 (a partir do PHP 7.0.19 e 7.1.5)
+     (exemplo: <literal>Sat, 30 Apr 2016 17:52:13 GMT</literal>)
+    </simpara>
+   </listitem>
   </varlistentry>
 
   <varlistentry xml:id="constant.date-rfc2822">
-   <term><constant>DATE_RFC2822</constant></term>
+   <term>
+    <constant>DATE_RFC2822</constant>
+    (<type>string</type>)
+   </term>
    <listitem>
     <simpara>
      RFC 2822 (exemplo: <literal>Mon, 15 Aug 2005 15:52:01 +0000</literal>)
@@ -170,7 +200,10 @@
   </varlistentry>
 
   <varlistentry xml:id="constant.date-rfc3339">
-   <term><constant>DATE_RFC3339</constant></term>
+   <term>
+    <constant>DATE_RFC3339</constant>
+    (<type>string</type>)
+   </term>
    <listitem>
     <simpara>
      O mesmo que <constant>DATE_ATOM</constant>.
@@ -179,7 +212,10 @@
   </varlistentry>
 
   <varlistentry xml:id="constant.date-rfc3339-extended">
-   <term><constant>DATE_RFC3339_EXTENDED</constant></term>
+   <term>
+    <constant>DATE_RFC3339_EXTENDED</constant>
+    (<type>string</type>)
+   </term>
    <listitem>
     <simpara>
      Formato RFC 3339 EXTENDIDO
@@ -189,7 +225,10 @@
   </varlistentry>
 
   <varlistentry xml:id="constant.date-rss">
-   <term><constant>DATE_RSS</constant></term>
+   <term>
+    <constant>DATE_RSS</constant>
+    (<type>string</type>)
+   </term>
    <listitem>
     <simpara>
      RSS (exemplo: <literal>Mon, 15 Aug 2005 15:52:01 +0000</literal>).
@@ -199,7 +238,10 @@
   </varlistentry>
 
   <varlistentry xml:id="constant.date-w3c">
-   <term><constant>DATE_W3C</constant></term>
+   <term>
+    <constant>DATE_W3C</constant>
+    (<type>string</type>)
+   </term>
    <listitem>
     <simpara>
      World Wide Web Consortium (exemplo: <literal>2005-08-15T15:52:01+00:00</literal>).

diff --git a/reference/datetime/dateinterval/createfromdatestring.xml b/reference/datetime/dateinterval/createfromdatestring.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c8ba91f7e546462dc66c2a11a7eab6f55c93915b Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano, leonardolara -->
+<!-- EN-Revision: 34f483426930c25870b4c5455157e7a759e0053c Maintainer: leonardolara Status: ready --><!-- CREDITS: fabioluciano, leonardolara -->
 <refentry xml:id="dateinterval.createfromdatestring" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>DateInterval::createFromDateString</refname>
@@ -42,7 +42,7 @@
       </para>
       <para>
        Para usar um string no formato ISO-8601 como <literal>P7D</literal>, deve-se
-       usar o construtor.
+       usar o construtor <methodname>DateInterval::__construct</methodname>.
       </para>
      </listitem>
     </varlistentry>
@@ -53,7 +53,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Retorna <classname>DateTimeImmutable</classname> em caso de sucesso.
+   Retorna <classname>DateInterval</classname> em caso de sucesso.
    &return.falseforfailure.style.procedural;
   </para>
  </refsect1>