proc_open

Execute a command and open file pointers for input/output.

proc_open Function synopsis

proc_open(
    array|string $command,
    array $descriptor_spec,
    &$pipes,
    ?string $cwd = null,
    ?array $env_vars = null,
    ?array $options = null
  )

Parameters

$command

Typearray|string

The commandline to execute as string. Special characters have to be properly escaped, and proper quoting has to be applied.

$descriptor_spec

Typearray

An indexed array where the key represents the descriptor number and the value represents how PHP will pass that descriptor to the child process. 0 is stdin, 1 is stdout, while 2 is stderr.

$pipes

Passed by reference

Will be set to an indexed array of file pointers that correspond to PHP's end of any pipes that are created.

$cwd

OptionalType?stringDefault valuenull

The initial working dir for the command. This must be an absolute directory path, or null if you want to use the default value (the working dir of the current PHP process)

$env_vars

OptionalType?arrayDefault valuenull

An array with the environment variables for the command that will be run, or null to use the same environment as the current PHP process

$options

OptionalType?arrayDefault valuenull

Allows you to specify additional options. Currently supported options include:

Note that the parameter $pipes is passed by reference, and contains additional/updated context data that may be useful.