Sync with EN

php · Jan 25, 2024 · eb90be3 · eb90be3
1 parent bebebd5
commit eb90be3
Show file tree

Hide file tree

Showing 8 changed files with 95 additions and 58 deletions.
diff --git a/appendices/migration74/incompatible.xml b/appendices/migration74/incompatible.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 68dfe9740823ed1d229e5e79b7018fe71237c665 Maintainer: samesch Status: ready -->
+<!-- EN-Revision: c308ed37a98decb1959ed47dc149a43d6c71ec60 Maintainer: samesch Status: ready -->
 
 <sect1 xml:id="migration74.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Nicht abwärtskompatible Änderungen</title>
@@ -14,7 +14,7 @@
    <para>
     Der Versuch, Werte vom Typ <type>null</type>, <type>bool</type>,
     <type>int</type>, <type>float</type> oder <type>resource</type> wie ein
-    Array zu verwenden, (z. B. <literal>$null["key"]</literal>) erzeugt nun
+    Array zu verwenden, (&zb; <literal>$null["key"]</literal>) erzeugt nun
     einen Hinweis.
    </para>
   </sect3>
@@ -138,7 +138,7 @@
     als Fehler gewertet.
    </para>
    <para>
-    Diese Funktionen geben nun auch bei Fehlern eine Meldung aus, z. B. wenn
+    Diese Funktionen geben nun auch bei Fehlern eine Meldung aus, &zb; wenn
     versucht wird, in eine schreibgeschützte Dateiressource zu schreiben.
    </para>
   </sect3>
@@ -150,7 +150,7 @@
 
   <para>
    BCMath-Funktionen erzeugen nun eine Warnung, wenn eine nicht wohlgeformte
-   Zahl übergeben wird, z. B. <literal>"32foo"</literal>. Der Parameter wird
+   Zahl übergeben wird, &zb; <literal>"32foo"</literal>. Der Parameter wird
    wie bisher als Null interpretiert.
   </para>
  </sect2>
@@ -226,9 +226,9 @@
    aus. Insbesondere wird ein <classname>Error</classname> ausgelöst, wenn die
    Anzahl der angeforderten Bytes kleiner oder gleich Null ist, und eine
    <classname>Exception</classname> wird ausgelöst, wenn nicht genügend
-   Zufallsdaten gesammelt werden können. Wenn die Funktion nicht auslöst, ist
-   der Parameter <literal>$crypto_strong output</literal> garantiert immer
-   &true;, weshalb eine explizite Überprüfung nicht nötig ist.
+   Zufallsdaten gesammelt werden können. Wenn die Funktion keine Exception
+   wirft, ist der Ausgabeparameter <literal>$crypto_strong</literal>
+   garantiert immer &true;, weshalb eine explizite Überprüfung nicht nötig ist.
   </para>
  </sect2>
 
@@ -303,8 +303,8 @@
    </listitem>
    <listitem>
     <simpara>
-     Möglicherweise andere, die Objekteigenschaften als Liste bearbeiten,
-     z. B. die Funktion <function>array_walk</function>.
+     Möglicherweise andere, die Objekteigenschaften als Liste bearbeiten, &zb;
+     die Funktion <function>array_walk</function>.
     </simpara>
    </listitem>
   </itemizedlist>

