svn: /phpdoc/de/trunk/ language/operators.xml reference/datetime/datetimeinterface.xml reference/datetime/functions/microtime.xml reference/exec/functions/proc-open.xml

Modified: phpdoc/de/trunk/language/operators.xml
===================================================================
--- phpdoc/de/trunk/language/operators.xml	2020-02-22 01:05:50 UTC (rev 349249)
+++ phpdoc/de/trunk/language/operators.xml	2020-02-23 10:46:02 UTC (rev 349250)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 348555 Maintainer: nobody Status: ready -->
+<!-- EN-Revision: 349236 Maintainer: nobody Status: ready -->
 <!-- CREDITS: tzwenny, betz -->

  <chapter xml:id="language.operators" xmlns="http://docbook.org/ns/docbook">
@@ -255,6 +255,7 @@
          <literal>^=</literal>
          <literal>&lt;&lt;=</literal>
          <literal>&gt;&gt;=</literal>
+         <literal>??=</literal>
         </entry>
         <entry>
          <link linkend="language.operators.assignment">Zuweisung</link>

Modified: phpdoc/de/trunk/reference/datetime/datetimeinterface.xml
===================================================================
--- phpdoc/de/trunk/reference/datetime/datetimeinterface.xml	2020-02-22 01:05:50 UTC (rev 349249)
+++ phpdoc/de/trunk/reference/datetime/datetimeinterface.xml	2020-02-23 10:46:02 UTC (rev 349250)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 345663 Maintainer: cmb Status: ready -->
+<!-- EN-Revision: 349226 Maintainer: cmb Status: ready -->
 <!-- CREDITS: Yannic Schnetz -->

 <phpdoc:classref xml:id="class.datetimeinterface" 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">
@@ -80,6 +80,12 @@
      <initializer>"D, d M Y H:i:s O"</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
+      <modifier>const</modifier>
+      <type>string</type>
+      <varname linkend="datetime.constants.rfc7231">DateTimeInterface::RFC7231</varname>
+      <initializer>"D, d M Y H:i:s \G\M\T"</initializer>
+    </fieldsynopsis>
+    <fieldsynopsis>
      <modifier>const</modifier>
      <type>string</type>
      <varname linkend="datetime.constants.rfc2822">DateTimeInterface::RFC2822</varname>
@@ -199,6 +205,16 @@
      </listitem>
     </varlistentry>

+    <varlistentry xml:id="datetime.constants.rfc7231">
+      <term><constant>DateTimeInterface::RFC7231</constant></term>
+      <term><constant>DATE_RFC7231</constant></term>
+      <listitem>
+       <simpara>
+        RFC 7231 (seit PHP 7.0.19 und 7.1.5) (Beispiel: Sat, 30 Apr 2016 17:52:13 GMT)
+       </simpara>
+      </listitem>
+    </varlistentry>
+
     <varlistentry xml:id="datetime.constants.rfc2822">
      <term><constant>DateTime::RFC2822</constant></term>
      <term><constant>DATE_RFC2822</constant></term>

Modified: phpdoc/de/trunk/reference/datetime/functions/microtime.xml
===================================================================
--- phpdoc/de/trunk/reference/datetime/functions/microtime.xml	2020-02-22 01:05:50 UTC (rev 349249)
+++ phpdoc/de/trunk/reference/datetime/functions/microtime.xml	2020-02-23 10:46:02 UTC (rev 349250)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 343899 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 349239 Maintainer: sammywg Status: ready -->

 <refentry xml:id="function.microtime" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -19,6 +19,10 @@
    Mikrosekunden zurück. Diese Funktion steht nur auf Systemen zur Verfügung,
    die den Systemaufruf gettimeofday() unterstützen.
   </para>
+  <para>
+   Für Leistungsfähigkeitsmessungen wird die Verwendung von <function>hrtime</function>
+   empfohlen.
+  </para>
  </refsect1>

  <refsect1 role="parameters">
@@ -130,6 +134,7 @@
   <para>
    <simplelist>
     <member><function>time</function></member>
+    <member><function>hrtime</function></member>
    </simplelist>
   </para>
  </refsect1>

Modified: phpdoc/de/trunk/reference/exec/functions/proc-open.xml
===================================================================
--- phpdoc/de/trunk/reference/exec/functions/proc-open.xml	2020-02-22 01:05:50 UTC (rev 349249)
+++ phpdoc/de/trunk/reference/exec/functions/proc-open.xml	2020-02-23 10:46:02 UTC (rev 349250)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 348652 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 349246 Maintainer: sammywg Status: ready -->
 <refentry xml:id='function.proc-open' xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>proc_open</refname>
