Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
When reporting issues, please try to be as descriptive as possible, and include as much relevant information as you can. A step by step guide on how to reproduce the issue will greatly increase the chances of your issue being resolved in a timely manner.
Our contributing policy is described in our Coding Guideline
If you want to contribute to the repository you will need to install/configure some things first.
To run tests follow the steps:
- Run
./bin/ci/scripts/install_dependencies.sh - Run
./vendor/bin/phpcs lib/ --report=summary - Run
./vendor/bin/phpmd lib/ ansi phpmd.xml - Run
./vendor/bin/phpstan analyse lib/ -c phpstan_lite.neon 2>&1 - Run
php -f ./bin/ci/run_tests.php
If you are on Windows environment simply run the file quality.bat located at the root of the project to run the step 2, 3 and 4 in once.
The last command will run all the unit tests of the project. If an error appears, fix it then you can submit your pull request.
Some tests will be skipped if you don't have special dependencies installed (Arangodb, Couchbase, Couchdb, Firestore credential and SDK, Dynamodb credential, etc.).
So don't worry if those tests are skipped as long as they pass on the GitHub and Travis CIs.