mirror of
https://gh.wpcy.net/https://github.com/wp-cli/handbook.git
synced 2026-05-10 04:33:07 +08:00
66 lines
2 KiB
Markdown
66 lines
2 KiB
Markdown
# WP_CLI::runcommand()
|
|
|
|
Run a WP-CLI command.
|
|
|
|
***
|
|
|
|
## Usage
|
|
|
|
WP_CLI::runcommand( $command, $options = [] )
|
|
|
|
<div>
|
|
<strong>$command</strong> (string) WP-CLI command to run, including arguments.<br />
|
|
<strong>$options</strong> (array) Configuration options for command execution.<br />
|
|
<strong>@return</strong> (mixed) <br />
|
|
</div>
|
|
|
|
|
|
***
|
|
|
|
## Notes
|
|
|
|
Launches a new child process to run a specified WP-CLI command.
|
|
Optionally:
|
|
|
|
* Run the command in an existing process.
|
|
* Prevent halting script execution on error.
|
|
* Capture and return STDOUT, or full details about command execution.
|
|
* Parse JSON output if the command rendered it.
|
|
* Include additional arguments that are passed to the command.
|
|
|
|
```
|
|
$options = array(
|
|
'return' => true, // Return 'STDOUT'; use 'all' for full object.
|
|
'parse' => 'json', // Parse captured STDOUT to JSON array.
|
|
'launch' => false, // Reuse the current process.
|
|
'exit_error' => true, // Halt script execution on error.
|
|
'command_args' => [ '--skip-themes' ], // Additional arguments to be passed to the $command.
|
|
);
|
|
$plugins = WP_CLI::runcommand( 'plugin list --format=json', $options );
|
|
```
|
|
|
|
|
|
*Internal API documentation is generated from the WP-CLI codebase on every release. To suggest improvements, please submit a pull request.*
|
|
|
|
|
|
***
|
|
|
|
## Related
|
|
|
|
<ul>
|
|
|
|
|
|
|
|
<li><strong><a href="https://make.wordpress.org/cli/handbook/internal-api/wp-cli-launch/">WP_CLI::launch()</a></strong> - Launch an arbitrary external process that takes over I/O.</li>
|
|
|
|
|
|
<li><strong><a href="https://make.wordpress.org/cli/handbook/internal-api/wp-cli-launch-self/">WP_CLI::launch_self()</a></strong> - Run a WP-CLI command in a new process reusing the current runtime arguments.</li>
|
|
|
|
|
|
<li><strong><a href="https://make.wordpress.org/cli/handbook/internal-api/wp-cli-run-command/">WP_CLI::run_command()</a></strong> - Run a given command within the current process using the same global parameters.</li>
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
