wp-studio 1.8.0 → 1.8.1

package/dist/cli/php/wp-config-transformer.php

@@ -0,0 +1,471 @@
+<?php
+
+/**
+ * Transforms the "wp-config.php" file.
+ *
+ * This parses the "wp-config.php" file contents into a token array and provides
+ * methods to modify it and serialize it back to a string with the modifications.
+ */
+class WP_Config_Transformer {
+	/**
+	 * The tokens of the wp-config.php file.
+	 *
+	 * @var array<array|string>
+	 */
+	private $tokens;
+
+	/**
+	 * Constructor.
+	 *
+	 * @param string $content The contents of the wp-config.php file.
+	 */
+	public function __construct( string $content ) {
+		$this->tokens = token_get_all( $content );
+
+		// Check if the file is a valid PHP file.
+		$is_valid_php_file = false;
+		foreach ( $this->tokens as $token ) {
+			if ( is_array( $token ) && T_OPEN_TAG === $token[0] ) {
+				$is_valid_php_file = true;
+				break;
+			}
+		}
+		if ( ! $is_valid_php_file ) {
+			throw new Exception( "The 'wp-config.php' file is not a valid PHP file." );
+		}
+	}
+
+	/**
+	 * Create a new config transformer instance from a file.
+	 *
+	 * @param string $path The path to the wp-config.php file.
+	 * @return self        The new config transformer instance.
+	 */
+	public static function from_file( string $path ): self {
+		if ( ! is_file( $path ) ) {
+			throw new Exception( sprintf( "The '%s' file does not exist.", $path ) );
+		}
+		return new self( file_get_contents( $path ) );
+	}
+
+	/**
+	 * Get the transformed wp-config.php file contents.
+	 *
+	 * @return string The transformed wp-config.php file contents.
+	 */
+	public function to_string(): string {
+		$output = '';
+		foreach ( $this->tokens as $token ) {
+			$output .= is_array( $token ) ? $token[1] : $token;
+		}
+		return $output;
+	}
+
+	/**
+	 * Save the transformed wp-config.php file contents to a file.
+	 *
+	 * @param string $path The path to the wp-config.php file.
+	 */
+	public function to_file( string $path ): void {
+		$result = file_put_contents( $path, $this->to_string() );
+		if ( false === $result ) {
+			throw new Exception( sprintf( "Failed to write to the '%s' file.", $path ) );
+		}
+	}
+
+	/**
+	 * Check if a constant is defined in the wp-config.php file.
+	 *
+	 * @param  string $name The name of the constant.
+	 * @return bool         True if the constant is defined, false otherwise.
+	 */
+	public function constant_exists( string $name ): bool {
+		foreach ( $this->tokens as $i => $token ) {
+			$is_string_token = is_array( $token ) && T_STRING === $token[0];
+			if ( $is_string_token && 'define' === strtolower( $token[1] ) ) {
+				$args       = $this->collect_function_call_argument_locations( $i );
+				$const_name = $this->evaluate_constant_name(
+					array_slice( $this->tokens, $args[0][0], $args[0][1] )
+				);
+				if ( $name === $const_name ) {
+					return true;
+				}
+			}
+		}
+		return false;
+	}
+
+	/**
+	 * Define a constant in the wp-config.php file.
+	 *
+	 * @param string $name  The name of the constant.
+	 * @param mixed  $value The value of the constant.
+	 */
+	public function define_constant( string $name, $value ): void {
+		// Tokenize the new constant value for insertion in the tokens array.
+		$definition_tokens = token_get_all(
+			sprintf(
+				"<?php define( %s, %s );\n",
+				var_export( $name, true ),
+				var_export( $value, true )
+			)
+		);
+
+		// Full constant definition statement, e.g.: define( 'WP_DEBUG', true );\n
+		$define_tokens = array_slice( $definition_tokens, 1 );
+
+		// The value of the constant, e.g.: "my-database-name"
+		$value_tokens = array_slice( $definition_tokens, 7, -4 );
+
+		// Collect all locations where the constant value needs to be updated.
+		$updates = array();
+		foreach ( $this->tokens as $i => $token ) {
+			$is_string_token = is_array( $token ) && T_STRING === $token[0];
+			if ( $is_string_token && 'define' === strtolower( $token[1] ) ) {
+				$args       = $this->collect_function_call_argument_locations( $i );
+				$const_name = $this->evaluate_constant_name(
+					array_slice( $this->tokens, $args[0][0], $args[0][1] )
+				);
+
+				if ( $name === $const_name ) {
+					$updates[] = $args[1];
+				}
+			}
+		}
+
+		// Modify the token array to define the constant. Apply updates in reverse
+		// order, so splices at earlier positions don't shift indices after them.
+		for ( $i = count( $updates ) - 1; $i >= 0; $i -= 1 ) {
+			list ( $value_start, $value_length ) = $updates[ $i ];
+			array_splice( $this->tokens, $value_start, $value_length, $value_tokens );
+		}
+
+		// If it's a new constant, inject it at the anchor location.
+		if ( 0 === count( $updates ) ) {
+			$anchor = $this->get_new_constant_location();
+			array_splice( $this->tokens, $anchor, 0, $define_tokens );
+
+			/*
+			 * Ensure at least one newline (one "\n") before the new constant.
+			 * This must be done after inserting the constant definition in order
+			 * to avoid shifting the anchor location when a new token is inserted.
+			 */
+			$this->ensure_newlines( $anchor - 1, 1 );
+		}
+	}
+
+	/**
+	 * Define multiple constants in the wp-config.php file.
+	 *
+	 * @param array<string, mixed> $constants An array of name-value pairs of constants to define.
+	 */
+	public function define_constants( array $constants ): void {
+		foreach ( $constants as $name => $value ) {
+			$this->define_constant( $name, $value );
+		}
+	}
+
+	/**
+	 * Inject code block into the wp-config.php file.
+	 *
+	 * @param string $code The code to inject.
+	 */
+	public function inject_code_block( string $code ): void {
+		// Tokenize the injected code for insertion in the token array.
+		$tokens      = token_get_all( sprintf( '<?php %s', trim( $code ) ) );
+		$code_tokens = array_slice( $tokens, 1 );
+
+		// Inject the code at the anchor location.
+		$anchor = $this->get_injected_code_location();
+		array_splice( $this->tokens, $anchor, 0, $code_tokens );
+
+		/*
+		 * Ensure empty line before and after the code block (at least two "\n").
+		 * This must be done after inserting the injected code, and the location
+		 * AFTER must be updated prior to the location BEFORE, in order to avoid
+		 * shifting the anchor location when a new token is inserted.
+		 */
+		$this->ensure_newlines( $anchor + count( $code_tokens ), 2 );
+		$this->ensure_newlines( $anchor - 1, 2 );
+	}
+
+	/**
+	 * Remove code block defined by two comment fragments from the wp-config.php file.
+	 *
+	 * @param string $from_comment_fragment A comment fragment from which to remove the code.
+	 * @param string $to_comment_fragment   A comment fragment to which to remove the code.
+	 */
+	public function remove_code_block( string $from_comment_fragment, string $to_comment_fragment ): void {
+		$start = $this->find_first_token_location( T_COMMENT, $from_comment_fragment );
+		$end   = $this->find_first_token_location( T_COMMENT, $to_comment_fragment );
+		if ( null === $start || null === $end ) {
+			return;
+		}
+
+		// Remove the code, including the comment fragments.
+		array_splice( $this->tokens, $start, $end - $start + 1 );
+
+		// If previous and next tokens are whitespace, merge them.
+		$prev = $this->tokens[ $start - 1 ];
+		$next = $this->tokens[ $start ] ?? null;
+		if (
+			is_array( $prev ) && T_WHITESPACE === $prev[0]
+			&& is_array( $next ) && T_WHITESPACE === $next[0]
+		) {
+			$this->tokens[ $start - 1 ][1] = $prev[1] . $next[1];
+			array_splice( $this->tokens, $start, 1 );
+		}
+
+		// Remove up to two empty lines (before & after), keeping at least one.
+		$token = $this->tokens[ $start - 1 ];
+		if ( is_array( $token ) && T_WHITESPACE === $token[0] ) {
+			$newlines = substr_count( $token[1], "\n" );
+			if ( $newlines > 2 ) {
+				$limit = min( $newlines - 2, 4 );
+				$value = $token[1];
+				for ( $i = 0; $limit > 0; $i += 1 ) {
+					if ( "\n" === $value[ $i ] ) {
+						$value  = substr_replace( $value, '', $i, 1 );
+						$limit -= 1;
+					}
+				}
+				$this->tokens[ $start - 1 ][1] = $value;
+			}
+		}
+	}
+
+	/**
+	 * Parse arguments of a function call and collect their locations.
+	 *
+	 * @param  int $start             The location of the first token of the function call.
+	 * @return array<array<int, int>> The arguments of the function call.
+	 */
+	private function collect_function_call_argument_locations( int $start ): array {
+		// Find location of the opening parenthesis after the function name.
+		$i = $start;
+		while ( '(' !== $this->tokens[ $i ] ) {
+			$i += 1;
+		}
+		$i += 1;
+
+		// Collect all function call argument locations.
+		$args         = array();
+		$arg_start    = $this->skip_whitespace_and_comments( $i );
+		$parens_level = 0;
+		for ( $i = $arg_start; $i < count( $this->tokens ); $i += 1 ) {
+			// Skip whitespace and comments, but preserve the index of the last
+			// non-whitespace token to calculate the exact argument boundaries.
+			$prev_i = $i;
+			$i      = $this->skip_whitespace_and_comments( $i );
+			$token  = $this->tokens[ $i ];
+
+			if ( 0 === $parens_level && ( ',' === $token || ')' === $token ) ) {
+				$args[] = array( $arg_start, $prev_i - $arg_start );
+				if ( ',' === $token ) {
+					// Start of the next argument.
+					$arg_start = $this->skip_whitespace_and_comments( $i + 1 );
+					$i         = $arg_start;
+				} else {
+					// End of the argument list.
+					break;
+				}
+			} elseif ( '(' === $token || '[' === $token || '{' === $token ) {
+				$parens_level += 1;
+			} elseif ( ')' === $token || ']' === $token || '}' === $token ) {
+				$parens_level -= 1;
+			}
+		}
+		return $args;
+	}
+
+	/**
+	 * Evaluate the constant name value from its tokens.
+	 *
+	 * @param  array $name_tokens The tokens containing the constant name.
+	 * @return string|null        The evaluated constant name.
+	 */
+	private function evaluate_constant_name( array $name_tokens ): ?string {
+		// Decide whether the array represents a constant name or an expression.
+		$name_token = null;
+		foreach ( $name_tokens as $token ) {
+			if ( $this->is_whitespace( $token ) ) {
+				continue;
+			}
+			if ( is_array( $token ) ) {
+				if ( T_STRING === $token[0] || T_CONSTANT_ENCAPSED_STRING === $token[0] ) {
+					$name_token = $token;
+				} else {
+					return null;
+				}
+			} elseif ( '(' !== $token && ')' !== $token ) {
+				return null;
+			}
+		}
+
+		if ( null === $name_token ) {
+			return null;
+		}
+
+		// Get the constant name value.
+		return eval( 'return ' . $name_token[1] . ';' );
+	}
+
+	/**
+	 * Skip whitespace and comment tokens and return the location of the first
+	 * non-whitespace and non-comment token after the specified start location.
+	 *
+	 * @param  int $start The start location in the token array.
+	 * @return int        The location of the first non-whitespace and non-comment token.
+	 */
+	private function skip_whitespace_and_comments( int $start ): int {
+		for ( $i = $start; $i < count( $this->tokens ); $i += 1 ) {
+			if ( $this->is_whitespace( $this->tokens[ $i ] ) ) {
+				continue;
+			}
+			break;
+		}
+		return $i;
+	}
+
+	/**
+	 * Ensure minimum number of newlines are present at the given index.
+	 *
+	 * @param int $index The index of the token to ensure newlines.
+	 * @param int $count The number of newlines that should be present.
+	 */
+	private function ensure_newlines( int $index, int $count ): void {
+		$token = $this->tokens[ $index ] ?? null;
+		if ( is_array( $token ) && ( T_WHITESPACE === $token[0] || T_OPEN_TAG === $token[0] ) ) {
+			$newlines = substr_count( $token[1], "\n" );
+			if ( $newlines < $count ) {
+				$this->tokens[ $index ][1] .= str_repeat( "\n", $count - $newlines );
+			}
+		} else {
+			$new_token = array( T_WHITESPACE, str_repeat( "\n", $count ) );
+			array_splice( $this->tokens, $index, 0, array( $new_token ) );
+		}
+	}
+
+	/**
+	 * Get the location to inject new constant definitions in the token array.
+	 *
+	 * @return int The location for new constant definitions in the token array.
+	 */
+	private function get_new_constant_location(): int {
+		// First try to find the "That's all, stop editing!" comment.
+		$anchor = $this->find_first_token_location( T_COMMENT, "That's all, stop editing!" );
+		if ( null !== $anchor ) {
+			return $anchor;
+		}
+
+		// If not found, try the "Absolute path to the WordPress directory." doc comment.
+		$anchor = $this->find_first_token_location( T_DOC_COMMENT, 'Absolute path to the WordPress directory.' );
+		if ( null !== $anchor ) {
+			return $anchor;
+		}
+
+		// If not found, try the "Sets up WordPress vars and included files." doc comment.
+		$anchor = $this->find_first_token_location( T_DOC_COMMENT, 'Sets up WordPress vars and included files.' );
+		if ( null !== $anchor ) {
+			return $anchor;
+		}
+
+		// If not found, try "require_once ABSPATH . 'wp-settings.php';".
+		$anchor = $this->find_first_token_location( T_REQUIRE_ONCE );
+		if ( null !== $anchor ) {
+			return $anchor;
+		}
+
+		// If not found, fall back to the PHP opening tag.
+		$open_tag_anchor = $this->find_first_token_location( T_OPEN_TAG );
+		if ( null !== $open_tag_anchor ) {
+			return $open_tag_anchor + 1;
+		}
+
+		// If we still don't have an anchor, the file is not a valid PHP file.
+		throw new Exception( "The 'wp-config.php' file is not a valid PHP file." );
+	}
+
+	/**
+	 * Get the location to inject new code in the token array.
+	 *
+	 * @return int The location for injected code in the token array.
+	 */
+	private function get_injected_code_location(): int {
+		// First try to find the "/** Sets up WordPress vars and included files. */" comment.
+		$anchor = $this->find_first_token_location( T_DOC_COMMENT, 'Sets up WordPress vars and included files.' );
+		if ( null !== $anchor ) {
+			return $anchor;
+		}
+
+		// If not found, try "require_once ABSPATH . 'wp-settings.php';".
+		$anchor = $this->find_require_wp_settings_location();
+		if ( null !== $anchor ) {
+			return $anchor;
+		}
+
+		// If not found, fall back to the PHP opening tag.
+		$open_tag_anchor = $this->find_first_token_location( T_OPEN_TAG );
+		if ( null !== $open_tag_anchor ) {
+			return $open_tag_anchor + 1;
+		}
+
+		// If we still don't have an anchor, the file is not a valid PHP file.
+		throw new Exception( "The 'wp-config.php' file is not a valid PHP file." );
+	}
+
+	/**
+	 * Find location of the "wp-settings.php" require statement in the token array.
+	 *
+	 * This method searches for the following statement:
+	 *
+	 *   require_once ABSPATH . 'wp-settings.php';
+	 *
+	 * @return int|null The location of the require statement.
+	 */
+	private function find_require_wp_settings_location(): ?int {
+		$require_anchor = $this->find_first_token_location( T_REQUIRE_ONCE );
+		if ( null === $require_anchor ) {
+			return null;
+		}
+
+		$abspath = $this->tokens[ $require_anchor + 2 ] ?? null;
+		$path    = $this->tokens[ $require_anchor + 6 ] ?? null;
+		if (
+			( is_array( $abspath ) && 'ABSPATH' === $abspath[1] )
+			&& ( is_array( $path ) && "'wp-settings.php'" === $path[1] )
+		) {
+			return $require_anchor;
+		}
+		return null;
+	}
+
+	/**
+	 * Find location of the first token of a given type in the token array.
+	 *
+	 * @param  int    $type   The type of the token.
+	 * @param  string $search Optional. A search string to match against the token content.
+	 * @return int|null       The location of the first token.
+	 */
+	private function find_first_token_location( int $type, ?string $search = null ): ?int {
+		foreach ( $this->tokens as $i => $token ) {
+			if ( is_array( $token ) && $type === $token[0] ) {
+				if ( null === $search || false !== strpos( $token[1], $search ) ) {
+					return $i;
+				}
+			}
+		}
+		return null;
+	}
+
+	/**
+	 * Check if a token is whitespace or a comment.
+	 *
+	 * @param  array|string $token The token to check.
+	 * @return bool                True if the token is whitespace or a comment.
+	 */
+	private function is_whitespace( $token ): bool {
+		return is_array( $token )
+			&& ( T_WHITESPACE === $token[0] || T_COMMENT === $token[0] || T_DOC_COMMENT === $token[0] );
+	}
+}

