Sync with EN

php · Nov 12, 2024 · 7ade239 · 7ade239
1 parent a0c7ae8
commit 7ade239
Show file tree

Hide file tree

Showing 25 changed files with 969 additions and 1,102 deletions.
diff --git a/appendices/migration70/changed-functions.xml b/appendices/migration70/changed-functions.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 4279863b96f74295fb6bd2d44e34270a71fb9537 Maintainer: nobody Status: ready -->
+<!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: nobody Status: ready -->
 
 <sect1 xml:id="migration70.changed-functions">
  <title>Geänderte Funktionen</title>
@@ -48,7 +48,9 @@
     <simpara>
      <function>setlocale</function> Funktion akzeptiert keine Zeichenketten mehr,
      die dem Parameter <parameter>category</parameter> übergeben werden.
-     Stattdessen muss eine der <constant>LC_*</constant> Konstanten verwendet werden.
+     Stattdessen muss eine der
+     <constant>LC_<replaceable>*</replaceable></constant>-Konstanten
+     verwendet werden.
     </simpara>
    </listitem>
    <listitem>

diff --git a/appendices/migration70/incompatible/removed-functions.xml b/appendices/migration70/incompatible/removed-functions.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 8f5f6a52c0d25a42a069c6c1cff4effb68fb379c Maintainer: samesch Status: ready -->
+<!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: samesch Status: ready -->
 
 <sect2 xml:id="migration70.incompatible.removed-functions">
  <title>Entfernte Funktionen</title>
@@ -44,7 +44,8 @@
    <function>mcrypt_ecb</function> <function>mcrypt_cbc</function>,
    <function>mcrypt_cfb</function> und <function>mcrypt_ofb</function>
    zugunsten von <function>mcrypt_decrypt</function> in Kombination
-   mit der entsprechenden <constant>MCRYPT_MODE_*</constant>-Konstante
+   mit der entsprechenden
+   <constant>MCRYPT_MODE_<replaceable>*</replaceable></constant>-Konstante
    entfernt.
   </para>
  </sect3>

diff --git a/appendices/migration80/other-changes.xml b/appendices/migration80/other-changes.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 4c41f6fa0ebe4afe8b7a3468e7e26dfd0c0e4131 Maintainer: samesch Status: ready -->
+<!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: samesch Status: ready -->
 
 <sect1 xml:id="migration80.other-changes" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Sonstige Änderungen</title>
@@ -79,9 +79,9 @@
       <methodname>ZipArchiv::addFile</methodname> und
       <methodname>ZipArchive::addFromString</methodname> haben den neuen
       Parameter <parameter>flags</parameter>. Damit können die Namenskodierung
-      (<constant>ZipArchive::FL_ENC_*</constant>) und die Ersetzung von
-      Einträgen (<constant>ZipArchive::FL_OVERWRITE</constant>) verwaltet
-      werden.
+      (<constant>ZipArchive::FL_ENC_<replaceable>*</replaceable></constant>)
+      und die Ersetzung von Einträgen
+      (<constant>ZipArchive::FL_OVERWRITE</constant>) verwaltet werden.
      </para>
     </listitem>
     <listitem>

diff --git a/install/fpm/configuration.xml b/install/fpm/configuration.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 0a2cede24d8931daf458935665d0cac08d0926c5 Maintainer: nikic Status: ready -->
+<!-- EN-Revision: 912e7346710c6404fe59d7085fff7a42d7a2c870 Maintainer: nikic Status: ready -->
 <!-- Reviewed: yes -->
 <!-- Rev-Revision: 197df870cb7d610d4b253621b85909969d3c509a Reviewer: samesch -->
 <!-- Credits: Jens-Andre Koch -->
@@ -988,22 +988,39 @@
           <entry>
            <literal>%t</literal>
           </entry>
