Shell.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Shell;
 
use MediaWiki\MediaWikiServices;
 
class Shell {
 
    public static function command( $command ) {
        $args = func_get_args();
        if ( count( $args ) === 1 && is_array( reset( $args ) ) ) {
            // If only one argument has been passed, and that argument is an array,
            // treat it as a list of arguments
            $args = reset( $args );
        }
        $command = MediaWikiServices::getInstance()
            ->getShellCommandFactory()
            ->create();
 
        return $command->params( $args );
    }
 
    public static function isDisabled() {
        static $disabled = null;
 
        if ( is_null( $disabled ) ) {
            if ( !function_exists( 'proc_open' ) ) {
                wfDebug( "proc_open() is disabled\n" );
                $disabled = true;
            } else {
                $disabled = false;
            }
        }
 
        return $disabled;
    }
 
    public static function escape( /* ... */ ) {
        $args = func_get_args();
        if ( count( $args ) === 1 && is_array( reset( $args ) ) ) {
            // If only one argument has been passed, and that argument is an array,
            // treat it as a list of arguments
            $args = reset( $args );
        }
 
        $first = true;
        $retVal = '';
        foreach ( $args as $arg ) {
            if ( $arg === null ) {
                continue;
            }
            if ( !$first ) {
                $retVal .= ' ';
            } else {
                $first = false;
            }
 
            if ( wfIsWindows() ) {
                // Escaping for an MSVC-style command line parser and CMD.EXE
                // @codingStandardsIgnoreStart For long URLs
                // Refs:
                //  * https://web.archive.org/web/20020708081031/http://mailman.lyra.org/pipermail/scite-interest/2002-March/000436.html
                //  * https://technet.microsoft.com/en-us/library/cc723564.aspx
                //  * T15518
                //  * CR r63214
                // Double the backslashes before any double quotes. Escape the double quotes.
                // @codingStandardsIgnoreEnd
                $tokens = preg_split( '/(\\\\*")/', $arg, -1, PREG_SPLIT_DELIM_CAPTURE );
                $arg = '';
                $iteration = 0;
                foreach ( $tokens as $token ) {
                    if ( $iteration % 2 == 1 ) {
                        // Delimiter, a double quote preceded by zero or more slashes
                        $arg .= str_replace( '\\', '\\\\', substr( $token, 0, -1 ) ) . '\\"';
                    } elseif ( $iteration % 4 == 2 ) {
                        // ^ in $token will be outside quotes, need to be escaped
                        $arg .= str_replace( '^', '^^', $token );
                    } else { // $iteration % 4 == 0
                        // ^ in $token will appear inside double quotes, so leave as is
                        $arg .= $token;
                    }
                    $iteration++;
                }
                // Double the backslashes before the end of the string, because
                // we will soon add a quote
                $m = [];
                if ( preg_match( '/^(.*?)(\\\\+)$/', $arg, $m ) ) {
                    $arg = $m[1] . str_replace( '\\', '\\\\', $m[2] );
                }
 
                // Add surrounding quotes
                $retVal .= '"' . $arg . '"';
            } else {
                $retVal .= escapeshellarg( $arg );
            }
        }
        return $retVal;
    }
}