We provide and maintain SDKs for the benefit of our developer community. Feedback, detailed bug reports, and focused PRs are always appreciated. Thank you in advance!
When contributing to this SDK, please:
- Maintain the minimum PHP version (found under
require.phpincomposer.jsonfor the branch). - Code to the PSR-2 standard.
- Run
composer pre-commitfor the whole project before submitting your PR for review. You can add this to a pre-commit hook with the following:
echo '#!/bin/sh' > .git/hooks/pre-commit && echo 'composer pre-commit' >> .git/hooks/pre-commit- Run
composer phpcsfor the changed PHP files before submitting your PR for review (optional). - Keep PRs focused and change the minimum number of lines to achieve your goal.
Prior to making a PR, make sure the static analysis suite detects no defects:
composer static-analysis
Prior to making a PR, ensure that the unit tests pass:
composer test-unit
The integration tests require a tenant and Auth0 Application configured with the following:
- The Application must be of type Machine-to-Machine and have the Management API authorized
- The tenant must have the default Database connection named "Username-Password-Authentication", and it must not have the "Requires Username" enabled
- The tenant must have at least two rules (they can be empty rules)
You will also need to create a .env file in the root of this package with the following entries:
DOMAIN- Auth0 domain for your test tenantAPP_CLIENT_ID- Client ID for a Machine-to-Machine Application within your test tenantAPP_CLIENT_SECRET- Client Secret for a Machine-to-Machine Application within your test tenant
This file is automatically excluded from Git with the
.gitignorefor this repo.
To run the integration tests:
composer test-integration