wp-studio 1.8.1 → 1.8.2

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

@@ -0,0 +1,260 @@
+<?php
+
+namespace WP_CLI;
+
+/**
+ * Path manipulation helper class.
+ *
+ * Provides a centralized collection of path-related utility methods for
+ * working with filesystem paths in a cross-platform manner.
+ *
+ * @package WP_CLI
+ */
+class Path {
+
+	/**
+	 * File stream wrapper prefix for Phar archives.
+	 *
+	 * @var string
+	 */
+	const PHAR_STREAM_PREFIX = 'phar://';
+
+	/**
+	 * Regular expression pattern to match __FILE__ and __DIR__ constants.
+	 *
+	 * We try to be smart and only replace the constants when they are not within quotes.
+	 * Regular expressions being stateless, this is probably not 100% correct for edge cases.
+	 *
+	 * @see https://regex101.com/r/9hXp5d/11
+	 * @see https://stackoverflow.com/a/171499/933065
+	 *
+	 * @var string
+	 */
+	const FILE_DIR_PATTERN = '%(?>#.*?$)|(?>//.*?$)|(?>/\*.*?\*/)|(?>\'(?:(?=(\\\\?))\1.)*?\')|(?>"(?:(?=(\\\\?))\2.)*?")|(?<file>\b__FILE__\b)|(?<dir>\b__DIR__\b)%ms';
+
+	/**
+	 * Check if a certain path is within a Phar archive.
+	 *
+	 * If no path is provided, the function checks whether the current WP_CLI instance is
+	 * running from within a Phar archive.
+	 *
+	 * @param string|null $path Optional. Path to check. Defaults to null, which checks WP_CLI_ROOT.
+	 * @return bool Whether path is within a Phar archive.
+	 */
+	public static function inside_phar( $path = null ) {
+		if ( null === $path ) {
+			if ( ! defined( 'WP_CLI_ROOT' ) ) {
+				return false;
+			}
+
+			$path = WP_CLI_ROOT;
+		}
+
+		return 0 === stripos( $path, self::PHAR_STREAM_PREFIX );
+	}
+
+	/**
+	 * Determine whether a path is absolute.
+	 *
+	 * @param string $path
+	 * @return bool
+	 */
+	public static function is_absolute( $path ) {
+		// Empty path is not absolute.
+		if ( '' === $path ) {
+			return false;
+		}
+
+		// Windows drive letter + colon + slash or backslash.
+		if ( preg_match( '#^[A-Z]:[\\\\/]#i', $path ) ) {
+			return true;
+		}
+
+		// UNC path (\\Server\Share).
+		if ( preg_match( '#^\\\\\\\\[^\\\\/]+[\\\\/][^\\\\/]+#', $path ) ) {
+			return true;
+		}
+
+		// Unix root.
+		return isset( $path[0] ) && '/' === $path[0];
+	}
+
+	/**
+	 * Expand tilde (~) in path to home directory.
+	 *
+	 * Expands paths that start with ~ to the current user's home directory.
+	 * Only handles the current user's home directory (not ~username patterns).
+	 *
+	 * @param string $path Path that may contain a tilde.
+	 * @return string Path with tilde expanded to home directory, or unchanged if tilde not at start or followed by username.
+	 */
+	public static function expand_tilde( $path ) {
+		if ( isset( $path[0] ) && '~' === $path[0] ) {
+			$home = self::get_home_dir();
+			// Only expand if we can determine the home directory.
+			// Handle both "~" and "~/..." patterns (but not "~username").
+			if ( ! empty( $home ) && ( 1 === strlen( $path ) || '/' === $path[1] ) ) {
+				$path = $home . substr( $path, 1 );
+			}
+			// If followed by anything other than '/', or home is empty, leave it unchanged.
+		}
+
+		return $path;
+	}
+
+	/**
+	 * Get the home directory.
+	 *
+	 * @return string
+	 */
+	public static function get_home_dir() {
+		$home = getenv( 'HOME' );
+		if ( ! $home ) {
+			// In Windows $HOME may not be defined.
+			$home = getenv( 'HOMEDRIVE' ) . getenv( 'HOMEPATH' );
+		}
+
+		return rtrim( $home, '/\\' );
+	}
+
+	/**
+	 * Appends a trailing slash.
+	 *
+	 * @param string $value What to add the trailing slash to.
+	 * @return string String with trailing slash added.
+	 */
+	public static function trailingslashit( $value ) {
+		if ( ! is_string( $value ) ) {
+			return '/';
+		}
+
+		return rtrim( $value, '/\\' ) . '/';
+	}
+
+	/**
+	 * Check if a path is a PHP stream URL.
+	 *
+	 * @param string $path The resource path or URL.
+	 * @return bool True if the path is a PHP stream URL, false otherwise.
+	 */
+	public static function is_stream( $path ) {
+		$scheme_separator = strpos( $path, '://' );
+
+		if ( false === $scheme_separator ) {
+			return false;
+		}
+
+		$stream = strtolower( substr( $path, 0, $scheme_separator ) );
+
+		return in_array( $stream, stream_get_wrappers(), true );
+	}
+
+	/**
+	 * Normalize a filesystem path.
+	 *
+	 * On Windows systems, replaces backslashes with forward slashes
+	 * and forces upper-case drive letters.
+	 * Allows for two leading slashes for Windows network shares, but
+	 * ensures that all other duplicate slashes are reduced to a single one.
+	 * Ensures upper-case drive letters on Windows systems.
+	 * Allows for PHP file wrappers.
+	 *
+	 * @param string $path Path to normalize.
+	 * @return string Normalized path.
+	 */
+	public static function normalize( $path ) {
+		$wrapper = '';
+		if ( self::is_stream( $path ) ) {
+			list( $wrapper, $path ) = explode( '://', $path, 2 );
+			$wrapper               .= '://';
+		}
+		$path = str_replace( '\\', '/', $path );
+		$path = (string) preg_replace( '|(?<=.)/+|', '/', $path );
+		if ( ':' === substr( $path, 1, 1 ) ) {
+			$path = ucfirst( $path );
+		}
+		// Resolve single-dot path segments (e.g., /foo/./bar becomes /foo/bar).
+		$path = (string) preg_replace( '#/(?:\./)+#', '/', $path );
+		if ( '/.' === substr( $path, -2 ) ) {
+			$path = substr( $path, 0, -1 );
+		}
+		// Resolve leading ./ (e.g., ./foo/bar becomes foo/bar).
+		$path = (string) preg_replace( '#^(?:\./)+#', '', $path );
+		// Collapse any duplicate slashes introduced by dot-segment resolution.
+		$path = (string) preg_replace( '|(?<=.)/+|', '/', $path );
+		return $wrapper . $path;
+	}
+
+	/**
+	 * Get the file basename.
+	 *
+	 * @param string $path
+	 * @param string $suffix
+	 * @return string
+	 */
+	public static function basename( $path, $suffix = '' ) {
+		// phpcs:ignore WordPress.PHP.DiscouragedPHPFunctions.urlencode_urlencode -- Format required by wordpress.org API.
+		return urldecode( \basename( str_replace( [ '%2F', '%5C' ], '/', urlencode( $path ) ), $suffix ) );
+	}
+
+	/**
+	 * Get a Phar-safe version of a path.
+	 *
+	 * For paths inside a Phar, this strips the outer filesystem's location to
+	 * reduce the path to what it needs to be within the Phar archive.
+	 *
+	 * Use the __FILE__ or __DIR__ constants as a starting point.
+	 *
+	 * @param string $path An absolute path that might be within a Phar.
+	 * @return string A Phar-safe version of the path.
+	 */
+	public static function phar_safe( $path ) {
+		if ( ! self::inside_phar() ) {
+			return $path;
+		}
+
+		return str_replace(
+			self::PHAR_STREAM_PREFIX . rtrim( WP_CLI_PHAR_PATH, '/' ) . '/',
+			self::PHAR_STREAM_PREFIX,
+			$path
+		);
+	}
+
+	/**
+	 * Replace magic constants in some PHP source code.
+	 *
+	 * Replaces the __FILE__ and __DIR__ magic constants with the values they are
+	 * supposed to represent at runtime.
+	 *
+	 * @param string $source The PHP code to manipulate.
+	 * @param string $path The path to use instead of the magic constants.
+	 * @return string Adapted PHP code.
+	 */
+	public static function replace_path_consts( $source, $path ) {
+		// Solve issue with Windows allowing single quotes in account names.
+		$file = addslashes( $path );
+
+		if ( file_exists( $file ) ) {
+			$file = (string) realpath( $file );
+		}
+
+		$dir = dirname( $file );
+
+		// Replace __FILE__ and __DIR__ constants with value of $file or $dir.
+		return (string) preg_replace_callback(
+			self::FILE_DIR_PATTERN,
+			static function ( $matches ) use ( $file, $dir ) {
+				if ( ! empty( $matches['file'] ) ) {
+					return "'{$file}'";
+				}
+
+				if ( ! empty( $matches['dir'] ) ) {
+					return "'{$dir}'";
+				}
+
+				return $matches[0];
+			},
+			$source
+		);
+	}
+}

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

