Sync with EN

php · Nov 29, 2024 · 3fdeee9 · 3fdeee9
1 parent 4dad89e
commit 3fdeee9
Show file tree

Hide file tree

Showing 18 changed files with 309 additions and 41 deletions.
diff --git a/language/oop5/constants.xml b/language/oop5/constants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: fc174e8d6162091550edde46159917ee7e5a2e73 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 7ddc30e0d2087d75b8f50da40668f4e422c6a4c5 Maintainer: sobak Status: ready -->
 <sect1 xml:id="language.oop5.constants" xmlns="http://docbook.org/ns/docbook">
  <title>Stałe w klasach</title>
  <para>
@@ -120,6 +120,60 @@ Fatal error: Uncaught Error: Cannot access private const Foo::BAZ in …
    Od PHP 7.1.0 dla stałych klasach dozwolone są modyfikatory widoczności.
   </para>
  </note>
+ <example>
+  <title>Sprawdzanie wariancji widoczności stałej klasy, od PHP 8.3.0</title>
+  <programlisting role="php">
+   <![CDATA[
+<?php
+
+interface MyInterface
+{
+    public const VALUE = 42;
+}
+
+class MyClass implements MyInterface
+{
+    protected const VALUE = 42;
+}
+?>
+]]>
+  </programlisting>
+  &example.outputs.83;
+  <screen>
+   <![CDATA[
+Fatal error: Access level to MyClass::VALUE must be public (as in interface MyInterface) …
+]]>
+  </screen>
+ </example>
+ <note>
+  <simpara>
+   Od PHP 8.3.0 wariancja widoczności jest sprawdzana bardziej rygorystycznie.
+   Przed tą wersją, widoczność stałej klasy mogła być inna
+   od widoczności tej stałej w zaimplementowanym interfejsie.
+  </simpara>
+ </note>
+ <example>
+  <title>Składnia pobierania stałej klasy, od PHP 8.3.0</title>
+  <programlisting role="php">
+   <![CDATA[
+<?php
+class Foo {
+    public const BAR = 'bar';
+    private const BAZ = 'baz';
+}
+
+$name = 'BAR';
+echo Foo::{$name}, PHP_EOL; // bar
+?>
+]]>
+  </programlisting>
+ </example>
+ <note>
+  <para>
+   Od PHP 8.3.0 stałe klas mogą być pobierane dynamicznie przy użyciu
+   zmiennej.
+  </para>
+ </note>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:

diff --git a/language/operators/arithmetic.xml b/language/operators/arithmetic.xml
@@ -65,10 +65,12 @@
   </tgroup>
  </table>
  <simpara>
-  Operator dzielenia ("/") zwraca liczbę zmiennoprzecinkową, chyba że oba argumenty (operandy)
-  są liczbami całkowitymi (lub ciągami znaków, które są konwertowane na liczby całkowite) i liczby te
-  mogą się równo podzielić - w tym wypadku zostanie zwrócona liczba całkowita. Aby
-  dowiedzieć się więcej o dzieleniu liczb całkowitych zobacz <function>intdiv</function>.
+  Operator dzielenia <literal>/</literal> zwraca liczbę zmiennoprzecinkową,
+  chyba że oba argumenty (tzw. operandy) są liczbami całkowitymi <type>int</type> (lub
+  <link linkend="language.types.numeric-strings">numerycznymi ciągami znaków</link>,
+  które są konwertowane na liczby całkowite) i licznik jest wielokrotnością
+  dzielnika, to wtedy zostanie zwrócona liczba całkowita.
+  Dla dzielenia liczb całkowitych zapoznaj się też z funkcją <function>intdiv</function>.
  </simpara>
  <simpara>
   Argumenty modulo są konwertowane do typu <type>int</type>
@@ -77,21 +79,30 @@
  </simpara>
  <para>
   Wynik dzielenia modulo <literal>%</literal> ma taki sam znak,
-  jak dzielna. Oznacza to, że wynik <literal>$a % $b</literal>
+  jak dzielna. Oznacza to, że wynik <code>$a % $b</code>
   będzie miał taki sam znak jak <varname>$a</varname>. Przykładowo:
   <informalexample>
    <programlisting role="php">
 <![CDATA[
 <?php
 
-echo (5 % 3)."\n";           // wyświetla 2
-echo (5 % -3)."\n";          // wyświetla 2
-echo (-5 % 3)."\n";          // wyświetla -2
-echo (-5 % -3)."\n";         // wyświetla -2
+var_dump(5 % 3);
+var_dump(5 % -3);
+var_dump(-5 % 3);
+var_dump(-5 % -3);
 
 ?>
 ]]>
    </programlisting>
+   &example.outputs;
+   <screen>
+    <![CDATA[
+int(2)
+int(2)
+int(-2)
+int(-2)
+]]>
+   </screen>
   </informalexample>
  </para>
  <sect2 role="seealso">

