From a7059021932567327a689a1822d5c4fb010ca399 Mon Sep 17 00:00:00 2001
From: Louis-Arnaud Catoire <la.catoire@gmail.com>
Date: Thu, 29 Jan 2026 22:27:42 +0100
Subject: [PATCH] Clarify executable lookup when using proc_open() with array
 command

---
 reference/exec/functions/proc-open.xml | 9 +++++++++
 1 file changed, 9 insertions(+)

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