From f811c29cdcb9ae601c51346f139ec75eef2ce334 Mon Sep 17 00:00:00 2001
From: Christoph Michael Becker <cmb@php.net>
Date: Fri, 21 Feb 2020 09:59:46 +0000
Subject: [PATCH] Document that proc_open() also accepts a $cmd array as of PHP
 7.4.0

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@349246 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/exec/functions/proc-open.xml | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/reference/exec/functions/proc-open.xml b/reference/exec/functions/proc-open.xml
index f5578ce5ad..02b2d18908 100644
--- a/reference/exec/functions/proc-open.xml
+++ b/reference/exec/functions/proc-open.xml
@@ -12,7 +12,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>
@@ -47,7 +47,8 @@
      <term><parameter>cmd</parameter></term>
      <listitem>
       <para>
-       The command to execute
+       The commandline to execute as &string;. Special characters have to be properly escaped,
+       and proper quoting has to be applied.
       </para>
       <note>
        <simpara>
@@ -63,6 +64,11 @@
         <parameter>cmd</parameter> (see example below).
        </simpara>
       </note>
+      <para>
+       As of PHP 7.4.0, <parameter>cmd</parameter> may be passed as &array; of command parameters.
+       In this case the process will be opened directly (without going through a shell)
+       and PHP will take care of any necessary argument escaping.
+      </para>
      </listitem>
     </varlistentry>
     <varlistentry>
@@ -181,6 +187,13 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>7.4.0</entry>
+       <entry>
+        <function>proc_open</function> now also accepts an &array;
+        for the <parameter>cmd</parameter>.
+       </entry>
+      </row>
       <row>
        <entry>7.4.0</entry>
        <entry>