diff --git a/language/predefined/exceptions.xml b/language/predefined/exceptions.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d269b2528db7c5a228cf0fd3218e7d24d8c71633 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 4bf789e981af0836c41daa16e57ef86c21497faa Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 
 <part xml:id="reserved.exceptions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -28,6 +28,7 @@
  &language.predefined.valueerror;
  &language.predefined.unhandledmatcherror;
  &language.predefined.fibererror;
+ &language.predefined.requestparsebodyexception;
 </part>
 
 <!-- Keep this comment at the end of the file

diff --git a/reference/array/functions/array-all.xml b/reference/array/functions/array-all.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 596c11440dc232b8ed1836d7e3afe2ed5b225a7b Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 679cf93fa1e54cde82fc9cf545966eb13bcb0638 Maintainer: sobak Status: ready -->
 <refentry xml:id="function.array-all" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_all</refname>
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>mixed</type><methodname>array_all</methodname>
+   <type>bool</type><methodname>array_all</methodname>
    <methodparam><type>array</type><parameter>array</parameter></methodparam>
    <methodparam><type>callable</type><parameter>callback</parameter></methodparam>
   </methodsynopsis>

diff --git a/reference/array/functions/array-any.xml b/reference/array/functions/array-any.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 596c11440dc232b8ed1836d7e3afe2ed5b225a7b Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 679cf93fa1e54cde82fc9cf545966eb13bcb0638 Maintainer: sobak Status: ready -->
 <refentry xml:id="function.array-any" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>array_any</refname>
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>mixed</type><methodname>array_any</methodname>
+   <type>bool</type><methodname>array_any</methodname>
    <methodparam><type>array</type><parameter>array</parameter></methodparam>
    <methodparam><type>callable</type><parameter>callback</parameter></methodparam>
   </methodsynopsis>

diff --git a/reference/bc/functions/bcdiv.xml b/reference/bc/functions/bcdiv.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 87f32875a189be7ee2a8487c0db3958579e4ce72 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: sobak -->
 <refentry xml:id="function.bcdiv" xmlns="http://docbook.org/ns/docbook">
@@ -50,11 +50,25 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Zwraca wynik dzielenia jako łańcuch znaków lub &null; jeśli
-   <parameter>num2</parameter> wynosi <literal>0</literal>.
+   Zwraca wynik dzielenia jako łańcuch znaków.
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Ta funkcja rzuca <exceptionname>ValueError</exceptionname> w następujących wypadkach:
+   <simplelist>
+    <member><parameter>num1</parameter> lub <parameter>num2</parameter> nie są numerycznymi ciągami znaków poprawnie sformatowanymi dla BCMath</member>
+    <member><parameter>scale</parameter> jest poza dozwolonym zakresem</member>
+   </simplelist>
+  </para>
+  <simpara>
+   Ta funkcja rzuca wyjątek <exceptionname>DivisionByZeroError</exceptionname> jeśli <parameter>num2</parameter>
+   wynosi <literal>0</literal>.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -72,6 +86,12 @@
        Parametr <parameter>scale</parameter> dopuszcza teraz &null;.
       </entry>
      </row>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Dzielenie przez zero powoduje teraz rzucenie <exceptionname>DivisionByZeroError</exceptionname> zamiast zwrócenia null.
+      </entry>
+     </row>
     </tbody>
    </tgroup>
   </informaltable>
@@ -97,6 +117,8 @@ echo bcdiv('105', '6.55957', 3);  // 16.007
   &reftitle.seealso;
   <para>
    <simplelist>
+    <member><function>bcdivmod</function></member>
+    <member><function>bcmod</function></member>
     <member><function>bcmul</function></member>
    </simplelist>
   </para>

diff --git a/reference/bc/functions/bcmod.xml b/reference/bc/functions/bcmod.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 87f32875a189be7ee2a8487c0db3958579e4ce72 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: qrak -->
 <refentry xml:id="function.bcmod" xmlns="http://docbook.org/ns/docbook">
@@ -44,18 +44,33 @@
       </para>
      </listitem>
     </varlistentry>
