Sync with EN

php · Nov 21, 2024 · 5af87ff · 5af87ff
1 parent 1c643fa
commit 5af87ff
Show file tree

Hide file tree

Showing 27 changed files with 207 additions and 120 deletions.
diff --git a/language-defs.ent b/language-defs.ent
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 38ee86c3c030bc74362a7e5c185192ef8ad5a442 Maintainer: joeaccord Status: ready -->
+<!-- EN-Revision: 5097918a78b2d1de0839a48bd30912d498ac5850 Maintainer: joeaccord Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: leszek, sobak -->
 
@@ -88,6 +88,7 @@ supplemental files to mark section titles -->
 <!ENTITY reftitle.changelog    '<title xmlns="http://docbook.org/ns/docbook">&Changelog;</title>'>
 <!ENTITY reftitle.classes      '<title xmlns="http://docbook.org/ns/docbook">Klasy predefiniowane</title>'>
 <!ENTITY reftitle.classsynopsis '<title xmlns="http://docbook.org/ns/docbook">Krótki opis klasy</title>'>
+<!ENTITY reftitle.enumsynopsis '<title xmlns="http://docbook.org/ns/docbook">Krótki opis enuma</title>'>
 <!ENTITY reftitle.constants    '<title xmlns="http://docbook.org/ns/docbook">Stałe predefiniowane</title>'>
 <!ENTITY reftitle.constructor  '<title xmlns="http://docbook.org/ns/docbook">Konstruktor</title>'>
 <!ENTITY reftitle.description  '<title xmlns="http://docbook.org/ns/docbook">Opis</title>'>

diff --git a/language/predefined/attributes/override.xml b/language/predefined/attributes/override.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 05b314c2ae84456def6a56777b05d0645fb3e11e Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 68265e11357d89a0c97986c89dcbf0e28b5977e1 Maintainer: sobak Status: ready -->
 <reference xml:id="class.override" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Atrybut Override</title>
  <titleabbrev>Override</titleabbrev>
@@ -8,8 +8,16 @@
 
   <section xml:id="override.intro">
    &reftitle.intro;
-   <para>
-   </para>
+   <simpara>
+    Ten atrybut jest używany do oznaczenia, że metoda ma na celu
+    nadpisanie metody klasy rodzica lub, że implementuje ona
+    metodę opisaną w interfejsie.
+   </simpara>
+   <simpara>
+    Jeżeli metoda o tej nazwie nie istnieje w klasie rodzica lub
+    w implementowanym interfejsie, wyemitowany zostanie błąd
+    czasu kompilacji.
+   </simpara>
   </section>
 
   <section xml:id="override.synopsis">

diff --git a/language/predefined/exceptions.xml b/language/predefined/exceptions.xml
@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 49b7f738f43c1ea2113cc7931357a10224824539 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: d269b2528db7c5a228cf0fd3218e7d24d8c71633 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 
 <part xml:id="reserved.exceptions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Predefiniowane wyjątki</title>
 
  <partintro>
   <para>
-   Zobacz także <link linkend="spl.exceptions">wyjątki SPL</link>
+   Zobacz także <link linkend="spl.exceptions">wyjątki SPL</link>.
   </para>
  </partintro>
 

diff --git a/language/predefined/variables/httpresponseheader.xml b/language/predefined/variables/httpresponseheader.xml
@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a6d209f4ff71ccba3f1255902827f5df3e092ff9 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 3f1cd5121f7c9f8347ca69c8f657fdb24c0f9729 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
-
 <refentry role="variable" xml:id="reserved.variables.httpresponseheader" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>$http_response_header</refname>
@@ -68,7 +67,15 @@ NULL
    </example>
   </para>
  </refsect1>
-
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>http_get_last_response_headers</function></member>
+   <member><function>http_clear_last_response_headers</function></member>
+  </simplelist>
+ </refsect1>
+
 </refentry>
 
 <!-- Keep this comment at the end of the file
@@ -91,4 +98,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->
-
diff --git a/reference/apache/functions/apache-request-headers.xml b/reference/apache/functions/apache-request-headers.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f3b9d85f71934d6814a493fabb367e10731e0394 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 68e52ef14de33f6752a8fdda1ae83c861c5babdb Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <!-- splitted from ./en/functions/apache.xml, last change in rev 1.2 -->
 <refentry xml:id="function.apache-request-headers" xmlns="http://docbook.org/ns/docbook">
@@ -28,8 +28,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Tablica asocjacyjna wszystkich nagłówków HTTP dla obecnego żądania lub
-   &false; w wypadku niepowodzenia.
+   Tablica asocjacyjna wszystkich nagłówków HTTP dla obecnego żądania.
   </para>
  </refsect1>
 

