svn: /phpdoc/de/trunk/appendices/ about.xml comparisons.xml migration56/constants.xml migration56/incompatible.xml migration56/new-features.xml migration56/new-functions.xml reserved.xml resources.xml userlandnaming.xml

Modified: phpdoc/de/trunk/appendices/about.xml
===================================================================
--- phpdoc/de/trunk/appendices/about.xml	2018-01-31 17:34:52 UTC (rev 344141)
+++ phpdoc/de/trunk/appendices/about.xml	2018-01-31 22:07:36 UTC (rev 344142)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 336646 Maintainer: hholzgra Status: ready -->
+<!-- EN-Revision: 342148 Maintainer: hholzgra Status: ready -->
 <!-- Credits: mk, simp -->

  <appendix xml:id="about" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

Modified: phpdoc/de/trunk/appendices/comparisons.xml
===================================================================
--- phpdoc/de/trunk/appendices/comparisons.xml	2018-01-31 17:34:52 UTC (rev 344141)
+++ phpdoc/de/trunk/appendices/comparisons.xml	2018-01-31 22:07:36 UTC (rev 344142)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 331317 Maintainer: simp Status: ready -->
+<!-- EN-Revision: 341793 Maintainer: simp Status: ready -->
 <appendix xml:id="types.comparisons" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Tabelle zu Typenvergleichen in PHP</title>
  <para>
@@ -42,11 +42,11 @@
    Einige numerische Operationen können ein Ergebnis erzeugen, welches durch die
    Konstante <constant>NAN</constant> represäntiert wird. Jeder schwach oder
    stark typisierte Vergleich dieses Wertes mit beliebigen anderen Werten,
-   einschließlich der Konstante selbst, wird &false; ergeben (d.h.
+   einschließlich der Konstante selbst, außer mit &true;, wird &false; ergeben (d.h.
    <literal>NAN != NAN</literal> und <literal>NAN !== NAN</literal>).
    Beispiele für Operationen, die <constant>NAN</constant> ergeben sind u.a.
    <literal>sqrt(-1)</literal>, <literal>asin(2)</literal>, und
-   <literal>asinh(0)</literal>.
+   <literal>acosh(0)</literal>.
   </para>
  </note>
  <para>
@@ -105,6 +105,14 @@
       <entry>&false;</entry>
      </row>
      <row>
+      <entry><literal>$x = array('a', 'b');</literal></entry>
+      <entry><type>array</type></entry>
+      <entry>&false;</entry>
+      <entry>&false;</entry>
+      <entry>&true;</entry>
+      <entry>&true;</entry>
+     </row>
+     <row>
       <entry><literal>$x = false;</literal></entry>
       <entry><type>boolean</type></entry>
       <entry>&true;</entry>

Modified: phpdoc/de/trunk/appendices/migration56/constants.xml
===================================================================
--- phpdoc/de/trunk/appendices/migration56/constants.xml	2018-01-31 17:34:52 UTC (rev 344141)
+++ phpdoc/de/trunk/appendices/migration56/constants.xml	2018-01-31 22:07:36 UTC (rev 344142)
@@ -1,10 +1,22 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 333609 Maintainer: tihox Status: ready -->
+<!-- EN-Revision: 339666 Maintainer: tihox Status: ready -->

 <sect1 xml:id="migration56.constants">
  <title>Neue globale Konstanten</title>

+ <sect2 xml:id="migration56.constants.gd">
+  <title><link linkend="book.image">GD</link></title>
+
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     <constant>IMG_WEBP</constant> (von PHP 5.6.25 an)
+    </simpara>
+   </listitem>
+  </itemizedlist>
+ </sect2>
+
  <sect2 xml:id="migration56.constants.ldap">
   <title><link linkend="book.ldap">LDAP</link></title>


Modified: phpdoc/de/trunk/appendices/migration56/incompatible.xml
===================================================================
--- phpdoc/de/trunk/appendices/migration56/incompatible.xml	2018-01-31 17:34:52 UTC (rev 344141)
+++ phpdoc/de/trunk/appendices/migration56/incompatible.xml	2018-01-31 22:07:36 UTC (rev 344142)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 334716 Maintainer: simp Status: ready -->
+<!-- EN-Revision: 337270 Maintainer: simp Status: ready -->
 <!-- Reviewed: no -->

 <sect1 xml:id="migration56.incompatible">
@@ -113,6 +113,16 @@
    kein IV übergeben wurde.
   </para>
  </sect2>
+
+ <sect2 xml:id="migration56.incompatible.curl">
+  <title><link linkend="book.curl">cURL</link> Datei-Uploads</title>
+
+  <para>
+   Uploads, die die @file Syntax verwenden, erfordern nun, dass
+   CURLOPT_SAFE_UPLOAD auf &false; gesetzt ist. Statt dessen sollte
+   <classname>CURLFile</classname> verwendet werden.
+  </para>
+ </sect2>
 </sect1>

 <!-- Keep this comment at the end of the file

Modified: phpdoc/de/trunk/appendices/migration56/new-features.xml
===================================================================
--- phpdoc/de/trunk/appendices/migration56/new-features.xml	2018-01-31 17:34:52 UTC (rev 344141)
+++ phpdoc/de/trunk/appendices/migration56/new-features.xml	2018-01-31 22:07:36 UTC (rev 344142)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 335317 Maintainer: simp Status: ready -->
+<!-- EN-Revision: 340228 Maintainer: simp Status: ready -->
 <!-- Reviewed: no -->

 <sect1 xml:id="migration56.new-features" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -283,15 +283,15 @@
 $a = gmp_init(42);
 $b = gmp_init(17);

-// Code vor 5.6:
-var_dump(gmp_add($a, $b));
-var_dump(gmp_add($a, 17));
-var_dump(gmp_add(42, $b));
-
-// Neuer Code:
-var_dump($a + $b);
-var_dump($a + 17);
-var_dump(42 + $b);
+if (version_compare(PHP_VERSION, '5.6', '<')) {
+    echo gmp_intval(gmp_add($a, $b)), PHP_EOL;
+    echo gmp_intval(gmp_add($a, 17)), PHP_EOL;
+    echo gmp_intval(gmp_add(42, $b)), PHP_EOL;
+} else {
+    echo $a + $b, PHP_EOL;
+    echo $a + 17, PHP_EOL;
+    echo 42 + $b, PHP_EOL;
+}
 ?>
 ]]>
    </programlisting>