@@ -0,0 +1,329 @@
+<?php
+
+namespace WP_CLI;
+
+use WP_CLI;
+
+/**
+ * Handles fatal errors to detect plugin/theme issues and suggest workarounds.
+ *
+ * This handler hooks into WordPress's fatal error handler to provide
+ * helpful suggestions to the user when plugins or themes cause errors.
+ *
+ * @package WP_CLI
+ */
+class ShutdownHandler {
+
+	/**
+	 * Register the error message filter.
+	 */
+	public static function register() {
+		// Ensure WordPress's fatal error handler is always enabled for WP-CLI
+		WP_CLI::add_wp_hook(
+			'wp_fatal_error_handler_enabled',
+			static function () {
+				return true;
+			}
+		);
+
+		// Hook into the error message filter to add our suggestions
+		WP_CLI::add_wp_hook(
+			'wp_php_error_message',
+			[ __CLASS__, 'filter_error_message' ],
+			10,
+			2
+		);
+	}
+
+	/**
+	 * Filter the PHP error message to add plugin/theme skip suggestions.
+	 *
+	 * @param string $message Error message.
+	 * @param array{type: int, message: string, file: string, line: int} $error Error information from error_get_last().
+	 * @return string Filtered error message.
+	 */
+	public static function filter_error_message( $message, $error ) {
+		if ( ! is_array( $error ) || ! isset( $error['file'], $error['line'], $error['message'] ) ) {
+			return wp_strip_all_tags( $message );
+		}
+
+		$message = 'There has been a critical error on this website.';
+
+		$message .= "\n\n" . wp_strip_all_tags( $error['message'] );
+
+		/**
+		 * @var string $file
+		 */
+		$file = $error['file'];
+
+		$plugin = self::identify_plugin( $file );
+		$theme  = self::identify_theme( $file );
+		$skip   = '--skip-plugins --skip-themes';
+		if ( $plugin ) {
+			$message .= "\n\nThis error may have been caused by the plugin {$plugin}.";
+			$message .= "\nTo skip this plugin, run the command again with:";
+			$message .= "\n  --skip-plugins={$plugin}";
+
+			$skip = [ 'skip-plugins' => $plugin ];
+		} elseif ( 'functions.php' === $theme ) {
+			$message .= "\n\nAn unexpected functions.php file in the themes directory may have caused this internal server error.";
+
+			// This error cannot be skipped with `--skip-themes`.
+			return $message;
+		} elseif ( $theme ) {
+			$message .= "\n\nThis error may have been caused by the theme {$theme}.";
+			$message .= "\nTo skip this theme, run the command again with:";
+			$message .= "\n  --skip-themes={$theme}";
+
+			$skip = [ 'skip-themes' => $theme ];
+		} else {
+			$message .= "\n\nThis error may have been caused by a theme or plugin.";
+			$message .= "\nTo skip all plugins and themes, run the command again with:";
+			$message .= "\n  --skip-plugins --skip-themes";
+			$skip     = [
+				'skip-plugins' => true,
+				'skip-themes'  => true,
+			];
+		}
+
+		if ( ! self::should_handle_error_rerun() ) {
+			return $message;
+		}
+
+		WP_CLI::add_wp_hook(
+			'wp_die_handler',
+			function () use ( $skip ) {
+				return static function ( $wp_error ) use ( $skip ) {
+					WP_CLI::error( $wp_error->get_error_message(), false );
+
+					self::prompt_and_rerun( $skip );
+				};
+			}
+		);
+
+		return $message;
+	}
+
+	/**
+	 * Identify the plugin causing the error.
+	 *
+	 * @param string $file File path where error occurred.
+	 * @return string|null Plugin slug, or null if not a plugin error.
+	 */
+	private static function identify_plugin( $file ) {
+		// Normalize path separators for consistent matching
+		$file = Path::normalize( $file );
+
+		// Use WordPress constants if available for more accurate path detection
+		if ( defined( 'WP_PLUGIN_DIR' ) ) {
+			$slug = self::extract_component_slug( $file, WP_PLUGIN_DIR );
+			if ( $slug ) {
+				return $slug;
+			}
+		}
+
+		if ( defined( 'WPMU_PLUGIN_DIR' ) ) {
+			$slug = self::extract_component_slug( $file, WPMU_PLUGIN_DIR );
+			if ( $slug ) {
+				return $slug;
+			}
+		}
+
+		// Fallback to pattern matching if constants are not available
+		if ( preg_match( '#/wp-content/(?:mu-)?plugins/([^/]+)/#', $file, $matches ) ) {
+			return $matches[1];
+		}
+
+		// Check for direct single-file plugins
+		if ( preg_match( '#/wp-content/(?:mu-)?plugins/([^/]+)\\.php$#', $file, $matches ) ) {
+			return $matches[1];
+		}
+
+		return null;
+	}
+
+	/**
+	 * Identify the theme causing the error.
+	 *
+	 * @param string $file File path where error occurred.
+	 * @return string|null Theme slug, or null if not a theme error.
+	 */
+	private static function identify_theme( $file ) {
+		// Normalize path separators for consistent matching
+		$file = Path::normalize( $file );
+
+		// Use get_theme_root() if available for more accurate path detection
+		if ( function_exists( 'get_theme_root' ) ) {
+			$slug = self::extract_theme_slug( $file, get_theme_root() );
+			if ( $slug ) {
+				return $slug;
+			}
+		} elseif ( defined( 'WP_CONTENT_DIR' ) ) {
+			// Fallback to WP_CONTENT_DIR/themes if get_theme_root() is not available
+			$slug = self::extract_theme_slug( $file, WP_CONTENT_DIR . '/themes' );
+			if ( $slug ) {
+				return $slug;
+			}
+		}
+
+		// Fallback to pattern matching if constants/functions are not available
+		if ( preg_match( '#/wp-content/themes/([^/]+)/#', $file, $matches ) ) {
+			return $matches[1];
+		}
+
+		// Check for themes/functions.php directly in the themes directory
+		if ( preg_match( '#/wp-content/themes/(functions\\.php)$#', $file, $matches ) ) {
+			return $matches[1];
+		}
+
+		return null;
+	}
+
+	/**
+	 * Extract component slug from a file path given a base directory.
+	 *
+	 * @param string $file    File path where error occurred.
+	 * @param string $base_dir Base directory path.
+	 * @return string|null Component slug, or null if not found.
+	 */
+	private static function extract_component_slug( $file, $base_dir ) {
+		$file     = Path::normalize( $file );
+		$base_dir = Path::normalize( $base_dir );
+
+		if ( 0 === strpos( $file, $base_dir . '/' ) ) {
+			$relative = substr( $file, strlen( $base_dir ) + 1 );
+			$parts    = explode( '/', $relative );
+			if ( ! empty( $parts[0] ) ) {
+				// For components in subdirectories, return the directory name
+				// For single-file components, return the filename without .php
+				return false !== strpos( $parts[0], '.php' ) ? basename( $parts[0], '.php' ) : $parts[0];
+			}
+		}
+		return null;
+	}
+
+	/**
+	 * Extract theme slug from a file path given a theme directory.
+	 *
+	 * @param string $file      File path where error occurred.
+	 * @param string $theme_dir Theme directory path.
+	 * @return string|null Theme slug, or null if not found.
+	 */
+	private static function extract_theme_slug( $file, $theme_dir ) {
+		$file      = Path::normalize( $file );
+		$theme_dir = Path::normalize( $theme_dir );
+
+		if ( 0 === strpos( $file, $theme_dir . '/' ) ) {
+			$relative = substr( $file, strlen( $theme_dir ) + 1 );
+			$parts    = explode( '/', $relative );
+			if ( ! empty( $parts[0] ) ) {
+				return $parts[0];
+			}
+		}
+		return null;
+	}
+
+	/**
+	 * Check if we should setup the error rerun handler.
+	 *
+	 * @return bool
+	 */
+	private static function should_handle_error_rerun() {
+		// Check environment variable WP_CLI_ERROR_RERUN
+		$error_rerun = Utils\get_env_or_config( 'WP_CLI_ERROR_RERUN' );
+
+		if ( false !== $error_rerun ) {
+			return 'no' !== $error_rerun;
+		}
+
+		// Default: handle the error rerun (prompt)
+		return true;
+	}
+
+	/**
+	 * Prompt the user to rerun the command with the skip flag.
+	 *
+	 * @param array<string, bool|string> $skip Skip flag(s) to append.
+	 */
+	private static function prompt_and_rerun( $skip ) {
+		// Get environment variable to check default behavior
+		$error_rerun = Utils\get_env_or_config( 'WP_CLI_ERROR_RERUN' );
+
+		// If set to 'yes', automatically rerun without prompting
+		if ( 'yes' === $error_rerun ) {
+			self::rerun_with_skip( $skip );
+			return;
+		}
+
+		// If set to 'no', don't prompt or rerun at all
+		if ( 'no' === $error_rerun ) {
+			return;
+		}
+
+		// 'prompt' or default behavior
+		$skip_string = self::get_skip_string( $skip );
+
+		try {
+			WP_CLI::confirm( "\nWould you like to run the command again with $skip_string?" );
+			self::rerun_with_skip( $skip );
+		} catch ( \WP_CLI\ExitException $e ) {
+			// User declined or Ctrl+C - exit gracefully
+			WP_CLI::line( 'Command not rerun.' );
+		}
+	}
+
+	/**
+	 * Return a formatted --skip-[...] string.
+	 *
+	 * @param array<string, bool|string> $skip Skip flag(s) to append.
+	 * @return string
+	 */
+	private static function get_skip_string( $skip ) {
+		return implode(
+			' ',
+			array_map(
+				static function ( $key, $value ) {
+					return is_bool( $value ) ? "--$key" : "--$key=$value";
+				},
+				array_keys( $skip ),
+				array_values( $skip )
+			)
+		);
+	}
+
+	/**
+	 * Rerun the current command with the skip flag.
+	 *
+	 * @param array<string, bool|string> $skip Skip flag(s) to append.
+	 */
+	private static function rerun_with_skip( $skip ) {
+		$runner = WP_CLI::get_runner();
+
+		if ( ! $runner ) {
+			return;
+		}
+
+		$args       = $runner->arguments;
+		$assoc_args = $runner->assoc_args;
+
+		foreach ( $skip as $skip_flag => $slug ) {
+			if ( isset( $assoc_args[ $skip_flag ] ) && ! is_bool( $slug ) ) {
+				// Add slug to existing skip list.
+				$existing                  = $assoc_args[ $skip_flag ];
+				$assoc_args[ $skip_flag ] .= ',' . $slug;
+			} else {
+				$assoc_args[ $skip_flag ] = $slug;
+			}
+		}
+
+		$skip_string = self::get_skip_string( $skip );
+
+		WP_CLI::line( "\nRerunning command with {$skip_string}...\n" );
+
+		try {
+			WP_CLI::run_command( $args, $assoc_args );
+		} catch ( \Exception $e ) {
+			WP_CLI::error( $e->getMessage() );
+		}
+	}
+}