diff --git a/reference/apache/functions/apache-response-headers.xml b/reference/apache/functions/apache-response-headers.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: f3b9d85f71934d6814a493fabb367e10731e0394 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 68e52ef14de33f6752a8fdda1ae83c861c5babdb Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: joeaccord, qrak -->
 <refentry xml:id="function.apache-response-headers" xmlns="http://docbook.org/ns/docbook">
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type class="union"><type>array</type><type>false</type></type><methodname>apache_response_headers</methodname>
+   <type>array</type><methodname>apache_response_headers</methodname>
    <void/>
   </methodsynopsis>
   <para>
@@ -28,7 +28,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Tablica wszystkich nagłówków odpowiedzi serwera Apache w przypadku powodzenia&return.falseforfailure;.
+   Tablica wszystkich nagłówków odpowiedzi serwera Apache w przypadku powodzenia.
   </para>
  </refsect1>
 

diff --git a/reference/apache/functions/getallheaders.xml b/reference/apache/functions/getallheaders.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f3b9d85f71934d6814a493fabb367e10731e0394 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 68e52ef14de33f6752a8fdda1ae83c861c5babdb Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: qrak -->
 <refentry xml:id="function.getallheaders" xmlns="http://docbook.org/ns/docbook">
@@ -32,8 +32,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Tablica asocjacyjna ze wszystkimi nagłówkami HTTP obecnego żądania lub
-   &false; w wypadku błędu.
+   Tablica asocjacyjna ze wszystkimi nagłówkami HTTP obecnego żądania.
   </para>
  </refsect1>
 

diff --git a/reference/array/functions/array-filter.xml b/reference/array/functions/array-filter.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1de7b5b65f959de3babdd8ea1b060f8cebd60856 Maintainer: leszek Status: ready -->
+<!-- EN-Revision: 596c11440dc232b8ed1836d7e3afe2ed5b225a7b Maintainer: leszek Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: sobak, grzesiek -->
 <refentry xml:id="function.array-filter" xmlns="http://docbook.org/ns/docbook">
