Contributions are welcome and will be fully credited.
We accept contributions via pull requests on Github.
Please make all pull requests to the
develop branch, not the
Before posting an issue
- If a command is failing, post the full output you get when running the command, with the
- If everything looks normal in said log, provide a log with the
- Symfony Coding Standard - The easiest way to apply the conventions is to run
- Add tests! - Your patch won't be accepted if it doesn't have tests.
- Document any change in behaviour - Make sure the
README.mdand any other relevant documentation are kept up-to-date.
- Consider our release cycle - We try to follow SemVer v2.0.0. Randomly breaking public APIs is not an option.
- Create feature branches - Don't ask us to pull from your master branch.
- One pull request per feature - If you want to do more than one thing, send multiple pull requests.
- Send coherent history - Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please squash them before submitting.
Building the PHAR
Once you cloned the repository in local, in order to test your changes, two solutions :
- You can execute
php bin/rocketeerwhich is what gets compiled as the entry point of the PHAR. This will directly read the files of the repository.
- You can also compile the PHAR by doing
composer buildwhich will output to
bin/rocketeer.phar. In order to compile it you'll need to have the
phar.readonlyset to Off in your
$ composer test