Notice: This an alpha-quality software at the moment. Do NOT use in production anything!!
This repository is meant to be a blank composer package template with a few configuration niceties already established. This includes integrated "support" for PHPUnit, Travis CI, Composer, and more. Even this README.md could serve as a template for your own package documentation. Just add/remove sections as needed.
- Bootstrap the process of creating a composer package.
This package is compliant with PSR-1, PSR-2 and PSR-4. If you notice compliance oversights, please send a patch via pull request.
Via Composer
{
"require": {
"vendor/package": "dev-master"
}
}
The following versions of PHP are supported by this version.
- PHP 5.3
- PHP 5.4
- PHP 5.5
It is typical to include documentation about folks use the packages you write… my work here is done.
// Handle some business
- Add usage documentation.
- Substitute all references of
vendor/package
with your own. - Update list of supported PHP versions.
- Add your own flair!
$ phpunit
Contributions are welcome and will be fully credited.
We accept contributions via Pull Requests on Github.
-
PSR-2 Coding Standard - The easiest way to apply the conventions is to install PHP Code Sniffer.
-
Add tests! - Your patch won't be accepted if it doesn't have tests.
-
Document any change in behaviour - Make sure the README and any other relevant documentation are kept up-to-date.
-
Consider our release cycle - We try to follow semver. Randomly breaking public APIs is not an option.
-
Create topic 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.
$ phpunit
Happy coding!
- Phil Sturgeon for documentation format. Stole!
The MIT License (MIT). Please see License File for more information.