wp-studio 1.7.8-beta2 → 1.7.8-beta3

package/dist/cli/wp-files/sqlite-command/vendor/wp-cli/wp-cli/php/WP_CLI/Context/Admin.php

@@ -4,8 +4,7 @@ namespace WP_CLI\Context;
 
 use WP_CLI;
 use WP_CLI\Context;
-use WP_CLI\Fetchers\User;
-use WP_User;
+use WP_Session_Tokens;
 
 /**
  * Context which simulates the administrator backend.
@@ -20,7 +19,6 @@ final class Admin implements Context {
 	 */
 	public function process( $config ) {
 		if ( defined( 'WP_ADMIN' ) ) {
-			// @phpstan-ignore phpstanWP.wpConstant.fetch
 			if ( ! WP_ADMIN ) {
 				WP_CLI::warning( 'Could not fake admin request.' );
 			}
@@ -36,104 +34,21 @@ final class Admin implements Context {
 
 		// Set a fake entry point to ensure wp-includes/vars.php does not throw
 		// notices/errors. This will be reflected in the global `$pagenow`
-		// variable. We try to use a realistic admin page based on the current
-		// command so that plugins which check `$pagenow` behave correctly.
-		$_SERVER['PHP_SELF'] = '/wp-admin/' . $this->get_fake_admin_page();
+		// variable being set to 'wp-cli-fake-admin-file.php'.
+		$_SERVER['PHP_SELF'] = '/wp-admin/wp-cli-fake-admin-file.php';
 
 		// Bootstrap the WordPress administration area.
 		WP_CLI::add_wp_hook(
-			'plugins_loaded',
-			function () use ( $config ) {
-				if ( isset( $config['user'] ) ) {
-					$fetcher       = new User();
-					$user          = $fetcher->get_check( $config['user'] );
-					$admin_user_id = $user->ID;
-				} else {
-					$admin_user_id = $this->find_admin_user_id();
-				}
-
-				/**
-				 * @var int<1, max> $admin_user_id
-				 */
-
-				WP_CLI::debug( sprintf( 'Continuing as admin user %d', $admin_user_id ), Context::DEBUG_GROUP );
-
-				$this->log_in_as_admin_user( $admin_user_id );
-			},
-			defined( 'PHP_INT_MIN' ) ? PHP_INT_MIN : -2147483648, // phpcs:ignore PHPCompatibility.Constants.NewConstants.php_int_minFound
-			0
-		);
-
-		WP_CLI::add_wp_hook(
-			'wp_loaded',
+			'init',
 			function () {
+				$this->log_in_as_admin_user();
 				$this->load_admin_environment();
 			},
-			defined( 'PHP_INT_MAX' ) ? PHP_INT_MAX : 2147483648, // phpcs:ignore PHPCompatibility.Constants.NewConstants.php_int_maxFound
+			defined( 'PHP_INT_MIN' ) ? PHP_INT_MIN : -2147483648, // phpcs:ignore PHPCompatibility.Constants.NewConstants.php_int_minFound
 			0
 		);
 	}
 
-	/**
-	 * Find a suitable admin user ID for the current environment.
-	 *
-	 * On multisite, resolves a super admin via get_super_admins().
-	 * On single site, finds a user with the administrator role.
-	 *
-	 * @return int<1, max> Admin user ID.
-	 */
-	private function find_admin_user_id() {
-		if ( is_multisite() ) {
-			$super_admins = get_super_admins();
-
-			foreach ( $super_admins as $super_admin_login ) {
-				$user = get_user_by( 'login', $super_admin_login );
-				if ( $user instanceof WP_User ) {
-					/** @var int<1, max> */
-					return $user->ID;
-				}
-			}
-
-			WP_CLI::error( 'No super admin user found. Specify one with --user=<login>.' );
-		}
-
-		$admins = get_users(
-			[
-				'role'    => 'administrator',
-				'number'  => 1,
-				'orderby' => 'ID',
-				'order'   => 'ASC',
-			]
-		);
-
-		if ( ! empty( $admins ) ) {
-			return $admins[0]->ID;
-		}
-
-		WP_CLI::error( 'No administrator user found. Specify one with --user=<login>.' );
-	}
-
-	/**
-	 * Get a fake admin page filename that reflects the current command.
-	 *
-	 * Returns 'plugins.php' for `wp plugin` commands, 'themes.php' for
-	 * `wp theme` commands, and 'wp-cli-fake-admin-file.php' otherwise.
-	 *
-	 * @return string Admin page filename.
-	 */
-	private function get_fake_admin_page(): string {
-		$command = WP_CLI::get_runner()->arguments;
-
-		$command_map = [
-			'plugin' => 'plugins.php',
-			'theme'  => 'themes.php',
-		];
-
-		$command_name = $command[0] ?? '';
-
-		return $command_map[ $command_name ] ?? 'wp-cli-fake-admin-file.php';
-	}
-
 	/**
 	 * Ensure the current request is done under a logged-in administrator
 	 * account.
@@ -141,11 +56,12 @@ final class Admin implements Context {
 	 * A lot of premium plugins/themes have their custom update routines locked
 	 * behind an is_admin() call.
 	 *
-	 * @param int<1, max> $admin_user_id to log in as
-	 *
 	 * @return void
 	 */
-	private function log_in_as_admin_user( $admin_user_id ): void {
+	private function log_in_as_admin_user() {
+		// TODO: Add logic to find an administrator user.
+		$admin_user_id = 1;
+
 		wp_set_current_user( $admin_user_id );
 
 		$expiration = time() + DAY_IN_SECONDS;
@@ -176,14 +92,11 @@ final class Admin implements Context {
 	 * @global string $pagenow
 	 * @global int    $wp_db_version
 	 * @global array  $_wp_submenu_nopriv
-	 * @global array  $menu_order
-	 * @global array  $default_menu_order
-	 * @global array  $menu
-	 * @global array  $submenu
-	 * @global array  $compat
+	 *
+	 * @return void
 	 */
-	private function load_admin_environment(): void {
-		global $compat, $default_menu_order, $hook_suffix, $menu, $menu_order, $pagenow, $submenu, $wp_db_version, $_wp_submenu_nopriv;
+	private function load_admin_environment() {
+		global $hook_suffix, $pagenow, $wp_db_version, $_wp_submenu_nopriv;
 
 		if ( ! isset( $hook_suffix ) ) {
 			$hook_suffix = 'index'; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
@@ -191,12 +104,7 @@ final class Admin implements Context {
 
 		// Make sure we don't trigger a DB upgrade as that tries to redirect
 		// the page.
-
-		/**
-		 * @var string $wp_db_version
-		 */
-		$wp_db_version = get_option( 'db_version' ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
-		$wp_db_version = (int) $wp_db_version; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
+		$wp_db_version = (int) get_option( 'db_version' ); // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
 
 		// Ensure WP does not iterate over an undefined variable in
 		// `user_can_access_admin_page()`.
@@ -204,20 +112,20 @@ final class Admin implements Context {
 			$_wp_submenu_nopriv = []; // phpcs:ignore WordPress.WP.GlobalVariablesOverride.Prohibited
 		}
 
-		$admin_php_file = (string) file_get_contents( ABSPATH . 'wp-admin/admin.php' );
+		$admin_php_file = file_get_contents( ABSPATH . 'wp-admin/admin.php' );
 
 		// First we remove the opening and closing PHP tags.
-		$admin_php_file = (string) preg_replace( '/^<\?php\s+/', '', $admin_php_file );
-		$admin_php_file = (string) preg_replace( '/\s+\?>$/', '', $admin_php_file );
+		$admin_php_file = preg_replace( '/^<\?php\s+/', '', $admin_php_file );
+		$admin_php_file = preg_replace( '/\s+\?>$/', '', $admin_php_file );
 
 		// Then we remove the loading of either wp-config.php or wp-load.php.
-		$admin_php_file = (string) preg_replace( '/^\s*(?:include|require).*[\'"]\/?wp-(?:load|config)\.php[\'"]\s*\)?;\s*$/m', '', $admin_php_file );
+		$admin_php_file = preg_replace( '/^\s*(?:include|require).*[\'"]\/?wp-(?:load|config)\.php[\'"]\s*\)?;\s*$/m', '', $admin_php_file );
 
 		// We also remove the authentication redirect.
-		$admin_php_file = (string) preg_replace( '/^\s*auth_redirect\(\);$/m', '', $admin_php_file );
+		$admin_php_file = preg_replace( '/^\s*auth_redirect\(\);$/m', '', $admin_php_file );
 
 		// Finally, we avoid sending headers.
-		$admin_php_file   = (string) preg_replace( '/^\s*nocache_headers\(\);$/m', '', $admin_php_file );
+		$admin_php_file   = preg_replace( '/^\s*nocache_headers\(\);$/m', '', $admin_php_file );
 		$_GET['noheader'] = true;
 
 		eval( $admin_php_file ); // phpcs:ignore Squiz.PHP.Eval.Discouraged

package/dist/cli/wp-files/sqlite-command/vendor/wp-cli/wp-cli/php/WP_CLI/Context/Auto.php

@@ -69,7 +69,7 @@ final class Auto implements Context {
 	 *
 	 * @return bool Whether the current command should be run as admin.
 	 */
-	private function is_command_to_run_as_admin(): bool {
+	private function is_command_to_run_as_admin() {
 		$command = WP_CLI::get_runner()->arguments;
 
 		foreach ( self::COMMANDS_TO_RUN_AS_ADMIN as $command_to_run_as_admin ) {

package/dist/cli/wp-files/sqlite-command/vendor/wp-cli/wp-cli/php/WP_CLI/Context/Cli.php

@@ -2,6 +2,7 @@
 
 namespace WP_CLI\Context;
 
+use WP_CLI;
 use WP_CLI\Context;
 
 /**

package/dist/cli/wp-files/sqlite-command/vendor/wp-cli/wp-cli/php/WP_CLI/Context/Frontend.php

@@ -2,6 +2,7 @@
 
 namespace WP_CLI\Context;
 
+use WP_CLI;
 use WP_CLI\Context;
 
 /**

package/dist/cli/wp-files/sqlite-command/vendor/wp-cli/wp-cli/php/WP_CLI/Dispatcher/CommandFactory.php

@@ -23,9 +23,9 @@ class CommandFactory {
 	/**
 	 * Create a new CompositeCommand (or Subcommand if class has __invoke())
 	 *
-	 * @param string                                       $name     Represents how the command should be invoked
-	 * @param string|callable-string|callable|array|object $callable A subclass of WP_CLI_Command, a function, or a closure
-	 * @param RootCommand|CompositeCommand                 $parent   The new command's parent Composite (or Root) command
+	 * @param string                                $name     Represents how the command should be invoked
+	 * @param string|callable-string|callable|array $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 ) {
 
@@ -34,7 +34,6 @@ class CommandFactory {
 			$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 ) ) ) {
-			/** @var array{0:object|class-string,1:string} $callable */
 			$reflection = new ReflectionClass( $callable[0] );
 			$command    = self::create_subcommand(
 				$parent,
@@ -43,9 +42,6 @@ class CommandFactory {
 				$reflection->getMethod( $callable[1] )
 			);
 		} else {
-			/**
-			 * @var class-string $callable
-			 */
 			$reflection = new ReflectionClass( $callable );
 			if ( $reflection->isSubclassOf( '\WP_CLI\Dispatcher\CommandNamespace' ) ) {
 				$command = self::create_namespace( $parent, $name, $callable );
@@ -75,18 +71,15 @@ class CommandFactory {
 	/**
 	 * Create a new Subcommand instance.
 	 *
-	 * @param mixed                                               $parent     The new command's parent Composite command.
-	 * @param string|false                                        $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 ReflectionClass|ReflectionMethod|ReflectionFunction $reflection Reflection instance, for doc parsing
-	 *
-	 * @template T of object
-	 * @phpstan-param ReflectionClass<T>|ReflectionMethod|ReflectionFunction $reflection
+	 * @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 ?: '' );
+		$docparser   = new DocParser( $doc_comment );
 
 		if ( is_array( $callable ) ) {
 			if ( ! $name ) {
@@ -104,49 +97,27 @@ class CommandFactory {
 		$when_invoked = function ( $args, $assoc_args ) use ( $callable ) {
 			if ( is_array( $callable ) ) {
 				$callable[0] = is_object( $callable[0] ) ? $callable[0] : new $callable[0]();
-
-				/**
-				 * @var callable $command
-				 */
-				$command = [ $callable[0], $callable[1] ];
-
-				call_user_func( $command, $args, $assoc_args );
+				call_user_func( [ $callable[0], $callable[1] ], $args, $assoc_args );
 			} else {
-				/**
-				 * @var callable $callable
-				 */
 				call_user_func( $callable, $args, $assoc_args );
 			}
 		};
 
-		/**
-		 * @var string $name
-		 */
-
-		$subcommand = new Subcommand( $parent, $name, $docparser, $when_invoked );
-
-		// Check for global argument conflicts
-		$path         = \WP_CLI\Dispatcher\get_path( $subcommand );
-		$command_name = implode( ' ', array_slice( $path, 1 ) );
-		\WP_CLI::check_global_arg_conflicts( $command_name, $subcommand );
-
-		return $subcommand;
+		return new Subcommand( $parent, $name, $docparser, $when_invoked );
 	}
 
 	/**
 	 * Create a new Composite command instance.
 	 *
-	 * @param RootCommand|CompositeCommand $parent   The new command's parent Root or Composite command
-	 * @param string                       $name     Represents how the command should be invoked
-	 * @param class-string                 $callable
+	 * @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' );
-
-			$doc_comment = '';
 		}
 		$docparser = new DocParser( $doc_comment );
 
@@ -171,19 +142,16 @@ class CommandFactory {
 	/**
 	 * Create a new command namespace instance.
 	 *
-	 * @param RootCommand|CompositeCommand $parent   The new namespace's parent Root or Composite command.
-	 * @param string                       $name     Represents how the command should be invoked
-	 * @param class-string                 $callable
+	 * @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' );
-
-			$doc_comment = '';
 		}
-
 		$docparser = new DocParser( $doc_comment );
 
 		return new CommandNamespace( $parent, $name, $docparser );
@@ -204,9 +172,6 @@ class CommandFactory {
 	 *
 	 * @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.
-	 *
-	 * @template T of object
-	 * @phpstan-param ReflectionClass<T>|ReflectionMethod|ReflectionFunction $reflection
 	 */
 	private static function get_doc_comment( $reflection ) {
 		$contents    = null;
@@ -221,20 +186,18 @@ class CommandFactory {
 
 		$filename = $reflection->getFileName();
 
-		if ( $filename ) {
-			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 ( 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() ?: 0 ) ) );
+			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' );
@@ -245,7 +208,7 @@ class CommandFactory {
 	 * 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|false The last doc comment if any, or false if none.
+	 * @return string|bool The last doc comment if any, or false if none.
 	 */
 	private static function extract_last_doc_comment( $content ) {
 		$content         = trim( $content );

package/dist/cli/wp-files/sqlite-command/vendor/wp-cli/wp-cli/php/WP_CLI/Dispatcher/CompositeCommand.php

@@ -27,19 +27,19 @@ class CompositeCommand {
 	/**
 	 * Instantiate a new CompositeCommand
 	 *
-	 * @param RootCommand|CompositeCommand $parent_command Parent command (either Root or Composite)
-	 * @param string                       $name           Represents how command should be invoked
-	 * @param DocParser                    $docparser
+	 * @param mixed $parent Parent command (either Root or Composite)
+	 * @param string $name Represents how command should be invoked
+	 * @param DocParser $docparser
 	 */
-	public function __construct( $parent_command, $name, $docparser ) {
-		$this->parent = $parent_command;
+	public function __construct( $parent, $name, $docparser ) {
+		$this->parent = $parent;
 
 		$this->name = $name;
 
 		$this->shortdesc = $docparser->get_shortdesc();
 		$this->longdesc  = $docparser->get_longdesc();
 		$this->docparser = $docparser;
-		$this->hook      = $parent_command->get_hook();
+		$this->hook      = $parent->get_hook();
 
 		$when_to_invoke = $docparser->get_tag( 'when' );
 		if ( $when_to_invoke ) {
@@ -51,7 +51,7 @@ class CompositeCommand {
 	/**
 	 * Get the parent composite (or root) command
 	 *
-	 * @return RootCommand|CompositeCommand
+	 * @return mixed
 	 */
 	public function get_parent() {
 		return $this->parent;
@@ -88,7 +88,7 @@ class CompositeCommand {
 	/**
 	 * Composite commands always contain subcommands.
 	 *
-	 * @return bool
+	 * @return true
 	 */
 	public function can_have_subcommands() {
 		return true;
@@ -135,15 +135,6 @@ class CompositeCommand {
 		return $this->hook;
 	}
 
-	/**
-	 * Get the DocParser instance for this command.
-	 *
-	 * @return DocParser|null
-	 */
-	public function get_docparser() {
-		return $this->docparser;
-	}
-
 	/**
 	 * Set the short description for this composite command.
 	 *
@@ -187,7 +178,6 @@ class CompositeCommand {
 	/**
 	 * Get the usage for this composite command.
 	 *
-	 * @param string $prefix
 	 * @return string
 	 */
 	public function get_usage( $prefix ) {
@@ -327,7 +317,7 @@ class CompositeCommand {
 			}
 
 			// Check if global parameters synopsis should be displayed or not.
-			if ( 'true' !== Utils\get_env_or_config( 'WP_CLI_SUPPRESS_GLOBAL_PARAMS' ) ) {
+			if ( 'true' !== getenv( 'WP_CLI_SUPPRESS_GLOBAL_PARAMS' ) ) {
 				$binding['parameters'][]   = [
 					'synopsis' => $synopsis,
 					'desc'     => $details['desc'],