Sync with EN

php · Aug 30, 2024 · 8b372ac · 8b372ac
1 parent ca49c8c
commit 8b372ac
Show file tree

Hide file tree

Showing 3 changed files with 111 additions and 42 deletions.
diff --git a/language/predefined/variables/globals.xml b/language/predefined/variables/globals.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: a6d209f4ff71ccba3f1255902827f5df3e092ff9 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: d58ee8eaaa7f716c51f66f5f1058ab3c42376d98 Maintainer: sobak Status: ready -->
 <!-- $Revision$ -->
 
 <refentry role="variable" xml:id="reserved.variables.globals" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -25,7 +25,9 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-function test() {
+
+function test()
+{
     $foo = "lokalna zmienna";
 
     echo '$foo w zasięgu globalnym: ' . $GLOBALS["foo"] . "\n";
@@ -34,6 +36,7 @@ function test() {
 
 $foo = "Przykładowa zawartość";
 test();
+
 ?>
 ]]>
     </programlisting>
@@ -52,18 +55,20 @@ $foo w zasięgu lokalnym: lokalna zmienna
     <example xml:id="variable.globals.entire_write_error">
      <title>Zapis całości <varname>$GLOBALS</varname> skutkuje błędem.</title>
      <programlisting role="php">
-      <![CDATA[
- <?php
- // Powoduje błąd czasu kompilacji:
- $GLOBALS = [];
- $GLOBALS += [];
- $GLOBALS =& $x;
- $x =& $GLOBALS;
- unset($GLOBALS);
- array_pop($GLOBALS);
- // ...i dowolne inne operacje zapisu/odczytu-zapisu na $GLOBALS
- ?>
- ]]>
+<![CDATA[
+<?php
+
+// Powoduje błąd czasu kompilacji:
+$GLOBALS = [];
+$GLOBALS += [];
+$GLOBALS =& $x;
+$x =& $GLOBALS;
+unset($GLOBALS);
+array_pop($GLOBALS);
+// ...i dowolne inne operacje zapisu/odczytu-zapisu na $GLOBALS
+
+?>
+]]>
      </programlisting>
     </example>
    </para>
@@ -82,13 +87,19 @@ $foo w zasięgu lokalnym: lokalna zmienna
   </note>
   <note>
    <para>
-    Od PHP 8.1.0 <varname>$GLOBALS</varname> jest kopią tylko do odczytu globalnej tablicy symboli. To znaczy, że zmienne globalne nie mogą być zmodyfikowane przez jej kopię. Wcześniej tablica <varname>$GLOBALS</varname> była wykluczona ze standardowego zachowania PHP, w którym tablice są przekazywane przez wartość. Zmienne globalne mogły być modyfikowane przez ich kopię.
+    Od PHP 8.1.0 <varname>$GLOBALS</varname> jest kopią tylko do odczytu
+    globalnej <link linkend="features.gc.refcounting-basics">tablicy symboli</link>.
+    To znaczy, że zmienne globalne nie mogą być zmodyfikowane przez jej kopię.
+    Wcześniej tablica <varname>$GLOBALS</varname> była wykluczona ze standardowego
+    zachowania PHP, w którym tablice są przekazywane przez wartość. Zmienne globalne mogły być modyfikowane przez ich kopię.
     <informalexample>
      <programlisting role="php">
       <![CDATA[
 <?php
+
 // Przed PHP 8.1.0
 $a = 1;
+
 $globals = $GLOBALS; // Ostensibly by-value copy
 $globals['a'] = 2;
 var_dump($a); // int(2)
@@ -102,6 +113,7 @@ $globals['a'] = 1;
 foreach ($globals as $key => $value) {
     $GLOBALS[$key] = $value;
 }
+
 ?>
 ]]>
      </programlisting>
@@ -132,4 +144,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/curl/curlfile.xml b/reference/curl/curlfile.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4731f1a2d216c527410022765b0ef1a731f02695 Maintainer: sobak Status: ready -->
+<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: sobak Status: ready -->
 
 <reference xml:id="class.curlfile" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
@@ -12,43 +12,52 @@
   <section xml:id="curlfile.intro">
    &reftitle.intro;
    <para>
-    <classname>CURLFile</classname> powinna być używana do uploadu plików przez
+    Ta klasa lub <classname>CURLStringFile</classname> powinna być używana do uploadu plików przez
     <constant>CURLOPT_POSTFIELDS</constant>.
    </para>
+   <para>
+    Deserializacja obiektów <classname>CURLFile</classname> jest niedozwolona.
+    Od PHP 7.4.0 w ogóle nie można ich też zserializować.
+   </para>
   </section>
 <!-- }}} -->
 
   <section xml:id="curlfile.synopsis">
    &reftitle.classsynopsis;
 
 <!-- {{{ Synopsis -->
-   <classsynopsis>
-    <ooclass><classname>CURLFile</classname></ooclass>
-
-<!-- {{{ Class synopsis -->
-    <classsynopsisinfo>
-     <ooclass>
-      <classname>CURLFile</classname>
-     </ooclass>
-    </classsynopsisinfo>
-<!-- }}} -->
+   <classsynopsis class="class">
+    <ooclass>
+     <classname>CURLFile</classname>
+    </ooclass>
+
     <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
     <fieldsynopsis>
      <modifier>public</modifier>
+     <type>string</type>
      <varname linkend="curlfile.props.name">name</varname>
+     <initializer>""</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>public</modifier>
+     <type>string</type>
      <varname linkend="curlfile.props.mime">mime</varname>
+     <initializer>""</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>public</modifier>
+     <type>string</type>
      <varname linkend="curlfile.props.postname">postname</varname>
+     <initializer>""</initializer>
     </fieldsynopsis>
 
-
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
-    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.curlfile')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.curlfile')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='CURLFile'])">
+     <xi:fallback/>
+    </xi:include>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.curlfile')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='CURLFile'])">
+     <xi:fallback/>
+    </xi:include>
    </classsynopsis>
 <!-- }}} -->
 
