pastuhov/php-exec-command

Simple php command executor with param binding.

php-exec-command

, _(*1)

Simple php command executor with param binding., _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require pastuhov/php-exec-command, <sub>(*4)</sub>

## Features

* light weight
* param binding
* throws an exception if return status >0
* redirect stderr to stdout if needed

## Usage

```php
    $output = Command::exec(
        'echo {phrase}',
        [
            'phrase' => 'hello'
        ]
    );
    // $output = 'hello'

or, <sub>(*5)</sub>

    $output = Command::exec(
        'echo {phrase}',
        [
            'phrase' => [
                'hello',
                'world'
            ]
        ]
    );
    // $output = 'hello world'

or, <sub>(*6)</sub>

    try {
        Command::exec('locate {parody}',
            [
                'parody' => [
                    'pink_unicorn'
                ]
            ]
        );    

        echo "unicorn was found!";
    } catch (\pastuhov\Command\CommandException $e) {
        echo "can't find unicorn :(";
    }

By default, all arguments are escaped using escapeshellarg. If you need to pass unescaped arguments, use {!name!}, like so:, <sub>(*7)</sub>

Command::exec('echo {!path!}', ['path' => '$PATH']);

Testing

``` bash $ composer test, <sub>(*8)</sub>

or
```bash
$ phpunit

Security

If you discover any security related issues, please email kirill@pastukhov.su instead of using the issue tracker., <sub>(*9)</sub>

Credits

• Kirill Pastukhov
• All Contributors

License

GNU General Public License, version 2. Please see License File for more information., <sub>(*10)</sub>