<?php

use WP_CLI\Utils;

class EvalFile_Command extends WP_CLI_Command {

    /**
     * Regular expression pattern to match the shell shebang.
     *
     * @var string
     */
    const SHEBANG_PATTERN = '/^(#!.*)$/m';

    /**
     * Loads and executes a PHP file.
     *
     * Note: because code is executed within a method, global variables need
     * to be explicitly globalized.
     *
     * ## OPTIONS
     *
     * <file>
     * : The path to the PHP file to execute.  Use '-' to run code from STDIN.
     *
     * [<arg>...]
     * : One or more positional arguments to pass to the file. They are placed in the $args variable.
     *
     * [--skip-wordpress]
     * : Load and execute file without loading WordPress.
     *
     * [--use-include]
     * : Process the provided file via include instead of evaluating its contents.
     *
     * @when before_wp_load
     *
     * ## EXAMPLES
     *
     *     # Execute file my-code.php and pass value1 and value2 arguments.
     *     # Access arguments in $args array ($args[0] = value1, $args[1] = value2).
     *     $ wp eval-file my-code.php value1 value2
     */
    public function __invoke( $args, $assoc_args ) {
        $file = array_shift( $args );

        if ( '-' !== $file && ! file_exists( $file ) ) {
            WP_CLI::error( "'$file' does not exist." );
        }

        $use_include = Utils\get_flag_value( $assoc_args, 'use-include', false );

        if ( '-' === $file && $use_include ) {
                WP_CLI::error( '"-" and "--use-include" parameters cannot be used at the same time' );
        }

        if ( null === Utils\get_flag_value( $assoc_args, 'skip-wordpress' ) ) {
            WP_CLI::get_runner()->load_wordpress();
        }

        self::execute_eval( $file, $args, $use_include );
    }

    /**
     * Evaluate a provided file.
     *
     * @param string $file Filepath to execute, or - for STDIN.
     * @param mixed  $args Array of positional arguments to pass to the file.
     * @param bool $use_include Process the provided file via include instead of evaluating its contents.
     */
    private static function execute_eval( $file, $args, $use_include ) {
        if ( '-' === $file ) {
            eval( '?>' . file_get_contents( 'php://stdin' ) );
        } elseif ( $use_include ) {
            include $file;
        } else {
            $file_contents = (string) file_get_contents( $file );

            // Adjust for __FILE__ and __DIR__ magic constants.
            $file_contents = Utils\replace_path_consts( $file_contents, $file );

            // Check for and remove she-bang.
            if ( 0 === strncmp( $file_contents, '#!', 2 ) ) {
                $file_contents = preg_replace( static::SHEBANG_PATTERN, '', $file_contents );
            }

            eval( '?>' . $file_contents );
        }
    }
}