Sync with EN

php · Nov 22, 2024 · 30c9d82 · 30c9d82
1 parent 5af87ff
commit 30c9d82
Show file tree

Hide file tree

Showing 11 changed files with 261 additions and 35 deletions.
diff --git a/language/control-structures/match.xml b/language/control-structures/match.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6c71b05df89358d7760a4740ed3fcfa1682eadb6 Maintainer: grzesiek Status: ready -->
+<!-- EN-Revision: 6507fc94c2d0a0e65ee9486a98e9135f34220ae7 Maintainer: grzesiek Status: ready -->
 <!-- $Revision$ -->
 
 <sect1 xml:id="control-structures.match" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -66,8 +66,8 @@ $output = match (true) {
     $age < 2 => "Baby",
     $age < 13 => "Child",
     $age <= 19 => "Teenager",
+    $age >= 40 => "Old adult",
     $age > 19 => "Young adult",
-    $age >= 40 => "Old adult"
 };
 
 var_dump($output);

diff --git a/language/functions.xml b/language/functions.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 74976cdb263ef841c5fc2c3f91ca7e284adce552 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 489d46bc2598784bd3711454ccab8940107cde67 Maintainer: sobak Status: ready -->
 <!-- CREDITS: cyb0org, pirate -->
  <chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>Funkcje</title>
@@ -456,20 +456,25 @@ Robię kubek jogurtu naturalnego o smaku truskawek.
      przez usunięcie domyślnej wartości, ponieważ i tak nie byłaby ona nigdy użyta.
      Wyjątkiem od tej reguły są argumenty w postaci
      <code>Typ $parametr = null</code>, gdzie domyślna wartość &null; czyni typ niejawnie
-     pozwalającym na null. To użycie pozostaje dozwolone, choć zaleca się używać
-     jawnego <link linkend="language.types.declarations.nullable">typu pozwalającego na null</link> zamiast tego.
+     pozwalającym na null. Taki zapis jest przestarzały od PHP 8.4.0 i powinien być użyty
+     wprost <link linkend="language.types.declarations.nullable">typ pozwalający na null</link>.
      <example>
       <title>Deklarowanie argumentów opcjonalnych po wymaganych</title>
       <programlisting role="php">
-       <![CDATA[
- <?php
- function foo($a = [], $b) {} // Domyślna wartość nieużywana; zdeprecjonowane od PHP 8.0.0
- function foo($a, $b) {}      // Zachowuje się identycznie, brak ostrzeżenia o deprekacji
-
- function bar(A $a = null, $b) {} // Wciąż dozwolone; $a jest wymagane ale pozwala na null
- function bar(?A $a, $b) {}       // Zalecane
- ?>
- ]]>
+<![CDATA[
+<?php
+
+function foo($a = [], $b) {}     // Domyślna wartość nieużywana; zdeprecjonowane od PHP 8.0.0
+function foo($a, $b) {}          // Zachowuje się identycznie, brak ostrzeżenia o przestarzałym zapisie
+
+function bar(A $a = null, $b) {} // Od PHP 8.1.0, parametr $a jest niejawnie wymagany
+                                 // (gdyż został zdeklarowany przed wymaganym parametrem),
+                                 // ale też niejawnie dopuszcza null (przestarzałe od PHP 8.4.0),
+                                 // ponieważ jego domyślną wartością jest null
+function bar(?A $a, $b) {}       // Zalecane
+
+?>
+]]>
       </programlisting>
      </example>
     </para>

diff --git a/language/oop5/autoload.xml b/language/oop5/autoload.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a9a6224ca97531df0a4e4b9b16b59c3f2baf1b09 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: ce3a2d381693ccbc10cc4a808c3eb853f3c85c9e Maintainer: sobak Status: ready -->
  <sect1 xml:id="language.oop5.autoload" xmlns="http://docbook.org/ns/docbook">
   <title>Autoloading klas</title>
   <para>
