参数

cmd

以 string 形式执行的命令行。特殊字符必须经过转义，并且使用正确的引号。

注意: 在 Windows 上, 除非在 other_options 中 把 bypass_shell 设置为 true ，否则 cmd 会被传递给 cmd.exe （实际上是 %ComSpec%） 其中的 /c 标志是 未加引号的 字符串 （也就是和 proc_open() 一样）。 这可能会导致 cmd.exe 删除 cmd 中的引号 （详见 cmd.exe 文档）， 从而导致意外的，甚至是潜在的危险行为，因为 cmd.exe 错误消息可能包含 （部分） 传递的 cmd （见下面的例子）。

从 PHP 7.4.0 开始，cmd 参数可以使用 array 类型传递。 在这种情况下，进程将直接打开（不通过 shell ）。 而 PHP 会处理任何必要的参数转义。

注意:

在 Windows 上， array 元素的参数转义假定 执行命令的命令行解析与 VC 运行时进行的命令行参数解析兼容。

descriptorspec

一个索引数组。 数组的键表示描述符，数组元素值表示 PHP 如何将这些描述符传送至子进程。 0 表示标准输入（stdin），1 表示标准输出（stdout），2 表示标准错误（stderr）。

数组中的元素可以是：

• 包含了要传送至进程的管道的描述信息的数组。 第一个元素为描述符类型， 第二个元素是针对该描述符的选项。 有效的类型有：pipe （第二个元素可以是： r 向进程传送该管道的读取端，w 向进程传送该管道的写入端）， 以及 file（第二个元素为文件名）。
• 表达一个真实文件描述符的流资源类型 （例如：已打开的文件，一个 socket 端口，STDIN）。

文件描述符的值不限于 0，1 和 2，你可以使用任何有效的文件描述符 并将其传送至子进程。 这使得你的脚本可以和其他脚本交互操作。 例如，可以通过指定文件描述符将密码以更加安全的方式 传送至诸如 PGP，GPG 和 openssl 程序， 同时也可以很方便的获取这些程序的状态信息。

pipes

将被置为索引数组， 其中的元素是被执行程序创建的管道对应到 PHP 这一端的文件指针。

cwd

要执行命令的初始工作目录。 必须是 绝对 路径， 设置此参数为 null 表示使用默认值（当前 PHP 进程的工作目录）。

env

要执行的命令所使用的环境变量。 设置此参数为 null 表示使用和当前 PHP 进程相同的环境变量。

other_options

你还可以指定一些附加选项。 目前支持的选项包括：

• suppress_errors （仅用于 Windows 平台）： 设置为 true 表示抑制本函数产生的错误。
• bypass_shell （仅用于 Windows 平台）： 设置为 true 表示绕过 cmd.exe shell。
• blocking_pipes （仅用于 Windows 平台）： 设置为 true 表示强制堵塞管道。
• create_process_group （仅用于 Windows 平台）： 设置为 true 表示允许子进程处理 CTRL 事件。
• create_new_console （仅用于 Windows 平台）： 表示新进程有一个新的控制台，用于代替父进程的控制台。