diff --git a/language-snippets.ent b/language-snippets.ent
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: fe11910e25e7eba44959bd347ba946ffc4d56934 Maintainer: simp Status: ready -->
+<!-- EN-Revision: 960a6ac3b1c21d95ce317acf248002129618efd9 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: '>
@@ -3522,7 +3522,7 @@ local: {
          </row>
          <row>
           <entry>queryType</entry>
-          <entry><type>int</type></entry>
+          <entry><type>string</type></entry>
           <entry>
            <para>
             The query type for evaluating queries with indexed, encrypted

diff --git a/reference/array/functions/array-key-exists.xml b/reference/array/functions/array-key-exists.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: a6655e3f9508eee6860b02f55e33560a790f42d1 Maintainer: wiesemann Status: ready -->
+<!-- EN-Revision: 89fe795cc8bcf1b5ff9eb894bff51f006db66a65 Maintainer: wiesemann Status: ready -->
 <!-- Reviewed: yes -->
 <!-- Rev-Revision: a6655e3f9508eee6860b02f55e33560a790f42d1 Reviewer: samesch -->
 <!-- CREDITS: tom -->
@@ -14,7 +14,7 @@
   &reftitle.description;
   <methodsynopsis>
    <type>bool</type><methodname>array_key_exists</methodname>
-   <methodparam><type class="union"><type>string</type><type>int</type></type><parameter>key</parameter></methodparam>
+   <methodparam><type class="union"><type>string</type><type>int</type><type>float</type><type>bool</type><type>resource</type><type>null</type></type><parameter>key</parameter></methodparam>
    <methodparam><type>array</type><parameter>array</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -63,6 +63,32 @@
   </note>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Der Parameter <parameter>key</parameter> akzeptiert nun Werte vom Typ
+       <parameter>bool</parameter>, <parameter>float</parameter>,
+       <parameter>int</parameter>, <parameter>null</parameter>,
+       <parameter>resource</parameter> und <parameter>string</parameter> als
+       Argument.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>

diff --git a/reference/classobj/functions/get-parent-class.xml b/reference/classobj/functions/get-parent-class.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: f004f576e7329b583dd41cf7e393efd5139bd5a3 Maintainer: samesch Status: ready -->
+<!-- EN-Revision: 7d126f6cefb26fc3ef145ba3c0307ba7c1d03cf3 Maintainer: samesch Status: ready -->
 <refentry xml:id="function.get-parent-class" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>get_parent_class</refname>
@@ -41,14 +41,12 @@
    Gibt den Namen der Elternklasse der Klasse zurück, von der
    <parameter>object_or_class</parameter> eine Instanz oder der Name ist.
   </para>
-  <note>
-   <para>
-    Falls das Objekt keine Elternklasse hat oder die angegebene Klasse nicht
-    existiert, wird &false; zurückgegeben.
-   </para>
-  </note>
   <para>
-   Falls die Funktion außerhalb eines Objekts ohne Parameter aufgerufen wird,
+   Falls das Objekt keine Elternklasse hat oder die angegebene Klasse nicht
+   existiert, wird &false; zurückgegeben.
+  </para>
+  <para>
+   Falls die Funktion ohne Parameter außerhalb eines Objekts aufgerufen wird,
    gibt sie &false; zurück.
   </para>
  </refsect1>
@@ -67,7 +65,8 @@
      <row>
       <entry>8.0.0</entry>
       <entry>
-       Der Parameter <parameter>object_or_class</parameter> akzeptiert jetzt nur noch Objekte oder gültige Klassennamen.
+       Der Parameter <parameter>object_or_class</parameter> akzeptiert jetzt
+       nur noch Objekte oder gültige Klassennamen.
       </entry>
      </row>
     </tbody>
@@ -85,24 +84,24 @@
 <?php
 
 class Vater {
-  function __construct()
-  {
-  // implementiert etwas Logik
-  }
+    function __construct()
+    {
+    // implementiert etwas Logik
+    }
 }
 
 class Kind extends Vater {
-  function __construct()
-  {
-    echo "Ich bin das Kind von " , get_parent_class($this) , "\n";
-  }
+    function __construct()
+    {
+        echo "Ich bin das Kind von " , get_parent_class($this) , "\n";
+    }
 }
 
 class Kind2 extends Vater {
-  function __construct()
-  {
-    echo "Ich bin ebenfalls das Kind von " , get_parent_class('kind2') , "\n";
-  }
+    function __construct()
+    {
+        echo "Ich bin ebenfalls das Kind von " , get_parent_class('kind2') , "\n";
+    }
 }
 
 $foo = new kind();

diff --git a/reference/classobj/functions/is-a.xml b/reference/classobj/functions/is-a.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 2428508fac1d38d4329a276403ef069218eaf083 Maintainer: samesch Status: ready -->
+<!-- EN-Revision: fd65805e83f7dc3b12ab5844cafc4489dc367a27 Maintainer: samesch Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.is-a" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -17,8 +17,9 @@
    <methodparam choice="opt"><type>bool</type><parameter>allow_string</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Prüft, ob das angegebene <parameter>object_or_class</parameter> vom
-   angegebenen Objekttyp ist oder diesen Objekttyp als einen seiner Eltern hat.
+   Ermittelt, ob das angegebene <parameter>object_or_class</parameter> vom
+   Objekttyp <parameter>class</parameter> ist oder
+   <parameter>class</parameter> als einen seiner Elterntypen hat.
   </para>
  </refsect1>
 
@@ -60,9 +61,9 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Gibt &true; zurück, wenn das Objekt vom
-   angegebenen Objekttyp ist oder diesen Objekttyp als einen seiner Eltern
-   hat, andernfalls wird &false; zurückgegeben.
+   Gibt &true; zurück, wenn <parameter>object_or_class</parameter> vom
+   Objekttyp <parameter>class</parameter> ist oder <parameter>class</parameter>
+   als einen seiner Elterntypen hat, andernfalls wird &false; zurückgegeben.
   </para>
  </refsect1>
 

diff --git a/reference/mail/functions/mail.xml b/reference/mail/functions/mail.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: nobody Status: ready -->
+<!-- EN-Revision: d43f29f6a628996d1b7c3be487dcff39450146bf Maintainer: nobody Status: ready -->
 <refentry xml:id="function.mail" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>mail</refname>
@@ -105,16 +105,6 @@ $text = str_replace("\n.", "\n..", $text);
        Header-Namen, und dessen Werte als entsprechende Header-Werte
        interpretiert.
       </para>
-      <note>
-       <para>
-        Vor PHP 5.4.42 bzw. 5.5.27 bot
-        <parameter>additional_headers</parameter> noch keinen Schutz vor
-        Mail-Header-Injection. Daher müssen Anwender sicherstellen, dass die
-        angegeben Header sicher sind und wirklich nur Header enthalten. Unter
-        anderem ist darauf zu achten, dass mehrere aufeinanderfolgende
-        Zeilenumbrüche den E-Mail-Header beenden.
-       </para>
-      </note>
       <note>
        <para>
         Um eine E-Mail zu senden, <emphasis>muss</emphasis> die E-Mail einen

diff --git a/reference/outcontrol/book.xml b/reference/outcontrol/book.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 95bdd6883b5dde9504701777ba81b3c5f15df52b Maintainer: hholzgra Status: ready -->
+<!-- EN-Revision: 7610e990293c87168d026ad078d8272e643e2c23 Maintainer: hholzgra Status: ready -->
 
 <book xml:id="book.outcontrol" xmlns="http://docbook.org/ns/docbook">
  <?phpdoc extension-membership="core" ?>
@@ -23,6 +23,9 @@
 
  &reference.outcontrol.setup;
  &reference.outcontrol.constants;
+ &reference.outcontrol.output-buffering;
+ &reference.outcontrol.flushing-system-buffers;
+ &reference.outcontrol.user-level-output-buffers;
  &reference.outcontrol.examples;
  &reference.outcontrol.reference;
 

diff --git a/reference/pdo/pdorow.xml b/reference/pdo/pdorow.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: daf4cc624df3c21d472149725feb377b1beedb04 Maintainer: samesch Status: ready -->
+<!-- EN-Revision: 59a7b6d83acdad0180fa4519fa537bfd6deb162a Maintainer: samesch Status: ready -->
 <!-- Reviewed: no -->
 <phpdoc:classref xml:id="class.pdorow" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Die Klasse PDORow</title>
@@ -16,14 +16,23 @@
     <constant>PDO_FETCH_LAZY</constant> zurückgegeben wurde.
    </para>
    <para>
-    Zusätzlich zu seiner Standardeigenschaft <property>queryString</property>
-    erstellt das <classname>PDORow</classname>-Objekt Eigenschaften, die den
-    Spaltennamen in der Ergebnismenge entsprechen, sobald auf diese
-    zugegriffen wird.
+    Objekte dieser Klasse können weder instanziiert noch serialisiert werden.
    </para>
    <para>
-    Objekte dieser Klasse können nicht instanziiert werden.
+    Über das <classname>PDORow</classname>-Objekt kann auf die zurückgegebenen
+    Daten zugegriffen werden, als ob sowohl der Modus
+    <constant>PDO::FETCH_OBJ</constant> als auch
+    <constant>PDO::FETCH_BOTH</constant> verwendet wurde. Das bedeutet, dass
+    auf die zurückgegebenen Daten als Objekteigenschaften und als Array
+    zugegriffen werden kann, das sowohl durch den Spaltennamen als auch durch
+    die Nummer des Spaltenoffsets indiziert ist.
    </para>
+   <caution>
+    <simpara>
+     Wenn auf eine undefinierte Eigenschaft zugegriffen wird, wird &null;
+     zurückgegeben, ohne dass eine Warnung ausgegeben wird.
+    </simpara>
+   </caution>
   </section>
 <!-- }}} -->
 
@@ -67,6 +76,15 @@
   </section>
 <!-- }}} -->
 
+  <section role="errors">
+   &reftitle.errors;
+   <para>
+    Wenn versucht wird, in eine beliebige Eigenschaft zu schreiben oder sie
+    mittels <function>unset</function> zu löschen, wird ein
+    <classname>Error</classname> geworfen.
+   </para>
+  </section>
+
  </partintro>
 
 </phpdoc:classref>