@@ -29,7 +29,7 @@
   </caution>
   <note>
    <para>
-    <function>spl_autoload_register</function> można wywołać wielokrotnie aby
+    <function>spl_autoload_register</function> można wywołać wielokrotnie, aby
     zarejestrować wiele autoloaderów. Jednak rzucenie wyjątku z funkcji ładującej
     przerwie ten proces i nie pozwoli uruchomić się kolejnym funkcjom
     ładującym. Z tego powodu rzucanie wyjątków z funkcji ładujących jest stanowczo

diff --git a/language/oop5/basic.xml b/language/oop5/basic.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f94d903985119d3ac00f4528551df947f57b667f Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 2f85d57a0b5a01b875cbca2b291f04389cf61ac2 Maintainer: sobak Status: ready -->
 
  <sect1 xml:id="language.oop5.basic" xmlns="http://docbook.org/ns/docbook">
   <title>Podstawy</title>
@@ -14,10 +14,12 @@
    </para>
    <para>
     Nazwa klasy może być dowolną poprawną etykietą, o ile nie jest
-    <link linkend="reserved">zastrzeżonym słowem</link> w PHP. Poprawna nazwa
-    klasy zaczyna się od litery lub podkreślnika, po której następuje dowolna ilość
-    liter, cyfr lub podkreślników. Jako wyrażenie regularne wyglądałoby
-    to więc następująco:
+    <link linkend="reserved">zastrzeżonym słowem</link> w PHP. 
+    Od PHP 8.4.0 użycie pojedynczego podkreślenia <literal>_</literal> jako
+    nazwy klasy jest przestarzałe.
+    Poprawna nazwa  klasy zaczyna się od litery lub podkreślnika,
+    po której następuje dowolna ilość liter, cyfr lub podkreślników. 
+    Jako wyrażenie regularne wyglądałoby to więc następująco:
     <code>^[a-zA-Z_\x80-\xff][a-zA-Z0-9_\x80-\xff]*$</code>.
    </para>
    <para>
@@ -374,6 +376,8 @@ bool(true)
 <![CDATA[
 <?php
 echo (new DateTime())->format('Y');
+// okalające nawiasy są opcjonalne od PHP 8.4.0
+echo new DateTime()->format('Y');
 ?>
 ]]>
     </programlisting>

diff --git a/language/oop5/changelog.xml b/language/oop5/changelog.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8d181538611c512546ac394511aa1d8e900dd9a3 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: c0fa5077c8862405942d8aac7360c5169558b59b Maintainer: sobak Status: ready -->
 <sect1 xml:id="language.oop5.changelog" xmlns="http://docbook.org/ns/docbook">
  <title>Wykaz zmian dla modelu OOP</title>
  <para>
@@ -16,6 +16,12 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Dodano: wsparcie dla <link linkend="language.oop5.lazy-objects">leniwych obiektów</link>.
+      </entry>
+     </row>
      <row>
       <entry>8.1.0</entry>
       <entry>

diff --git a/reference/reflection/reflectionattribute.xml b/reference/reflection/reflectionattribute.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 790f63af6521908477b285ff753e454e118bb989 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <reference xml:id="class.reflectionattribute" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
@@ -40,6 +40,13 @@
      <varname linkend="reflectionattribute.constants.is-instanceof">ReflectionAttribute::IS_INSTANCEOF</varname>
     </fieldsynopsis>
 
+    <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <type>string</type>
+     <varname linkend="reflectionattribute.props.name">name</varname>
+    </fieldsynopsis>
+
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.reflectionattribute')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='ReflectionAttribute'])">
      <xi:fallback/>
@@ -52,6 +59,20 @@
 
   </section>
 