-          <entry>Serverzeit, zu der die Anfrage eingegangen ist</entry>
+          <entry>
+           Serverzeit, zu der die Anfrage eingegangen ist. Diese Direktive
+           akzeptiert das <literal>strftime(3)</literal>-Format
+           <literal>%d/%b/%Y:%H:%M:%S %z</literal> (Standard). Das
+           <literal>strftime(3)</literal>-Format muss in einem
+           <literal>%{&lt;strftime_format&gt;}t</literal>-Tag gekapselt sein.
+           Für eine Zeitangabe im ISO8601-Format würde &zb; folgendes
+           verwendet: <literal>%{%Y-%m-%dT%H:%M:%S%z}t</literal>
+          </entry>
          </row>
          <row>
           <entry>
            <literal>%T</literal>
           </entry>
           <entry>
            Zeitpunkt, zu dem das Protokoll geschrieben wurde (als die Anfrage
-           beendet wurde)
+           beendet wurde). Diese Direktive akzeptiert das
+           <literal>strftime(3)</literal>-Format
+           <literal>%d/%b/%Y:%H:%M:%S %z</literal> (Standard). Das
+           <literal>strftime(3)</literal>-Format muss in einem
+           <literal>%{&lt;strftime_format&gt;}t</literal>-Tag gekapselt sein.
+           Für eine Zeitangabe im ISO8601-Format würde &zb; folgendes
+           verwendet: <literal>%{%Y-%m-%dT%H:%M:%S%z}t</literal>
           </entry>
          </row>
          <row>
           <entry>
            <literal>%u</literal>
           </entry>
-          <entry>Entfernter (Remote-) Benutzer</entry>
+          <entry>
+           Benutzer mit Basis-Zugangsauthentifizierung, falls im
+           <literal>Authorization</literal>-Header angegeben
+          </entry>
          </row>
         </tbody>
        </tgroup>

diff --git a/language-snippets.ent b/language-snippets.ent
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5051184c4fb3fcfe5f3f01f4789d0149e3e1f945 Maintainer: simp Status: ready -->
+<!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: simp Status: ready -->
 <!-- CREDITS: sammywg, mk, betz -->
 
 <!ENTITY installation.enabled.disable 'Diese Erweiterung ist standardmäßig aktiviert. Sie kann bei der Kompilierung mit der folgenden Option ausgeschaltet werden: '>
@@ -1485,8 +1485,9 @@ Server gespeichert werden sollen.'>
 <!ENTITY memcached.result.delete-multi '<para xmlns="http://docbook.org/ns/docbook">
    Gibt ein Array mit <parameter>keys</parameter> als Indizes zurück. Dabei
    sind die jeweiligen Werte &true;, wenn der entsprechende Schlüssel gelöscht
-   wurde, oder eine der <constant>Memcached::RES_*</constant>-Konstanten, wenn
-   der entsprechende Löschvorgang fehlgeschlagen ist.
+   wurde, oder eine der
+   <constant>Memcached::RES_<replaceable>*</replaceable></constant>-Konstanten,
+   wenn der entsprechende Löschvorgang fehlgeschlagen ist.
    </para>
   <para xmlns="http://docbook.org/ns/docbook">
    Die Methode <methodname>Memcached::getResultCode</methodname> gibt den

diff --git a/language/control-structures/match.xml b/language/control-structures/match.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 6c71b05df89358d7760a4740ed3fcfa1682eadb6 Maintainer: joshuaruesweg Status: ready -->
+<!-- EN-Revision: 6507fc94c2d0a0e65ee9486a98e9135f34220ae7 Maintainer: joshuaruesweg Status: ready -->
 <sect1 xml:id="control-structures.match" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>match</title>
  <?phpdoc print-version-for="match"?>
@@ -63,8 +63,8 @@ $output = match (true) {
     $age < 2 => "Baby",
     $age < 13 => "Kind",
     $age <= 19 => "Teenager",
+    $age >= 40 => "Alter Erwachsener",
     $age > 19 => "Junger Erwachsener",
-    $age >= 40 => "Alter Erwachsener"
 };
 
 var_dump($output);

