Download the PHP package consolidation/site-process without Composer
On this page you can find all versions of the php package consolidation/site-process. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download consolidation/site-process
More information about consolidation/site-process
Files in consolidation/site-process
Package site-process
Short Description 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.
License MIT
Informations about the package site-process
Site Process
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.
Overview
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
object may be created to run an application on the local system using the standard Symfony Process Component API like so:
Similarly, a remote call can be done using the general-purpose SiteProcess
API, which is accessible via the ProcessManager object:
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:
This is equivalent to:
Transports
SSH
Wraps a command so that it runs on a remote system via the ssh cli.
Example:
Vagrant
Wraps commands so they run with vagrant ssh -c
.
Example:
Docker Compose
Wraps a command so that it runs on a remote system via docker-compose.
Example:
The above would execute commands prefixed with:
docker.project
and compose.options --project
do the same thing, docker.project existed before options.
docker.service
is the exact name of the service as it appears in docker-compose.yml
docker.compose.version
defaults to 1
. Set to 2
to use the new syntax:
The default behaviour is to use docker-compose exec
to invoke a command on a running container.
You can change this to use docker-compose run
for containers which by default are not running, with the property compose.command
.
Check the docker-compose manual for all available options.
Local
Runs the command on the local system.
Running the tests
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 |
Deployment
- Run
composer release
Contributing
Please read CONTRIBUTING.md for details on the process for submitting pull requests to us.
Versioning
We use SemVer for versioning. For the versions available, see the releases page.
Branch | Symfony Versions | PHP Versions | |
---|---|---|---|
main (5.x) | ^5 | ^6 | 8.0+ |
4.x | ^4 | 7.1+ | |
2.x | ^2 | ^3 | 5.6+ |
Note that all 3.x releases of consolidation/site-process were skipped simply to align the 4.x versions with Symfony 4.x support.
Note that the API of consolidation/site-process itself is compatible between the 2.x and 4.x versions, so most clients that work with both Symfony 3 and Symfony 4 should be able to require "consolidation/site-process": "^2 | ^4"
without problems.
Authors
See also the list of contributors who participated in this project.
License
This project is licensed under the MIT License - see the LICENSE file for details
Acknowledgments
- Thanks to PurpleBooth for the example README template
All versions of site-process with dependencies
consolidation/config Version ^2 || ^3
consolidation/site-alias Version ^3 || ^4
symfony/process Version ^6 || ^7
symfony/console Version ^5.4 || ^6 || ^7