icyboy/shellwrap

Use any command-line tool as a PHP function.

ShellWrap

What is it?

It's a beautiful way to use powerful Linux/Unix tools in PHP. Easily and logically pipe commands together, capture errors as PHP Exceptions and use a simple yet powerful syntax. Works with any command line tool automagically., _(*1)

Features

• Flexible and sexy syntax.
• Exceptions are thrown if the executable returns an error.
• Paths to binaries are automatically resolved.
• All arguments are properly escaped.

Examples

 true
)));

// Touch a file to create it
sh::touch('file.html');

// Remove file
sh::rm('file.html');

// Remove file again (this fails, and throws an exception because the file doesn't exist)

try {
    sh::rm('file.html');
} catch (ShellWrapException $e) {
    echo 'Caught failing sh::rm() call';
}


// This throws an exception, as 'invalidoption' is not a valid argument
try {
    echo sh::ls(array('invalidoption' => true));
} catch (ShellWrapException $e) {
    echo 'Caught failing sh::ls() call';
}

// Commands can be written multiple ways
sh::git('reset', array('hard' => true), 'HEAD');
sh::git('reset', '--hard', 'HEAD');
sh::git(array('reset', '--hard', 'HEAD'));

// Arguments passed in are automatically escaped, this expands to
// date --date '2012-10-10 10:00:00'
echo sh::date(array(
    'date' => '2012-10-10 10:00:00'
));

// If arg keys are one letter, is assumes one dash prefixing it
// date -d '2012-10-10 10:00:00'
echo sh::date(array(
    'd' => '2012-10-10 10:00:00'
));


?>

Example: Tailing a file and adding timestamps to output

You can stream the output of a command into a callback function. For example:, _(*2)

sh::tail('-f log', function($in) {
    echo "\033[32m" . date('Y-m-d H:i:s') . "\033[39m " . $in;
});

Make sure the file 'log' exists. This will output a timestamp, and the input. Try echoing into the log file., _(*3)

The escape codes are to add a little colour to the terminal., _(*4)

Interactive Shell

ShellWrap also ships with an interactive shell mode. You can access this by typing:, _(*5)

./bin/shellwrap

Warning

Don't use any user inputted data with these commands. Even with very paranoid filtering, you can't know all the potential pitfalls of each command you're using. Use your noggin., _(*6)

Acknowledgements

Inspired by the Python project sh by Andrew Moffat, _(*7)