pastuhov/php-exec-command

Simple php command executor with param binding.

1.1.0 2016-08-27 09:07 UTC

Requires

• php: >=5.3.0

Requires (Dev)

• phpunit/phpunit: 4.*
• scrutinizer/ocular: ~1.1

GPL-2.0

• Kirill Pastukhov

• command
• system
• exec

README

Simple php command executor with param binding.

Install

Via Composer

$ composer require pastuhov/php-exec-command

Features

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

Usage

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

or

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

or

    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:

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

Testing

$ composer test

or

$ phpunit

Security

If you discover any security related issues, please email [e-mail] instead of using the issue tracker.

Credits

• Kirill Pastukhov
• All Contributors

License

GNU General Public License, version 2. Please see License File for more information.