W3cubDocs

/Symfony 2.7

Symfony\Component\Process\ProcessBuilder

class ProcessBuilder

Process builder.

Methods

__construct(array $arguments = array())

Constructor

static ProcessBuilder create(array $arguments = array())

Creates a process builder instance.

ProcessBuilder add(string $argument)

Adds an unescaped argument to the command string.

ProcessBuilder setPrefix(string|array $prefix)

Adds an unescaped prefix to the command string.

ProcessBuilder setArguments(array $arguments)

Sets the arguments of the process.

ProcessBuilder setWorkingDirectory(null|string $cwd)

Sets the working directory.

ProcessBuilder inheritEnvironmentVariables(bool $inheritEnv = true)

Sets whether environment variables will be inherited or not.

ProcessBuilder setEnv(string $name, null|string $value)

Sets an environment variable

ProcessBuilder addEnvironmentVariables(array $variables)

Adds a set of environment variables.

ProcessBuilder setInput(string|null $input)

Sets the input of the process.

ProcessBuilder setTimeout(float|null $timeout)

Sets the process timeout.

ProcessBuilder setOption(string $name, string $value)

Adds a proc_open option.

ProcessBuilder disableOutput()

Disables fetching output and error output from the underlying process.

ProcessBuilder enableOutput()

Enables fetching output and error output from the underlying process.

Process getProcess()

Creates a Process instance and returns it.

Details

public __construct(array $arguments = array())

Constructor

Parameters

array $arguments An array of arguments

static public ProcessBuilder create(array $arguments = array())

Creates a process builder instance.

Parameters

array $arguments An array of arguments

Return Value

ProcessBuilder

public ProcessBuilder add(string $argument)

Adds an unescaped argument to the command string.

Parameters

string $argument A command argument

Return Value

ProcessBuilder

public ProcessBuilder setPrefix(string|array $prefix)

Adds an unescaped prefix to the command string.

The prefix is preserved when resetting arguments.

Parameters

string|array $prefix A command prefix or an array of command prefixes

Return Value

ProcessBuilder

public ProcessBuilder setArguments(array $arguments)

Sets the arguments of the process.

Arguments must not be escaped. Previous arguments are removed.

Parameters

array $arguments

Return Value

ProcessBuilder

public ProcessBuilder setWorkingDirectory(null|string $cwd)

Sets the working directory.

Parameters

null|string $cwd The working directory

Return Value

ProcessBuilder

public ProcessBuilder inheritEnvironmentVariables(bool $inheritEnv = true)

Sets whether environment variables will be inherited or not.

Parameters

bool $inheritEnv

Return Value

ProcessBuilder

public ProcessBuilder setEnv(string $name, null|string $value)

Sets an environment variable

Setting a variable overrides its previous value. Use null to unset a defined environment variable.

Parameters

string $name The variable name
null|string $value The variable value

Return Value

ProcessBuilder

public ProcessBuilder addEnvironmentVariables(array $variables)

Adds a set of environment variables.

Already existing environment variables with the same name will be overridden by the new values passed to this method. Pass null to unset a variable.

Parameters

array $variables The variables

Return Value

ProcessBuilder

public ProcessBuilder setInput(string|null $input)

Sets the input of the process.

Deprecation: As of Symfony 2.5, this method only accepts string values.

Parameters

string|null $input The input as a string

Return Value

ProcessBuilder

Exceptions

InvalidArgumentException In case the argument is invalid

public ProcessBuilder setTimeout(float|null $timeout)

Sets the process timeout.

To disable the timeout, set this value to null.

Parameters

float|null $timeout

Return Value

ProcessBuilder

Exceptions

InvalidArgumentException

public ProcessBuilder setOption(string $name, string $value)

Adds a proc_open option.

Parameters

string $name The option name
string $value The option value

Return Value

ProcessBuilder

public ProcessBuilder disableOutput()

Disables fetching output and error output from the underlying process.

Return Value

ProcessBuilder

public ProcessBuilder enableOutput()

Enables fetching output and error output from the underlying process.

Return Value

ProcessBuilder

public Process getProcess()

Creates a Process instance and returns it.

Return Value

Process

Exceptions

LogicException In case no arguments have been provided

© 2004–2016 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.7/Symfony/Component/Process/ProcessBuilder.html