Contributing to the AWS SDK for PHP
We work hard to provide a high-quality and useful SDK for our AWS services, and we greatly value feedback and contributions from our community. Please submit your issues or pull requests through GitHub.
Things to keep in mind
- The SDK is released under the Apache license. Any code you submit will be released under that license. For substantial contributions, we may ask you to sign a Contributor License Agreement (CLA).
- We follow all of the relevant PSR recommendations from the PHP Framework Interop Group. Please submit code that follows these standards. The PHP CS Fixer tool can be helpful for formatting your code.
- We maintain a high percentage of code coverage in our unit tests. If you make changes to the code, please add, update, and/or remove tests as appropriate.
- We may choose not to accept pull requests that change files in the
src/datadirectory, since we generate these files based on our internal knowledge of the AWS services. Please check in with us ahead of time if you find a mistake or missing feature that would affect those files.
- If your code does not conform to the PSR standards or does not include adequate tests, we may ask you to update your pull requests before we accept them. We also reserve the right to deny any pull requests that do not align with our standards or goals.
- If you would like to implement support for a significant feature that is not yet available in the SDK, please talk to us beforehand to avoid any duplication of effort.
- We greatly appreciate contributions to our User Guide. The docs are written
as a Sphinx website formatted with reStructuredText (very similar to
Markdown). The User Guide is located in the
docsdirectory of this repository. Please see the docs README for more information about how to build the User Guide.
- If you are working on the SDK, make sure to check out the
Makefilefor some of the common tasks that we have to do.