Improve compatibility with other operating systems

[swissspidy]

I'm trying to improve Windows support a little bit so that tests could run on CI. Doing things in PHP vs. CLI commands is one step.

Lots of AI code changes in here, might need some cleanup

Main change is blocked by wp-cli/wp-cli#6124

To-do:

• Add Behat tags to skip tests for certain OS?

See #155

[swissspidy]

Looks like there's basically two categories of remaining testing errors on Windows:

• When doing things like echo "value1", it will actually add the quotes to stdout.
• Line ending issues in Test CSV containing with headers scenario

[swissspidy]

/gemini review

[gemini-code-assist]

Code Review

This pull request focuses on improving cross-platform compatibility, particularly for Windows, which is a valuable effort. The changes largely involve replacing shell-specific commands with PHP-native implementations and using DIRECTORY_SEPARATOR for path construction. These are solid improvements for portability. I've identified a few issues, including a critical bug in path concatenation, a high-severity regression that affects file permissions on non-Windows systems, and several medium-severity items related to robust error handling and consistent path construction. Addressing these will significantly strengthen the cross-platform support.

[gemini-code-assist]

There's a missing DIRECTORY_SEPARATOR when constructing the $phar_path. This will lead to an incorrect path (e.g., /path/to/bindirwp.bat on Windows) and will cause failures when trying to use the phar.

                $phar_path = $bin_dir . DIRECTORY_SEPARATOR . $bin;

[gemini-code-assist]

The order of array_merge() appears to be incorrect. By using array_merge( $env, $_ENV ), any environment variables from $_ENV with the same key (like PATH) will overwrite the ones you've carefully constructed in $env. This could lead to an incorrect environment for the sub-process. To ensure your specific settings take precedence unless overridden by $_ENV, you should reverse the order of the arguments.

        $env = array_merge( $_ENV, $env );

[gemini-code-assist]

The previous implementation using curl also made the downloaded phar executable with chmod +x. This functionality was removed in the refactoring, which is a regression for non-Windows systems where the phar needs to be executable to be run directly. Please add logic to set the executable permission on non-Windows platforms.

        $response = Utils\http_request( 'GET', $download_url, null, [], [ 'filename' => $this->variables['PHAR_PATH'] ] );

        if ( 200 !== $response->status_code ) {
            throw new RuntimeException( "Could not download WP-CLI PHAR (HTTP code {$response->status_code})" );
        }

        if ( ! Utils\is_windows() ) {
            chmod( $this->variables['PHAR_PATH'], 0755 );
        }

[gemini-code-assist]

Casting the result of file_get_contents() to a string with (string) can hide potential file read errors. If file_get_contents() fails, it returns false, which is then cast to an empty string. json_decode('') on this empty string results in null, allowing the script to proceed without a clear indication of failure. It would be more robust to explicitly check the return value of file_get_contents().

        $composer_contents = file_get_contents( $project_composer );
        if ( false === $composer_contents ) {
            return;
        }
        $composer = json_decode( $composer_contents );

[gemini-code-assist]

Casting the result of file_get_contents() to (string) can mask file read errors. If file_get_contents() fails, it returns false, which becomes an empty string. This could lead to the if condition failing silently for the wrong reason. It's safer to check the return value of file_get_contents() explicitly before using it.

[gemini-code-assist]

For better cross-platform compatibility, DIRECTORY_SEPARATOR should be used here instead of a hardcoded forward slash (/) when constructing the destination path.

            $dest_path = $dest_dir . DIRECTORY_SEPARATOR . $iterator->getSubPathname();

[gemini-code-assist]

To ensure cross-platform compatibility, it's best to use the DIRECTORY_SEPARATOR constant instead of a hardcoded forward slash (/) for constructing paths.

        $dest_dir = $this->variables['RUN_DIR'] . DIRECTORY_SEPARATOR . $subdir;

[gemini-code-assist]

For consistency with the implementation in FeatureContext.php and for better robustness (e.g., to correctly handle symlinks), it's recommended to use getRealPath() instead of getPathname() when removing files and directories.

            if ( $file->isDir() ) {
                rmdir( $file->getRealPath() );
            } else {
                unlink( $file->getRealPath() );
            }