Giter VIP home page Giter VIP logo

composer-package-template's Introduction

Composer Package Template

Latest Stable Version License composer.lock Total Downloads

If you are trying to create a new PHP Composer package, whether it is going to be submitted to packagist.org or just to exist in your Github account, this template package of files will surely help you make the process a lot easier and faster.

Requirements

  • PHP >= 7.0;
  • composer.

Features

  • PSR-4 autoloading compliant structure;
  • PSR-2 compliant code style;
  • Unit-Testing with PHPUnit 6;
  • Comprehensive guide and tutorial;
  • Easy to use with any framework or even a plain php file;
  • Useful tools for better code included.

Installation

composer create-project gino-pane/composer-package-template yourproject

This will create a basic project structure for you:

  • /build is used to store code coverage output by default;
  • /src is where your codes will live in, each class will need to reside in its own file inside this folder;
  • /tests each class that you write in src folder needs to be tested before it was even "included" into somewhere else. So basically we have tests classes there to test other classes;
  • .gitignore there are certain files that we don't want to publish in Git, so we just add them to this fle for them to "get ignored by git";
  • CHANGELOG.md to keep track of package updates;
  • CONTRIBUTION.md Contributor Covenant Code of Conduct;
  • LICENSE terms of how much freedom other programmers is allowed to use this library;
  • README.md it is a mini documentation of the library, this is usually the "home page" of your repo if you published it on GitHub and Packagist;
  • composer.json is where the information about your library is stored, like package name, author and dependencies;
  • phpunit.xml It is a configuration file of PHPUnit, so that tests classes will be able to test the classes you've written;
  • .travis.yml basic configuration for Travis CI with configured test coverage reporting for code climate.

Please refer to original article for more information.

Useful Tools

Running Tests:

php vendor/bin/phpunit

or

composer test

Code Sniffer Tool:

php vendor/bin/phpcs --standard=PSR2 src/

or

composer psr2check

Code Auto-fixer:

php vendor/bin/phpcbf --standard=PSR2 src/ 

or

composer psr2autofix

Building Docs:

php vendor/bin/phpdoc -d "src" -t "docs"

or

composer docs

Changelog

To keep track, please refer to CHANGELOG.md.

Contributing

  1. Fork it.
  2. Create your feature branch (git checkout -b my-new-feature).
  3. Make your changes.
  4. Run the tests, adding new ones for your own code if necessary (phpunit).
  5. Commit your changes (git commit -am 'Added some feature').
  6. Push to the branch (git push origin my-new-feature).
  7. Create new pull request.

Also please refer to CONTRIBUTION.md.

License

Please refer to LICENSE.

composer-package-template's People

Contributors

buonzz avatar ginopane avatar paperdarwin avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.