@@ -88,6 +97,7 @@
      <member>
       <function>curl_setopt</function>
      </member>
+     <member><classname>CURLStringFile</classname></member>
     </simplelist>
    </para>
   </section>

diff --git a/reference/datetime/book.xml b/reference/datetime/book.xml
@@ -14,22 +14,29 @@
    Te funkcje pozwalają pobierać datę i czas z serwera,
    na którym uruchomione są skrypty PHP. Można ich używać do formatowania
    daty i czasu na wiele różnych sposobów.
+   <classname>DateTimeImmutable</classname> oraz klasy pokrewne pozwalają na
+   reprezentowanie informacji o dacie i czasie. Te obiekty mogą być tworzone przez przekazanie
+   tekstowej reprezentacji informacji o dacie/czasie lub z użyciem obecnego czasu
+   systemowego.
   </para>
   <para>
-   Informacje o dacie i czasie są wewnętrzenie przechowywane jako liczby 64 bitowe, dlatego
+   Dostępny jest też szeroki zakres metod pozwalających na modyfikację i formatowanie
+   tych informacji, w tym obsługę stres czasowych i przejść z czasu letniego na zimowy.
+  </para>
+  <para>
+   Funkcjonalności obsługi daty/czasu implementują kalendarz ISO 8601, który jest
+   <link xlink:href="&url.proleptic-gregorian-calendar;">proleptycznym kalendarzem
+   gregoriańskim</link> implementującym obecne reguły dni przestępnych dla lat sprzed
+   wprowadzenia kalendarza gregoriańskiego, a także zawierającym rok
+   <literal>0</literal> jako numer roku pomiędzy <literal>-1
+   p.n.e</literal> i <literal>1 n.e.</literal>. Sekundy przestępne nie są obsługiwane.
+  </para>
+  <para>
+   Informacje o dacie i czasie są wewnętrznie przechowywane jako liczby 64-bitowe, dlatego
    obsługiwane są wszystkie możliwie przydatne daty (włącznie z latami ujemnymi).
-   Zakres dat jest od 292 miliardów lat w przeszłości do 292 miliardów lat w przyszłości.
+   Zakres dat jest od 292 miliardów lat w przeszłości do 292 miliardów lat w
+   przyszłości.
   </para>
-  <note>
-   <simpara>
-    Proszę pamiętać, że poniższe funkcje są zależne od
-    lokalnych ustawień danego serwera. Należy się upewnić, że
-    podczas pracy z nimi bierzemy pod uwagę czas zimowy
-    i lata przestępne (należy użyć np.
-    <literal>$date = strtotime('+7 days', $date)</literal>, a nie
-    <literal>$date += 7*24*60*60</literal>).
-   </simpara>
-  </note>
   <note>
    <simpara>
     Strefy czasowe, do których odwołujemy się w tym rozdziale
@@ -51,9 +58,50 @@
  &reference.datetime.dateperiod;
 
  &reference.datetime.reference;
+
+ <article xml:id="datetime.error.tree">
+  <title>Wyjątki i błędy daty/czasu</title>
+
+  <itemizedlist>
+   <listitem>
+    <simpara><exceptionname>DateError</exceptionname> (rozszerza <exceptionname>Error</exceptionname>)</simpara>
+    <itemizedlist>
+     <listitem>
+      <simpara><exceptionname>DateObjectError</exceptionname></simpara>
+      <simpara><exceptionname>DateRangeError</exceptionname></simpara>
+     </listitem>
+    </itemizedlist>
+   </listitem>
+   <listitem>
+    <simpara><exceptionname>DateException</exceptionname> (rozszerza <exceptionname>Exception</exceptionname>)</simpara>
+    <itemizedlist>
+     <listitem>
+      <itemizedlist>
+       <listitem><simpara><exceptionname>DateInvalidOperationException</exceptionname></simpara></listitem>
+       <listitem><simpara><exceptionname>DateInvalidTimezoneException</exceptionname></simpara></listitem>
+       <listitem><simpara><exceptionname>DateMalformedIntervalStringException</exceptionname></simpara></listitem>
+       <listitem><simpara><exceptionname>DateMalformedPeriodStringException</exceptionname></simpara></listitem>
+       <listitem><simpara><exceptionname>DateMalformedStringException</exceptionname></simpara></listitem>
+      </itemizedlist>
+     </listitem>
+    </itemizedlist>
+   </listitem>
+  </itemizedlist>
+ </article>
+
  &reference.datetime.formats;
  &reference.datetime.timezones;
 
+ &reference.datetime.dateerror;
+ &reference.datetime.dateobjecterror;
+ &reference.datetime.daterangeerror;
+ &reference.datetime.dateexception;
+ &reference.datetime.dateinvalidoperationexception;
+ &reference.datetime.dateinvalidtimezoneexception;
+ &reference.datetime.datemalformedintervalstringexception;
+ &reference.datetime.datemalformedperiodstringexception;
+ &reference.datetime.datemalformedstringexception;
+
 </book>
 
 <!-- Keep this comment at the end of the file