+    &bc.scale.description;
    </variablelist>
   </para>
  </refsect1>
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Zwraca modulo jako łańcuch znaków lub &null; jeśli 
-   <parameter>num2</parameter> wynosi 0.
+   Zwraca modulo jako łańcuch znaków.
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Ta funkcja rzuca <exceptionname>ValueError</exceptionname> w następujących wypadkach:
+   <simplelist>
+    <member><parameter>num1</parameter> lub <parameter>num2</parameter> nie są numerycznymi ciągami znaków poprawnie sformatowanymi dla BCMath</member>
+    <member><parameter>scale</parameter> jest poza dozwolonym zakresem</member>
+   </simplelist>
+  </para>
+  <simpara>
+   Ta funkcja rzuca wyjątek <exceptionname>DivisionByZeroError</exceptionname> jeśli <parameter>num2</parameter>
+   wynosi <literal>0</literal>.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="changelog"><!-- {{{ -->
   &reftitle.changelog;
   <informaltable>
@@ -73,6 +88,12 @@
        Parametr <parameter>scale</parameter> dopuszcza teraz &null;.
       </entry>
      </row>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Dzielenie przez zero powoduje teraz rzucenie <exceptionname>DivisionByZeroError</exceptionname> zamiast zwrócenia null.
+      </entry>
+     </row>
      <row>
       <entry>7.2.0</entry>
       <entry>
@@ -127,6 +148,7 @@ echo bcmod('5.7', '1.3'); // 0.5 od PHP 7.2.0; wcześniej 0
   <para>
    <simplelist>
     <member><function>bcdiv</function></member>
+    <member><function>bcdivmod</function></member>
    </simplelist>
   </para>
  </refsect1>

diff --git a/reference/bc/functions/bcpow.xml b/reference/bc/functions/bcpow.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 23f5599c8cc2713e7a4fdc29d8cceab66c341c48 Maintainer: qrak Status: ready -->
+<!-- EN-Revision: e333514f66ae32a3468e05dbe64f55f01ff9451e Maintainer: qrak Status: ready -->
 <!-- $Revision$ -->
 <refentry xml:id="function.bcpow" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -37,7 +37,7 @@
      <term><parameter>exponent</parameter></term>
      <listitem>
       <para>
-       Wykładnik, jako ciąg znaków. Jeśli wykładnik nie jest liczbą całkowitą, jest on przycinany.
+       Wykładnik, jako ciąg znaków. Musi być wartością bez części ułamkowej.
        Dozwolony zakres wykładnika zależy od platformy uruchomieniowej, ale jest to przynajmniej
        <literal>-2147483648</literal> do <literal>2147483647</literal>.
       </para>
@@ -55,6 +55,22 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   Ta funkcja rzuca <exceptionname>ValueError</exceptionname> w następujących wypadkach:
+   <simplelist>
+    <member><parameter>num1</parameter> lub <parameter>num2</parameter> nie są numerycznymi ciągami znaków poprawnie sformatowanymi dla BCMath</member>
+    <member><parameter>scale</parameter> jest poza dozwolonym zakresem</member>
+    <member><parameter>exponent</parameter> ma część ułamkową</member>
+   </simplelist>
+  </para>
+  <simpara>
+   Ta funkcja rzuca wyjątek <exceptionname>DivisionByZeroError</exceptionname> jeśli <parameter>num2</parameter>
+   wynosi <literal>0</literal> a <parameter>exponent</parameter> jest ujemny.
+  </simpara>
+ </refsect1>
+
  <refsect1 role="changelog"><!-- {{{ -->
   &reftitle.changelog;
   <informaltable>
@@ -66,6 +82,19 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       Ujemne potęgi 0 wcześniej zwracały, ale teraz rzucają wyjątek <exceptionname>DivisionByZeroError</exceptionname>.
+      </entry>
+     </row>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Gdy <parameter>exponent</parameter> ma część ułamkową, funkcja rzuca teraz <exceptionname>ValueError</exceptionname>
+       zamiast przycinać tę wartość.
+      </entry>
+     </row>
      <row>
       <entry>7.3.0</entry>
       <entry>

diff --git a/reference/bc/functions/bcsqrt.xml b/reference/bc/functions/bcsqrt.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 23f5599c8cc2713e7a4fdc29d8cceab66c341c48 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 04c37bc8ca6b2faff2b14b85b4576529444bd6a2 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <refentry xml:id="function.bcsqrt" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -39,7 +39,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Zwraca pierwiastek kwadratowy jako numeryczny ciąg znaków.
+   Zwraca pierwiastek kwadratowy jako numeryczny łańcuch znaków poprawnie sformatowany dla BCMath.
   </para>
  </refsect1>
 
@@ -48,7 +48,7 @@
   <para>
    Ta funkcja rzuca <classname>ValueError</classname> w następujących wypadkach:
    <simplelist>
-    <member><parameter>num</parameter> nie jest numerycznym ciągiem znaków zrozumiałym przez BCMath</member>
+    <member><parameter>num</parameter> nie jest numerycznym ciągiem znaków poprawnie sformatowanym dla BCMath</member>
     <member><parameter>num</parameter> wynosi mniej niż <literal>0</literal></member>
     <member><parameter>scale</parameter> jest poza dozwolonym zakresem</member>
    </simplelist>

diff --git a/reference/curl/constants.xml b/reference/curl/constants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 09619263cfbc188c49e9219e0d983bcf90231026 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: dec90c90d3662c5433f7c3972f8557321da7b11d Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <appendix xml:id="curl.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
@@ -2028,7 +2028,7 @@
    <listitem>
     <simpara>
      Negotiate auth is supported.
-     Dostępna od PHP 7.3.0 i cURL 7.10.6 (deprecated as of 7.38.0)
+     Dostępna od PHP 7.3.0 i cURL 7.10.6 (przestarzała od cURL 7.38.0)
     </simpara>
    </listitem>
   </varlistentry>
@@ -2084,7 +2084,7 @@
    </term>
    <listitem>
     <simpara>
-     Wspierane są międzynarodowowe nazwy domen.
+     Wspierane są międzynarodowe nazwy domen.
      Dostępna od PHP 7.3.0 i cURL 7.12.0
     </simpara>
    </listitem>