WP_CLI\Dispatcher
CommandFactory{} │ WP-CLI 1.0
Creates CompositeCommand or Subcommand instances.
Хуков нет.
Использование
$CommandFactory = new CommandFactory(); // use class methods
Методы
- public static clear_file_contents_cache()
- public static create( $name, $callable, $parent )
- private static create_composite_command( $parent, $name, $callable )
- private static create_namespace( $parent, $name, $callable )
- private static create_subcommand( $parent, $name, $callable, $reflection )
- private static extract_last_doc_comment( $content )
- private static get_doc_comment( $reflection )
- private static is_good_method( $method )
Заметки
- Пакет: WP_CLI
Код CommandFactory{} CommandFactory{} WP-CLI 2.8.0-alpha
class CommandFactory {
// Cache of file contents, indexed by filename. Only used if opcache.save_comments is disabled.
private static $file_contents = [];
/**
* Create a new CompositeCommand (or Subcommand if class has __invoke())
*
* @param string $name Represents how the command should be invoked
* @param string $callable A subclass of WP_CLI_Command, a function, or a closure
* @param mixed $parent The new command's parent Composite (or Root) command
*/
public static function create( $name, $callable, $parent ) {
if ( ( is_object( $callable ) && ( $callable instanceof Closure ) )
|| ( is_string( $callable ) && function_exists( $callable ) ) ) {
$reflection = new ReflectionFunction( $callable );
$command = self::create_subcommand( $parent, $name, $callable, $reflection );
} elseif ( is_array( $callable ) && ( is_callable( $callable ) || Utils\is_valid_class_and_method_pair( $callable ) ) ) {
$reflection = new ReflectionClass( $callable[0] );
$command = self::create_subcommand(
$parent,
$name,
[ $callable[0], $callable[1] ],
$reflection->getMethod( $callable[1] )
);
} else {
$reflection = new ReflectionClass( $callable );
if ( $reflection->isSubclassOf( '\WP_CLI\Dispatcher\CommandNamespace' ) ) {
$command = self::create_namespace( $parent, $name, $callable );
} elseif ( $reflection->hasMethod( '__invoke' ) ) {
$class = is_object( $callable ) ? $callable : $reflection->name;
$command = self::create_subcommand(
$parent,
$name,
[ $class, '__invoke' ],
$reflection->getMethod( '__invoke' )
);
} else {
$command = self::create_composite_command( $parent, $name, $callable );
}
}
return $command;
}
/**
* Clear the file contents cache.
*/
public static function clear_file_contents_cache() {
self::$file_contents = [];
}
/**
* Create a new Subcommand instance.
*
* @param mixed $parent The new command's parent Composite command
* @param string|bool $name Represents how the command should be invoked.
* If false, will be determined from the documented subject, represented by `$reflection`.
* @param mixed $callable A callable function or closure, or class name and method
* @param object $reflection Reflection instance, for doc parsing
*/
private static function create_subcommand( $parent, $name, $callable, $reflection ) {
$doc_comment = self::get_doc_comment( $reflection );
$docparser = new DocParser( $doc_comment );
if ( is_array( $callable ) ) {
if ( ! $name ) {
$name = $docparser->get_tag( 'subcommand' );
}
if ( ! $name ) {
$name = $reflection->name;
}
}
if ( ! $doc_comment ) {
WP_CLI::debug( null === $doc_comment ? "Failed to get doc comment for {$name}." : "No doc comment for {$name}.", 'commandfactory' );
}
$when_invoked = function ( $args, $assoc_args ) use ( $callable ) {
if ( is_array( $callable ) ) {
$callable[0] = is_object( $callable[0] ) ? $callable[0] : new $callable[0]();
call_user_func( [ $callable[0], $callable[1] ], $args, $assoc_args );
} else {
call_user_func( $callable, $args, $assoc_args );
}
};
return new Subcommand( $parent, $name, $docparser, $when_invoked );
}
/**
* Create a new Composite command instance.
*
* @param mixed $parent The new command's parent Root or Composite command
* @param string $name Represents how the command should be invoked
* @param mixed $callable
*/
private static function create_composite_command( $parent, $name, $callable ) {
$reflection = new ReflectionClass( $callable );
$doc_comment = self::get_doc_comment( $reflection );
if ( ! $doc_comment ) {
WP_CLI::debug( null === $doc_comment ? "Failed to get doc comment for {$name}." : "No doc comment for {$name}.", 'commandfactory' );
}
$docparser = new DocParser( $doc_comment );
$container = new CompositeCommand( $parent, $name, $docparser );
foreach ( $reflection->getMethods() as $method ) {
if ( ! self::is_good_method( $method ) ) {
continue;
}
$class = is_object( $callable ) ? $callable : $reflection->name;
$subcommand = self::create_subcommand( $container, false, [ $class, $method->name ], $method );
$subcommand_name = $subcommand->get_name();
$container->add_subcommand( $subcommand_name, $subcommand );
}
return $container;
}
/**
* Create a new command namespace instance.
*
* @param mixed $parent The new namespace's parent Root or Composite command.
* @param string $name Represents how the command should be invoked
* @param mixed $callable
*/
private static function create_namespace( $parent, $name, $callable ) {
$reflection = new ReflectionClass( $callable );
$doc_comment = self::get_doc_comment( $reflection );
if ( ! $doc_comment ) {
WP_CLI::debug( null === $doc_comment ? "Failed to get doc comment for {$name}." : "No doc comment for {$name}.", 'commandfactory' );
}
$docparser = new DocParser( $doc_comment );
return new CommandNamespace( $parent, $name, $docparser );
}
/**
* Check whether a method is actually callable.
*
* @param ReflectionMethod $method
* @return bool
*/
private static function is_good_method( $method ) {
return $method->isPublic() && ! $method->isStatic() && 0 !== strpos( $method->getName(), '__' );
}
/**
* Gets the document comment. Caters for PHP directive `opcache.save comments` being disabled.
*
* @param ReflectionMethod|ReflectionClass|ReflectionFunction $reflection Reflection instance.
* @return string|false|null Doc comment string if any, false if none (same as `Reflection*::getDocComment()`), null if error.
*/
private static function get_doc_comment( $reflection ) {
$contents = null;
$doc_comment = $reflection->getDocComment();
if ( false !== $doc_comment || ! ( ini_get( 'opcache.enable_cli' ) && ! ini_get( 'opcache.save_comments' ) ) ) { // phpcs:ignore PHPCompatibility.IniDirectives.NewIniDirectives
// Either have doc comment, or no doc comment and save comments enabled - standard situation.
if ( ! getenv( 'WP_CLI_TEST_GET_DOC_COMMENT' ) ) {
return $doc_comment;
}
}
$filename = $reflection->getFileName();
if ( isset( self::$file_contents[ $filename ] ) ) {
$contents = self::$file_contents[ $filename ];
} elseif ( is_readable( $filename ) ) {
$contents = file_get_contents( $filename );
if ( is_string( $contents ) && '' !== $contents ) {
$contents = explode( "\n", $contents );
self::$file_contents[ $filename ] = $contents;
}
}
if ( ! empty( $contents ) ) {
return self::extract_last_doc_comment( implode( "\n", array_slice( $contents, 0, $reflection->getStartLine() ) ) );
}
WP_CLI::debug( "Could not read contents for filename '{$filename}'.", 'commandfactory' );
return null;
}
/**
* Returns the last doc comment if any in `$content`.
*
* @param string $content The content, which should end at the class or function declaration.
* @return string|bool The last doc comment if any, or false if none.
*/
private static function extract_last_doc_comment( $content ) {
$content = trim( $content );
$comment_end_pos = strrpos( $content, '*/' );
if ( false === $comment_end_pos ) {
return false;
}
// Make sure comment end belongs to this class/function.
if ( preg_match_all( '/(?:^|[\s;}])(?:class|function)\s+/', substr( $content, $comment_end_pos + 2 ), $dummy /*needed for PHP 5.3*/ ) > 1 ) {
return false;
}
$content = substr( $content, 0, $comment_end_pos + 2 );
$comment_start_pos = strrpos( $content, '/**' );
if ( false === $comment_start_pos || ( $comment_start_pos + 2 ) === $comment_end_pos ) {
return false;
}
// Make sure comment start belongs to this comment end.
$comment_end2_pos = strpos( substr( $content, $comment_start_pos ), '*/' );
if ( false !== $comment_end2_pos && ( $comment_start_pos + $comment_end2_pos ) < $comment_end_pos ) {
return false;
}
// Allow for '/**' within doc comment.
$subcontent = substr( $content, 0, $comment_start_pos );
while ( false !== ( $comment_start2_pos = strrpos( $subcontent, '/**' ) ) && false === strpos( $subcontent, '*/', $comment_start2_pos ) ) {
$comment_start_pos = $comment_start2_pos;
$subcontent = substr( $subcontent, 0, $comment_start_pos );
}
return substr( $content, $comment_start_pos, $comment_end_pos + 2 );
}
}