Modified: phpdoc/de/trunk/appendices/migration56/new-functions.xml
===================================================================
--- phpdoc/de/trunk/appendices/migration56/new-functions.xml	2018-01-31 17:34:52 UTC (rev 344141)
+++ phpdoc/de/trunk/appendices/migration56/new-functions.xml	2018-01-31 22:07:36 UTC (rev 344142)
@@ -1,11 +1,23 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 335068 Maintainer: simp Status: ready -->
+<!-- EN-Revision: 338399 Maintainer: simp Status: ready -->
 <!-- Reviewed: no -->

 <sect1 xml:id="migration56.new-functions">
  <title>Neue Funktionen</title>

+ <sect2 xml:id="migration56.new-functions.datetime">
+  <title><link linkend="book.datetime">Datum und Uhrzeit</link></title>
+
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     <methodname>DateTimeImmutable::createFromMutable</methodname>
+    </simpara>
+   </listitem>
+  </itemizedlist>
+ </sect2>
+
  <sect2 xml:id="migration56.new-functions.gmp">
   <title><link linkend="book.gmp">GMP</link></title>


Modified: phpdoc/de/trunk/appendices/reserved.xml
===================================================================
--- phpdoc/de/trunk/appendices/reserved.xml	2018-01-31 17:34:52 UTC (rev 344141)
+++ phpdoc/de/trunk/appendices/reserved.xml	2018-01-31 22:07:36 UTC (rev 344142)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 336657 Maintainer: hholzgra Status: working -->
+<!-- EN-Revision: 343458 Maintainer: hholzgra Status: working -->

  <appendix xml:id="reserved" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>Liste der reservierten Wörter</title>
@@ -7,7 +7,7 @@
   <para>
    Die folgenden Listen enthält in PHP vordefinierten Bezeichner.
    Sie sollten die reservierten Worte aus diesen Listen keinesfalls
-   in eigenen Skripten als Bezeichner benutzen. Die Listen enthalten
+   in eigenen Skripten als Bezeichner benutzen, es sei denn, es wird ausdrücklich erlaubt. Die Listen enthalten
    Schlüsselworte, vordefinierte Variablen, Konstanten und Klassennamen.
    Beachten Sie bitte auch, dass diese Listen nicht unbedingt vollständig
    sind.
@@ -24,6 +24,11 @@
     als Variablenname ist in der Regel möglich, sollte aber unterlassen
     werden um Verwirrung zu vermeiden.
    </simpara>
