CommandFactory.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Shell;
 
use ExecutableFinder;
use Psr\Log\LoggerAwareTrait;
use Psr\Log\NullLogger;
 
class CommandFactory {
    use LoggerAwareTrait;
 
    private $limits;
 
    private $cgroup;
 
    private $doLogStderr = false;
 
    private $restrictionMethod;
 
    private $firejail;
 
    public function __construct( array $limits, $cgroup, $restrictionMethod ) {
        $this->limits = $limits;
        $this->cgroup = $cgroup;
        if ( $restrictionMethod === 'autodetect' ) {
            // On Linux systems check for firejail
            if ( PHP_OS === 'Linux' && $this->findFirejail() !== null ) {
                $this->restrictionMethod = 'firejail';
            } else {
                $this->restrictionMethod = false;
            }
        } else {
            $this->restrictionMethod = $restrictionMethod;
        }
        $this->setLogger( new NullLogger() );
    }
 
    protected function findFirejail(): ?string {
        if ( $this->firejail === null ) {
            // Convert a `false` from ExecutableFinder to `null` (T257282)
            $this->firejail = ExecutableFinder::findInDefaultPaths( 'firejail' ) ?: null;
        }
 
        return $this->firejail;
    }
 
    public function logStderr( bool $yesno = true ): void {
        $this->doLogStderr = $yesno;
    }
 
    public function create(): Command {
        if ( $this->restrictionMethod === 'firejail' ) {
            $command = new FirejailCommand( $this->findFirejail() );
            $command->restrict( Shell::RESTRICT_DEFAULT );
        } else {
            $command = new Command();
        }
        $command->setLogger( $this->logger );
 
        return $command
            ->limits( $this->limits )
            ->cgroup( $this->cgroup )
            ->logStderr( $this->doLogStderr );
    }
}