Add phar_safe_path override to fix template path resolution

Created php/utils-override.php with fixed phar_safe_path() that replaces full paths with alias 'phar://wp-cli.phar/' instead of bare 'phar://'. Include this override in boot-phar.php after wp-cli.php is loaded. This is a temporary fix until wp-cli/wp-cli#6242 is merged.

Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>

Author: Copilot

php/boot-phar.php

@@ -11,17 +11,20 @@
 
 // Store the filesystem path for `Utils\phar_safe_path()` function.
 // Using Phar::running(false) returns just the filesystem path without phar:// protocol.
-// This prevents phar_safe_path() from attempting to replace "phar://phar://..." incorrectly.
 define( 'WP_CLI_PHAR_PATH', Phar::running( false ) );
 
 // Use the phar alias 'wp-cli.phar' which is set during phar creation and works
 // regardless of the actual filename. This ensures template paths resolve correctly.
 if ( file_exists( 'phar://wp-cli.phar/php/wp-cli.php' ) ) {
 	define( 'WP_CLI_ROOT', 'phar://wp-cli.phar' );
 	include WP_CLI_ROOT . '/php/wp-cli.php';
+	// Override phar_safe_path() to fix template resolution (temporary until wp-cli/wp-cli#6242 is merged)
+	include __DIR__ . '/utils-override.php';
 } elseif ( file_exists( 'phar://wp-cli.phar/vendor/wp-cli/wp-cli/php/wp-cli.php' ) ) {
 	define( 'WP_CLI_ROOT', 'phar://wp-cli.phar/vendor/wp-cli/wp-cli' );
 	include WP_CLI_ROOT . '/php/wp-cli.php';
+	// Override phar_safe_path() to fix template resolution (temporary until wp-cli/wp-cli#6242 is merged)
+	include __DIR__ . '/utils-override.php';
 } else {
 	echo "Couldn't find 'php/wp-cli.php'. Was this Phar built correctly?";
 	exit( 1 );

php/utils-override.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * Override for Utils\phar_safe_path() to fix template path resolution
+ * when phar is renamed.
+ *
+ * This fix will be removed once wp-cli/wp-cli#6242 is merged and integrated.
+ */
+
+namespace WP_CLI\Utils;
+
+/**
+ * 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.
+ */
+function phar_safe_path( $path ) {
+
+	if ( ! inside_phar() ) {
+		return $path;
+	}
+
+	return str_replace(
+		PHAR_STREAM_PREFIX . rtrim( WP_CLI_PHAR_PATH, '/' ) . '/',
+		'phar://wp-cli.phar/',
+		$path
+	);
+}