+   <simpara>
+    Von PHP 7.0.0 an sind diese Schlüsselwörter als Eigenschafts-, Konstanten-
+    und Methodennamen von Klassen, Interfaces und Traits erlaubt, außer dass
+    <literal>class</literal> nicht als Konstantenname verwendet werden darf.
+   </simpara>

    <table>
     <title>PHP Schlüsselworte</title>
@@ -421,6 +426,67 @@
     </simpara>
    </sect2>

+   <sect2 xml:id="reserved.classes.php7">
+    <title>Vordefinierte Interfaces und Klassen von PHP 7 an</title>
+
+    <simpara>
+     Diese zusätzlichen vordefinierten Interfaces und Klassen wurden in PHP
+     7.0.0 eingeführt.
+    </simpara>
+
+    <variablelist>
+     <varlistentry>
+      <term><classname>ArithmeticError</classname></term>
+      <listitem>
+       <simpara>
+       </simpara>
+      </listitem>
+     </varlistentry>
+     <varlistentry>
+      <term><classname>AssertionError</classname></term>
+      <listitem>
+       <simpara>
+       </simpara>
+      </listitem>
+     </varlistentry>
+     <varlistentry>
+      <term><classname>DivisionByZeroError</classname></term>
+      <listitem>
+       <simpara>
+       </simpara>
+      </listitem>
+     </varlistentry>
+     <varlistentry>
+      <term><classname>Error</classname></term>
+      <listitem>
+       <simpara>
+       </simpara>
+      </listitem>
+     </varlistentry>
+     <varlistentry>
+      <term><classname>Throwable</classname></term>
+      <listitem>
+       <simpara>
+       </simpara>
+      </listitem>
+     </varlistentry>
+     <varlistentry>
+      <term><classname>ParseError</classname></term>
+      <listitem>
+       <simpara>
+       </simpara>
+      </listitem>
+     </varlistentry>
+     <varlistentry>
+      <term><classname>TypeError</classname></term>
+      <listitem>
+       <simpara>
+       </simpara>
+      </listitem>
+     </varlistentry>
+    </variablelist>
+   </sect2>
+
    <sect2 xml:id="reserved.classes.special">
     <title>Spezielle Klassen</title>

@@ -464,11 +530,9 @@
   <sect1 xml:id="reserved.other-reserved-words">
    <title>Liste weiterer reservierter Wörter</title>
    <simpara>
-    Diese Wörter können nicht verwendet werden um eine Klasse, ein Interface
-    oder einen Trait zu benennen. Diese Wörter können ebenfalls nicht in
-    Namespaces verwendet werden. Einige der Wörter sind reserviert, um
-    zukünftige PHP Features zu ermöglichen ohne die Abwärtskompatibilität zu
-    brechen.
+    Die folgenden Wörter können nicht verwendet werden um eine Klasse, ein Interface
+    oder einen Trait zu benennen, und sie können ebenfalls nicht in
+    Namespaces verwendet werden.
    </simpara>
    <para>
     <table>
@@ -500,14 +564,37 @@
          null (ab PHP 7)
         </entry>
         <entry>
-         resource (ab PHP 7)
+         void (ab PHP 7.1)
         </entry>
        </row>
        <row>
         <entry>
-         object (ab PHP 7)
+         iterable (ab PHP 7.1)
         </entry>
         <entry>
+         object (ab PHP 7.2)
+        </entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </table>
+   </para>
+   <para>
+    Die folgende Liste von Wörtern war weich reserviert. Obgleich sie noch
+    immer als Klassen-, Interface- und Traitname verwendet werden können (sowie
+    in Namensräumen), ist deren Verwendung zu vermeiden, da sie in zukünftigen
+    PHP-Versionen verwendet werden können.
+   </para>
+   <para>
+    <table>
+     <title>Weich reservierte Wörter</title>
+     <tgroup cols="5">
+      <tbody>
+       <row>
+        <entry>
+         resource (ab PHP 7)
+        </entry>
+        <entry>
          mixed (ab PHP 7)
         </entry>
         <entry>

Modified: phpdoc/de/trunk/appendices/resources.xml
===================================================================
--- phpdoc/de/trunk/appendices/resources.xml	2018-01-31 17:34:52 UTC (rev 344141)
+++ phpdoc/de/trunk/appendices/resources.xml	2018-01-31 22:07:36 UTC (rev 344142)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 336886 Maintainer: hholzgra Status: ready -->
+<!-- EN-Revision: 340367 Maintainer: hholzgra Status: ready -->
 <appendix xml:id="resource" xmlns="http://docbook.org/ns/docbook">
  <title>Liste der Ressource-Typen</title>
  <para>