diff --git a/language/functions.xml b/language/functions.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: a8a996177b68bf946ba2825c6eadb9bb9d37b165 Maintainer: cmb Status: ready -->
+<!-- EN-Revision: 489d46bc2598784bd3711454ccab8940107cde67 Maintainer: cmb Status: ready -->
 <!-- Reviewed: yes -->
 <!-- Rev-Revision: b95e76e41de2ffe5c75e04be1b187d80ca745359 Reviewer: samesch -->
 <!-- Credits: hholzgra, tom, updated to fix build by theseer -->
@@ -477,11 +477,17 @@ Making a bowl of raspberry natural yogurt.
       <programlisting role="php">
 <![CDATA[
 <?php
-function foo($a = [], $b) {} // Seit PHP 8.0.0 veraltet; Standardwert wird nicht verwendet
-function foo($a, $b) {}      // Funktionell identisch, aber ohne Veraltet-Hinweis
 
-function bar(A $a = null, $b) {} // Seit PHP 8.4.0 veraltet; $a wird benötigt, kann aber null sein
+function foo($a = [], $b) {}     // Standardwert wird nicht verwendet;
+                                 // seit PHP 8.0.0 veraltet
+function foo($a, $b) {}          // Funktionell identisch, aber ohne Veraltet-Hinweis
+
+function bar(A $a = null, $b) {} // Seit PHP 8.1.0 ist $a implizit erforderlich
+                                 // (da es vor dem erforderlichen Parameter steht),
+                                 // aber implizit löschbar (seit PHP 8.4.0 veraltet),
+                                 // da der Standardparameterwert null ist
 function bar(?A $a, $b) {}       // Empfohlen
+
 ?>
 ]]>
       </programlisting>

diff --git a/language/oop5/final.xml b/language/oop5/final.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 16f66c05a4060a7d673ae1c70b656d65009407b0 Maintainer: wiesemann Status: ready -->
+<!-- EN-Revision: 214912bef853e01a194fe627f109d132f7602bab Maintainer: wiesemann Status: ready -->
 <!-- Reviewed: yes -->
 <!-- Rev-Revision: 3ddc88b8364f27727a53ba6eb7c9a98f8525f3ce Reviewer: samesch -->
  <sect1 xml:id="language.oop5.final" xmlns="http://docbook.org/ns/docbook">

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"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c2cf2290247ae581d10dc4d74d91cc4f97293daa Maintainer: sammywg Status: ready -->
-
+<!-- EN-Revision: 3f1cd5121f7c9f8347ca69c8f657fdb24c0f9729 Maintainer: sammywg Status: ready -->
 <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>
@@ -16,7 +15,8 @@
    Verwendung eines <link linkend="wrappers.http">HTTP-Wrappers</link> enthält
    <varname>$http_response_header</varname> die HTTP Response-Header.
    <varname>$http_response_header</varname> wird im
-   <link linkend="language.variables.scope">lokalen Variablengeltungsbereich</link> erstellt.
+   <link linkend="language.variables.scope">lokalen Geltungsbereich von Variablen</link>
+   erstellt.
   </para>
  </refsect1>
 
@@ -69,8 +69,15 @@ NULL
   </para>
  </refsect1>
 
-</refentry>
+ <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
 Local variables:
 mode: sgml

diff --git a/language/predefined/weakreference.xml b/language/predefined/weakreference.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: samesch Status: ready -->
+<!-- EN-Revision: cd391e65a613a729f9bbded2b1249e2d7143400c Maintainer: samesch Status: ready -->
 <!-- Reviewed: no -->
 <reference xml:id="class.weakreference" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
@@ -16,6 +16,12 @@
     Schwache Referenzen erlauben es dem Programmierer, eine Referenz auf ein
     Objekt zu behalten, die nicht verhindert, dass das Objekt zerstört wird.
     Sie sind nützlich für die Implementierung von Cache-ähnlichen Strukturen.
