ddrv/shell

Shell abstraction

v0.9.6 2019-09-13 08:55 UTC

Requires

• php: >=7.2

MIT

• Ivan Dudarev

• console
• shell

README

Install

composer require ddrv/shell

Usage

Local

<?php

$shell = new Ddrv\Shell\LocalShell('/tmp', ['APP_ENV' => 'test', 'APP_SECRET' => '$3cr3t'], true);

/* or
$shell = new Ddrv\Shell\LocalShell();
$shell
    ->setCwd('/tmp')
    ->setEnv('APP_ENV', 'test')
    ->setEnv('APP_SECRET', '$3cr3t')
    ->mergeErrorsAndOutput();
*/

$result = $shell->exec('ls -l');

var_dump($result->getExitCode()); // 0
var_dump($result->getOutput()); // list directories in /tmp
var_dump($result->getErrors()); // null

Descriptors

<?php

use Ddrv\Shell\Contract\ShellInterface;
use Ddrv\Shell\Descriptor\WritablePipe;
use Ddrv\Shell\Descriptor\ReadablePipe;
use Ddrv\Shell\Descriptor\File;

/** @var ShellInterface $shell */
$shell->setDescriptor(new WritablePipe(), ShellInterface::DESCRIPTOR_INPUT);
$shell->setDescriptor(new File('/tmp/out.txt', 'a'), ShellInterface::DESCRIPTOR_OUTPUT);
$shell->setDescriptor(new ReadablePipe(), ShellInterface::DESCRIPTOR_ERRORS);