Download the PHP package adambrett/shell-wrapper without Composer
On this page you can find all versions of the php package adambrett/shell-wrapper. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download adambrett/shell-wrapper
More information about adambrett/shell-wrapper
Files in adambrett/shell-wrapper
Package shell-wrapper
Short Description An object oriented wrapper for shell commands
License BSD-3-Clause
Informations about the package shell-wrapper
PHP Shell Wrapper
PHP Shell Wrapper is a high level object-oriented wrapper for accessing the program execution functions in PHP.
Its primary purpose is to abstract away low level program execution functions in your application, allowing you to mock PHP Shell Wrapper in your tests, making applications which call shell functions easily testable.
Installation
Using composer:
Basic Usage
Hello World
Import the required classes into your namespace:
Instantiate a new shell runner:
Create the command:
Add some parameters:
Now run the command:
Which would run the command:
Command Builder
Whilst this library is highly object-oriented behind the scenes, you may not
want to use it that way, what's where the Command Builder comes in. The command
builder constructs a Command
object behind the scenes, and then constructs the
correct class for each method called, so you don't have to worry about it.
The Command Builder also has a fluent interface for extra syntactical sugar. Here's the above example re-written using the Command Builder:
And here's a slightly less trivial example:
Which would run:
and another:
Which would run:
Runners
Runners are paths directly in to the
PHP program execution functions, and map to them by name
exactly. Runners should all implement \AdamBrett\ShellWrapper\Runners\Runner
,
which means you can type hint on that whenever you need to use a shell and they
should then all be interchangeable.
Some runners will also implement \AdamBrett\ShellWrapper\Runners\ReturnValue
,
but only where that is appropriate to the low level function.
Some runners (marked *) only emulate command running. This feature useful for testing.
Runner | Returns | Flush | getOutput | getReturnValue |
---|---|---|---|---|
Exec | Last Line | x | x | |
Passthru | x | x | ||
ShellExec | Full Output or null |
|||
System | Last Line or false |
x | x | |
Dry* | Exit code | x | x | |
Fake* | Exit code | x | x |
You can use FakeRunner
in your unit tests to emulate running a command.
You can use DryRunner
for debugging purposes, or when your application uses
a --dry-run
type argument and you want to echo the command rather than run it.
SubCommands
Usage
Sub commands will not be escaped or modified in anyway, they are intended for use like so:
Which would run the command jekyll build
.
Arguments
Usage
$value
will be automatically escaped behind the scenes, but $name
will not,
so make sure you never have user input in $name
, or if you do, escape it
yourself.
If you want multiple arguments of the same name, then $value
can be an array,
like so:
Which would result in the following:
Flags
Usage
$flag
will not be escaped, but can be a string rather than a single character,
so new Flag('lla')
is perfectly valid.
Params
Usage
$param
will be automatically escaped behind the scenes, but will otherwise be
un-altered.
Requirements
- PHP >= 8.1
Contributing
Pull Requests
- Fork the php-shell-wrapper repository
- Create a new branch for each feature or improvement
- Send a pull request from each feature branch to the master branch
Style Guide
This package is compliant with PSR-4 and PSR-12. If you notice compliance oversights, please send a patch via pull request.
Tests
The library is developed using test driven development. All pull requests should be accompanied by passing unit tests with 100% coverage. phpunit is used for testing and mockery is used for mocks.