That you're reading this must mean you consider contributing to this package. So first off: Awesome! 👍🤘
In case you encounter any bugs please
file an issue.
Describe the issue as well as you can and provide an example to
reproduce it.
Maybe you're not 100 percent sure whether what you've discovered
is a bug or the intended behavior. You can still file an issue
and tell us which results you'd expect.
If you know how to fix the issue you're welcome to send a pull request. 💪
If you have ideas for new features you can tell us about it on Twitter or via crwlr.software or just send a pull request. Please keep in mind that there is no guarantee that your feature will be merged.
This package follows the
PSR-12 coding standard.
You can run PHP CS Fixer via composer cs
for a dry run or
composer cs-fix
to automatically fix code style issues.
When you're making changes to this package please always run
tests and linting. Commands:
composer test
composer test-integration
composer cs
composer stan
Ideally you add the pre-commit git hook that is shipped with
this repo that will run tests and linting. Add it to your local
clone by running:
composer add-git-hooks
The integration tests start a simple PHP web server for the testing purpose on port 8000. If you have anything else running on that port, the integration tests won't work.
Also, please don't forget to add new test cases if necessary.
For any code change that changes/adds something for users of
the package, please don't forget to add an entry to the
CHANGELOG.md
file.
When your pull request is merged I will show some love and tweet about it. Also, if you meet me in person I will be glad to buy you a beer.