[DOC-CVS] [doc-en] master: Clarify executable lookup when using proc_open() with array command (#5220)

Author: Louis-Arnaud (lacatoire)
Committer: GitHub (web-flow)
Pusher: lacatoire
Date: 2026-08-21T18:51:33+02:00

Commit: https://github.com/php/doc-en/commit/5600a279c7904a92dca710222de2289613a47aad
Raw diff: https://github.com/php/doc-en/commit/5600a279c7904a92dca710222de2289613a47aad.diff

Clarify executable lookup when using proc_open() with array command (#5220)

Changed paths:
  M  reference/exec/functions/proc-open.xml


Diff:

diff --git a/reference/exec/functions/proc-open.xml b/reference/exec/functions/proc-open.xml
index 35e0a3edbf39..f6e85be8f13c 100644
--- a/reference/exec/functions/proc-open.xml
+++ b/reference/exec/functions/proc-open.xml
@@ -69,6 +69,15 @@
        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>
+      <simpara>
+       When <parameter>command</parameter> is provided as an array and the first element
+       is a simple filename without directory separators, the executable is searched
+       using the current <envar>PATH</envar> environment variable.
+      </simpara>
+      <simpara>
+       If <envar>PATH</envar> is not set, the system default search paths are used, as
+       defined by the operating system.
+      </simpara>
       <note>
        <para>
         On Windows, the argument escaping of the &array; elements assumes that the