+  <section xml:id="reflectionattribute.props">
+   &reftitle.properties;
+   <variablelist>
+    <varlistentry xml:id="reflectionattribute.props.name">
+     <term><varname>name</varname></term>
+     <listitem>
+      <simpara>
+       Nazwa atrybutu.
+      </simpara>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </section>
+
   <!-- {{{ ReflectionAttribute constants -->
   <section xml:id="reflectionattribute.constants">
    &reftitle.constants;
@@ -81,6 +102,28 @@
   </section>
   <!-- }}} -->
 
+  <section role="changelog">
+   &reftitle.changelog;
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        Dodano <property>ReflectionAttribute::$name</property>.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </section>
+
  </partintro>
 
  &reference.reflection.entities.reflectionattribute;

diff --git a/reference/reflection/reflectionclass.xml b/reference/reflection/reflectionclass.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: sobak Status: ready -->
+<!-- EN-Revision: c0fa5077c8862405942d8aac7360c5169558b59b Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <reference xml:id="class.reflectionclass" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
@@ -57,6 +57,18 @@
      <type>int</type>
      <varname linkend="reflectionclass.constants.is-readonly">ReflectionClass::IS_READONLY</varname>
     </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="reflectionclass.constants.skip-initialization-on-serialize">ReflectionClass::SKIP_INITIALIZATION_ON_SERIALIZE</varname>
+    </fieldsynopsis>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <modifier>const</modifier>
+     <type>int</type>
+     <varname linkend="reflectionclass.constants.skip-destructor">ReflectionClass::SKIP_DESTRUCTOR</varname>
+    </fieldsynopsis>
 
     <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
     <fieldsynopsis>
@@ -141,6 +153,26 @@
       </listitem>
      </varlistentry>
 
+     <varlistentry xml:id="reflectionclass.constants.skip-initialization-on-serialize">
+      <term><constant>ReflectionClass::SKIP_INITIALIZATION_ON_SERIALIZE</constant></term>
+      <listitem>
+       <simpara>
+        Zaznacza że <function>serialize</function> nie powinno wyzwalać
+        serializacji leniwego obiektu.
+       </simpara>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry xml:id="reflectionclass.constants.skip-destructor">
+      <term><constant>ReflectionClass::SKIP_DESTRUCTOR</constant></term>
+      <listitem>
+       <simpara>
+        Zaznacza, że destruktor obiektu nie powinien być wywołany, gdy obiekt jest resetowany jako
+        leniwy.
+       </simpara>
+      </listitem>
+     </varlistentry>
+
     </variablelist>
    </section>
   </section>

diff --git a/reference/reflection/reflectionclassconstant/tostring.xml b/reference/reflection/reflectionclassconstant/tostring.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 6d25b8ee6654db8e9eb551e3d6fc77be65eeccd5 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <refentry xml:id="reflectionclassconstant.tostring" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -31,14 +31,33 @@
   </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.4.0</entry>
+      <entry>
+       Teraz dołączony jest też komentarz dokumentacyjny przypisany do stałej.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><methodname>ReflectionClassConstant::export</methodname></member>
-    <member><link linkend="object.tostring">__toString()</link></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><link linkend="object.tostring">__toString()</link></member>
+  </simplelist>
  </refsect1>
 
 </refentry>

diff --git a/reference/reflection/reflectionmethod/construct.xml b/reference/reflection/reflectionmethod/construct.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 790f63af6521908477b285ff753e454e118bb989 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <refentry xml:id="reflectionmethod.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -19,6 +19,12 @@
    <modifier>public</modifier> <methodname>ReflectionMethod::__construct</methodname>
    <methodparam><type>string</type><parameter>classMethod</parameter></methodparam>
   </constructorsynopsis>
+  <warning>
+   <simpara>
+    Alternatywna sygnatura jest przestarzała od PHP 8.4.0,
+    zamiast niej skorzystaj z <methodname>ReflectionMethod::createFromMethodName</methodname>.
+   </simpara>
+  </warning>
   <para>
    Tworzy obiekt <classname>ReflectionMethod</classname>.
   </para>