PHPackages                             khs1994/pickle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. khs1994/pickle

ActiveApplication[Utility &amp; Helpers](/categories/utility)

khs1994/pickle
==============

Installer for PHP extension, supports pecl package or install from src tree directly

v19.11.11(6y ago)29PHP-3.01PHPPHP &gt;=5.4CI failing

Since Jul 11Pushed 7mo ago1 watchersCompare

[ Source](https://github.com/khs1994-php/pickle)[ Packagist](https://packagist.org/packages/khs1994/pickle)[ Docs](https://github.com/FriendsOfPHP/pickle)[ RSS](/packages/khs1994-pickle/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (1)Dependencies (10)Versions (9)Used By (0)

pickle - PHP Extension installer [![SensioLabsInsight](https://camo.githubusercontent.com/ba8699cb526a1ed011c0b44fa19d47bb6af69e753f6134a32ca40e5fc616497d/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f37653135336430342d373962652d343765362d623265652d3630636463323636356464352f736d616c6c2e706e67)](https://insight.sensiolabs.com/projects/7e153d04-79be-47e6-b2ee-60cdc2665dd5)
=======================================================================================================================================================================================================================================================================================================================================================================================================================

[](#pickle---php-extension-installer-)

Pickle installs PHP extensions easily on all platforms.

[![Code Climate](https://camo.githubusercontent.com/163529909f69bdf34530a9462e1044c1e807b1e4ddef06e4c5fd4da0161c6d5e/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f467269656e64734f665048502f7069636b6c652e737667)](https://codeclimate.com/github/FriendsOfPHP/pickle)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/69dcf92f03e104f189573f60f8b6565f5c6be55997e385062868923be61768b0/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f467269656e64734f665048502f7069636b6c652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/FriendsOfPHP/pickle/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/5412d5b5ddc1a802ee8aa9e20d84b12cf45125c46c71cd7e91f9eb2ef1fc2002/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f467269656e64734f665048502f7069636b6c652f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/FriendsOfPHP/pickle/?branch=master)[![Build Status](https://camo.githubusercontent.com/dcfce6bc7f2a84c4dccd93b8c05926b04d432c4929788f642f15c58df3cd8156/68747470733a2f2f7472617669732d63692e636f6d2f6b6873313939342d7068702f7069636b6c652e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/khs1994-php/pickle)

Compare Upstream
----------------

[](#compare-upstream)

-
- 不维护 HHVM 部分

TODO
----

[](#todo)

path arg
--------

[](#path-arg)

- 支持传入多个 path `$ pickle install xdebug yaml curl`
- pecl name (yaml yaml-beta yaml-x.y.z)
- git url ()
- local dir (/tmp/yaml)

```
.
├── 6efa6058386c5a7af3e8f944c716fe27.tar
├── package.xml
└── yaml-2.0.4
```

- archive ()

convert to composer.json
------------------------

[](#convert-to-composerjson)

```
{
    "name": "yaml",
    "type": "extension",
    "license": [
        "MIT"
    ],
    "authors": [
        {
            "name": "Bryan Davis",
            "email": "bd808@bd808.com"
        }
    ],
    "description": "YAML-1.1 parser and emitter",
    "extra": {
        "configure-options": {
            "with-yaml": {
                "default": "autodetect",
                "prompt": "Please provide the prefix of libyaml installation"
            }
        }
    }
}
```

Introduction
------------

[](#introduction)

Pickle is a new PHP extension installer. It is based on Composer and the plan is to get Composer to fully support it. See [composer/composer#2898 (comment)](https://github.com/composer/composer/pull/2898#issuecomment-48439196) for the Composer part of the discussions.

Pickle fully supports existing extensions in , running the following will install the latest available version of the memcache extension:

```
$ bin/pickle install memcache
```

Windows is fully supported, to install binaries or from the sources (work in progress and given that you have a working build environment in place).

The concept behind Pickle is to ease the life of both developers and end users.

For end users, nothing changes much except that Pickle is based on modern concepts and works with multiple protocols (git or http(s) URLs).

For developers, it drastically reduces the release work. Extension meta information is not duplicated anymore. Configuration options, files to package etc. are automatically fetched from the sources and the respective files are updated during the release process. There is no risk anymore of forgetting to update the version here or there, or to neglect to include a file.

Installation
------------

[](#installation)

Clone this repository and install the dependencies with [Composer](http://getcomposer.org/):

```
$ composer install
```

A [phar is also available](https://github.com/FriendsOfPHP/pickle/releases/download/v0.4.0/pickle.phar), but it might be outdated.

If you like to create your own phar from the pickle sources, you will need to install Box (). Then clone the repository and run the following commands:

```
$ cd pickle
$ composer install --no-dev --optimize-autoloader
$ php -d phar.readonly=0 box.phar build
```

Usage
-----

[](#usage)

Usage is pretty straightforward. For example, to install the memcache extension run the following command:

```
$ bin/pickle install memcache
```

You can also use pickle from your extension directory, the following command:

```
$ cd myext
$ bin/pickle install
```

A list of the commands is available using:

```
$ bin/pickle list
```

To get extended help for a given command, use:

```
$ bin/pickle help install
```

To convert a package (based on package.xml current PECL installer), use:

```
$ bin/pickle convert /home/pierre/myext/
```

Or run it from the extension source directory.

Contributing
------------

[](#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](http://www.php-fig.org/psr/psr-1/) and [PSR-2](http://www.php-fig.org/psr/psr-2/) coding standards.

To avoid CS issues, you should use [php-cs-fixer](http://cs.sensiolabs.org/):

```
$ php-cs-fixer fix src/
```

Support
-------

[](#support)

Support is available via the [issue tracker](https://github.com/FriendsOfPHP/pickle/issues) in the Github project page or via [IRC, EFNet, channel `#pickle`](http://chat.efnet.org/).

Running tests
-------------

[](#running-tests)

Unit tests are written using [atoum](https://github.com/atoum/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](https://github.com/behat/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

###  Health Score

35

—

LowBetter than 79% of packages

Maintenance44

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~278 days

Recently: every ~434 days

Total

8

Last Release

2377d ago

Major Versions

v0.4.0 → v19.11.82019-11-08

PHP version history (2 changes)v0.1.0PHP ~5.4

v0.3.0PHP &gt;=5.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/69941311121544acc11e09be153f827d1c02ba629fba7b09bea32a96b92d8274?d=identicon)[khs1994](/maintainers/khs1994)

---

Top Contributors

[![weltling](https://avatars.githubusercontent.com/u/22016?v=4)](https://github.com/weltling "weltling (245 commits)")[![pierrejoye](https://avatars.githubusercontent.com/u/282408?v=4)](https://github.com/pierrejoye "pierrejoye (148 commits)")[![jubianchi](https://avatars.githubusercontent.com/u/327237?v=4)](https://github.com/jubianchi "jubianchi (89 commits)")[![Hywan](https://avatars.githubusercontent.com/u/946104?v=4)](https://github.com/Hywan "Hywan (45 commits)")[![khs1994](https://avatars.githubusercontent.com/u/16733187?v=4)](https://github.com/khs1994 "khs1994 (37 commits)")[![pborreli](https://avatars.githubusercontent.com/u/77759?v=4)](https://github.com/pborreli "pborreli (32 commits)")[![Seldaek](https://avatars.githubusercontent.com/u/183678?v=4)](https://github.com/Seldaek "Seldaek (8 commits)")[![keradus](https://avatars.githubusercontent.com/u/2716794?v=4)](https://github.com/keradus "keradus (5 commits)")[![harikt](https://avatars.githubusercontent.com/u/120454?v=4)](https://github.com/harikt "harikt (4 commits)")[![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (1 commits)")[![romainneutron](https://avatars.githubusercontent.com/u/137574?v=4)](https://github.com/romainneutron "romainneutron (1 commits)")[![staabm](https://avatars.githubusercontent.com/u/120441?v=4)](https://github.com/staabm "staabm (1 commits)")[![stevelacey](https://avatars.githubusercontent.com/u/289531?v=4)](https://github.com/stevelacey "stevelacey (1 commits)")[![stof](https://avatars.githubusercontent.com/u/439401?v=4)](https://github.com/stof "stof (1 commits)")[![teohhanhui](https://avatars.githubusercontent.com/u/548843?v=4)](https://github.com/teohhanhui "teohhanhui (1 commits)")[![TomasVotruba](https://avatars.githubusercontent.com/u/924196?v=4)](https://github.com/TomasVotruba "TomasVotruba (1 commits)")[![ivan1986](https://avatars.githubusercontent.com/u/156418?v=4)](https://github.com/ivan1986 "ivan1986 (1 commits)")[![fabpot](https://avatars.githubusercontent.com/u/47313?v=4)](https://github.com/fabpot "fabpot (1 commits)")[![mbrodala](https://avatars.githubusercontent.com/u/5037116?v=4)](https://github.com/mbrodala "mbrodala (1 commits)")[![duncan3dc](https://avatars.githubusercontent.com/u/546811?v=4)](https://github.com/duncan3dc "duncan3dc (1 commits)")

###  Code Quality

TestsBehat

### Embed Badge

![Health badge](/badges/khs1994-pickle/health.svg)

```
[![Health](https://phpackages.com/badges/khs1994-pickle/health.svg)](https://phpackages.com/packages/khs1994-pickle)
```

###  Alternatives

[symfony/maker-bundle

Symfony Maker helps you create empty commands, controllers, form classes, tests and more so you can forget about writing boilerplate code.

3.4k111.1M568](/packages/symfony-maker-bundle)[symplify/monorepo-builder

Not only Composer tools to build a Monorepo.

5205.3M82](/packages/symplify-monorepo-builder)[roave/backward-compatibility-check

Tool to compare two revisions of a public API to check for BC breaks

5953.3M56](/packages/roave-backward-compatibility-check)[coenjacobs/mozart

Composes all dependencies as a package inside a WordPress plugin

4723.6M20](/packages/coenjacobs-mozart)[friendsofphp/pickle

Installer for PHP extension, supports pecl package or install from src tree directly

1.7k3.3k](/packages/friendsofphp-pickle)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

96374.6k23](/packages/friendsoftypo3-content-blocks)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
