WP_CLI

Runner::find_command_to_run() │ public │ WP-CLI 1.0

Given positional arguments, find the command to execute.

Method of the class: Runner{}

No Hooks.

Return

Array|String. Command, args, and path on success; error message on failure

Usage

$Runner = new Runner();
$Runner->find_command_to_run( $args );
$args(array) (required)
-

Runner::find_command_to_run() code WP-CLI 2.8.0-alpha

wp-cli/php/WP_CLI/Runner.php 
public function find_command_to_run( $args ) {
	$command = WP_CLI::get_root_command();

	WP_CLI::do_hook( 'find_command_to_run_pre' );

	$cmd_path = [];

	while ( ! empty( $args ) && $command->can_have_subcommands() ) {
		$cmd_path[] = $args[0];
		$full_name  = implode( ' ', $cmd_path );

		$subcommand = $command->find_subcommand( $args );

		if ( ! $subcommand ) {
			if ( count( $cmd_path ) > 1 ) {
				$child       = array_pop( $cmd_path );
				$parent_name = implode( ' ', $cmd_path );
				$suggestion  = $this->get_subcommand_suggestion( $child, $command );
				return sprintf(
					"'%s' is not a registered subcommand of '%s'. See 'wp help %s' for available subcommands.%s",
					$child,
					$parent_name,
					$parent_name,
					! empty( $suggestion ) ? PHP_EOL . "Did you mean '{$suggestion}'?" : ''
				);
			}

			$suggestion = $this->get_subcommand_suggestion( $full_name, $command );

			return sprintf(
				"'%s' is not a registered wp command. See 'wp help' for available commands.%s",
				$full_name,
				! empty( $suggestion ) ? PHP_EOL . "Did you mean '{$suggestion}'?" : ''
			);
		}

		if ( $this->is_command_disabled( $subcommand ) ) {
			return sprintf(
				"The '%s' command has been disabled from the config file.",
				$full_name
			);
		}

		$command = $subcommand;
	}

	return [ $command, $args, $cmd_path ];
}