package/dist/cli/php-binary-metadata-B51UcEYo.mjs

@@ -0,0 +1,85 @@
+import { sprintf } from "@wordpress/i18n";
+import { z } from "zod";
+import { a as SupportedPHPVersions } from "./php-versions-C4NIFv0m.mjs";
+const NativePhpSupportedVersions = SupportedPHPVersions.filter((v) => v !== "7.4");
+function validateNativePhpVersion(version) {
+  const phpVersionSchema = z.enum(NativePhpSupportedVersions);
+  const result = phpVersionSchema.safeParse(version);
+  if (!result.success) {
+    throw new Error(
+      sprintf(
+        `PHP %s is not supported by the native-php runtime. Supported versions: %s.`,
+        version,
+        NativePhpSupportedVersions.join(", ")
+      )
+    );
+  }
+  return result.data;
+}
+const PHP_PATCH_VERSIONS = {
+  "8.5": "8.5.5",
+  "8.4": "8.4.20",
+  "8.3": "8.3.30",
+  "8.2": "8.2.30",
+  "8.1": "8.1.34",
+  "8.0": "8.0.30"
+};
+const PHP_BINARY_HASHES = {
+  // PHP 8.5 (8.5.5)
+  "8.5-darwin-arm64": "d66ef557189baa9215cec65dba80eb5dcfa84ac87bfce565059263bce5c9cccb",
+  "8.5-darwin-x64": "f206193e86c6ca188fbb46532c432ff3f216f203be9fe67bfc839973de64f9b8",
+  "8.5-linux-x64": "72a877af1cb93d7c14f79344bdbd78dc2a57a2e915a76b13e9a3141700df3f21",
+  "8.5-linux-arm64": "a45fc1f818497586bfd8f749c808f1f63c9d10bf48f439985e77bee607a2c76b",
+  "8.5-win32-x64": "ddd8098a1e71dfe53c147c392eeaa50eb61259a1c430e3cbe016b0edbdc1cf91",
+  // PHP 8.4 (8.4.20)
+  "8.4-darwin-arm64": "63b676b3e638aae10055a795ad25a820451fdfc79afb9f99b1605bad61560679",
+  "8.4-darwin-x64": "6fc09f87d9676bf8f22b05cf77a91b99ee120414e9a028c6f357c18df531fa83",
+  "8.4-linux-x64": "3624293e0556625e19f4483d74eac21d41b70d21bdbb7e8ea3e1247303886148",
+  "8.4-linux-arm64": "1be37b0cc533edc691632828ecdaddd84eaa0f71bb9c06a3458347aa13da2987",
+  "8.4-win32-x64": "174ee2fefa1da9727bfc3d89d37b0bc31b474d7cbbf2005d71bf364cf93fd3f2",
+  // PHP 8.3 (8.3.30)
+  "8.3-darwin-arm64": "8cfc16a7741c94bb1c7c991de554aeae7275308a6233e6da898e69d8d7e88920",
+  "8.3-darwin-x64": "a6389d12d35661a5e9428fa074397f6b086e1aaf5aa7a5461012986d2d2ca3da",
+  "8.3-linux-x64": "b23bd3cae443dc23f1013190456ce16406b5eb89115ba7c4b6e19ee613948739",
+  "8.3-linux-arm64": "d8c6c064585190d5ce27671b862c3acacf98b1b248efb402536051768edfa8a9",
+  "8.3-win32-x64": "7eb9f5f45c24d984e69214e6b1f264bf9bf98f1469e32a720a39b849ab490837",
+  // PHP 8.2 (8.2.30)
+  "8.2-darwin-arm64": "71189159f072c2b0dec2c4c778f313187234725cc888dd648fde06b9671536b9",
+  "8.2-darwin-x64": "51bbea18b71ee81a547a85fd6f64c671c3bb21e1e2aaaa8317b9ec786755f160",
+  "8.2-linux-x64": "f655fd34bdd8cc2fc48190feaa100eeec4a1e35d629316252fce16e9faca7652",
+  "8.2-linux-arm64": "e48d38ae0e2bfe1a4c1f7c2fb87cd4e2ff3ae391de99b3ed7860aa7d9ff0f1e5",
+  "8.2-win32-x64": "004f0fec7c7e92135f88a37d04236433b3627ef2339218cbfe503f15a83b9be1",
+  // PHP 8.1 (8.1.34)
+  "8.1-darwin-arm64": "4feae4b89a6a2b1d0f1c9cc6bbb37e7a7f299a392a6f8f207946fc60c6ed631a",
+  "8.1-darwin-x64": "91dddd79c1a8296eec6baa79e890d174a7ddcac40e0565390ae97eea09055e25",
+  "8.1-linux-x64": "4caa8b82b574212b2f7af83cc800b23e0529b3dec85b8b2887547f909e717143",
+  "8.1-linux-arm64": "134a0244b399c73792db3e91337fa3c18f0d773fd78ecfc26b14560fec7bcd6d",
+  "8.1-win32-x64": "112f3a411280a91eb5a32716484b52124e874678edb8f1a0ffbe0db767afc5ff",
+  // PHP 8.0 (8.0.30)
+  "8.0-darwin-arm64": "af2e06f1c0e872712177dda3478434890ed9bfc278f5435ed7d82f989b28a080",
+  "8.0-darwin-x64": "8851a859b67e2abb6b15ec87eea547a47ec2380d7abc8297f26a9fb927eac46f",
+  "8.0-linux-x64": "1a5b1d5e60bca9e0c06557640f878e88bd52ac4eb28e8a118103867b084e8ff8",
+  "8.0-linux-arm64": "7515adedd9553d5c07f5fcead401a97e37b23e3cc0f156285b00a9232b2cdeff",
+  "8.0-win32-x64": "67c98a95790d2dd9f79b051c2b6cab0cf9bb4d4cc0b4c5401c991bc99c99ac82"
+};
+const CDN_ARCH_MAP = { x64: "x86_64", arm64: "aarch64" };
+const OS_SEGMENT = { darwin: "macos", linux: "linux", win32: "win" };
+function buildPhpBinaryUrl(version, platform, arch) {
+  const patchVersion = PHP_PATCH_VERSIONS[version];
+  const p = platform;
+  if (p === "win32") {
+    return `https://dl.static-php.dev/static-php-cli/windows/spc-max/php-${patchVersion}-cli-win.zip`;
+  }
+  const cdnArch = CDN_ARCH_MAP[arch] ?? arch;
+  return `https://dl.static-php.dev/static-php-cli/common/php-${patchVersion}-cli-${OS_SEGMENT[p]}-${cdnArch}.tar.gz`;
+}
+function getPhpBinaryHash(version, platform, arch) {
+  const effectiveArch = platform === "win32" ? "x64" : arch;
+  return PHP_BINARY_HASHES[`${version}-${platform}-${effectiveArch}`] || void 0;
+}
+export {
+  PHP_PATCH_VERSIONS as P,
+  buildPhpBinaryUrl as b,
+  getPhpBinaryHash as g,
+  validateNativePhpVersion as v
+};