+    Wenn das ursprüngliche Objekt zerstört wurde, wird beim Aufruf der Methode
+    <methodname>WeakReference::get</methodname> &null; zurückgegeben. Wenn der
+    <link linkend="features.gc.refcounting-basics">Referenzzähler</link> für
+    das ursprüngliche Objekt auf Null fällt, wird es zerstört; das
+    Erstellen von schwachen Referenzen erhöht den <literal>refcount</literal>
+    des referenzierten Objekts nicht.
    </para>
    <para>
     <classname>WeakReference</classname>s können nicht serialisiert werden.
@@ -53,11 +59,16 @@
      <programlisting role="php">
 <![CDATA[
 <?php
-$obj = new stdClass;
+
+$obj = new stdClass();
 $weakref = WeakReference::create($obj);
+
 var_dump($weakref->get());
+
 unset($obj);
+
 var_dump($weakref->get());
+
 ?>
 ]]>
      </programlisting>

diff --git a/reference/curl/constants_curl_multi.xml b/reference/curl/constants_curl_multi.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 6369333ffbe351e8d072127ff8b42512bd4b8078 Maintainer: samesch Status: ready -->
+<!-- EN-Revision: 92e188ab73f99fa0dfe4a4bfcb3a3f363e451d4a Maintainer: samesch Status: ready -->
 <!-- Reviewed: no -->
 <variablelist xml:id="constant.curl-multi.constants" role="constant_list">
  <title>curl_multi_<replaceable>*</replaceable> status constants</title>
@@ -12,7 +12,7 @@
    <simpara>
     Es wurde versucht, ein einfaches Handle, das bereits zu einem
     Mehrfach-Handle hinzugefügt wurde, ein zweites Mal hinzuzufügen.
-    Verfügbar seit cURL 7.32.1
+    Verfügbar seit cURL 7.32.1.
    </simpara>
   </listitem>
  </varlistentry>
@@ -26,6 +26,7 @@
     Ein einfaches Handle war nicht gut/gültig. Dies könnte bedeuten, dass es
     sich gar nicht um ein einfaches Handle handelt, oder dass das Handle
     bereits von diesem Mehrfach-Handle oder einem anderen verwendet wird.
+    Verfügbar seit cURL 7.9.6.
    </simpara>
   </listitem>
  </varlistentry>
@@ -37,6 +38,7 @@
   <listitem>
    <simpara>
     Das übergebene Handle ist kein gültiges Mehrfach-Handle.
+    Verfügbar seit cURL 7.9.6.
    </simpara>
   </listitem>
  </varlistentry>
@@ -52,6 +54,7 @@
     <function>curl_multi_exec</function> zurückgegeben werden, wenn
     <function>curl_multi_select</function> oder eine ähnliche Funktion
     aufgerufen wurde, bevor sie eine andere Konstante zurückgab.
+    Verfügbar seit cURL 7.9.6.
    </simpara>
   </listitem>
  </varlistentry>
@@ -63,6 +66,7 @@
   <listitem>
    <simpara>
     Interner <literal>libcurl</literal>-Fehler.
+    Verfügbar seit cURL 7.9.6.
    </simpara>
   </listitem>
  </varlistentry>
@@ -74,6 +78,7 @@
   <listitem>
    <simpara>
     Keine Fehler.
+    Verfügbar seit cURL 7.9.6.
    </simpara>
   </listitem>
  </varlistentry>
@@ -85,6 +90,7 @@
   <listitem>
    <simpara>
     Bei der Verarbeitung von Mehrfach-Handles war kein Speicher mehr verfügbar.
+    Verfügbar seit cURL 7.9.6.
    </simpara>
   </listitem>
  </varlistentry>

diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml
@@ -1,4 +1,4 @@
-<!-- EN-Revision: 5af46249c57c3cdee132f275899b0b7750e0cba4 Maintainer: samesch Status: wip -->
+<!-- EN-Revision: fb2b760cac71413ec55fe403086586fd1560a002 Maintainer: samesch Status: wip -->
 <!-- Reviewed: no -->
 <!-- Mostly copied from curl/functions/curl-setopt.xml -->
 <!-- Credits: jaenecke -->