@@ -13,7 +13,7 @@
   &reftitle.description;
    <methodsynopsis>
     <type>resource</type><methodname>proc_open</methodname>
-    <methodparam><type>string</type><parameter>cmd</parameter></methodparam>
+    <methodparam><type>mixed</type><parameter>cmd</parameter></methodparam>
     <methodparam><type>array</type><parameter>descriptorspec</parameter></methodparam>
     <methodparam><type>array</type><parameter role="reference">pipes</parameter></methodparam>
     <methodparam choice="opt"><type>string</type><parameter>cwd</parameter><initializer>&null;</initializer></methodparam>
@@ -49,8 +49,28 @@
      <term><parameter>cmd</parameter></term>
      <listitem>
       <para>
-       Das auszuführende Kommando.
+       Das auszuführende Kommandozeile als &string;. Sonderzeichen müssen ordnungsgemäß maskiert,
+       und Argumente müssen ggf. in Anführungszeichen eingeschlossen werden.
       </para>
+      <note>
+       <simpara>
+        Unter <emphasis>Windows</emphasis> wird, falls <literal>bypass_shell</literal> in
+        <parameter>other_options</parameter> nicht auf &true; gesetzt ist, das <parameter>cmd</parameter>
+        mit dem <literal>/c</literal> Flag als <emphasis>nicht in Anführungszeichen eingeschlossene</emphasis> Zeichenkette
+        (d.h. genau wie an <function>proc_open</function> übergeben)
+        an <command>cmd.exe</command> übergeben (genauer gesagt an <literal>%ComSpec%</literal>).
+        Dies kann <command>cmd.exe</command> veranlassen, umschließende Anführungszeichen von
+        <parameter>cmd</parameter> zu entfernen (Details sind der <command>cmd.exe</command> Dokumentation zu entnehmen),
+        was zu unerwartetem, und potentiell sogar gefährlichen Verhalten führen kann, da
+        <command>cmd.exe</command> Fehlermeldungen das übergebene <parameter>cmd</parameter>
+        oder Teile davon enthalten können (siehe Beispiel weiter unten).
+       </simpara>
+      </note>
+      <para>
+       Von PHP 7.4.0 an kann <parameter>cmd</parameter> als &array; von Kommandozeilenparametern übergeben werden.
+       In diesem Fall wird der Prozess direkt gestartet (ohne Umweg über die Shell)
+       und PHP kümmert sich um das nötige Maskieren von Argumenten.
+      </para>
      </listitem>
     </varlistentry>
     <varlistentry>
@@ -180,6 +200,13 @@
       <row>
        <entry>7.4.0</entry>
        <entry>
+        <function>proc_open</function> akzeptiert nun ebenfalls ein &array;
+        für das <parameter>cmd</parameter>.
+       </entry>
+      </row>
+      <row>
+       <entry>7.4.0</entry>
+       <entry>
         Die Option <literal>create_process_group</literal> wurde dem Parameter
         <parameter>other_options</parameter> hinzugefügt.
        </entry>
@@ -261,6 +288,43 @@
    </example>
   </para>

+  <para>
+   <example>
+    <title><function>proc_open</function>-Eigenheit unter Windows</title>
+    <simpara>
+     Während man erwarten könnte, dass das folgende Program die Datei <filename>filename.txt</filename>
+     nach dem Text <literal>suche</literal> durchsucht und die Ergebnisse ausgibt,
+     verhält es sich ganz anders.
+    </simpara>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$descriptorspec = [STDIN, STDOUT, STDOUT];
+$cmd = '"findstr" "suche" "filename.txt"';
+$proc = proc_open($cmd, $descriptorspec, $pipes);
+proc_close($proc);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+Der Befehl "findstr" "suche" "filename.txt" ist entweder falsch geschrieben oder
+konnte nicht gefunden werden.
+]]>
+    </screen>
+    <simpara>
+     Um dieses Verhalten zu vermeiden, ist es üblicherweise ausreichend das
+     <parameter>cmd</parameter> in zusätzliche Anführungszeichen einzuschließen:
+    </simpara>
+    <programlisting role="php">
+<![CDATA[
+$cmd = '""findstr" "suche" "filename.txt""';
+]]>
+    </programlisting>
+   </example>
+  </para>
+
 <!-- ptys are currently disabled
   <para>
    <example>