@@ -2272,7 +2272,7 @@
     <entry>
      <function>shmop_close</function>
     </entry>
-    <entry></entry>
+    <entry>Handle eines Shared-Memory-Blocks (von PHP 7.0.0 an)</entry>
    </row>
    <row>
     <entry>sockets file descriptor set</entry>
@@ -2583,6 +2583,32 @@
     </entry>
     <entry>gz-komprimierte Datei</entry>
    </row>
+   <row>
+    <entry>zlib.deflate</entry>
+    <entry>
+     <function>deflate_init</function>
+    </entry>
+    <entry>
+     <function>deflate_add</function>
+    </entry>
+    <entry>
+     <function>keine</function>
+    </entry>
+    <entry>inkrementeller Deflate-Kontext</entry>
+   </row>
+   <row>
+    <entry>zlib.inflate</entry>
+    <entry>
+     <function>inflate_init</function>
+    </entry>
+    <entry>
+     <function>inflate_add</function>
+    </entry>
+    <entry>
+     <function>keine</function>
+    </entry>
+    <entry>inkrementeller Inflate-Kontext</entry>
+   </row>
        </tbody>
    </tgroup>
   </table>

Modified: phpdoc/de/trunk/appendices/userlandnaming.xml
===================================================================
--- phpdoc/de/trunk/appendices/userlandnaming.xml	2018-01-31 17:34:52 UTC (rev 344141)
+++ phpdoc/de/trunk/appendices/userlandnaming.xml	2018-01-31 22:07:36 UTC (rev 344142)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 322134 Maintainer: hholzgra  Status: working -->
+<!-- EN-Revision: 340765 Maintainer: hholzgra  Status: working -->
 <appendix xml:id="userlandnaming" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Userland Naming Guide</title>
  <para>
@@ -102,25 +102,54 @@
  </section>

  <section xml:id="userlandnaming.tips">
-  <title>Hinweise</title>
+  <title>Tipps</title>
   <para>
-   In order to write future-proof code, it is recommended that you prefix
-   (or suffix) anything that goes into the global namespace with an uncommon
-   3-4 letter prefix (or suffix) separated with an underscore.
+   Um zukunftssicheren Code zu schreiben, wird empfohlen möglichst wenig
+   Variablen, Funktionen oder Klassen im globalen Namensraum zu platzieren. Das
+   wird Namenskonflikte mit Third-Party-Code sowie auch möglichen zukünftigen
+   Erweiterung der Sprache verhindern.
+  </para>
+  <para>
+   Eine übliche Maßnahme, um Namenskonflikte von Funktionen und Klassen zu
+   vermeiden, ist diese zu ihrem eigenen <link
+   linkend="language.namespaces">Namensraum</link> hinzuzufügen.
+  </para>
+  <informalexample>
+   <programlisting role="php">
+<![CDATA[
+<?php

-   It is
-   recommended that in order to prevent namespace clashes with other userland
-   code that projects research existing prefixes (or suffixes) used in other
-   projects and advertise their chosen prefix (or suffix) appropriately.
+namespace MyProject;

-   Examples:
+function my_function() {
+    return true;
+}
+
+\MyProject\my_function();
+]]>
+   </programlisting>
+  </informalexample>
+  <para>
+   Das erfordert noch immer den Überblick über bereits verwendete Namesräume zu
+   behalten, aber sobald entschieden wurde, welcher Namensraum verwendet werden
+   soll, können diesem alle Funktionen und Klassen hinzugefügt werden, ohne
+   weitere Gedanken an Konflikte verschwenden zu müssen.
   </para>
-
-  <itemizedlist>
-   <listitem><para>MyPx_someFunc()</para></listitem>
-   <listitem><para>Foo_Date</para></listitem>
-   <listitem><para>$asdf_dbh</para></listitem>
-  </itemizedlist>
+  <para>
+   Es wird als beste Praxis angesehen, die Zahl von Variablen, die zum globalen
+   Geltungsbereich hinzugefügt werden, zu beschränken, um Namenskonflikte mit
+   Third-Party-Code zu vermeiden.
+  </para>
+  <note>
+   <title>Geltungsbereich von Variablen </title>
+   <para>
+    Aufgrund der <link
+    linkend="language.variables.scope">Geltungsbereichsregeln</link> von PHP
+    befinden sich Variablen, die in Funktionen oder Methoden definiert sind,
+    nicht im globalen Geltungsbereich, und können daher nicht mit anderen
+    Variablen, die im globalen Geltungsbereich definiert sind, kollidieren.
+   </para>
+  </note>
  </section>

 </appendix>