@@ -254,9 +254,10 @@ array(2) {
   <para>
    <simplelist>
     <member><function>array_intersect</function></member>
+    <member><function>array_find</function></member>
+    <member><function>array_any</function></member>
     <member><function>array_map</function></member>
     <member><function>array_reduce</function></member>
-    <member><function>array_walk</function></member>
    </simplelist>
   </para>
  </refsect1>

diff --git a/reference/array/functions/array.xml b/reference/array/functions/array.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: c6534cb59e785d4fc77f123602132da74b07ac2a Maintainer: leszek Status: ready -->
+<!-- EN-Revision: e784ba3c905ef723c16eb9f90e181708a696523e Maintainer: leszek Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: sobak, grzesiek -->
 <refentry xml:id="function.array" xmlns="http://docbook.org/ns/docbook">
@@ -14,9 +14,9 @@
    <methodparam rep="repeat"><type>mixed</type><parameter>values</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Tworzy tablicę. Przeczytaj rozdział poświęcony typowi tablicowemu
-   <link linkend="language.types.array">array type</link>, żeby dowiedzieć się
-   czym jest tablica.
+   Tworzy tablicę. Przeczytaj rozdział poświęcony
+   <link linkend="language.types.array">typowi tablicowemu</link>, żeby dowiedzieć się,
+   czym jest tablica oraz poznać szczegóły na temat alternatywnej składni nawiasów klamrowych (<literal>[]</literal>).
   </para>
  </refsect1>
  <refsect1 role="parameters">

diff --git a/reference/array/functions/list.xml b/reference/array/functions/list.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 43ac336818cb3a18011d9b6ba91514f3332eb46d Maintainer: leszek Status: ready -->
+<!-- EN-Revision: 75a5125c8b8bbe3006415bdcff531735c5701bd5 Maintainer: leszek Status: ready -->
 <!-- $Revision$ -->
 <!-- CREDITS: sobak -->
 <refentry xml:id="function.list" xmlns="http://docbook.org/ns/docbook">
@@ -27,6 +27,11 @@
     że indeksy numeryczne zaczynają się od 0.
    </para>
   </note>
+  <para>
+   Od PHP 7.1.0 <function>list</function> może zawierać też jawnie podane klucze, pozwalając na
+   destrukturyzację tablic z kluczami innymi niż liczbowe lub sekwencyjne. Aby dowiedzieć się więcej
+   o destrukturyzacji tablic, zobacz <link linkend="language.types.array.syntax.destructuring">sekcję o destrukturyzacji tablic</link>.
+  </para>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;

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: b2e9eb240c89c08cf22887d3d3747310edd4b8d1 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 09619263cfbc188c49e9219e0d983bcf90231026 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <appendix xml:id="curl.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
@@ -1375,6 +1375,28 @@
     </simpara>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.curl-http-version-3">
+   <term>
+    <constant>CURL_HTTP_VERSION_3</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Dostępna od PHP 8.4.0 i 7.66.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.curl-http-version-3only">
+   <term>
+    <constant>CURL_HTTP_VERSION_3ONLY</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Dostępna od PHP 8.4.0 i cURL 7.88.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
   <varlistentry xml:id="constant.curl-http-version-none">
    <term>
     <constant>CURL_HTTP_VERSION_NONE</constant>
@@ -2263,6 +2285,28 @@
     </simpara>
    </listitem>
   </varlistentry>
+  <varlistentry xml:id="constant.curl-prereqfunc-ok">
+   <term>
+    <constant>CURL_PREREQFUNC_OK</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Dostępna od PHP 8.4.0 i cURL 7.80.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.curl-prereqfunc-abort">
+   <term>
+    <constant>CURL_PREREQFUNC_ABORT</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Dostępna od PHP 8.4.0 i cURL 7.80.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
  </variablelist>
  &reference.curl.constants-curl-setopt;
  &reference.curl.constants-curl-share-setopt;

diff --git a/reference/curl/functions/curl-exec.xml b/reference/curl/functions/curl-exec.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: b7f8c11e56ff1c57a2993e2ed7e5c5ace18637fd Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 6c60e8e8fcd92bdaa469f7292b12179e841dfd39 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <refentry xml:id="function.curl-exec" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -34,7 +34,9 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success; Jednakże, jeśli <constant>CURLOPT_RETURNTRANSFER</constant>
+   W przypadku powodzenia ta funkcja wyrzuca wynik bezpośrednio do
+   <literal>stdout</literal> i zwraca &true;, &return.falseforfailure;.
+   Jednakże, jeśli <constant>CURLOPT_RETURNTRANSFER</constant>
    zostało <link linkend="function.curl-setopt">ustawione</link>, funkcja zwróci
    wynik sesji w wypadku powodzenia lub &false; w wypadku błędu.
   </para>

diff --git a/reference/curl/functions/curl-init.xml b/reference/curl/functions/curl-init.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: b7f8c11e56ff1c57a2993e2ed7e5c5ace18637fd Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 61f65786e2363a0a3a58a0b6f9ecfd02cf1db815 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <refentry xml:id="function.curl-init" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -14,9 +14,7 @@
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>url</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Inicjalizuje nową sesję i zwraca uchwyt cURL dla funkcji
-   <function>curl_setopt</function>, <function>curl_exec</function>,
-   i <function>curl_close</function>.  
+   Inicjalizuje nową sesję i zwraca uchwyt cURL.
   </para>
  </refsect1>
 
@@ -29,7 +27,7 @@
      <listitem>
       <para>
        Jeżeli podano, opcja <constant>CURLOPT_URL</constant> zostanie ustawiona
-       na tą wartość. Możesz ustawić adres ręcznie, używając funkcji
+       na tą wartość. Można ustawić adres ręcznie, używając funkcji
        <function>curl_setopt</function>.
       </para>
       <note>
@@ -90,18 +88,17 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-// stwórz nowy zasób cURL
+
+// Zainicjalizuj nową sesję cURL
 $ch = curl_init();
 
-// ustaw URL i inne potrzebne opcje
+// Ustaw URL i inne potrzebne opcje
 curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
 curl_setopt($ch, CURLOPT_HEADER, 0);
 
-// pobierz stronę i wyślij do przeglądarki
+// Pobierz stronę i wyślij do przeglądarki
 curl_exec($ch);
 
-// zamknij zasób cURL, zwolnij zasoby systemowe
-curl_close($ch);
 ?>
 ]]>
     </programlisting>
@@ -113,7 +110,6 @@ curl_close($ch);
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function>curl_close</function></member>
     <member><function>curl_multi_init</function></member>
    </simplelist>
   </para>

diff --git a/reference/curl/functions/curl-pause.xml b/reference/curl/functions/curl-pause.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 77a60306bc47d2151ebca7e6983897a0371a9671 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 <refentry xml:id="function.curl-pause" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -30,7 +30,7 @@
     <term><parameter>flags</parameter></term>
     <listitem>
      <para>
-      Jedna ze stałych <constant>CURLPAUSE_*</constant>.
+      Jedna ze stałych <constant>CURLPAUSE_<replaceable>*</replaceable></constant>.
      </para>
     </listitem>
    </varlistentry>

diff --git a/reference/curl/setup.xml b/reference/curl/setup.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: b08895614bbc3bfb0273a41c29eda921161538c7 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 85de4c26253a797b6f8050d5fb3e27b6ab7d8488 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 
 <chapter xml:id="curl.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -14,6 +14,7 @@
    lub późniejszej.
    Od PHP 7.3.0 wymagana jest wersja 7.15.5 lub nowsza.
    Od PHP 8.0.0 wymagana jest wersja 7.29.0 lub nowsza.
+   Od PHP 8.4.0 wymagana jest wersja 7.61.0 lub nowsza.
   </para>
  </section>
  <!-- }}} -->