README.md

pickle - PHP Extension installer

Pickle installs PHP extensions easily on all platforms.

Installation and usage

Clone this repository and install dependencies with Composer:

$ composer install

Usage

Usage is prety straighforward. For example, to install the memcache extension run the following command:

$ bin/pickle install memcache

And then, run, in your extension directory, the following command:

The list of commands is available via

$ bin/pickle list

To get extended help for a given command, use:

$ bin/pickle help install

Contributing

Fork the project, create a feature branch and send us a pull request.

To ensure a consistent code base, you should make sure the code follows the PSR-1 and PSR-2 coding standards.

To avoid CS issues, you should use php-cs-fixer:

$ php-cs-fixer fix src/

Support

Support is available via the issue tracker in the Github project page or via IRC, EFNet, channel #pickle.

Running tests

Unit tests are written using atoum. You will get atoum, among other dependencies, when running composer install. To run tests, you will need to run the following command:

$ vendor/bin/atoum

# To run tests in a loop, ideal to do TDD
$ vendor/bin/atoum --loop

There are also some Behat tests. You will get Behat, among other dependencies, when running composer install. To run tests, you will need to run the following command:

$ vendor/bin/behat

# To choose the test suite you want to run
$ vendor/bin/behat -s pickle

Pickle is covered using 4 Behat tests suites:

• pickle runs tests against pickle's sources
• pickle_phar runs tests against pickle's Phar which you have to manually build
• pecl tests PECL extensions conversion with pickle's sources
• phar_pecl tests PECL extensions conversion with pickle's Phar