A thin wrapper around the Symfony Process Component that allows applications to use the Site Alias library to specify the target for a remote call.
Site Process is a thin wrapper around the Symfony Process Component that allows applications to use the Site Alias library to specify the target for a remote call.
For comparison purposes, the Process
obejct may be created to run an application on the local system using the standard Symfony Process Component API like so:
$process = new Process(['ls', '-lsa']);
Similarly, a remote call can be done using the general-purpose SiteProcess
API, which is accessible via the ProcessManager object:
$processManager = ProcessManager::createDefault();
$process = $processManager->siteProcess($site_alias, ['ls', '-lsa', '{root}']);
In this example, if $site_alias
represents a site on the same system, then the ls -lsa
command will run locally. If, on the other hand, it represents a remote site, then the ls -lsa
command will be wrapped in an ssh call to the remote system. In either case, the {root}
reference will be replaced with the value of the attribute of the site alias named root
. An exception will be thrown if the named attribute does not exist.
Options may also be specified as an associative array provided as a third parameter:
$process = $processManager->siteProcess($site_alias, ['git', 'status'], ['untracked-files' => 'no']);
This is equivalent to:
$process = $processManager->siteProcess($site_alias, ['git', '--untracked-files=no', 'status']);
The Symfony Process component has different typehints in the parameters of several APIs in Symfony 4 than Symfony 3 does. This is due to the fact that Symfony 4 requires PHP 7.1.3 or later, which supports a number of typehints not permitted in earlier PHP versions. This difference is minor for most clients, but presents problems for code that subclasses Process, as it is not possible to be compatible with both the Symofny 3 and the Symfony 4 typehints at the same time.
In the future, Symfony 4 will be supported in this library on a separate branch.
The test suite may be run locally by way of some simple composer scripts:
Test | Command |
---|---|
Run all tests | composer test |
PHPUnit tests | composer unit |
PHP linter | composer lint |
Code style | composer cs |
Fix style errors | composer cbf |
- Run
composer release
Please read CONTRIBUTING.md for details on the process for submitting pull requests to us.
We use SemVer for versioning. For the versions available, see the releases page.
See also the list of contributors who participated in this project.
This project is licensed under the MIT License - see the LICENSE file for details
- Thanks to PurpleBooth for the example README template