prepare 0.6.0 v0.6.0
authorMichael Wallner <mike@php.net>
Sat, 5 Sep 2015 13:14:12 +0000 (15:14 +0200)
committerMichael Wallner <mike@php.net>
Sat, 5 Sep 2015 13:14:12 +0000 (15:14 +0200)
.gitattributes [new file with mode: 0644]
package.xml
php_pq.h
raphf-1.1.0.ext.phar [new file with mode: 0755]

diff --git a/.gitattributes b/.gitattributes
new file mode 100644 (file)
index 0000000..4ae09e1
--- /dev/null
@@ -0,0 +1,2 @@
+package.xml            merge=touch
+php_pq.g               merge=touch
index 67cbe83c90ffeb64d754e9df6f0a06396d9fc3dd..4a97e8ef312d04945b308a700e6d93a0568726a5 100644 (file)
@@ -13,17 +13,17 @@ http://pear.php.net/dtd/package-2.0.xsd">
  <channel>pecl.php.net</channel>
  <summary>PostgreSQL client library (libpq) binding</summary>
  <description>
- Documents: http://devel-m6w6.rhcloud.com/mdref/pq
+ Documents: https://mdref.m6w6.name/pq
  
  Highlights:
  * Nearly complete support for asynchronous usage:
-   http://devel-m6w6.rhcloud.com/mdref/pq/Connection/%3A%20Asynchronous%20Usage
+   https://mdref.m6w6.name/pq/Connection/%3A%20Asynchronous%20Usage
  * Extended type support by pg_type:
-   http:/devel-m6w6.rhcloud.com/mdref/pq/Types/%3A%20Overview
+   https://mdref.m6w6.name/pq/Types/%3A%20Overview
  * Fetching simple multi-dimensional array maps:
-   http:/devel-m6w6.rhcloud.com/mdref/pq/Result/map
+   https://mdref.m6w6.name/pq/Result/map
  * Working Gateway implementation: 
-   https://http://devel-m6w6.rhcloud.com/mdref/pq-gateway
+   https://mdref.m6w6.name/pq-gateway
  </description>
  <lead>
   <name>Michael Wallner</name>
@@ -37,9 +37,9 @@ http://pear.php.net/dtd/package-2.0.xsd">
   <email>daverandom@php.net</email>
   <active>yes</active>
  </developer>
- <date>2015-07-28</date>
+ <date>2015-09-05</date>
  <version>
-  <release>0.6.0RC2</release>
+  <release>0.6.0</release>
   <api>0.6.0</api>
  </version>
  <stability>
@@ -160,7 +160,9 @@ Changes from RC1:
  <dependencies>
   <required>
    <php>
-    <min>5.4</min>
+    <min>5.4.0</min>
+    <max>7.0.0</max>
+    <exclude>7.0.0</exclude>
    </php>
    <pearinstaller>
     <min>1.4.0</min>
index 3b26130e390318d8bc5424a9da34935f5966a52c..ef7d2dd3018feb21b711e666cee01eb7a5c8690d 100644 (file)
--- a/php_pq.h
+++ b/php_pq.h
@@ -14,7 +14,7 @@
 #ifndef PHP_PQ_H
 #define PHP_PQ_H
 
-#define PHP_PQ_VERSION "0.6.0RC2"
+#define PHP_PQ_VERSION "0.6.0"
 
 #ifdef PHP_WIN32
 #      define PHP_PQ_API __declspec(dllexport)
diff --git a/raphf-1.1.0.ext.phar b/raphf-1.1.0.ext.phar
new file mode 100755 (executable)
index 0000000..7152acb
--- /dev/null
@@ -0,0 +1,6240 @@
+#!/usr/bin/env php
+<?php
+
+/**
+ * The installer sub-stub for extension phars
+ */
+
+namespace pharext;
+
+define("PHAREXT_PHAR", __FILE__);
+
+spl_autoload_register(function($c) {
+       return include strtr($c, "\\_", "//") . ".php";
+});
+
+
+
+namespace pharext;
+
+class Exception extends \Exception
+{
+       public function __construct($message = null, $code = 0, $previous = null) {
+               if (!isset($message)) {
+                       $last_error = error_get_last();
+                       $message = $last_error["message"];
+                       if (!$code) {
+                               $code = $last_error["type"];
+                       }
+               }
+               parent::__construct($message, $code, $previous);
+       }
+}
+
+
+
+namespace pharext;
+
+use pharext\Exception;
+
+/**
+ * A temporary file/directory name
+ */
+class Tempname
+{
+       /**
+        * @var string
+        */
+       private $name;
+
+       /**
+        * @param string $prefix uniqid() prefix
+        * @param string $suffix e.g. file extension
+        */
+       public function __construct($prefix, $suffix = null) {
+               $temp = sys_get_temp_dir() . "/pharext-" . $this->getUser();
+               if (!is_dir($temp) && !mkdir($temp, 0700, true)) {
+                       throw new Exception;
+               }
+               $this->name = $temp ."/". uniqid($prefix) . $suffix;
+       }
+
+       private function getUser() {
+               if (extension_loaded("posix") && function_exists("posix_getpwuid")) {
+                       return posix_getpwuid(posix_getuid())["name"];
+               }
+               return trim(`whoami 2>/dev/null`)
+                       ?: trim(`id -nu 2>/dev/null`)
+                       ?: getenv("USER")
+                       ?: get_current_user();
+       }
+
+       /**
+        * @return string
+        */
+       public function __toString() {
+               return (string) $this->name;
+       }
+}
+
+
+namespace pharext;
+
+/**
+ * Create a new temporary file
+ */
+class Tempfile extends \SplFileInfo
+{
+       /**
+        * @var resource
+        */
+       private $handle;
+
+       /**
+        * @param string $prefix uniqid() prefix
+        * @param string $suffix e.g. file extension
+        * @throws \pharext\Exception
+        */
+       public function __construct($prefix, $suffix = ".tmp") {
+               $tries = 0;
+               $omask = umask(077);
+               do {
+                       $path = new Tempname($prefix, $suffix);
+                       $this->handle = fopen($path, "x");
+               } while (!is_resource($this->handle) && $tries++ < 10);
+               umask($omask);
+               
+               if (!is_resource($this->handle)) {
+                       throw new Exception("Could not create temporary file");
+               }
+               
+               parent::__construct($path);
+       }
+
+       /**
+        * Unlink the file
+        */
+       public function __destruct() {
+               if (is_file($this->getPathname())) {
+                       @unlink($this->getPathname());
+               }
+       }
+
+       /**
+        * Close the stream
+        */
+       public function closeStream() {
+               fclose($this->handle);
+       }
+
+       /**
+        * Retrieve the stream resource
+        * @return resource
+        */
+       public function getStream() {
+               return $this->handle;
+       }
+}
+
+
+
+namespace pharext;
+
+/**
+ * Create a temporary directory
+ */
+class Tempdir extends \SplFileInfo
+{
+       /**
+        * @param string $prefix prefix to uniqid()
+        * @throws \pharext\Exception
+        */
+       public function __construct($prefix) {
+               $temp = new Tempname($prefix);
+               if (!is_dir($temp) && !mkdir($temp, 0700, true)) {
+                       throw new Exception("Could not create tempdir: ".error_get_last()["message"]);
+               }
+               parent::__construct($temp);
+       }
+}
+
+
+
+namespace pharext;
+
+use ArrayAccess;
+use IteratorAggregate;
+use RecursiveDirectoryIterator;
+use SplFileInfo;
+
+use pharext\Exception;
+
+class Archive implements ArrayAccess, IteratorAggregate
+{
+       const HALT_COMPILER = "\137\137\150\141\154\164\137\143\157\155\160\151\154\145\162\50\51\73";
+       const SIGNED = 0x10000;
+       const SIG_MD5    = 0x0001;
+       const SIG_SHA1   = 0x0002;
+       const SIG_SHA256 = 0x0003;
+       const SIG_SHA512 = 0x0004;
+       const SIG_OPENSSL= 0x0010;
+
+       private static $siglen = [
+               self::SIG_MD5    => 16,
+               self::SIG_SHA1   => 20,
+               self::SIG_SHA256 => 32,
+               self::SIG_SHA512 => 64,
+               self::SIG_OPENSSL=> 0
+       ];
+
+       private static $sigalg = [
+               self::SIG_MD5    => "md5",
+               self::SIG_SHA1   => "sha1",
+               self::SIG_SHA256 => "sha256",
+               self::SIG_SHA512 => "sha512",
+               self::SIG_OPENSSL=> "openssl"
+       ];
+
+       private static $sigtyp = [
+               self::SIG_MD5    => "MD5",
+               self::SIG_SHA1   => "SHA-1",
+               self::SIG_SHA256 => "SHA-256",
+               self::SIG_SHA512 => "SHA-512",
+               self::SIG_OPENSSL=> "OpenSSL",
+       ];
+
+       const PERM_FILE_MASK = 0x01ff;
+       const COMP_FILE_MASK = 0xf000;
+       const COMP_GZ_FILE   = 0x1000;
+       const COMP_BZ2_FILE  = 0x2000;
+
+       const COMP_PHAR_MASK= 0xf000;
+       const COMP_PHAR_GZ  = 0x1000;
+       const COMP_PHAR_BZ2 = 0x2000;
+
+       private $file;
+       private $fd;
+       private $stub;
+       private $manifest;
+       private $signature;
+       private $extracted;
+
+       function __construct($file = null) {
+               if (strlen($file)) {
+                       $this->open($file);
+               }
+       }
+
+       function open($file) {
+               if (!$this->fd = @fopen($file, "r")) {
+                       throw new Exception;
+               }
+               $this->file = $file;
+               $this->stub = $this->readStub();
+               $this->manifest = $this->readManifest();
+               $this->signature = $this->readSignature();
+       }
+
+       function getIterator() {
+               return new RecursiveDirectoryIterator($this->extract());
+       }
+
+       function extract() {
+               return $this->extracted ?: $this->extractTo(new Tempdir("archive"));
+       }
+
+       function extractTo($dir) {
+               if ((string) $this->extracted == (string) $dir) {
+                       return $this->extracted;
+               }
+               foreach ($this->manifest["entries"] as $file => $entry) {
+                       fseek($this->fd, $this->manifest["offset"]+$entry["offset"]);
+                       $path = "$dir/$file";
+                       $copy = stream_copy_to_stream($this->fd, $this->outFd($path, $entry["flags"]), $entry["csize"]);
+                       if ($entry["osize"] != $copy) {
+                               throw new Exception("Copied '$copy' of '$file', expected '{$entry["osize"]}' from '{$entry["csize"]}");
+                       }
+
+                       $crc = hexdec(hash_file("crc32b", $path));
+                       if ($crc !== $entry["crc32"]) {
+                               throw new Exception("CRC mismatch of '$file': '$crc' != '{$entry["crc32"]}");
+                       }
+
+                       chmod($path, $entry["flags"] & self::PERM_FILE_MASK);
+                       touch($path, $entry["stamp"]);
+               }
+               return $this->extracted = $dir;
+       }
+
+       function offsetExists($o) {
+               return isset($this->entries[$o]);
+       }
+
+       function offsetGet($o) {
+               $this->extract();
+               return new SplFileInfo($this->extracted."/$o");
+       }
+
+       function offsetSet($o, $v) {
+               throw new Exception("Archive is read-only");
+       }
+
+       function offsetUnset($o) {
+               throw new Exception("Archive is read-only");
+       }
+
+       function getSignature() {
+               /* compatible with Phar::getSignature() */
+               return [
+                       "hash_type" => self::$sigtyp[$this->signature["flags"]],
+                       "hash" => strtoupper(bin2hex($this->signature["hash"])),
+               ];
+       }
+
+       function getPath() {
+               /* compatible with Phar::getPath() */
+               return new SplFileInfo($this->file);
+       }
+
+       function getMetadata($key = null) {
+               if (isset($key)) {
+                       return $this->manifest["meta"][$key];
+               }
+               return $this->manifest["meta"];
+       }
+
+       private function outFd($path, $flags) {
+                       $dirn = dirname($path);
+                       if (!is_dir($dirn) && !@mkdir($dirn, 0777, true)) {
+                               throw new Exception;
+                       }
+                       if (!$fd = @fopen($path, "w")) {
+                               throw new Exception;
+                       }
+                       switch ($flags & self::COMP_FILE_MASK) {
+                       case self::COMP_GZ_FILE:
+                               if (!@stream_filter_append($fd, "zlib.inflate")) {
+                                       throw new Exception;
+                               }
+                               break;
+                       case self::COMP_BZ2_FILE:
+                               if (!@stream_filter_append($fd, "bz2.decompress")) {
+                                       throw new Exception;
+                               }
+                               break;
+                       }
+
+       }
+       private function readVerified($fd, $len) {
+               if ($len != strlen($data = fread($fd, $len))) {
+                       throw new Exception("Unexpected EOF");
+               }
+               return $data;
+       }
+
+       private function readFormat($format, $fd, $len) {
+               if (false === ($data = @unpack($format, $this->readVerified($fd, $len)))) {
+                       throw new Exception;
+               }
+               return $data;
+       }
+
+       private function readSingleFormat($format, $fd, $len) {
+               return current($this->readFormat($format, $fd, $len));
+       }
+
+       private function readStringBinary($fd) {
+               if (($length = $this->readSingleFormat("V", $fd, 4))) {
+                       return $this->readVerified($this->fd, $length);
+               }
+               return null;
+       }
+
+       private function readSerializedBinary($fd) {
+               if (($length = $this->readSingleFormat("V", $fd, 4))) {
+                       if (false === ($data = unserialize($this->readVerified($fd, $length)))) {
+                               throw new Exception;
+                       }
+                       return $data;
+               }
+               return null;
+       }
+
+       private function readStub() {
+               $stub = "";
+               while (!feof($this->fd)) {
+                       $line = fgets($this->fd);
+                       $stub .= $line;
+                       if (false !== stripos($line, self::HALT_COMPILER)) {
+                               /* check for '?>' on a separate line */
+                               if ('?>' === $this->readVerified($this->fd, 2)) {
+                                       $stub .= '?>' . fgets($this->fd);
+                               } else {
+                                       fseek($this->fd, -2, SEEK_CUR);
+                               }
+                               break;
+                       }
+               }
+               return $stub;
+       }
+
+       private function readManifest() {
+               $current = ftell($this->fd);
+               $header = $this->readFormat("Vlen/Vnum/napi/Vflags", $this->fd, 14);
+               $alias = $this->readStringBinary($this->fd);
+               $meta = $this->readSerializedBinary($this->fd);
+               $entries = [];
+               for ($i = 0; $i < $header["num"]; ++$i) {
+                       $this->readEntry($entries);
+               }
+               $offset = ftell($this->fd);
+               if (($length = $offset - $current - 4) != $header["len"]) {
+                       throw new Exception("Manifest length read was '$length', expected '{$header["len"]}'");
+               }
+               return $header + compact("alias", "meta", "entries", "offset");
+       }
+
+       private function readEntry(array &$entries) {
+               if (!count($entries)) {
+                       $offset = 0;
+               } else {
+                       $last = end($entries);
+                       $offset = $last["offset"] + $last["csize"];
+               }
+               $file = $this->readStringBinary($this->fd);
+               if (!strlen($file)) {
+                       throw new Exception("Empty file name encountered at offset '$offset'");
+               }
+               $header = $this->readFormat("Vosize/Vstamp/Vcsize/Vcrc32/Vflags", $this->fd, 20);
+               $meta = $this->readSerializedBinary($this->fd);
+               $entries[$file] =  $header + compact("meta", "offset");
+       }
+
+       private function readSignature() {
+               fseek($this->fd, -8, SEEK_END);
+               $sig = $this->readFormat("Vflags/Z4magic", $this->fd, 8);
+               $end = ftell($this->fd);
+
+               if ($sig["magic"] !== "GBMB") {
+                       throw new Exception("Invalid signature magic value '{$sig["magic"]}");
+               }
+
+               switch ($sig["flags"]) {
+               case self::SIG_OPENSSL:
+                       fseek($this->fd, -12, SEEK_END);
+                       if (($hash = $this->readSingleFormat("V", $this->fd, 4))) {
+                               $offset = 4 + $hash;
+                               fseek($this->fd, -$offset, SEEK_CUR);
+                               $hash = $this->readVerified($this->fd, $hash);
+                               fseek($this->fd, 0, SEEK_SET);
+                               $valid = openssl_verify($this->readVerified($this->fd, $end - $offset - 8),
+                                       $hash, @file_get_contents($this->file.".pubkey")) === 1;
+                       }
+                       break;
+
+               case self::SIG_MD5:
+               case self::SIG_SHA1:
+               case self::SIG_SHA256:
+               case self::SIG_SHA512:
+                       $offset = 8 + self::$siglen[$sig["flags"]];
+                       fseek($this->fd, -$offset, SEEK_END);
+                       $hash = $this->readVerified($this->fd, self::$siglen[$sig["flags"]]);
+                       $algo = hash_init(self::$sigalg[$sig["flags"]]);
+                       fseek($this->fd, 0, SEEK_SET);
+                       hash_update_stream($algo, $this->fd, $end - $offset);
+                       $valid = hash_final($algo, true) === $hash;
+                       break;
+
+               default:
+                       throw new Exception("Invalid signature type '{$sig["flags"]}");
+               }
+
+               return $sig + compact("hash", "valid");
+       }
+}
+
+
+namespace pharext;
+
+if (extension_loaded("Phar")) {
+       \Phar::interceptFileFuncs();
+       \Phar::mapPhar();
+       $phardir = "phar://".__FILE__;
+} else {
+       $archive = new Archive(__FILE__);
+       $phardir = $archive->extract();
+}
+
+set_include_path("$phardir:". get_include_path());
+
+$installer = new Installer();
+$installer->run($argc, $argv);
+
+__HALT_COMPILER(); ?>\r
\10\0\07\0\0\0\11\0\0\0\ 1\0\0\0\0\0(\ 6\0\0a:7:{s:7:"version";s:5:"4.1.1";s:6:"header";s:49:"pharext v4.1.1 (c) Michael Wallner <mike@php.net>";s:4:"date";s:10:"2015-09-05";s:4:"name";s:5:"raphf";s:7:"release";s:5:"1.1.0";s:7:"license";s:1345:"Copyright (c) 2013, Michael Wallner <mike@php.net>.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice, 
+      this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright 
+      notice, this list of conditions and the following disclaimer in the 
+      documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE 
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+";s:4:"type";s:9:"extension";}\13\0\0\0pharext/Archive.php\18\1e\0\0ËéêU\18\1e\0\04-ÔI¶\ 1\0\0\0\0\0\0\19\0\0\0pharext/Cli/Args/Help.phpÉ\f\0\0ËéêUÉ\f\0\0gX'\1f\ 1\0\0\0\0\0\0\14\0\0\0pharext/Cli/Args.php\ f\1d\0\0ËéêU\ f\1d\0\0?n\9dö¶\ 1\0\0\0\0\0\0\17\0\0\0pharext/Cli/Command.phpk \0\0ËéêUk \0\0d\84aê¶\ 1\0\0\0\0\0\0\13\0\0\0pharext/Command.php\12\ 4\0\0ËéêU\12\ 4\0\0Ôm`Ͷ\ 1\0\0\0\0\0\0\15\0\0\0pharext/Exception.phpc\ 1\0\0ËéêUc\ 1\0\0U\86Ï{¶\ 1\0\0\0\0\0\0\13\0\0\0pharext/ExecCmd.php\1c\ e\0\0ËéêU\1c\ e\0\0¹l\94ʶ\ 1\0\0\0\0\0\0\15\0\0\0pharext/Installer.php&\18\0\0ËéêU&\18\0\0ød&À¶\ 1\0\0\0\0\0\0\13\0\0\0pharext/License.php\93\ 4\0\0ËéêU\93\ 4\0\0î\ 4òE¶\ 1\0\0\0\0\0\0\14\0\0\0pharext/Metadata.php\95\ 1\0\0ËéêU\95\ 1\0\0¿Ú\90\9e\ 1\0\0\0\0\0\0\1e\0\0\0pharext/Openssl/PrivateKey.phpÁ\ 4\0\0ËéêUÁ\ 4\0\0&æP\1a\ 1\0\0\0\0\0\0\14\0\0\0pharext/Packager.phpÌ!\0\0ËéêUÌ!\0\00\ 2\ 3\ 1\0\0\0\0\0\0\e\0\0\0pharext/SourceDir/Basic.phpz\ 5\0\0ËéêUz\ 5\0\0÷+Ôâ¶\ 1\0\0\0\0\0\0\19\0\0\0pharext/SourceDir/Git.phpZ\ 6\0\0ËéêUZ\ 6\0\0É\bÎ\¶\ 1\0\0\0\0\0\0\1a\0\0\0pharext/SourceDir/Pecl.phpø\11\0\0ËéêUø\11\0\0ã\bùж\ 1\0\0\0\0\0\0\15\0\0\0pharext/SourceDir.php½\ 2\0\0ËéêU½\ 2\0\03·#\ f\ 1\0\0\0\0\0\0\19\0\0\0pharext/Task/Activate.phpÜ\v\0\0ËéêUÜ\v\0\0I\93\1c\18\ 1\0\0\0\0\0\0\18\0\0\0pharext/Task/Askpass.phpU\ 2\0\0ËéêUU\ 2\0\0\87*\1e\90\ 1\0\0\0\0\0\0 \0\0\0pharext/Task/BundleGenerator.php}\ 2\0\0ËéêU}\ 2\0\0 ï`Y¶\ 1\0\0\0\0\0\0\18\0\0\0pharext/Task/Cleanup.php\1e\ 4\0\0ËéêU\1e\ 4\0\0ÉI\80\ 1\0\0\0\0\0\0\1a\0\0\0pharext/Task/Configure.phpT\ 4\0\0ËéêUT\ 4\0\0}\17Ëì¶\ 1\0\0\0\0\0\0\18\0\0\0pharext/Task/Extract.phpp\ 3\0\0ËéêUp\ 3\0\0[¨Û̶\ 1\0\0\0\0\0\0\19\0\0\0pharext/Task/GitClone.phpm\ 3\0\0ËéêUm\ 3\0\0óyµ@¶\ 1\0\0\0\0\0\0\15\0\0\0pharext/Task/Make.phpª\ 4\0\0ËéêUª\ 4\0\0\9cç6\r\ 1\0\0\0\0\0\0\19\0\0\0pharext/Task/PaxFixup.php¬\ 3\0\0ËéêU¬\ 3\0\0yâ¯\e\ 1\0\0\0\0\0\0\1a\0\0\0pharext/Task/PeclFixup.php\9c\ 4\0\0ËéêU\9c\ 4\0\0eùt\9a\ 1\0\0\0\0\0\0\1a\0\0\0pharext/Task/PharBuild.phpâ\a\0\0ËéêUâ\a\0\0ζ0ɶ\ 1\0\0\0\0\0\0\1d\0\0\0pharext/Task/PharCompress.phpc\ 4\0\0ËéêUc\ 4\0\0½\10³Ï¶\ 1\0\0\0\0\0\0\e\0\0\0pharext/Task/PharRename.phpä\ 3\0\0ËéêUä\ 3\0\0\8a[Þ˶\ 1\0\0\0\0\0\0\19\0\0\0pharext/Task/PharSign.php¨\ 3\0\0ËéêU¨\ 3\0\0Ûº¦i¶\ 1\0\0\0\0\0\0\19\0\0\0pharext/Task/PharStub.phpæ\ 3\0\0ËéêUæ\ 3\0\0Y|­\9b\ 1\0\0\0\0\0\0\17\0\0\0pharext/Task/Phpize.php\ f\ 4\0\0ËéêU\ f\ 4\0\0ù\f2Ѷ\ 1\0\0\0\0\0\0\1c\0\0\0pharext/Task/StreamFetch.php\10\a\0\0ËéêU\10\a\0\0\88îs\¶\ 1\0\0\0\0\0\0\10\0\0\0pharext/Task.phpw\0\0\0ËéêUw\0\0\0 ÄIǶ\ 1\0\0\0\0\0\0\13\0\0\0pharext/Tempdir.phpµ\ 1\0\0ËéêUµ\ 1\0\0ë\7f\96\ 1\0\0\0\0\0\0\14\0\0\0pharext/Tempfile.php\ f\ 4\0\0ËéêU\ f\ 4\0\0\0®ô\1e\ 1\0\0\0\0\0\0\14\0\0\0pharext/Tempname.phpt\ 3\0\0ËéêUt\ 3\0\0\9en<\8d\ 1\0\0\0\0\0\0\13\0\0\0pharext/Updater.php\8d\10\0\0ËéêU\8d\10\0\0\9eÏv\16\ 1\0\0\0\0\0\0\15\0\0\0pharext_installer.phpÝ\ 2\0\0ËéêUÝ\ 2\0\0\19\8cÞq¶\ 1\0\0\0\0\0\0\14\0\0\0pharext_packager.phpb\ 3\0\0ËéêUb\ 3\0\0îVÓ϶\ 1\0\0\0\0\0\0\13\0\0\0pharext_updater.phph\ 3\0\0ËéêUh\ 3\0\0 Êúj¶\ 1\0\0\0\0\0\0\13\0\0\0pharext_package.php2\0\0\0ËéêU2\0\0\0vSTÒ¶\ 1\0\0\0\0\0\0\v\0\0\0package.xmlÄ\a\0\0ËéêUÄ\a\0\0?z,e¶\ 1\0\0\0\0\0\0\a\0\0\0CREDITS\16\0\0\0ËéêU\16\0\0\0Cµ]²¶\ 1\0\0\0\0\0\0\a\0\0\0LICENSEA\ 5\0\0ËéêUA\ 5\0\0¾¬Jþ¶\ 1\0\0\0\0\0\0\b\0\0\0DoxyfileW,\0\0ËéêUW,\0\0\ 6°¶\ 1\0\0\0\0\0\0     \0\0\0config.m4$\ 1\0\0ËéêU$\ 1\0\0Åê@\9b\ 1\0\0\0\0\0\0
+\0\0\0config.w32Ð\0\0\0ËéêUÐ\0\0\0ýÍ\b\8e\ 1\0\0\0\0\0\0\v\0\0\0php_raphf.h\ f\ 5\0\0ËéêU\ f\ 5\0\0Z1\80\9e\ 1\0\0\0\0\0\0\ f\0\0\0php_raphf_api.hz5\0\0ËéêUz5\0\0{¯>\14\ 1\0\0\0\0\0\0\v\0\0\0php_raphf.c\1dH\0\0ËéêU\1dH\0\0\99Çê\80\ 1\0\0\0\0\0\0\12\0\0\0tests/http001.phpt\14\ 6\0\0ËéêU\14\ 6\0\0\f\e\ 1\0\0\0\0\0\0\12\0\0\0tests/http002.phptL\ 5\0\0ËéêUL\ 5\0\0\80ÔïS¶\ 1\0\0\0\0\0\0\12\0\0\0tests/http003.phpt^\ 5\0\0ËéêU^\ 5\0\0\14\88\19\ 1\0\0\0\0\0\0\12\0\0\0tests/http004.phpt[\b\0\0ËéêU[\b\0\0\1c«¶\ 1\0\0\0\0\0\0<?php
+
+namespace pharext;
+
+use ArrayAccess;
+use IteratorAggregate;
+use RecursiveDirectoryIterator;
+use SplFileInfo;
+
+use pharext\Exception;
+
+class Archive implements ArrayAccess, IteratorAggregate
+{
+       const HALT_COMPILER = "\137\137\150\141\154\164\137\143\157\155\160\151\154\145\162\50\51\73";
+       const SIGNED = 0x10000;
+       const SIG_MD5    = 0x0001;
+       const SIG_SHA1   = 0x0002;
+       const SIG_SHA256 = 0x0003;
+       const SIG_SHA512 = 0x0004;
+       const SIG_OPENSSL= 0x0010;
+
+       private static $siglen = [
+               self::SIG_MD5    => 16,
+               self::SIG_SHA1   => 20,
+               self::SIG_SHA256 => 32,
+               self::SIG_SHA512 => 64,
+               self::SIG_OPENSSL=> 0
+       ];
+
+       private static $sigalg = [
+               self::SIG_MD5    => "md5",
+               self::SIG_SHA1   => "sha1",
+               self::SIG_SHA256 => "sha256",
+               self::SIG_SHA512 => "sha512",
+               self::SIG_OPENSSL=> "openssl"
+       ];
+
+       private static $sigtyp = [
+               self::SIG_MD5    => "MD5",
+               self::SIG_SHA1   => "SHA-1",
+               self::SIG_SHA256 => "SHA-256",
+               self::SIG_SHA512 => "SHA-512",
+               self::SIG_OPENSSL=> "OpenSSL",
+       ];
+
+       const PERM_FILE_MASK = 0x01ff;
+       const COMP_FILE_MASK = 0xf000;
+       const COMP_GZ_FILE   = 0x1000;
+       const COMP_BZ2_FILE  = 0x2000;
+
+       const COMP_PHAR_MASK= 0xf000;
+       const COMP_PHAR_GZ  = 0x1000;
+       const COMP_PHAR_BZ2 = 0x2000;
+
+       private $file;
+       private $fd;
+       private $stub;
+       private $manifest;
+       private $signature;
+       private $extracted;
+
+       function __construct($file = null) {
+               if (strlen($file)) {
+                       $this->open($file);
+               }
+       }
+
+       function open($file) {
+               if (!$this->fd = @fopen($file, "r")) {
+                       throw new Exception;
+               }
+               $this->file = $file;
+               $this->stub = $this->readStub();
+               $this->manifest = $this->readManifest();
+               $this->signature = $this->readSignature();
+       }
+
+       function getIterator() {
+               return new RecursiveDirectoryIterator($this->extract());
+       }
+
+       function extract() {
+               return $this->extracted ?: $this->extractTo(new Tempdir("archive"));
+       }
+
+       function extractTo($dir) {
+               if ((string) $this->extracted == (string) $dir) {
+                       return $this->extracted;
+               }
+               foreach ($this->manifest["entries"] as $file => $entry) {
+                       fseek($this->fd, $this->manifest["offset"]+$entry["offset"]);
+                       $path = "$dir/$file";
+                       $copy = stream_copy_to_stream($this->fd, $this->outFd($path, $entry["flags"]), $entry["csize"]);
+                       if ($entry["osize"] != $copy) {
+                               throw new Exception("Copied '$copy' of '$file', expected '{$entry["osize"]}' from '{$entry["csize"]}");
+                       }
+
+                       $crc = hexdec(hash_file("crc32b", $path));
+                       if ($crc !== $entry["crc32"]) {
+                               throw new Exception("CRC mismatch of '$file': '$crc' != '{$entry["crc32"]}");
+                       }
+
+                       chmod($path, $entry["flags"] & self::PERM_FILE_MASK);
+                       touch($path, $entry["stamp"]);
+               }
+               return $this->extracted = $dir;
+       }
+
+       function offsetExists($o) {
+               return isset($this->entries[$o]);
+       }
+
+       function offsetGet($o) {
+               $this->extract();
+               return new SplFileInfo($this->extracted."/$o");
+       }
+
+       function offsetSet($o, $v) {
+               throw new Exception("Archive is read-only");
+       }
+
+       function offsetUnset($o) {
+               throw new Exception("Archive is read-only");
+       }
+
+       function getSignature() {
+               /* compatible with Phar::getSignature() */
+               return [
+                       "hash_type" => self::$sigtyp[$this->signature["flags"]],
+                       "hash" => strtoupper(bin2hex($this->signature["hash"])),
+               ];
+       }
+
+       function getPath() {
+               /* compatible with Phar::getPath() */
+               return new SplFileInfo($this->file);
+       }
+
+       function getMetadata($key = null) {
+               if (isset($key)) {
+                       return $this->manifest["meta"][$key];
+               }
+               return $this->manifest["meta"];
+       }
+
+       private function outFd($path, $flags) {
+                       $dirn = dirname($path);
+                       if (!is_dir($dirn) && !@mkdir($dirn, 0777, true)) {
+                               throw new Exception;
+                       }
+                       if (!$fd = @fopen($path, "w")) {
+                               throw new Exception;
+                       }
+                       switch ($flags & self::COMP_FILE_MASK) {
+                       case self::COMP_GZ_FILE:
+                               if (!@stream_filter_append($fd, "zlib.inflate")) {
+                                       throw new Exception;
+                               }
+                               break;
+                       case self::COMP_BZ2_FILE:
+                               if (!@stream_filter_append($fd, "bz2.decompress")) {
+                                       throw new Exception;
+                               }
+                               break;
+                       }
+
+       }
+       private function readVerified($fd, $len) {
+               if ($len != strlen($data = fread($fd, $len))) {
+                       throw new Exception("Unexpected EOF");
+               }
+               return $data;
+       }
+
+       private function readFormat($format, $fd, $len) {
+               if (false === ($data = @unpack($format, $this->readVerified($fd, $len)))) {
+                       throw new Exception;
+               }
+               return $data;
+       }
+
+       private function readSingleFormat($format, $fd, $len) {
+               return current($this->readFormat($format, $fd, $len));
+       }
+
+       private function readStringBinary($fd) {
+               if (($length = $this->readSingleFormat("V", $fd, 4))) {
+                       return $this->readVerified($this->fd, $length);
+               }
+               return null;
+       }
+
+       private function readSerializedBinary($fd) {
+               if (($length = $this->readSingleFormat("V", $fd, 4))) {
+                       if (false === ($data = unserialize($this->readVerified($fd, $length)))) {
+                               throw new Exception;
+                       }
+                       return $data;
+               }
+               return null;
+       }
+
+       private function readStub() {
+               $stub = "";
+               while (!feof($this->fd)) {
+                       $line = fgets($this->fd);
+                       $stub .= $line;
+                       if (false !== stripos($line, self::HALT_COMPILER)) {
+                               /* check for '?>' on a separate line */
+                               if ('?>' === $this->readVerified($this->fd, 2)) {
+                                       $stub .= '?>' . fgets($this->fd);
+                               } else {
+                                       fseek($this->fd, -2, SEEK_CUR);
+                               }
+                               break;
+                       }
+               }
+               return $stub;
+       }
+
+       private function readManifest() {
+               $current = ftell($this->fd);
+               $header = $this->readFormat("Vlen/Vnum/napi/Vflags", $this->fd, 14);
+               $alias = $this->readStringBinary($this->fd);
+               $meta = $this->readSerializedBinary($this->fd);
+               $entries = [];
+               for ($i = 0; $i < $header["num"]; ++$i) {
+                       $this->readEntry($entries);
+               }
+               $offset = ftell($this->fd);
+               if (($length = $offset - $current - 4) != $header["len"]) {
+                       throw new Exception("Manifest length read was '$length', expected '{$header["len"]}'");
+               }
+               return $header + compact("alias", "meta", "entries", "offset");
+       }
+
+       private function readEntry(array &$entries) {
+               if (!count($entries)) {
+                       $offset = 0;
+               } else {
+                       $last = end($entries);
+                       $offset = $last["offset"] + $last["csize"];
+               }
+               $file = $this->readStringBinary($this->fd);
+               if (!strlen($file)) {
+                       throw new Exception("Empty file name encountered at offset '$offset'");
+               }
+               $header = $this->readFormat("Vosize/Vstamp/Vcsize/Vcrc32/Vflags", $this->fd, 20);
+               $meta = $this->readSerializedBinary($this->fd);
+               $entries[$file] =  $header + compact("meta", "offset");
+       }
+
+       private function readSignature() {
+               fseek($this->fd, -8, SEEK_END);
+               $sig = $this->readFormat("Vflags/Z4magic", $this->fd, 8);
+               $end = ftell($this->fd);
+
+               if ($sig["magic"] !== "GBMB") {
+                       throw new Exception("Invalid signature magic value '{$sig["magic"]}");
+               }
+
+               switch ($sig["flags"]) {
+               case self::SIG_OPENSSL:
+                       fseek($this->fd, -12, SEEK_END);
+                       if (($hash = $this->readSingleFormat("V", $this->fd, 4))) {
+                               $offset = 4 + $hash;
+                               fseek($this->fd, -$offset, SEEK_CUR);
+                               $hash = $this->readVerified($this->fd, $hash);
+                               fseek($this->fd, 0, SEEK_SET);
+                               $valid = openssl_verify($this->readVerified($this->fd, $end - $offset - 8),
+                                       $hash, @file_get_contents($this->file.".pubkey")) === 1;
+                       }
+                       break;
+
+               case self::SIG_MD5:
+               case self::SIG_SHA1:
+               case self::SIG_SHA256:
+               case self::SIG_SHA512:
+                       $offset = 8 + self::$siglen[$sig["flags"]];
+                       fseek($this->fd, -$offset, SEEK_END);
+                       $hash = $this->readVerified($this->fd, self::$siglen[$sig["flags"]]);
+                       $algo = hash_init(self::$sigalg[$sig["flags"]]);
+                       fseek($this->fd, 0, SEEK_SET);
+                       hash_update_stream($algo, $this->fd, $end - $offset);
+                       $valid = hash_final($algo, true) === $hash;
+                       break;
+
+               default:
+                       throw new Exception("Invalid signature type '{$sig["flags"]}");
+               }
+
+               return $sig + compact("hash", "valid");
+       }
+}
+<?php
+
+namespace pharext\Cli\Args;
+
+use pharext\Cli\Args;
+
+class Help
+{
+       private $args;
+
+       function __construct($prog, Args $args) {
+               $this->prog = $prog;
+               $this->args = $args;
+       }
+
+       function __toString() {
+               $usage = "Usage:\n\n  \$ ";
+               $usage .= $this->prog;
+
+               list($flags, $required, $optional, $positional) = $this->listSpec();
+               if ($flags) {
+                       $usage .= $this->dumpFlags($flags);
+               }
+               if ($required) {
+                       $usage .= $this->dumpRequired($required);
+               }
+               if ($optional) {
+                       $usage .= $this->dumpOptional($optional);
+               }
+               if ($positional) {
+                       $usage .= $this->dumpPositional($positional);
+               }
+
+               $help = $this->dumpHelp($positional);
+
+               return $usage . "\n\n" . $help . "\n";
+       }
+
+       function listSpec() {
+               $flags = [];
+               $required = [];
+               $optional = [];
+               $positional = [];
+               foreach ($this->args->getSpec() as $spec) {
+                       if (is_numeric($spec[0])) {
+                               $positional[] = $spec;
+                       } elseif ($spec[3] & Args::REQUIRED) {
+                               $required[] = $spec;
+                       } elseif ($spec[3] & (Args::OPTARG|Args::REQARG)) {
+                               $optional[] = $spec;
+                       } else {
+                               $flags[] = $spec;
+                       }
+               }
+
+               return [$flags, $required, $optional, $positional]
+                       + compact("flags", "required", "optional", "positional");
+       }
+
+       function dumpFlags(array $flags) {
+               return sprintf(" [-%s]", implode("", array_column($flags, 0)));
+       }
+
+       function dumpRequired(array $required) {
+               $dump = "";
+               foreach ($required as $req) {
+                       $dump .= sprintf(" -%s <%s>", $req[0], $req[1]);
+               }
+               return $dump;
+       }
+
+       function dumpOptional(array $optional) {
+               $req = array_filter($optional, function($a) {
+                       return $a[3] & Args::REQARG;
+               });
+               $opt = array_filter($optional, function($a) {
+                       return $a[3] & Args::OPTARG;
+               });
+
+               $dump = "";
+               if ($req) {
+                       $dump .= sprintf(" [-%s <arg>]", implode("|-", array_column($req, 0)));
+               }
+               if ($opt) {
+                       $dump .= sprintf(" [-%s [<arg>]]", implode("|-", array_column($opt, 0)));
+               }
+               return $dump;
+       }
+
+       function dumpPositional(array $positional) {
+               $dump = " [--]";
+               foreach ($positional as $pos) {
+                       if ($pos[3] & Args::REQUIRED) {
+                               $dump .= sprintf(" <%s>", $pos[1]);
+                       } else {
+                               $dump .= sprintf(" [<%s>]", $pos[1]);
+                       }
+                       if ($pos[3] & Args::MULTI) {
+                               $dump .= sprintf(" [<%s>]...", $pos[1]);
+                       }
+               }
+               return $dump;
+       }
+
+       function calcMaxLen() {
+               $spc = $this->args->getSpec();
+               $max = max(array_map("strlen", array_column($spc, 1)));
+               $max += $max % 8 + 2;
+               return $max;
+       }
+
+       function dumpHelp() {
+               $max = $this->calcMaxLen();
+               $dump = "";
+               foreach ($this->args->getSpec() as $spec) {
+                       $dump .= "    ";
+                       if (is_numeric($spec[0])) {
+                               $dump .= sprintf("--   %s ", $spec[1]);
+                       } elseif (isset($spec[0])) {
+                               $dump .= sprintf("-%s|", $spec[0]);
+                       }
+                       if (!is_numeric($spec[0])) {
+                               $dump .= sprintf("--%s ", $spec[1]);
+                       }
+                       if ($spec[3] & Args::REQARG) {
+                               $dump .= "<arg>  ";
+                       } elseif ($spec[3] & Args::OPTARG) {
+                               $dump .= "[<arg>]";
+                       } else {
+                               $dump .= "       ";
+                       }
+
+                       $dump .= str_repeat(" ", $max-strlen($spec[1])+3*!isset($spec[0]));
+                       $dump .= $spec[2];
+
+                       if ($spec[3] & Args::REQUIRED) {
+                               $dump .= " (REQUIRED)";
+                       }
+                       if ($spec[3] & Args::MULTI) {
+                               $dump .= " (MULTIPLE)";
+                       }
+                       if (isset($spec[4])) {
+                               $dump .= sprintf(" [%s]", $spec[4]);
+                       }
+                       $dump .= "\n";
+               }
+               return $dump;
+       }
+}
+<?php
+
+namespace pharext\Cli;
+
+/**
+ * Command line arguments
+ */
+class Args implements \ArrayAccess
+{
+       /**
+        * Optional option
+        */
+       const OPTIONAL = 0x000;
+
+       /**
+        * Required Option
+        */
+       const REQUIRED = 0x001;
+
+       /**
+        * Only one value, even when used multiple times
+        */
+       const SINGLE = 0x000;
+
+       /**
+        * Aggregate an array, when used multiple times
+        */
+       const MULTI = 0x010;
+
+       /**
+        * Option takes no argument
+        */
+       const NOARG = 0x000;
+
+       /**
+        * Option requires an argument
+        */
+       const REQARG = 0x100;
+
+       /**
+        * Option takes an optional argument
+        */
+       const OPTARG = 0x200;
+
+       /**
+        * Option halts processing
+        */
+       const HALT = 0x10000000;
+
+       /**
+        * Original option spec
+        * @var array
+        */
+       private $orig = [];
+
+       /**
+        * Compiled spec
+        * @var array
+        */
+       private $spec = [];
+
+       /**
+        * Parsed args
+        * @var array
+        */
+       private $args = [];
+
+       /**
+        * Compile the original spec
+        * @param array|Traversable $spec
+        */
+       public function __construct($spec = null) {
+               if (is_array($spec) || $spec instanceof Traversable) {
+                       $this->compile($spec);
+               }
+
+       }
+
+       /**
+        * Compile the original spec
+        * @param array|Traversable $spec
+        * @return pharext\Cli\Args self
+        */
+       public function compile($spec) {
+               foreach ($spec as $arg) {
+                       if (isset($arg[0]) && is_numeric($arg[0])) {
+                               $arg[3] &= ~0xf00;
+                               $this->spec["--".$arg[0]] = $arg;
+                       } elseif (isset($arg[0])) {
+                               $this->spec["-".$arg[0]] = $arg;
+                               $this->spec["--".$arg[1]] = $arg;
+                       } else {
+                               $this->spec["--".$arg[1]] = $arg;
+                       }
+                       $this->orig[] = $arg;
+               }
+               return $this;
+       }
+
+       /**
+        * Get original spec
+        * @return array
+        */
+       public function getSpec() {
+               return $this->orig;
+       }
+
+       /**
+        * Get compiled spec
+        * @return array
+        */
+       public function getCompiledSpec() {
+               return $this->spec;
+       }
+
+       /**
+        * Parse command line arguments according to the compiled spec.
+        *
+        * The Generator yields any parsing errors.
+        * Parsing will stop when all arguments are processed or the first option
+        * flagged Cli\Args::HALT was encountered.
+        *
+        * @param int $argc
+        * @param array $argv
+        * @return Generator
+        */
+       public function parse($argc, array $argv) {
+               for ($f = false, $p = 0, $i = 0; $i < $argc; ++$i) {
+                       $o = $argv[$i];
+
+                       if ($o{0} === "-" && strlen($o) > 2 && $o{1} !== "-") {
+                               // multiple short opts, e.g. -vps
+                               $argc += strlen($o) - 2;
+                               array_splice($argv, $i, 1, array_map(function($s) {
+                                       return "-$s";
+                               }, str_split(substr($o, 1))));
+                               $o = $argv[$i];
+                       } elseif ($o{0} === "-" && strlen($o) > 2 && $o{1} === "-" && 0 < ($eq = strpos($o, "="))) {
+                               // long opt with argument, e.g. --foo=bar
+                               $argc++;
+                               array_splice($argv, $i, 1, [
+                                       substr($o, 0, $eq++),
+                                       substr($o, $eq)
+                               ]);
+                               $o = $argv[$i];
+                       } elseif ($o === "--") {
+                               // only positional args following
+                               $f = true;
+                               continue;
+                       }
+
+                       if ($f || !isset($this->spec[$o])) {
+                               if ($o{0} !== "-" && isset($this->spec["--$p"])) {
+                                       $this[$p] = $o;
+                                       if (!$this->optIsMulti($p)) {
+                                               ++$p;
+                                       }
+                               } else {
+                                       yield sprintf("Unknown option %s", $o);
+                               }
+                       } elseif (!$this->optAcceptsArg($o)) {
+                               $this[$o] = true;
+                       } elseif ($i+1 < $argc && !isset($this->spec[$argv[$i+1]])) {
+                               $this[$o] = $argv[++$i];
+                       } elseif ($this->optRequiresArg($o)) {
+                               yield sprintf("Option --%s requires an argument", $this->optLongName($o));
+                       } else {
+                               // OPTARG
+                               $this[$o] = $this->optDefaultArg($o);
+                       }
+
+                       if ($this->optHalts($o)) {
+                               return;
+                       }
+               }
+       }
+
+       /**
+        * Validate that all required options were given.
+        *
+        * The Generator yields any validation errors.
+        *
+        * @return Generator
+        */
+       public function validate() {
+               $required = array_filter($this->orig, function($spec) {
+                       return $spec[3] & self::REQUIRED;
+               });
+               foreach ($required as $req) {
+                       if ($req[3] & self::MULTI) {
+                               if (is_array($this[$req[0]])) {
+                                       continue;
+                               }
+                       } elseif (strlen($this[$req[0]])) {
+                               continue;
+                       }
+                       if (is_numeric($req[0])) {
+                               yield sprintf("Argument <%s> is required", $req[1]);
+                       } else {
+                               yield sprintf("Option --%s is required", $req[1]);
+                       }
+               }
+       }
+
+
+       public function toArray() {
+               $args = [];
+               foreach ($this->spec as $spec) {
+                       $opt = $this->opt($spec[1]);
+                       $args[$opt] = $this[$opt];
+               }
+               return $args;
+       }
+
+       /**
+        * Retreive the default argument of an option
+        * @param string $o
+        * @return mixed
+        */
+       private function optDefaultArg($o) {
+               $o = $this->opt($o);
+               if (isset($this->spec[$o][4])) {
+                       return $this->spec[$o][4];
+               }
+               return null;
+       }
+
+       /**
+        * Retrieve the help message of an option
+        * @param string $o
+        * @return string
+        */
+       private function optHelp($o) {
+               $o = $this->opt($o);
+               if (isset($this->spec[$o][2])) {
+                       return $this->spec[$o][2];
+               }
+               return "";
+       }
+
+       /**
+        * Retrieve option's flags
+        * @param string $o
+        * @return int
+        */
+       private function optFlags($o) {
+               $o = $this->opt($o);
+               if (isset($this->spec[$o])) {
+                       return $this->spec[$o][3];
+               }
+               return null;
+       }
+
+       /**
+        * Check whether an option is flagged for halting argument processing
+        * @param string $o
+        * @return boolean
+        */
+       private function optHalts($o) {
+               return $this->optFlags($o) & self::HALT;
+       }
+
+       /**
+        * Check whether an option needs an argument
+        * @param string $o
+        * @return boolean
+        */
+       private function optRequiresArg($o) {
+               return $this->optFlags($o) & self::REQARG;
+       }
+
+       /**
+        * Check wether an option accepts any argument
+        * @param string $o
+        * @return boolean
+        */
+       private function optAcceptsArg($o) {
+               return $this->optFlags($o) & 0xf00;
+       }
+
+       /**
+        * Check whether an option can be used more than once
+        * @param string $o
+        * @return boolean
+        */
+       private function optIsMulti($o) {
+               return $this->optFlags($o) & self::MULTI;
+       }
+
+       /**
+        * Retreive the long name of an option
+        * @param string $o
+        * @return string
+        */
+       private function optLongName($o) {
+               $o = $this->opt($o);
+               return is_numeric($this->spec[$o][0]) ? $this->spec[$o][0] : $this->spec[$o][1];
+       }
+
+       /**
+        * Retreive the short name of an option
+        * @param string $o
+        * @return string
+        */
+       private function optShortName($o) {
+               $o = $this->opt($o);
+               return is_numeric($this->spec[$o][0]) ? null : $this->spec[$o][0];
+       }
+
+       /**
+        * Retreive the canonical name (--long-name) of an option
+        * @param string $o
+        * @return string
+        */
+       private function opt($o) {
+               if (is_numeric($o)) {
+                       return "--$o";
+               }
+               if ($o{0} !== '-') {
+                       if (strlen($o) > 1) {
+                               $o = "-$o";
+                       }
+                       $o = "-$o";
+               }
+               return $o;
+       }
+
+       /**@+
+        * Implements ArrayAccess and virtual properties
+        */
+       function offsetExists($o) {
+               $o = $this->opt($o);
+               return isset($this->args[$o]);
+       }
+       function __isset($o) {
+               return $this->offsetExists($o);
+       }
+       function offsetGet($o) {
+               $o = $this->opt($o);
+               if (isset($this->args[$o])) {
+                       return $this->args[$o];
+               }
+               return $this->optDefaultArg($o);
+       }
+       function __get($o) {
+               return $this->offsetGet($o);
+       }
+       function offsetSet($o, $v) {
+               $osn = $this->optShortName($o);
+               $oln = $this->optLongName($o);
+               if ($this->optIsMulti($o)) {
+                       if (isset($osn)) {
+                               $this->args["-$osn"][] = $v;
+                       }
+                       $this->args["--$oln"][] = $v;
+               } else {
+                       if (isset($osn)) {
+                               $this->args["-$osn"] = $v;
+                       }
+                       $this->args["--$oln"] = $v;
+               }
+       }
+       function __set($o, $v) {
+               $this->offsetSet($o, $v);
+       }
+       function offsetUnset($o) {
+               unset($this->args["-".$this->optShortName($o)]);
+               unset($this->args["--".$this->optLongName($o)]);
+       }
+       function __unset($o) {
+               $this->offsetUnset($o);
+       }
+       /**@-*/
+}
+<?php
+
+namespace pharext\Cli;
+
+use pharext\Archive;
+
+use Phar;
+
+trait Command
+{
+       /**
+        * Command line arguments
+        * @var pharext\Cli\Args
+        */
+       private $args;
+       
+       /**
+        * @inheritdoc
+        * @see \pharext\Command::getArgs()
+        */
+       public function getArgs() {
+               return $this->args;
+       }
+
+       /**
+        * Retrieve metadata of the currently running phar
+        * @param string $key
+        * @return mixed
+        */
+       public function metadata($key = null) {
+               if (extension_loaded("Phar")) {
+                       $running = new Phar(Phar::running(false));
+               } else {
+                       $running = new Archive(PHAREXT_PHAR);
+               }
+
+               if ($key === "signature") {
+                       $sig = $running->getSignature();
+                       return sprintf("%s signature of %s\n%s", 
+                               $sig["hash_type"],
+                               $this->metadata("name"),
+                               chunk_split($sig["hash"], 64, "\n"));
+               }
+
+               $metadata = $running->getMetadata();
+               if (isset($key)) {
+                       return $metadata[$key];
+               }
+               return $metadata;
+       }
+
+       /**
+        * Output pharext vX.Y.Z header
+        */
+       public function header() {
+               if (!headers_sent()) {
+                       /* only display header, if we didn't generate any output yet */
+                       printf("%s\n\n", $this->metadata("header"));
+               }
+       }
+       
+       /**
+        * @inheritdoc
+        * @see \pharext\Command::debug()
+        */
+       public function debug($fmt) {
+               if ($this->args->verbose) {
+                       vprintf($fmt, array_slice(func_get_args(), 1));
+               }
+       }
+       
+       /**
+        * @inheritdoc
+        * @see \pharext\Command::info()
+        */
+       public function info($fmt) {
+               if (!$this->args->quiet) {
+                       vprintf($fmt, array_slice(func_get_args(), 1));
+               }
+       }
+
+       /**
+        * @inheritdoc
+        * @see \pharext\Command::warn()
+        */
+       public function warn($fmt) {
+               if (!$this->args->quiet) {
+                       if (!isset($fmt)) {
+                               $fmt = "%s\n";
+                               $arg = error_get_last()["message"];
+                       } else {
+                               $arg = array_slice(func_get_args(), 1);
+                       }
+                       vfprintf(STDERR, "Warning: $fmt", $arg);
+               }
+       }
+
+       /**
+        * @inheritdoc
+        * @see \pharext\Command::error()
+        */
+       public function error($fmt) {
+               if (!isset($fmt)) {
+                       $fmt = "%s\n";
+                       $arg = error_get_last()["message"];
+               } else {
+                       $arg = array_slice(func_get_args(), 1);
+               }
+               vfprintf(STDERR, "ERROR: $fmt", $arg);
+       }
+
+       /**
+        * Output command line help message
+        * @param string $prog
+        */
+       public function help($prog) {
+               print new Args\Help($prog, $this->args);
+       }
+       
+       /**
+        * Verbosity
+        * @return boolean
+        */
+       public function verbosity() {
+               if ($this->args->verbose) {
+                       return true;
+               } elseif ($this->args->quiet) {
+                       return false;
+               } else {
+                       return null;
+               }
+       }
+}
+<?php
+
+namespace pharext;
+
+/**
+ * Command interface
+ */
+interface Command
+{
+       /**
+        * Argument error
+        */
+       const EARGS = 1;
+       /**
+        * Build error
+        */
+       const EBUILD = 2;
+       /**
+        * Signature error
+        */
+       const ESIGN = 3;
+       /**
+        * Extract/unpack error
+        */
+       const EEXTRACT = 4;
+       /**
+        * Install error
+        */
+       const EINSTALL = 5;
+       
+       /**
+        * Retrieve command line arguments
+        * @return pharext\Cli\Args
+        */
+       public function getArgs();
+       
+       /**
+        * Print debug message
+        * @param string $fmt
+        * @param string ...$args
+        */
+       public function debug($fmt);
+       
+       /**
+        * Print info
+        * @param string $fmt
+        * @param string ...$args
+        */
+       public function info($fmt);
+       
+       /**
+        * Print warning
+        * @param string $fmt
+        * @param string ...$args
+        */
+       public function warn($fmt);
+
+       /**
+        * Print error
+        * @param string $fmt
+        * @param string ...$args
+        */
+       public function error($fmt);
+
+       /**
+        * Execute the command
+        * @param int $argc command line argument count
+        * @param array $argv command line argument list
+        */
+       public function run($argc, array $argv);
+}
+<?php
+
+namespace pharext;
+
+class Exception extends \Exception
+{
+       public function __construct($message = null, $code = 0, $previous = null) {
+               if (!isset($message)) {
+                       $last_error = error_get_last();
+                       $message = $last_error["message"];
+                       if (!$code) {
+                               $code = $last_error["type"];
+                       }
+               }
+               parent::__construct($message, $code, $previous);
+       }
+}
+<?php
+
+namespace pharext;
+
+/**
+ * Execute system command
+ */
+class ExecCmd
+{
+       /**
+        * Sudo command, if the cmd needs escalated privileges
+        * @var string
+        */
+       private $sudo;
+       
+       /**
+        * Executable of the cmd
+        * @var string
+        */
+       private $command;
+       
+       /**
+        * Passthrough cmd output
+        * @var bool
+        */
+       private $verbose;
+       
+       /**
+        * Output of cmd run
+        * @var string
+        */
+       private $output;
+       
+       /**
+        * Return code of cmd run
+        * @var int
+        */
+       private $status;
+
+       /**
+        * @param string $command
+        * @param bool verbose
+        */
+       public function __construct($command, $verbose = false) {
+               $this->command = $command;
+               $this->verbose = $verbose;
+       }
+       
+       /**
+        * (Re-)set sudo command
+        * @param string $sudo
+        */
+       public function setSu($sudo = false) {
+               $this->sudo = $sudo;
+       }
+       
+       /**
+        * Execute a program with escalated privileges handling interactive password prompt
+        * @param string $command
+        * @param bool $verbose
+        * @return int exit status
+        */
+       private function suExec($command, $verbose = null) {
+               if (!($proc = proc_open($command, [STDIN,["pipe","w"],["pipe","w"]], $pipes))) {
+                       $this->status = -1;
+                       throw new Exception("Failed to run {$command}");
+               }
+               
+               $stdout = $pipes[1];
+               $passwd = 0;
+               $checks = 10;
+
+               while (!feof($stdout)) {
+                       $R = [$stdout]; $W = []; $E = [];
+                       if (!stream_select($R, $W, $E, null)) {
+                               continue;
+                       }
+                       $data = fread($stdout, 0x1000);
+                       /* only check a few times */
+                       if ($passwd < $checks) {
+                               $passwd++;
+                               if (stristr($data, "password")) {
+                                       $passwd = $checks + 1;
+                                       printf("\n%s", $data);
+                                       continue;
+                               }
+                       } elseif ($passwd > $checks) {
+                               /* new line after pw entry */
+                               printf("\n");
+                               $passwd = $checks;
+                       }
+                       
+                       if ($verbose === null) {
+                               print $this->progress($data, 0);
+                       } else {
+                               if ($verbose) {
+                                       printf("%s", $data);
+                               }
+                               $this->output .= $data;
+                       }
+               }
+               if ($verbose === null) {
+                       $this->progress("", PHP_OUTPUT_HANDLER_FINAL);
+               }
+               return $this->status = proc_close($proc);
+       }
+
+       /**
+        * Output handler that displays some progress while soaking output
+        * @param string $string
+        * @param int $flags
+        * @return string
+        */
+       private function progress($string, $flags) {
+               static $counter = 0;
+               static $symbols = ["\\","|","/","-"];
+
+               $this->output .= $string;
+               
+               if (false !== strpos($string, "\n")) {
+                       ++$counter;
+               }
+
+               return $flags & PHP_OUTPUT_HANDLER_FINAL
+                       ? "   \r"
+                       : sprintf("  %s\r", $symbols[$counter % 4]);
+       }
+
+       /**
+        * Run the command
+        * @param array $args
+        * @return \pharext\ExecCmd self
+        * @throws \pharext\Exception
+        */
+       public function run(array $args = null) {
+               $exec = escapeshellcmd($this->command);
+               if ($args) {
+                       $exec .= " ". implode(" ", array_map("escapeshellarg", (array) $args));
+               }
+               
+               if ($this->sudo) {
+                       $this->suExec(sprintf($this->sudo." 2>&1", $exec), $this->verbose);
+               } elseif ($this->verbose) {
+                       ob_start(function($s) {
+                               $this->output .= $s;
+                               return $s;
+                       }, 1);
+                       passthru($exec, $this->status);
+                       ob_end_flush();
+               } elseif ($this->verbose !== false /* !quiet */) {
+                       ob_start([$this, "progress"], 1);
+                       passthru($exec . " 2>&1", $this->status);
+                       ob_end_flush();
+               } else {
+                       exec($exec ." 2>&1", $output, $this->status);
+                       $this->output = implode("\n", $output);
+               }
+               
+               if ($this->status) {
+                       throw new Exception("Command {$exec} failed ({$this->status})");
+               }
+
+               return $this;
+       }
+       
+       /**
+        * Retrieve exit code of cmd run
+        * @return int
+        */
+       public function getStatus() {
+               return $this->status;
+       }
+       
+       /**
+        * Retrieve output of cmd run
+        * @return string
+        */
+       public function getOutput() {
+               return $this->output;
+       }
+}
+<?php
+
+namespace pharext;
+
+use Phar;
+use SplObjectStorage;
+
+/**
+ * The extension install command executed by the extension phar
+ */
+class Installer implements Command
+{
+       use Cli\Command;
+
+       /**
+        * Cleanups
+        * @var array
+        */
+       private $cleanup = [];
+
+       /**
+        * Create the command
+        */
+       public function __construct() {
+               $this->args = new Cli\Args([
+                       ["h", "help", "Display help",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+                       ["v", "verbose", "More output",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
+                       ["q", "quiet", "Less output",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
+                       ["p", "prefix", "PHP installation prefix if phpize is not in \$PATH, e.g. /opt/php7",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::REQARG],
+                       ["n", "common-name", "PHP common program name, e.g. php5 or zts-php",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::REQARG,
+                               "php"],
+                       ["c", "configure", "Additional extension configure flags, e.g. -c --with-flag",
+                               Cli\Args::OPTIONAL|Cli\Args::MULTI|Cli\Args::REQARG],
+                       ["s", "sudo", "Installation might need increased privileges",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::OPTARG,
+                               "sudo -S %s"],
+                       ["i", "ini", "Activate in this php.ini instead of loaded default php.ini",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::REQARG],
+                       [null, "signature", "Show package signature",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+                       [null, "license", "Show package license",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+                       [null, "name", "Show package name",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+                       [null, "date", "Show package release date",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+                       [null, "release", "Show package release version",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+                       [null, "version", "Show pharext version",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+               ]);
+       }
+
+       /**
+        * Perform cleaniup
+        */
+       function __destruct() {
+               foreach ($this->cleanup as $cleanup) {
+                       $cleanup->run();
+               }
+       }
+
+       private function extract($phar) {
+               $temp = (new Task\Extract($phar))->run($this->verbosity());
+               $this->cleanup[] = new Task\Cleanup($temp);
+               return $temp;
+       }
+
+       private function hooks(SplObjectStorage $phars) {
+               $hook = [];
+               foreach ($phars as $phar) {
+                       if (isset($phar["pharext_package.php"])) {
+                               $sdir = include $phar["pharext_package.php"];
+                               if ($sdir instanceof SourceDir) {
+                                       $this->args->compile($sdir->getArgs());
+                                       $hook[] = $sdir;
+                               }
+                       }
+               }
+               return $hook;
+       }
+
+       private function load() {
+               $list = new SplObjectStorage();
+               $phar = extension_loaded("Phar")
+                       ? new Phar(Phar::running(false))
+                       : new Archive(PHAREXT_PHAR);
+               $temp = $this->extract($phar);
+
+               foreach ($phar as $entry) {
+                       $dep_file = $entry->getBaseName();
+                       if (fnmatch("*.ext.phar*", $dep_file)) {
+                               $dep_phar = extension_loaded("Phar")
+                                       ? new Phar("$temp/$dep_file")
+                                       : new Archive("$temp/$dep_file");
+                               $list[$dep_phar] = $this->extract($dep_phar);
+                       }
+               }
+
+               /* the actual ext.phar at last */
+               $list[$phar] = $temp;
+               return $list;
+       }
+
+       /**
+        * @inheritdoc
+        * @see \pharext\Command::run()
+        */
+       public function run($argc, array $argv) {
+               try {
+                       /* load the phar(s) */
+                       $list = $this->load();
+                       /* installer hooks */
+                       $hook = $this->hooks($list);
+               } catch (\Exception $e) {
+                       $this->error("%s\n", $e->getMessage());
+                       exit(self::EEXTRACT);
+               }
+
+               /* standard arg stuff */
+               $errs = [];
+               $prog = array_shift($argv);
+               foreach ($this->args->parse(--$argc, $argv) as $error) {
+                       $errs[] = $error;
+               }
+
+               if ($this->args["help"]) {
+                       $this->header();
+                       $this->help($prog);
+                       exit;
+               }
+               try {
+                       foreach (["signature", "name", "date", "license", "release", "version"] as $opt) {
+                               if ($this->args[$opt]) {
+                                       printf("%s\n", $this->metadata($opt));
+                                       exit;
+                               }
+                       }
+               } catch (\Exception $e) {
+                       $this->error("%s\n", $e->getMessage());
+                       exit(self::EARGS);
+               }
+
+               foreach ($this->args->validate() as $error) {
+                       $errs[] = $error;
+               }
+
+               if ($errs) {
+                       if (!$this->args["quiet"]) {
+                               $this->header();
+                       }
+                       foreach ($errs as $err) {
+                               $this->error("%s\n", $err);
+                       }
+                       if (!$this->args["quiet"]) {
+                               $this->help($prog);
+                       }
+                       exit(self::EARGS);
+               }
+
+               try {
+                       /* post process hooks */
+                       foreach ($hook as $sdir) {
+                               $sdir->setArgs($this->args);
+                       }
+               } catch (\Exception $e) {
+                       $this->error("%s\n", $e->getMessage());
+                       exit(self::EARGS);
+               }
+
+               /* install packages */
+               try {
+                       foreach ($list as $phar) {
+                               $this->info("Installing %s ...\n", basename($phar->getPath()));
+                               $this->install($list[$phar]);
+                               $this->activate($list[$phar]);
+                               $this->info("Successfully installed %s!\n", basename($phar->getPath()));
+                       }
+               } catch (\Exception $e) {
+                       $this->error("%s\n", $e->getMessage());
+                       exit(self::EINSTALL);
+               }
+       }
+
+       /**
+        * Phpize + trinity
+        */
+       private function install($temp) {
+               // phpize
+               $phpize = new Task\Phpize($temp, $this->args->prefix, $this->args->{"common-name"});
+               $phpize->run($this->verbosity());
+
+               // configure
+               $configure = new Task\Configure($temp, $this->args->configure, $this->args->prefix, $this->args->{"common-name"});
+               $configure->run($this->verbosity());
+
+               // make
+               $make = new Task\Make($temp);
+               $make->run($this->verbosity());
+
+               // install
+               $sudo = isset($this->args->sudo) ? $this->args->sudo : null;
+               $install = new Task\Make($temp, ["install"], $sudo);
+               $install->run($this->verbosity());
+       }
+
+       private function activate($temp) {
+               if ($this->args->ini) {
+                       $files = [$this->args->ini];
+               } else {
+                       $files = array_filter(array_map("trim", explode(",", php_ini_scanned_files())));
+                       $files[] = php_ini_loaded_file();
+               }
+
+               $sudo = isset($this->args->sudo) ? $this->args->sudo : null;
+               $type = $this->metadata("type") ?: "extension";
+
+               $activate = new Task\Activate($temp, $files, $type, $this->args->prefix, $this->args{"common-name"}, $sudo);
+               if (!$activate->run($this->verbosity())) {
+                       $this->info("Extension already activated ...\n");
+               }
+       }
+}
+<?php
+
+namespace pharext;
+
+trait License
+{
+       function findLicense($dir, $file = null) {
+               if (isset($file)) {
+                       return realpath("$dir/$file");
+               }
+
+               $names = [];
+               foreach (["{,UN}LICEN{S,C}{E,ING}", "COPY{,ING,RIGHT}"] as $name) {
+                       $names[] = $this->mergeLicensePattern($name, strtolower($name));
+               }
+               $exts = [];
+               foreach (["t{,e}xt", "rst", "asc{,i,ii}", "m{,ark}d{,own}", "htm{,l}"] as $ext) {
+                       $exts[] = $this->mergeLicensePattern(strtoupper($ext), $ext);
+               }
+               
+               $pattern = "{". implode(",", $names) ."}{,.{". implode(",", $exts) ."}}";
+
+               if (($glob = glob("$dir/$pattern", GLOB_BRACE))) {
+                       return current($glob);
+               }
+       }
+
+       private function mergeLicensePattern($upper, $lower) {
+               $pattern = "";
+               $length = strlen($upper);
+               for ($i = 0; $i < $length; ++$i) {
+                       if ($lower{$i} === $upper{$i}) {
+                               $pattern .= $upper{$i};
+                       } else {
+                               $pattern .= "[" . $upper{$i} . $lower{$i} . "]";
+                       }
+               }
+               return $pattern;
+       }
+
+       public function readLicense($file) {
+               $text = file_get_contents($file);
+               switch (strtolower(pathinfo($file, PATHINFO_EXTENSION))) {
+                       case "htm":
+                       case "html":
+                               $text = strip_tags($text);
+                               break;
+               }
+               return $text;
+       }
+}
+<?php
+
+namespace pharext;
+
+class Metadata
+{
+       static function version() {
+               return "4.1.1";
+       }
+
+       static function header() {
+               return sprintf("pharext v%s (c) Michael Wallner <mike@php.net>", self::version());
+       }
+
+       static function date() {
+               return gmdate("Y-m-d");
+       }
+
+       static function all() {
+               return [
+                       "version" => self::version(),
+                       "header" => self::header(),
+                       "date" => self::date(),
+               ];
+       }
+}
+<?php
+
+namespace pharext\Openssl;
+
+use pharext\Exception;
+
+class PrivateKey
+{
+       /**
+        * Private key
+        * @var string
+        */
+       private $key;
+       
+       /**
+        * Public key
+        * @var string
+        */
+       private $pub;
+
+       /**
+        * Read a private key
+        * @param string $file
+        * @param string $password
+        * @throws \pharext\Exception
+        */
+       function __construct($file, $password) {
+               /* there appears to be a bug with refcount handling of this
+                * resource; when the resource is stored as property, it cannot be
+                * "coerced to a private key" on openssl_sign() later in another method
+                */
+               $key = openssl_pkey_get_private("file://$file", $password);
+               if (!is_resource($key)) {
+                       throw new Exception("Could not load private key");
+               }
+               openssl_pkey_export($key, $this->key);
+               $this->pub = openssl_pkey_get_details($key)["key"];
+       }
+
+       /**
+        * Sign the PHAR
+        * @param \Phar $package
+        */
+       function sign(\Phar $package) {
+               $package->setSignatureAlgorithm(\Phar::OPENSSL, $this->key);
+       }
+
+       /**
+        * Export the public key to a file
+        * @param string $file
+        * @throws \pharext\Exception
+        */
+       function exportPublicKey($file) {
+               if (!file_put_contents("$file.tmp", $this->pub) || !rename("$file.tmp", $file)) {
+                       throw new Exception;
+               }
+       }
+}
+<?php
+
+namespace pharext;
+
+use Phar;
+use pharext\Exception;
+
+/**
+ * The extension packaging command executed by bin/pharext
+ */
+class Packager implements Command
+{
+       use Cli\Command;
+       
+       /**
+        * Extension source directory
+        * @var pharext\SourceDir
+        */
+       private $source;
+       
+       /**
+        * Cleanups
+        * @var array
+        */
+       private $cleanup = [];
+       
+       /**
+        * Create the command
+        */
+       public function __construct() {
+               $this->args = new Cli\Args([
+                       ["h", "help", "Display this help",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+                       ["v", "verbose", "More output",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
+                       ["q", "quiet", "Less output",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
+                       ["n", "name", "Extension name",
+                               Cli\Args::REQUIRED|Cli\Args::SINGLE|Cli\Args::REQARG],
+                       ["r", "release", "Extension release version",
+                               Cli\Args::REQUIRED|Cli\Args::SINGLE|Cli\Args::REQARG],
+                       ["s", "source", "Extension source directory",
+                               Cli\Args::REQUIRED|Cli\Args::SINGLE|Cli\Args::REQARG],
+                       ["g", "git", "Use `git ls-tree` to determine file list",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
+                       ["b", "branch", "Checkout this tag/branch",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::REQARG],
+                       ["p", "pecl", "Use PECL package.xml to determine file list, name and release",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
+                       ["d", "dest", "Destination directory",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::REQARG,
+                               "."],
+                       ["z", "gzip", "Create additional PHAR compressed with gzip",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
+                       ["Z", "bzip", "Create additional PHAR compressed with bzip",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
+                       ["S", "sign", "Sign the PHAR with a private key",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::REQARG],
+                       ["E", "zend", "Mark as Zend Extension",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
+                       [null, "signature", "Show pharext signature",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+                       [null, "license", "Show pharext license",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+                       [null, "version", "Show pharext version",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+               ]);
+       }
+       
+       /**
+        * Perform cleaniup
+        */
+       function __destruct() {
+               foreach ($this->cleanup as $cleanup) {
+                       $cleanup->run();
+               }
+       }
+       
+       /**
+        * @inheritdoc
+        * @see \pharext\Command::run()
+        */
+       public function run($argc, array $argv) {
+               $errs = [];
+               $prog = array_shift($argv);
+               foreach ($this->args->parse(--$argc, $argv) as $error) {
+                       $errs[] = $error;
+               }
+               
+               if ($this->args["help"]) {
+                       $this->header();
+                       $this->help($prog);
+                       exit;
+               }
+               try {
+                       foreach (["signature", "license", "version"] as $opt) {
+                               if ($this->args[$opt]) {
+                                       printf("%s\n", $this->metadata($opt));
+                                       exit;
+                               }
+                       }
+               } catch (\Exception $e) {
+                       $this->error("%s\n", $e->getMessage());
+                       exit(self::EARGS);
+               }
+
+               try {
+                       /* source needs to be evaluated before Cli\Args validation, 
+                        * so e.g. name and version can be overriden and Cli\Args 
+                        * does not complain about missing arguments
+                        */
+                       $this->loadSource();
+               } catch (\Exception $e) {
+                       $errs[] = $e->getMessage();
+               }
+               
+               foreach ($this->args->validate() as $error) {
+                       $errs[] = $error;
+               }
+               
+               if ($errs) {
+                       if (!$this->args["quiet"]) {
+                               $this->header();
+                       }
+                       foreach ($errs as $err) {
+                               $this->error("%s\n", $err);
+                       }
+                       printf("\n");
+                       if (!$this->args["quiet"]) {
+                               $this->help($prog);
+                       }
+                       exit(self::EARGS);
+               }
+               
+               $this->createPackage();
+       }
+       
+       /**
+        * Download remote source
+        * @param string $source
+        * @return string local source
+        */
+       private function download($source) {
+               if ($this->args->git) {
+                       $task = new Task\GitClone($source, $this->args->branch);
+               } else {
+                       /* print newline only once */
+                       $done = false;
+                       $task = new Task\StreamFetch($source, function($bytes_pct) use(&$done) {
+                               if (!$done) {
+                                       $this->info(" %3d%% [%s>%s] \r",
+                                               floor($bytes_pct*100),
+                                               str_repeat("=", round(50*$bytes_pct)),
+                                               str_repeat(" ", round(50*(1-$bytes_pct)))
+                                       );
+                                       if ($bytes_pct == 1) {
+                                               $done = true;
+                                               $this->info("\n");
+                                       }
+                               }
+                       });
+               }
+               $local = $task->run($this->verbosity());
+
+               $this->cleanup[] = new Task\Cleanup($local);
+               return $local;
+       }
+
+       /**
+        * Extract local archive
+        * @param stirng $source
+        * @return string extracted directory
+        */
+       private function extract($source) {
+               try {
+                       $task = new Task\Extract($source);
+                       $dest = $task->run($this->verbosity());
+               } catch (\Exception $e) {
+                       if (false === strpos($e->getMessage(), "checksum mismatch")) {
+                               throw $e;
+                       }
+                       $dest = (new Task\PaxFixup($source))->run($this->verbosity());
+               }
+               
+               $this->cleanup[] = new Task\Cleanup($dest);
+               return $dest;
+       }
+
+       /**
+        * Localize a possibly remote source
+        * @param string $source
+        * @return string local source directory
+        */
+       private function localize($source) {
+               if (!stream_is_local($source) || ($this->args->git && isset($this->args->branch))) {
+                       $source = $this->download($source);
+                       $this->cleanup[] = new Task\Cleanup($source);
+               }
+               $source = realpath($source);
+               if (!is_dir($source)) {
+                       $source = $this->extract($source);
+                       $this->cleanup[] = new Task\Cleanup($source);
+                       
+                       if (!$this->args->git) {
+                               $source = (new Task\PeclFixup($source))->run($this->verbosity());
+                       }
+               }
+               return $source;
+       }
+
+       /**
+        * Load the source dir
+        * @throws \pharext\Exception
+        */
+       private function loadSource(){
+               if ($this->args["source"]) {
+                       $source = $this->localize($this->args["source"]);
+
+                       if ($this->args["pecl"]) {
+                               $this->source = new SourceDir\Pecl($source);
+                       } elseif ($this->args["git"]) {
+                               $this->source = new SourceDir\Git($source);
+                       } elseif (is_file("$source/pharext_package.php")) {
+                               $this->source = include "$source/pharext_package.php";
+                       } else {
+                               $this->source = new SourceDir\Basic($source);
+                       }
+
+                       if (!$this->source instanceof SourceDir) {
+                               throw new Exception("Unknown source dir $source");
+                       }
+
+                       foreach ($this->source->getPackageInfo() as $key => $val) {
+                               $this->args->$key = $val;
+                       }
+               }
+       }
+
+       /**
+        * Creates the extension phar
+        */
+       private function createPackage() {
+               try {
+                       $meta = array_merge(Metadata::all(), [
+                               "name" => $this->args->name,
+                               "release" => $this->args->release,
+                               "license" => $this->source->getLicense(),
+                               "type" => $this->args->zend ? "zend_extension" : "extension",
+                       ]);
+                       $file = (new Task\PharBuild($this->source, __DIR__."/../pharext_installer.php", $meta))->run($this->verbosity());
+               } catch (\Exception $e) {
+                       $this->error("%s\n", $e->getMessage());
+                       exit(self::EBUILD);
+               }
+
+               try {
+                       if ($this->args->sign) {
+                               $this->info("Using private key to sign phar ...\n");
+                               $pass = (new Task\Askpass)->run($this->verbosity());
+                               $sign = new Task\PharSign($file, $this->args->sign, $pass);
+                               $pkey = $sign->run($this->verbosity());
+                       }
+
+               } catch (\Exception $e) {
+                       $this->error("%s\n", $e->getMessage());
+                       exit(self::ESIGN);
+               }
+
+               if ($this->args->gzip) {
+                       try {
+                               $gzip = (new Task\PharCompress($file, Phar::GZ))->run();
+                               $move = new Task\PharRename($gzip, $this->args->dest, $this->args->name ."-". $this->args->release);
+                               $name = $move->run($this->verbosity());
+
+                               $this->info("Created gzipped phar %s\n", $name);
+
+                               if ($this->args->sign) {
+                                       $sign = new Task\PharSign($name, $this->args->sign, $pass);
+                                       $sign->run($this->verbosity())->exportPublicKey($name.".pubkey");
+                               }
+
+                       } catch (\Exception $e) {
+                               $this->warn("%s\n", $e->getMessage());
+                       }
+               }
+               
+               if ($this->args->bzip) {
+                       try {
+                               $bzip = (new Task\PharCompress($file, Phar::BZ2))->run();
+                               $move = new Task\PharRename($bzip, $this->args->dest, $this->args->name ."-". $this->args->release);
+                               $name = $move->run($this->verbosity());
+
+                               $this->info("Created bzipped phar %s\n", $name);
+
+                               if ($this->args->sign) {
+                                       $sign = new Task\PharSign($name, $this->args->sign, $pass);
+                                       $sign->run($this->verbosity())->exportPublicKey($name.".pubkey");
+                               }
+
+                       } catch (\Exception $e) {
+                               $this->warn("%s\n", $e->getMessage());
+                       }
+               }
+
+               try {
+                       $move = new Task\PharRename($file, $this->args->dest, $this->args->name ."-". $this->args->release);
+                       $name = $move->run($this->verbosity());
+
+                       $this->info("Created executable phar %s\n", $name);
+
+                       if (isset($pkey)) {
+                               $pkey->exportPublicKey($name.".pubkey");
+                       }
+
+               } catch (\Exception $e) {
+                       $this->error("%s\n", $e->getMessage());
+                       exit(self::EBUILD);
+               }
+       }
+}
+<?php
+
+namespace pharext\SourceDir;
+
+use pharext\Cli\Args;
+use pharext\License;
+use pharext\SourceDir;
+
+use FilesystemIterator;
+use IteratorAggregate;
+use RecursiveCallbackFilterIterator;
+use RecursiveDirectoryIterator;
+use RecursiveIteratorIterator;
+
+
+class Basic implements IteratorAggregate, SourceDir
+{
+       use License;
+       
+       private $path;
+       
+       public function __construct($path) {
+               $this->path = $path;
+       }
+       
+       public function getBaseDir() {
+               return $this->path;
+       }
+       
+       public function getPackageInfo() {
+               return [];
+       }
+       
+       public function getLicense() {
+               if (($file = $this->findLicense($this->getBaseDir()))) {
+                       return $this->readLicense($file);
+               }
+               return "UNKNOWN";
+       }
+
+       public function getArgs() {
+               return [];
+       }
+       
+       public function setArgs(Args $args) {
+       }
+
+       public function filter($current, $key, $iterator) {
+               $sub = $current->getSubPath();
+               if ($sub === ".git" || $sub === ".hg" || $sub === ".svn") {
+                       return false;
+               }
+               return true;
+       }
+       
+       public function getIterator() {
+               $rdi = new RecursiveDirectoryIterator($this->path,
+                               FilesystemIterator::CURRENT_AS_SELF | // needed for 5.5
+                               FilesystemIterator::KEY_AS_PATHNAME |
+                               FilesystemIterator::SKIP_DOTS);
+               $rci = new RecursiveCallbackFilterIterator($rdi, [$this, "filter"]);
+               $rii = new RecursiveIteratorIterator($rci);
+               foreach ($rii as $path => $child) {
+                       if (!$child->isDir()) {
+                               yield realpath($path);
+                       }
+               }
+       }
+}
+<?php
+
+namespace pharext\SourceDir;
+
+use pharext\Cli\Args;
+use pharext\License;
+use pharext\SourceDir;
+
+/**
+ * Extension source directory which is a git repo
+ */
+class Git implements \IteratorAggregate, SourceDir
+{
+       use License;
+       
+       /**
+        * Base directory
+        * @var string
+        */
+       private $path;
+       
+       /**
+        * @inheritdoc
+        * @see \pharext\SourceDir::__construct()
+        */
+       public function __construct($path) {
+               $this->path = $path;
+       }
+
+       /**
+        * @inheritdoc
+        * @see \pharext\SourceDir::getBaseDir()
+        */
+       public function getBaseDir() {
+               return $this->path;
+       }
+
+       /**
+        * @inheritdoc
+        * @return array
+        */
+       public function getPackageInfo() {
+               return [];
+       }
+
+       /**
+        * @inheritdoc
+        * @return string
+        */
+       public function getLicense() {
+               if (($file = $this->findLicense($this->getBaseDir()))) {
+                       return $this->readLicense($file);
+               }
+               return "UNKNOWN";
+       }
+
+       /**
+        * @inheritdoc
+        * @return array
+        */
+       public function getArgs() {
+               return [];
+       }
+
+       /**
+        * @inheritdoc
+        */
+       public function setArgs(Args $args) {
+       }
+
+       /**
+        * Generate a list of files by `git ls-files`
+        * @return Generator
+        */
+       private function generateFiles() {
+               $pwd = getcwd();
+               chdir($this->path);
+               if (($pipe = popen("git ls-tree -r --name-only HEAD", "r"))) {
+                       $path = realpath($this->path);
+                       while (!feof($pipe)) {
+                               if (strlen($file = trim(fgets($pipe)))) {
+                                       /* there may be symlinks, so no realpath here */
+                                       yield "$path/$file";
+                               }
+                       }
+                       pclose($pipe);
+               }
+               chdir($pwd);
+       }
+
+       /**
+        * Implements IteratorAggregate
+        * @see IteratorAggregate::getIterator()
+        */
+       public function getIterator() {
+               return $this->generateFiles();
+       }
+}
+<?php
+
+namespace pharext\SourceDir;
+
+use pharext\Cli\Args;
+use pharext\Exception;
+use pharext\SourceDir;
+use pharext\License;
+
+/**
+ * A PECL extension source directory containing a v2 package.xml
+ */
+class Pecl implements \IteratorAggregate, SourceDir
+{
+       use License;
+       
+       /**
+        * The package.xml
+        * @var SimpleXmlElement
+        */
+       private $sxe;
+       
+       /**
+        * The base directory
+        * @var string
+        */
+       private $path;
+
+       /**
+        * The package.xml
+        * @var string
+        */
+       private $file;
+       
+       /**
+        * @inheritdoc
+        * @see \pharext\SourceDir::__construct()
+        */
+       public function __construct($path) {
+               if (is_file("$path/package2.xml")) {
+                       $sxe = simplexml_load_file($this->file = "$path/package2.xml");
+               } elseif (is_file("$path/package.xml")) {
+                       $sxe = simplexml_load_file($this->file = "$path/package.xml");
+               } else {
+                       throw new Exception("Missing package.xml in $path");
+               }
+               
+               $sxe->registerXPathNamespace("pecl", $sxe->getDocNamespaces()[""]);
+               
+               $this->sxe = $sxe;
+               $this->path = realpath($path);
+       }
+       
+       /**
+        * @inheritdoc
+        * @see \pharext\SourceDir::getBaseDir()
+        */
+       public function getBaseDir() {
+               return $this->path;
+       }
+
+       /**
+        * Retrieve gathered package info
+        * @return Generator
+        */
+       public function getPackageInfo() {
+               if (($name = $this->sxe->xpath("/pecl:package/pecl:name"))) {
+                       yield "name" => (string) $name[0];
+               }
+               if (($release = $this->sxe->xpath("/pecl:package/pecl:version/pecl:release"))) {
+                       yield "release" => (string) $release[0];
+               }
+               if ($this->sxe->xpath("/pecl:package/pecl:zendextsrcrelease")) {
+                       yield "zend" => true;
+               }
+       }
+
+       /**
+        * @inheritdoc
+        * @return string
+        */
+       public function getLicense() {
+               if (($license = $this->sxe->xpath("/pecl:package/pecl:license"))) {
+                       if (($file = $this->findLicense($this->getBaseDir(), $license[0]["filesource"]))) {
+                               return $this->readLicense($file);
+                       }
+               }
+               if (($file = $this->findLicense($this->getBaseDir()))) {
+                       return $this->readLicense($file);
+               }
+               if ($license) {
+                       return $license[0] ." ". $license[0]["uri"];
+               }
+               return "UNKNOWN";
+       }
+
+       /**
+        * @inheritdoc
+        * @see \pharext\SourceDir::getArgs()
+        */
+       public function getArgs() {
+               $configure = $this->sxe->xpath("/pecl:package/pecl:extsrcrelease/pecl:configureoption");
+               foreach ($configure as $cfg) {
+                       yield [null, $cfg["name"], ucfirst($cfg["prompt"]), Args::OPTARG,
+                               strlen($cfg["default"]) ? $cfg["default"] : null];
+               }
+               $configure = $this->sxe->xpath("/pecl:package/pecl:zendextsrcrelease/pecl:configureoption");
+               foreach ($configure as $cfg) {
+                       yield [null, $cfg["name"], ucfirst($cfg["prompt"]), Args::OPTARG,
+                               strlen($cfg["default"]) ? $cfg["default"] : null];
+               }
+       }
+
+       /**
+        * @inheritdoc
+        * @see \pharext\SourceDir::setArgs()
+        */
+       public function setArgs(Args $args) {
+               $configure = $this->sxe->xpath("/pecl:package/pecl:extsrcrelease/pecl:configureoption");
+               foreach ($configure as $cfg) {
+                       if (isset($args[$cfg["name"]])) {
+                               $args->configure = "--{$cfg["name"]}={$args[$cfg["name"]]}";
+                       }
+               }
+               $configure = $this->sxe->xpath("/pecl:package/pecl:zendextsrcrelease/pecl:configureoption");
+               foreach ($configure as $cfg) {
+                       if (isset($args[$cfg["name"]])) {
+                               $args->configure = "--{$cfg["name"]}={$args[$cfg["name"]]}";
+                       }
+               }
+       }
+       
+       /**
+        * Compute the path of a file by parent dir nodes
+        * @param \SimpleXMLElement $ele
+        * @return string
+        */
+       private function dirOf($ele) {
+               $path = "";
+               while (($ele = current($ele->xpath(".."))) && $ele->getName() == "dir") {
+                       $path = trim($ele["name"], "/") ."/". $path ;
+               }
+               return trim($path, "/");
+       }
+
+       /**
+        * Generate a list of files from the package.xml
+        * @return Generator
+        */
+       private function generateFiles() {
+               /* hook  */
+               $temp = tmpfile();
+               fprintf($temp, "<?php\nreturn new %s(__DIR__);\n", get_class($this));
+               rewind($temp);
+               yield "pharext_package.php" => $temp;
+
+               /* deps */
+               $dependencies = $this->sxe->xpath("/pecl:package/pecl:dependencies/pecl:required/pecl:package");
+               foreach ($dependencies as $key => $dep) {
+                       if (($glob = glob("{$this->path}/{$dep->name}-*.ext.phar*"))) {
+                               usort($glob, function($a, $b) {
+                                       return version_compare(
+                                               substr($a, strpos(".ext.phar", $a)),
+                                               substr($b, strpos(".ext.phar", $b))
+                                       );
+                               });
+                               yield end($glob);
+                       }
+               }
+
+               /* files */
+               yield realpath($this->file);
+               foreach ($this->sxe->xpath("//pecl:file") as $file) {
+                       yield realpath($this->path ."/". $this->dirOf($file) ."/". $file["name"]);
+               }
+       }
+       
+       /**
+        * Implements IteratorAggregate
+        * @see IteratorAggregate::getIterator()
+        */
+       public function getIterator() {
+               return $this->generateFiles();
+       }
+}
+<?php
+
+namespace pharext;
+
+/**
+ * Source directory interface, which should yield file names to package on traversal
+ */
+interface SourceDir extends \Traversable
+{
+       /**
+        * Retrieve the base directory
+        * @return string
+        */
+       public function getBaseDir();
+
+       /**
+        * Retrieve gathered package info
+        * @return array|Traversable
+        */
+       public function getPackageInfo();
+
+       /**
+        * Retrieve the full text license
+        * @return string
+        */
+       public function getLicense();
+
+       /**
+        * Provide installer command line args
+        * @return array|Traversable
+        */
+       public function getArgs();
+
+       /**
+        * Process installer command line args
+        * @param \pharext\Cli\Args $args
+        */
+       public function setArgs(Cli\Args $args);
+}
+<?php
+
+namespace pharext\Task;
+
+use pharext\Exception;
+use pharext\ExecCmd;
+use pharext\Task;
+use pharext\Tempfile;
+
+/**
+ * PHP INI activation
+ */
+class Activate implements Task
+{
+       /**
+        * @var string
+        */
+       private $cwd;
+
+       /**
+        * @var array
+        */
+       private $inis;
+
+       /**
+        * @var string
+        */
+       private $type;
+
+       /**
+        * @var string
+        */
+       private $php_config;
+       
+       /**
+        * @var string
+        */
+       private $sudo;
+
+       /**
+        * @param string $cwd working directory
+        * @param array $inis custom INI or list of loaded/scanned INI files
+        * @param string $type extension or zend_extension
+        * @param string $prefix install prefix, e.g. /usr/local
+        * @param string $common_name PHP programs common name, e.g. php5
+        * @param string $sudo sudo command
+        * @throws \pharext\Exception
+        */
+       public function __construct($cwd, array $inis, $type = "extension", $prefix = null, $common_name = "php", $sudo = null) {
+               $this->cwd = $cwd;
+               $this->type = $type;
+               $this->sudo = $sudo;
+               if (!$this->inis = $inis) {
+                       throw new Exception("No PHP INIs given");
+               }
+               $cmd = $common_name . "-config";
+               if (isset($prefix)) {
+                       $cmd = $prefix . "/bin/" . $cmd;
+               }
+               $this->php_config = $cmd;
+       }
+
+       /**
+        * @param bool $verbose
+        * @return boolean false, if extension was already activated
+        */
+       public function run($verbose = false) {
+               if ($verbose !== false) {
+                       printf("Running INI activation ...\n");
+               }
+               $extension = basename(current(glob("{$this->cwd}/modules/*.so")));
+
+               if ($this->type === "zend_extension") {
+                       $pattern = preg_quote((new ExecCmd($this->php_config))->run(["--extension-dir"])->getOutput() . "/$extension", "/");
+               } else {
+                       $pattern = preg_quote($extension, "/");
+               }
+
+               foreach ($this->inis as $file) {
+                       if ($verbose) {
+                               printf("Checking %s ...\n", $file);
+                       }
+                       if (!file_exists($file)) {
+                               throw new Exception(sprintf("INI file '%s' does not exist", $file));
+                       }
+                       $temp = new Tempfile("phpini");
+                       foreach (file($file) as $line) {
+                               if (preg_match("/^\s*{$this->type}\s*=\s*[\"']?{$pattern}[\"']?\s*(;.*)?\$/", $line)) {
+                                       return false;
+                               }
+                               fwrite($temp->getStream(), $line);
+                       }
+               }
+
+               /* not found; append to last processed file, which is the main by default */
+               if ($verbose) {
+                       printf("Activating in %s ...\n", $file);
+               }
+               fprintf($temp->getStream(), $this->type . "=%s\n", $extension);
+               $temp->closeStream();
+
+               $path = $temp->getPathname();
+               $stat = stat($file);
+
+               // owner transfer
+               $ugid = sprintf("%d:%d", $stat["uid"], $stat["gid"]);
+               $cmd = new ExecCmd("chown", $verbose);
+               if (isset($this->sudo)) {
+                       $cmd->setSu($this->sudo);
+               }
+               $cmd->run([$ugid, $path]);
+
+               // permission transfer
+               $perm = decoct($stat["mode"] & 0777);
+               $cmd = new ExecCmd("chmod", $verbose);
+               if (isset($this->sudo)) {
+                       $cmd->setSu($this->sudo);
+               }
+               $cmd->run([$perm, $path]);
+
+               // rename
+               $cmd = new ExecCmd("mv", $verbose);
+               if (isset($this->sudo)) {
+                       $cmd->setSu($this->sudo);
+               }
+               $cmd->run([$path, $file]);
+               
+               if ($verbose) {
+                       printf("Replaced %s ...\n", $file);
+               }
+
+               return true;
+       }
+}
+<?php
+
+namespace pharext\Task;
+
+use pharext\Task;
+
+/**
+ * Ask password on console
+ */
+class Askpass implements Task
+{
+       /**
+        * @var string
+        */
+       private $prompt;
+
+       /**
+        * @param string $prompt
+        */
+       public function __construct($prompt = "Password:") {
+               $this->prompt = $prompt;
+       }
+
+       /**
+        * @param bool $verbose
+        * @return string
+        */
+       public function run($verbose = false) {
+               system("stty -echo");
+               printf("%s ", $this->prompt);
+               $pass = fgets(STDIN, 1024);
+               printf("\n");
+               system("stty echo");
+               if (substr($pass, -1) == "\n") {
+                       $pass = substr($pass, 0, -1);
+               }
+               return $pass;
+       }
+}
+<?php
+
+namespace pharext\Task;
+
+use pharext\Task;
+
+use RecursiveDirectoryIterator;
+use RecursiveIteratorIterator;
+
+/**
+ * List all library files of pharext to bundle with a phar
+ */
+class BundleGenerator implements Task
+{
+       /**
+        * @param bool $verbose
+        * @return Generator
+        */
+       public function run($verbose = false) {
+               if ($verbose) {
+                       printf("Packaging pharext ... \n");
+               }
+               $rdi = new RecursiveDirectoryIterator(dirname(dirname(__DIR__)));
+               $rii = new RecursiveIteratorIterator($rdi);
+               for ($rii->rewind(); $rii->valid(); $rii->next()) {
+                       if (!$rii->isDot()) {
+                               yield $rii->getSubPathname() => $rii->key();
+                       }
+               }
+       }
+}
+<?php
+
+namespace pharext\Task;
+
+use pharext\Task;
+
+use FilesystemIterator;
+use RecursiveDirectoryIterator;
+use RecursiveIteratorIterator;
+
+/**
+ * Recursively cleanup FS entries
+ */
+class Cleanup implements Task
+{
+       /**
+        * @var string
+        */
+       private $rm;
+
+       public function __construct($rm) {
+               $this->rm = $rm;
+       }
+
+       /**
+        * @param bool $verbose
+        */
+       public function run($verbose = false) {
+               if ($verbose) {
+                       printf("Cleaning up %s ...\n", $this->rm);
+               }
+               if ($this->rm instanceof Tempfile) {
+                       unset($this->rm);
+               } elseif (is_dir($this->rm)) {
+                       $rdi = new RecursiveDirectoryIterator($this->rm,
+                               FilesystemIterator::CURRENT_AS_SELF | // needed for 5.5
+                               FilesystemIterator::KEY_AS_PATHNAME |
+                               FilesystemIterator::SKIP_DOTS);
+                       $rii = new RecursiveIteratorIterator($rdi,
+                               RecursiveIteratorIterator::CHILD_FIRST);
+                       foreach ($rii as $path => $child) {
+                               if ($child->isDir()) {
+                                       @rmdir($path);
+                               } else {
+                                       @unlink($path);
+                               }
+                       }
+                       @rmdir($this->rm);
+               } elseif (file_exists($this->rm)) {
+                       @unlink($this->rm);
+               }
+       }
+}
+<?php
+
+namespace pharext\Task;
+
+use pharext\Exception;
+use pharext\ExecCmd;
+use pharext\Task;
+
+/**
+ * Runs extension's configure
+ */
+class Configure implements Task
+{
+       /**
+        * @var array
+        */
+       private $args;
+
+       /**
+        * @var string
+        */
+       private $cwd;
+
+       /**
+        * @param string $cwd working directory
+        * @param array $args configure args
+        * @param string $prefix install prefix, e.g. /usr/local
+        * @param string $common_name PHP programs common name, e.g. php5
+        */
+       public function __construct($cwd, array $args = null, $prefix = null, $common_name = "php") {
+               $this->cwd = $cwd;
+               $cmd = $common_name . "-config";
+               if (isset($prefix)) {
+                       $cmd = $prefix . "/bin/" . $cmd;
+               }
+               $this->args =  ["--with-php-config=$cmd"];
+               if ($args) {
+                       $this->args = array_merge($this->args, $args);
+               }
+       }
+
+       public function run($verbose = false) {
+               if ($verbose !== false) {
+                       printf("Running ./configure ...\n");
+               }
+               $pwd = getcwd();
+               if (!chdir($this->cwd)) {
+                       throw new Exception;
+               }
+               try {
+                       $cmd = new ExecCmd("./configure", $verbose);
+                       $cmd->run($this->args);
+               } finally {
+                       chdir($pwd);
+               }
+       }
+}
+<?php
+
+namespace pharext\Task;
+
+use pharext\Archive;
+use pharext\Task;
+use pharext\Tempdir;
+
+use Phar;
+use PharData;
+
+/**
+ * Extract a package archive
+ */
+class Extract implements Task
+{
+       /**
+        * @var Phar(Data)
+        */
+       private $source;
+
+       /**
+        * @param mixed $source archive location
+        */
+       public function __construct($source) {
+               if ($source instanceof Phar || $source instanceof PharData || $source instanceof Archive) {
+                       $this->source = $source;
+               } else {
+                       $this->source = new PharData($source);
+               }
+       }
+
+       /**
+        * @param bool $verbose
+        * @return \pharext\Tempdir
+        */
+       public function run($verbose = false) {
+               if ($verbose) {
+                       printf("Extracting %s ...\n", basename($this->source->getPath()));
+               }
+               if ($this->source instanceof Archive) {
+                       return $this->source->extract();
+               }
+               $dest = new Tempdir("extract");
+               $this->source->extractTo($dest);
+               return $dest;
+       }
+}
+<?php
+
+namespace pharext\Task;
+
+use pharext\ExecCmd;
+use pharext\Task;
+use pharext\Tempdir;
+
+/**
+ * Clone a git repo
+ */
+class GitClone implements Task
+{
+       /**
+        * @var string
+        */
+       private $source;
+       
+       /**
+        * @var string
+        */
+       private $branch;
+
+       /**
+        * @param string $source git repo location
+        */
+       public function __construct($source, $branch = null) {
+               $this->source = $source;
+               $this->branch = $branch;
+       }
+
+       /**
+        * @param bool $verbose
+        * @return \pharext\Tempdir
+        */
+       public function run($verbose = false) {
+               if ($verbose !== false) {
+                       printf("Fetching %s ...\n", $this->source);
+               }
+               $local = new Tempdir("gitclone");
+               $cmd = new ExecCmd("git", $verbose);
+               if (strlen($this->branch)) {
+                       $cmd->run(["clone", "--depth", 1, "--branch", $this->branch, $this->source, $local]);
+               } else {
+                       $cmd->run(["clone", $this->source, $local]);
+               }
+               return $local;
+       }
+}
+<?php
+
+namespace pharext\Task;
+
+use pharext\ExecCmd;
+use pharext\Exception;
+use pharext\Task;
+
+/**
+ * Run make in the source dir
+ */
+class Make implements Task
+{
+       /**
+        * @var string
+        */
+       private $cwd;
+
+       /**
+        * @var array
+        */
+       private $args;
+
+       /**
+        * @var string
+        */
+       private $sudo;
+
+       /**
+        *
+        * @param string $cwd working directory
+        * @param array $args make's arguments
+        * @param string $sudo sudo command
+        */
+       public function __construct($cwd, array $args = null, $sudo = null) {
+               $this->cwd = $cwd;
+               $this->sudo = $sudo;
+               $this->args = $args;
+       }
+
+       /**
+        *
+        * @param bool $verbose
+        * @throws \pharext\Exception
+        */
+       public function run($verbose = false) {
+               if ($verbose !== false) {
+                       printf("Running make");
+                       if ($this->args) {
+                               foreach ($this->args as $arg) {
+                                       printf(" %s", $arg);
+                               }
+                       }
+                       printf(" ...\n");
+               }
+               $pwd = getcwd();
+               if (!chdir($this->cwd)) {
+                       throw new Exception;
+               }
+               try {
+                       $cmd = new ExecCmd("make", $verbose);
+                       if (isset($this->sudo)) {
+                               $cmd->setSu($this->sudo);
+                       }
+                       $args = $this->args;
+                       if (!$verbose) {
+                               $args = array_merge((array) $args, ["-s"]);
+                       }
+                       $cmd->run($args);
+               } finally {
+                       chdir($pwd);
+               }
+       }
+}
+<?php
+
+namespace pharext\Task;
+
+use pharext\Exception;
+use pharext\Task;
+use pharext\Tempfile;
+
+class PaxFixup implements Task
+{
+       private $source;
+
+       public function __construct($source) {
+               $this->source = $source;
+       }
+
+       private function openArchive($source) {
+               $hdr = file_get_contents($source, false, null, 0, 3);
+               if ($hdr === "\x1f\x8b\x08") {
+                       $fd = fopen("compress.zlib://$source", "r");
+               } elseif ($hdr === "BZh") {
+                       $fd = fopen("compress.bzip2://$source", "r");
+               } else {
+                       $fd = fopen($source, "r");
+               }
+               if (!is_resource($fd)) {
+                       throw new Exception;
+               }
+               return $fd;
+       }
+
+       public function run($verbose = false) {
+               if ($verbose !== false) {
+                       printf("Fixing up a tarball with global pax header ...\n");
+               }
+               $temp = new Tempfile("paxfix");
+               stream_copy_to_stream($this->openArchive($this->source),
+                       $temp->getStream(), -1, 1024);
+               $temp->closeStream();
+               return (new Extract((string) $temp))->run($verbose);
+       }
+}<?php
+
+namespace pharext\Task;
+
+use pharext\Exception;
+use pharext\Task;
+
+/**
+ * Fixup package.xml files in an extracted PECL dir
+ */
+class PeclFixup implements Task
+{
+       /**
+        * @var string
+        */
+       private $source;
+
+       /**
+        * @param string $source source directory
+        */
+       public function __construct($source) {
+               $this->source = $source;
+       }
+
+       /**
+        * @param bool $verbose
+        * @return string sanitized source location
+        * @throws \pahrext\Exception
+        */
+       public function run($verbose = false) {
+               if ($verbose !== false) {
+                       printf("Sanitizing PECL dir ...\n");
+               }
+               $dirs = glob("{$this->source}/*", GLOB_ONLYDIR);
+               $files = array_diff(glob("{$this->source}/*"), $dirs);
+               $check = array_reduce($files, function($r, $v) {
+                       return $v && fnmatch("package*.xml", basename($v));
+               }, true);
+
+               if (count($dirs) !== 1 || !$check) {
+                       throw new Exception("Does not look like an extracted PECL dir: {$this->source}");
+               }
+
+               $dest = current($dirs);
+
+               foreach ($files as $file) {
+                       if ($verbose) {
+                               printf("Moving %s into %s ...\n", basename($file), basename($dest));
+                       }
+                       if (!rename($file, "$dest/" . basename($file))) {
+                               throw new Exception;
+                       }
+               }
+
+               return $dest;
+       }
+}
+<?php
+
+namespace pharext\Task;
+
+use pharext\Exception;
+use pharext\SourceDir;
+use pharext\Task;
+use pharext\Tempname;
+
+use Phar;
+
+/**
+ * Build phar
+ */
+class PharBuild implements Task
+{
+       /**
+        * @var \pharext\SourceDir
+        */
+       private $source;
+
+       /**
+        * @var string
+        */
+       private $stub;
+
+       /**
+        * @var array
+        */
+       private $meta;
+
+       /**
+        * @var bool
+        */
+       private $readonly;
+
+       /**
+        * @param SourceDir $source extension source directory
+        * @param string $stub path to phar stub
+        * @param array $meta phar meta data
+        * @param bool $readonly whether the stub has -dphar.readonly=1 set
+        */
+       public function __construct(SourceDir $source = null, $stub, array $meta = null, $readonly = true) {
+               $this->source = $source;
+               $this->stub = $stub;
+               $this->meta = $meta;
+               $this->readonly = $readonly;
+       }
+
+       /**
+        * @param bool $verbose
+        * @return \pharext\Tempname
+        * @throws \pharext\Exception
+        */
+       public function run($verbose = false) {
+               /* Phar::compress() and ::convert*() use strtok("."), ugh!
+                * so, be sure to not use any other dots in the filename
+                * except for .phar
+                */
+               $temp = new Tempname("", "-pharext.phar");
+
+               $phar = new Phar($temp);
+               $phar->startBuffering();
+
+               if ($this->meta) {
+                       $phar->setMetadata($this->meta);
+               }
+               if ($this->stub) {
+                       (new PharStub($phar, $this->stub))->run($verbose);
+               }
+
+               $phar->buildFromIterator((new Task\BundleGenerator)->run());
+
+               if ($this->source) {
+                       if ($verbose) {
+                               $bdir = $this->source->getBaseDir();
+                               $blen = strlen($bdir);
+                               foreach ($this->source as $index => $file) {
+                                       if (is_resource($file)) {
+                                               printf("Packaging %s ...\n", $index);
+                                               $phar[$index] = $file;
+                                       } else {
+                                               printf("Packaging %s ...\n", $index = trim(substr($file, $blen), "/"));
+                                               $phar->addFile($file, $index);
+                                       }
+                               }
+                       } else {
+                               $phar->buildFromIterator($this->source, $this->source->getBaseDir());
+                       }
+               }
+
+               $phar->stopBuffering();
+               
+               if (!chmod($temp, fileperms($temp) | 0111)) {
+                       throw new Exception;
+               }
+               
+               return $temp;
+       }
+}<?php
+
+namespace pharext\Task;
+
+use pharext\Task;
+
+use Phar;
+
+/**
+ * Clone a compressed copy of a phar
+ */
+class PharCompress implements Task
+{
+       /**
+        * @var string
+        */
+       private $file;
+
+       /**
+        * @var Phar
+        */
+       private $package;
+
+       /**
+        * @var int
+        */
+       private $encoding;
+
+       /**
+        * @var string
+        */
+       private $extension;
+
+       /**
+        * @param string $file path to the original phar
+        * @param int $encoding Phar::GZ or Phar::BZ2
+        */
+       public function __construct($file, $encoding) {
+               $this->file = $file;
+               $this->package = new Phar($file);
+               $this->encoding = $encoding;
+
+               switch ($encoding) {
+                       case Phar::GZ:
+                               $this->extension = ".gz";
+                               break;
+                       case Phar::BZ2:
+                               $this->extension = ".bz2";
+                               break;
+               }
+       }
+
+       /**
+        * @param bool $verbose
+        * @return string
+        */
+       public function run($verbose = false) {
+               if ($verbose) {
+                       printf("Compressing %s ...\n", basename($this->package->getPath()));
+               }
+               /* stop shebang */
+               $stub = $this->package->getStub();
+               $phar = $this->package->compress($this->encoding);
+               $phar->setStub(substr($stub, strpos($stub, "\n")+1));
+               return $this->file . $this->extension;
+       }
+}
+<?php
+
+namespace pharext\Task;
+
+use pharext\Exception;
+use pharext\Task;
+
+/**
+ * Rename the phar archive
+ */
+class PharRename implements Task
+{
+       /**
+        * @var string
+        */
+       private $phar;
+
+       /**
+        * @var string
+        */
+       private $dest;
+
+       /**
+        * @var string
+        */
+       private $name;
+
+       /**
+        * @param string $phar path to phar
+        * @param string $dest destination dir
+        * @param string $name package name
+        */
+       public function __construct($phar, $dest, $name) {
+               $this->phar = $phar;
+               $this->dest = $dest;
+               $this->name = $name;
+       }
+
+       /**
+        * @param bool $verbose
+        * @return string path to renamed phar
+        * @throws \pharext\Exception
+        */
+       public function run($verbose = false) {
+               $extension = substr(strstr($this->phar, "-pharext.phar"), 8);
+               $name = sprintf("%s/%s.ext%s", $this->dest, $this->name, $extension);
+               
+               if ($verbose) {
+                       printf("Renaming %s to %s ...\n", basename($this->phar), basename($name));
+               }
+
+               if (!rename($this->phar, $name)) {
+                       throw new Exception;
+               }
+
+               return $name;
+       }
+}
+<?php
+
+namespace pharext\Task;
+
+use pharext\Openssl;
+use pharext\Task;
+
+use Phar;
+
+/**
+ * Sign the phar with a private key
+ */
+class PharSign implements Task
+{
+       /**
+        * @var Phar
+        */
+       private $phar;
+
+       /**
+        * @var \pharext\Openssl\PrivateKey
+        */
+       private $pkey;
+
+       /**
+        *
+        * @param mixed $phar phar instance or path to phar
+        * @param string $pkey path to private key
+        * @param string $pass password for the private key
+        */
+       public function __construct($phar, $pkey, $pass) {
+               if ($phar instanceof Phar || $phar instanceof PharData) {
+                       $this->phar = $phar;
+               } else {
+                       $this->phar = new Phar($phar);
+               }
+               $this->pkey = new Openssl\PrivateKey($pkey, $pass);
+       }
+
+       /**
+        * @param bool $verbose
+        * @return \pharext\Openssl\PrivateKey
+        */
+       public function run($verbose = false) {
+               if ($verbose) {
+                       printf("Signing %s ...\n", basename($this->phar->getPath()));
+               }
+               $this->pkey->sign($this->phar);
+               return $this->pkey;
+       }
+}
+<?php
+
+namespace pharext\Task;
+
+use Phar;
+use pharext\Exception;
+use pharext\Task;
+
+/**
+ * Set the phar's stub
+ */
+class PharStub implements Task
+{
+       /**
+        * @var \Phar
+        */
+       private $phar;
+
+       /**
+        * @var string
+        */
+       private $stub;
+
+       /**
+        * @param \Phar $phar
+        * @param string $stub file path to the stub
+        * @throws \pharext\Exception
+        */
+       function __construct(Phar $phar, $stub) {
+               $this->phar = $phar;
+               if (!file_exists($this->stub = $stub)) {
+                       throw new Exception("File '$stub' does not exist");
+               }
+       }
+
+       /**
+        * @param bool $verbose
+        */
+       function run($verbose = false) {
+               if ($verbose) {
+                       printf("Using stub '%s'...\n", basename($this->stub));
+               }
+               $stub = preg_replace_callback('/^#include <([^>]+)>/m', function($includes) {
+                       return file_get_contents($includes[1], true, null, 5);
+               }, file_get_contents($this->stub));
+               if ($this->phar->isCompressed() && substr($stub, 0, 2) === "#!") {
+                       $stub = substr($stub, strpos($stub, "\n")+1);
+               }
+               $this->phar->setStub($stub);
+       }
+}
+<?php
+
+namespace pharext\Task;
+
+use pharext\Exception;
+use pharext\ExecCmd;
+use pharext\Task;
+
+/**
+ * Run phpize in the extension source directory
+ */
+class Phpize implements Task
+{
+       /**
+        * @var string
+        */
+       private $phpize;
+
+       /**
+        *
+        * @var string
+        */
+       private $cwd;
+
+       /**
+        * @param string $cwd working directory
+        * @param string $prefix install prefix, e.g. /usr/local
+        * @param string $common_name PHP program common name, e.g. php5
+        */
+       public function __construct($cwd, $prefix = null,  $common_name = "php") {
+               $this->cwd = $cwd;
+               $cmd = $common_name . "ize";
+               if (isset($prefix)) {
+                       $cmd = $prefix . "/bin/" . $cmd;
+               }
+               $this->phpize = $cmd;
+       }
+
+       /**
+        * @param bool $verbose
+        * @throws \pharext\Exception
+        */
+       public function run($verbose = false) {
+               if ($verbose !== false) {
+                       printf("Running %s ...\n", $this->phpize);
+               }
+               $pwd = getcwd();
+               if (!chdir($this->cwd)) {
+                       throw new Exception;
+               }
+               try {
+                       $cmd = new ExecCmd($this->phpize, $verbose);
+                       $cmd->run();
+               } finally {
+                       chdir($pwd);
+               }
+       }
+}
+<?php
+
+namespace pharext\Task;
+
+use pharext\Exception;
+use pharext\Task;
+use pharext\Tempfile;
+
+/**
+ * Fetch a remote archive
+ */
+class StreamFetch implements Task
+{
+       /**
+        * @var string
+        */
+       private $source;
+
+       /**
+        * @var callable
+        */
+       private $progress;
+
+       /**
+        * @param string $source remote file location
+        * @param callable $progress progress callback
+        */
+       public function __construct($source, callable $progress) {
+               $this->source = $source;
+               $this->progress = $progress;
+       }
+
+       private function createStreamContext() {
+               $progress = $this->progress;
+
+               /* avoid bytes_max bug of older PHP versions */
+               $maxbytes = 0;
+               return stream_context_create([],["notification" => function($notification, $severity, $message, $code, $bytes_cur, $bytes_max) use($progress, &$maxbytes) {
+                       if ($bytes_max > $maxbytes) {
+                               $maxbytes = $bytes_max;
+                       }
+                       switch ($notification) {
+                               case STREAM_NOTIFY_CONNECT:
+                                       $progress(0);
+                                       break;
+                               case STREAM_NOTIFY_PROGRESS:
+                                       $progress($maxbytes > 0 ? $bytes_cur/$maxbytes : .5);
+                                       break;
+                               case STREAM_NOTIFY_COMPLETED:
+                                       /* this is sometimes not generated, why? */
+                                       $progress(1);
+                                       break;
+                       }
+               }]);
+       }
+
+       /**
+        * @param bool $verbose
+        * @return \pharext\Task\Tempfile
+        * @throws \pharext\Exception
+        */
+       public function run($verbose = false) {
+               if ($verbose !== false) {
+                       printf("Fetching %s ...\n", $this->source);
+               }
+               $context = $this->createStreamContext();
+
+               if (!$remote = fopen($this->source, "r", false, $context)) {
+                       throw new Exception;
+               }
+               
+               $local = new Tempfile("remote");
+               if (!stream_copy_to_stream($remote, $local->getStream())) {
+                       throw new Exception;
+               }
+               $local->closeStream();
+
+               /* STREAM_NOTIFY_COMPLETED is not generated, see above */
+               call_user_func($this->progress, 1);
+
+               return $local;
+       }
+}
+<?php
+
+namespace pharext;
+
+/**
+ * Simple task interface
+ */
+interface Task
+{
+       public function run($verbose = false);
+}
+<?php
+
+namespace pharext;
+
+/**
+ * Create a temporary directory
+ */
+class Tempdir extends \SplFileInfo
+{
+       /**
+        * @param string $prefix prefix to uniqid()
+        * @throws \pharext\Exception
+        */
+       public function __construct($prefix) {
+               $temp = new Tempname($prefix);
+               if (!is_dir($temp) && !mkdir($temp, 0700, true)) {
+                       throw new Exception("Could not create tempdir: ".error_get_last()["message"]);
+               }
+               parent::__construct($temp);
+       }
+}
+<?php 
+
+namespace pharext;
+
+/**
+ * Create a new temporary file
+ */
+class Tempfile extends \SplFileInfo
+{
+       /**
+        * @var resource
+        */
+       private $handle;
+
+       /**
+        * @param string $prefix uniqid() prefix
+        * @param string $suffix e.g. file extension
+        * @throws \pharext\Exception
+        */
+       public function __construct($prefix, $suffix = ".tmp") {
+               $tries = 0;
+               $omask = umask(077);
+               do {
+                       $path = new Tempname($prefix, $suffix);
+                       $this->handle = fopen($path, "x");
+               } while (!is_resource($this->handle) && $tries++ < 10);
+               umask($omask);
+               
+               if (!is_resource($this->handle)) {
+                       throw new Exception("Could not create temporary file");
+               }
+               
+               parent::__construct($path);
+       }
+
+       /**
+        * Unlink the file
+        */
+       public function __destruct() {
+               if (is_file($this->getPathname())) {
+                       @unlink($this->getPathname());
+               }
+       }
+
+       /**
+        * Close the stream
+        */
+       public function closeStream() {
+               fclose($this->handle);
+       }
+
+       /**
+        * Retrieve the stream resource
+        * @return resource
+        */
+       public function getStream() {
+               return $this->handle;
+       }
+}
+<?php
+
+namespace pharext;
+
+use pharext\Exception;
+
+/**
+ * A temporary file/directory name
+ */
+class Tempname
+{
+       /**
+        * @var string
+        */
+       private $name;
+
+       /**
+        * @param string $prefix uniqid() prefix
+        * @param string $suffix e.g. file extension
+        */
+       public function __construct($prefix, $suffix = null) {
+               $temp = sys_get_temp_dir() . "/pharext-" . $this->getUser();
+               if (!is_dir($temp) && !mkdir($temp, 0700, true)) {
+                       throw new Exception;
+               }
+               $this->name = $temp ."/". uniqid($prefix) . $suffix;
+       }
+
+       private function getUser() {
+               if (extension_loaded("posix") && function_exists("posix_getpwuid")) {
+                       return posix_getpwuid(posix_getuid())["name"];
+               }
+               return trim(`whoami 2>/dev/null`)
+                       ?: trim(`id -nu 2>/dev/null`)
+                       ?: getenv("USER")
+                       ?: get_current_user();
+       }
+
+       /**
+        * @return string
+        */
+       public function __toString() {
+               return (string) $this->name;
+       }
+}
+<?php
+
+namespace pharext;
+
+use Phar;
+use PharFileInfo;
+use SplFileInfo;
+use pharext\Exception;
+
+class Updater implements Command
+{
+       use Cli\Command;
+
+       /**
+        * Create the command
+        */
+       public function __construct() {
+               $this->args = new Cli\Args([
+                       ["h", "help", "Display this help",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+                       ["v", "verbose", "More output",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
+                       ["q", "quiet", "Less output",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
+                       [null, "signature", "Show pharext signature",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+                       [null, "license", "Show pharext license",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+                       [null, "version", "Show pharext version",
+                               Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
+                       [0, "path", "Path to .ext.phar to update",
+                               Cli\Args::REQUIRED|Cli\Args::MULTI],
+               ]);
+       }
+
+       /**
+        * @inheritdoc
+        * @see \pharext\Command::run()
+        */
+       public function run($argc, array $argv) {
+               $errs = [];
+               $prog = array_shift($argv);
+               foreach ($this->args->parse(--$argc, $argv) as $error) {
+                       $errs[] = $error;
+               }
+
+               if ($this->args["help"]) {
+                       $this->header();
+                       $this->help($prog);
+                       exit;
+               }
+
+               try {
+                       foreach (["signature", "license", "version"] as $opt) {
+                               if ($this->args[$opt]) {
+                                       printf("%s\n", $this->metadata($opt));
+                                       exit;
+                               }
+                       }
+               } catch (\Exception $e) {
+                       $this->error("%s\n", $e->getMessage());
+                       exit(self::EARGS);
+               }
+
+
+               foreach ($this->args->validate() as $error) {
+                       $errs[] = $error;
+               }
+
+               if ($errs) {
+                       if (!$this->args["quiet"]) {
+                               $this->header();
+                       }
+                       foreach ($errs as $err) {
+                               $this->error("%s\n", $err);
+                       }
+                       printf("\n");
+                       if (!$this->args["quiet"]) {
+                               $this->help($prog);
+                       }
+                       exit(self::EARGS);
+               }
+
+               foreach ($this->args[0] as $file) {
+                       $info = new SplFileInfo($file);
+
+                       while ($info->isLink()) {
+                               $info = new SplFileInfo($info->getLinkTarget());
+                       }
+                       
+                       if ($info->isFile()) {
+                               if (!$this->updatePackage($info)) {
+                                       $this->warn("Cannot upgrade pre-v3 packages\n");
+                               }
+                       } else {
+                               $this->error("File '%s' does not exist\n", $file);
+                               exit(self::EARGS);
+                       }
+               }
+       }
+
+       /**
+        * Replace the pharext core in an .ext.phar package
+        * @param string $temp path to temp phar
+        * @return boolean FALSE if the package is too old (pre-v3) to upgrade
+        */
+       private function replacePharext($temp) {
+               $phar = new Phar($temp, Phar::CURRENT_AS_SELF);
+               $phar->startBuffering();
+
+               if (!$meta = $phar->getMetadata()) {
+                       // don't upgrade pre-v3 packages
+                       return false;
+               }
+
+               // replace current pharext files
+               $core = (new Task\BundleGenerator)->run($this->verbosity());
+               $phar->buildFromIterator($core);
+               $stub = __DIR__."/../pharext_installer.php";
+               (new Task\PharStub($phar, $stub))->run($this->verbosity());
+
+               // check dependencies
+               foreach ($phar as $info) {
+                       if (fnmatch("*.ext.phar*", $info->getBasename())) {
+                               $this->updatePackage($info, $phar);
+                       }
+               }
+               
+               $phar->stopBuffering();
+
+               $phar->setMetadata([
+                       "version" => Metadata::version(),
+                       "header" => Metadata::header(),
+               ] + $meta);
+
+               $this->info("Updated pharext version from '%s' to '%s'\n",
+                       isset($meta["version"]) ? $meta["version"] : "(unknown)",
+                       $phar->getMetadata()["version"]);
+
+               return true;
+       }
+
+       /**
+        * Update an .ext.phar package to the current pharext version
+        * @param SplFileInfo $file
+        * @param Phar $phar the parent phar containing $file as dependency
+        * @return boolean FALSE if the package is too old (pre-v3) to upgrade
+        * @throws Exception
+        */
+       private function updatePackage(SplFileInfo $file, Phar $phar = null) {
+               $this->info("Updating pharext core in '%s'...\n", basename($file));
+
+               $temp = new Tempname("update", substr(strstr($file, ".ext.phar"), 4));
+
+               if (!copy($file->getPathname(), $temp)) {
+                       throw new Exception;
+               }
+               if (!chmod($temp, $file->getPerms())) {
+                       throw new Exception;
+               }
+               
+               if (!$this->replacePharext($temp)) {
+                       return false;
+               }
+
+               if ($phar) {
+                       $phar->addFile($temp, $file);
+               } elseif (!rename($temp, $file->getPathname())) {
+                       throw new Exception;
+               }
+
+               return true;
+       }
+}
+#!/usr/bin/env php
+<?php
+
+/**
+ * The installer sub-stub for extension phars
+ */
+
+namespace pharext;
+
+define("PHAREXT_PHAR", __FILE__);
+
+spl_autoload_register(function($c) {
+       return include strtr($c, "\\_", "//") . ".php";
+});
+
+#include <pharext/Exception.php>
+#include <pharext/Tempname.php>
+#include <pharext/Tempfile.php>
+#include <pharext/Tempdir.php>
+#include <pharext/Archive.php>
+
+namespace pharext;
+
+if (extension_loaded("Phar")) {
+       \Phar::interceptFileFuncs();
+       \Phar::mapPhar();
+       $phardir = "phar://".__FILE__;
+} else {
+       $archive = new Archive(__FILE__);
+       $phardir = $archive->extract();
+}
+
+set_include_path("$phardir:". get_include_path());
+
+$installer = new Installer();
+$installer->run($argc, $argv);
+
+__HALT_COMPILER();
+#!/usr/bin/php -dphar.readonly=0
+<?php
+
+/**
+ * The packager sub-stub for bin/pharext
+ */
+
+namespace pharext;
+
+spl_autoload_register(function($c) {
+       return include strtr($c, "\\_", "//") . ".php";
+});
+
+set_include_path('phar://' . __FILE__ .":". get_include_path());
+
+if (!extension_loaded("Phar")) {
+       fprintf(STDERR, "ERROR: Phar extension not loaded\n\n");
+       fprintf(STDERR, "\tPlease load the phar extension in your php.ini\n".
+                                       "\tor rebuild PHP with the --enable-phar flag.\n\n");
+       exit(1);
+}
+
+if (ini_get("phar.readonly")) {
+       fprintf(STDERR, "ERROR: Phar is configured read-only\n\n");
+       fprintf(STDERR, "\tPlease specify phar.readonly=0 in your php.ini\n".
+                                       "\tor run this command with php -dphar.readonly=0\n\n");
+       exit(1);
+}
+
+\Phar::interceptFileFuncs();
+\Phar::mapPhar();
+
+$packager = new Packager();
+$packager->run($argc, $argv);
+
+__HALT_COMPILER();
+#!/usr/bin/php -dphar.readonly=0
+<?php
+
+/**
+ * The installer updater stub for extension phars
+ */
+
+namespace pharext;
+
+spl_autoload_register(function($c) {
+       return include strtr($c, "\\_", "//") . ".php";
+});
+
+set_include_path('phar://' . __FILE__ .":". get_include_path());
+
+if (!extension_loaded("Phar")) {
+       fprintf(STDERR, "ERROR: Phar extension not loaded\n\n");
+       fprintf(STDERR, "\tPlease load the phar extension in your php.ini\n".
+                                       "\tor rebuild PHP with the --enable-phar flag.\n\n");
+       exit(1);
+}
+
+if (ini_get("phar.readonly")) {
+       fprintf(STDERR, "ERROR: Phar is configured read-only\n\n");
+       fprintf(STDERR, "\tPlease specify phar.readonly=0 in your php.ini\n".
+                                       "\tor run this command with php -dphar.readonly=0\n\n");
+       exit(1);
+}
+
+\Phar::interceptFileFuncs();
+\Phar::mapPhar();
+
+$updater = new Updater();
+$updater->run($argc, $argv);
+
+__HALT_COMPILER();
+<?php
+return new pharext\SourceDir\Pecl(__DIR__);
+<?xml version="1.0" encoding="UTF-8"?>
+<package 
+ packagerversion="1.4.11" 
+ version="2.0" 
+ xmlns="http://pear.php.net/dtd/package-2.0" 
+ xmlns:tasks="http://pear.php.net/dtd/tasks-1.0" 
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
+ xsi:schemaLocation="http://pear.php.net/dtd/tasks-1.0
+http://pear.php.net/dtd/tasks-1.0.xsd
+http://pear.php.net/dtd/package-2.0
+http://pear.php.net/dtd/package-2.0.xsd">
+ <name>raphf</name>
+ <channel>pecl.php.net</channel>
+ <summary>Resource and persistent handles factory</summary>
+ <description>A reusable split-off of pecl_http's persistent handle and resource factory API.</description>
+ <lead>
+  <name>Michael Wallner</name>
+  <user>mike</user>
+  <email>mike@php.net</email>
+  <active>yes</active>
+ </lead>
+ <date>2015-07-28</date>
+ <version>
+  <release>1.1.0</release>
+  <api>1.0.0</api>
+ </version>
+ <stability>
+  <release>stable</release>
+  <api>stable</api>
+ </stability>
+ <license>BSD, revised</license>
+ <notes><![CDATA[
+* Fixed php module dependency check with RTLD_LAZY
++ Source code documentation available at http://m6w6.github.io/ext-raphf
+]]></notes>
+ <contents>
+  <dir name="/">
+   <file role="doc" name="CREDITS" />
+   <file role="doc" name="LICENSE" />
+   <file role="doc" name="Doxyfile" />
+   <file role="src" name="config.m4" />
+   <file role="src" name="config.w32" />
+   <file role="src" name="php_raphf.h" />
+   <file role="src" name="php_raphf_api.h" />
+   <file role="src" name="php_raphf.c" />
+   <dir name="tests">
+    <file role="test" name="http001.phpt" />
+    <file role="test" name="http002.phpt" />
+    <file role="test" name="http003.phpt" />
+    <file role="test" name="http004.phpt" />
+   </dir>
+  </dir>
+ </contents>
+ <dependencies>
+  <required>
+   <php>
+    <min>5.3.0</min>
+    <max>7.0.0</max>
+    <exclude>7.0.0</exclude>
+   </php>
+   <pearinstaller>
+    <min>1.4.0</min>
+   </pearinstaller>
+  </required>
+ </dependencies>
+ <providesextension>raphf</providesextension>
+ <extsrcrelease/>
+</package>
+
+raphf
+Michael Wallner
+Copyright (c) 2013, Michael Wallner <mike@php.net>.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice, 
+      this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright 
+      notice, this list of conditions and the following disclaimer in the 
+      documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE 
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+# Doxyfile 1.8.9.1
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+DOXYFILE_ENCODING      = UTF-8
+PROJECT_NAME           = "Resource and persistent handle factory API"
+PROJECT_NUMBER         =
+PROJECT_BRIEF          = "A facility to manage possibly persistent resources with a comprehensible API.  Provides simliar functionality like the zend_list API, but with more flexiblity and freedom."
+PROJECT_LOGO           = raphf.png
+OUTPUT_DIRECTORY       =
+CREATE_SUBDIRS         = NO
+ALLOW_UNICODE_NAMES    = NO
+OUTPUT_LANGUAGE        = English
+BRIEF_MEMBER_DESC      = YES
+REPEAT_BRIEF           = YES
+ABBREVIATE_BRIEF       =
+ALWAYS_DETAILED_SEC    = NO
+INLINE_INHERITED_MEMB  = NO
+FULL_PATH_NAMES        = YES
+STRIP_FROM_PATH        =
+STRIP_FROM_INC_PATH    =
+SHORT_NAMES            = NO
+JAVADOC_AUTOBRIEF      = YES
+QT_AUTOBRIEF           = NO
+MULTILINE_CPP_IS_BRIEF = NO
+INHERIT_DOCS           = YES
+SEPARATE_MEMBER_PAGES  = NO
+TAB_SIZE               = 4
+ALIASES                =
+TCL_SUBST              =
+OPTIMIZE_OUTPUT_FOR_C  = YES
+OPTIMIZE_OUTPUT_JAVA   = NO
+OPTIMIZE_FOR_FORTRAN   = NO
+OPTIMIZE_OUTPUT_VHDL   = NO
+EXTENSION_MAPPING      =
+MARKDOWN_SUPPORT       = YES
+AUTOLINK_SUPPORT       = YES
+BUILTIN_STL_SUPPORT    = NO
+CPP_CLI_SUPPORT        = NO
+SIP_SUPPORT            = NO
+IDL_PROPERTY_SUPPORT   = YES
+DISTRIBUTE_GROUP_DOC   = NO
+SUBGROUPING            = YES
+INLINE_GROUPED_CLASSES = NO
+INLINE_SIMPLE_STRUCTS  = YES
+TYPEDEF_HIDES_STRUCT   = NO
+LOOKUP_CACHE_SIZE      = 0
+#---------------------------------------------------------------------------
+# Build related configuration options
+#---------------------------------------------------------------------------
+EXTRACT_ALL            = YES
+EXTRACT_PRIVATE        = NO
+EXTRACT_PACKAGE        = NO
+EXTRACT_STATIC         = NO
+EXTRACT_LOCAL_CLASSES  = NO
+EXTRACT_LOCAL_METHODS  = NO
+EXTRACT_ANON_NSPACES   = NO
+HIDE_UNDOC_MEMBERS     = NO
+HIDE_UNDOC_CLASSES     = NO
+HIDE_FRIEND_COMPOUNDS  = NO
+HIDE_IN_BODY_DOCS      = NO
+INTERNAL_DOCS          = NO
+CASE_SENSE_NAMES       = YES
+HIDE_SCOPE_NAMES       = NO
+HIDE_COMPOUND_REFERENCE= NO
+SHOW_INCLUDE_FILES     = YES
+SHOW_GROUPED_MEMB_INC  = NO
+FORCE_LOCAL_INCLUDES   = NO
+INLINE_INFO            = YES
+SORT_MEMBER_DOCS       = YES
+SORT_BRIEF_DOCS        = NO
+SORT_MEMBERS_CTORS_1ST = NO
+SORT_GROUP_NAMES       = NO
+SORT_BY_SCOPE_NAME     = NO
+STRICT_PROTO_MATCHING  = NO
+GENERATE_TODOLIST      = YES
+GENERATE_TESTLIST      = YES
+GENERATE_BUGLIST       = YES
+GENERATE_DEPRECATEDLIST= YES
+ENABLED_SECTIONS       =
+MAX_INITIALIZER_LINES  = 30
+SHOW_USED_FILES        = YES
+SHOW_FILES             = YES
+SHOW_NAMESPACES        = YES
+FILE_VERSION_FILTER    =
+LAYOUT_FILE            =
+CITE_BIB_FILES         =
+#---------------------------------------------------------------------------
+# Configuration options related to warning and progress messages
+#---------------------------------------------------------------------------
+QUIET                  = NO
+WARNINGS               = YES
+WARN_IF_UNDOCUMENTED   = YES
+WARN_IF_DOC_ERROR      = YES
+WARN_NO_PARAMDOC       = NO
+WARN_FORMAT            = "$file:$line: $text"
+WARN_LOGFILE           =
+#---------------------------------------------------------------------------
+# Configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT                  = php_raphf.h
+INPUT_ENCODING         = UTF-8
+FILE_PATTERNS          =
+RECURSIVE              = NO
+EXCLUDE                =
+EXCLUDE_SYMLINKS       = NO
+EXCLUDE_PATTERNS       =
+EXCLUDE_SYMBOLS        =
+EXAMPLE_PATH           =
+EXAMPLE_PATTERNS       =
+EXAMPLE_RECURSIVE      = NO
+IMAGE_PATH             =
+INPUT_FILTER           =
+FILTER_PATTERNS        =
+FILTER_SOURCE_FILES    = NO
+FILTER_SOURCE_PATTERNS =
+USE_MDFILE_AS_MAINPAGE =
+#---------------------------------------------------------------------------
+# Configuration options related to source browsing
+#---------------------------------------------------------------------------
+SOURCE_BROWSER         = NO
+INLINE_SOURCES         = NO
+STRIP_CODE_COMMENTS    = YES
+REFERENCED_BY_RELATION = YES
+REFERENCES_RELATION    = NO
+REFERENCES_LINK_SOURCE = YES
+SOURCE_TOOLTIPS        = YES
+USE_HTAGS              = NO
+VERBATIM_HEADERS       = YES
+#---------------------------------------------------------------------------
+# Configuration options related to the alphabetical class index
+#---------------------------------------------------------------------------
+ALPHABETICAL_INDEX     = YES
+COLS_IN_ALPHA_INDEX    = 5
+IGNORE_PREFIX          =
+#---------------------------------------------------------------------------
+# Configuration options related to the HTML output
+#---------------------------------------------------------------------------
+GENERATE_HTML          = YES
+HTML_OUTPUT            = .
+HTML_FILE_EXTENSION    = .html
+HTML_HEADER            =
+HTML_FOOTER            =
+HTML_STYLESHEET        =
+HTML_EXTRA_STYLESHEET  =
+HTML_EXTRA_FILES       =
+HTML_COLORSTYLE_HUE    = 220
+HTML_COLORSTYLE_SAT    = 100
+HTML_COLORSTYLE_GAMMA  = 80
+HTML_TIMESTAMP         = NO
+HTML_DYNAMIC_SECTIONS  = NO
+HTML_INDEX_NUM_ENTRIES = 100
+GENERATE_DOCSET        = NO
+DOCSET_FEEDNAME        = "Doxygen generated docs"
+DOCSET_BUNDLE_ID       = org.doxygen.Project
+DOCSET_PUBLISHER_ID    = org.doxygen.Publisher
+DOCSET_PUBLISHER_NAME  = Publisher
+GENERATE_HTMLHELP      = NO
+CHM_FILE               =
+HHC_LOCATION           =
+GENERATE_CHI           = NO
+CHM_INDEX_ENCODING     =
+BINARY_TOC             = NO
+TOC_EXPAND             = NO
+GENERATE_QHP           = NO
+QCH_FILE               =
+QHP_NAMESPACE          = org.doxygen.Project
+QHP_VIRTUAL_FOLDER     = doc
+QHP_CUST_FILTER_NAME   =
+QHP_CUST_FILTER_ATTRS  =
+QHP_SECT_FILTER_ATTRS  =
+QHG_LOCATION           =
+GENERATE_ECLIPSEHELP   = NO
+ECLIPSE_DOC_ID         = org.doxygen.Project
+DISABLE_INDEX          = NO
+GENERATE_TREEVIEW      = YES
+ENUM_VALUES_PER_LINE   = 4
+TREEVIEW_WIDTH         = 250
+EXT_LINKS_IN_WINDOW    = NO
+FORMULA_FONTSIZE       = 10
+FORMULA_TRANSPARENT    = YES
+USE_MATHJAX            = NO
+MATHJAX_FORMAT         = HTML-CSS
+MATHJAX_RELPATH        = http://cdn.mathjax.org/mathjax/latest
+MATHJAX_EXTENSIONS     =
+MATHJAX_CODEFILE       =
+SEARCHENGINE           = YES
+SERVER_BASED_SEARCH    = NO
+EXTERNAL_SEARCH        = NO
+SEARCHENGINE_URL       =
+SEARCHDATA_FILE        = searchdata.xml
+EXTERNAL_SEARCH_ID     =
+EXTRA_SEARCH_MAPPINGS  =
+#---------------------------------------------------------------------------
+# Configuration options related to the LaTeX output
+#---------------------------------------------------------------------------
+GENERATE_LATEX         = NO
+LATEX_OUTPUT           = latex
+LATEX_CMD_NAME         = latex
+MAKEINDEX_CMD_NAME     = makeindex
+COMPACT_LATEX          = NO
+PAPER_TYPE             = a4
+EXTRA_PACKAGES         =
+LATEX_HEADER           =
+LATEX_FOOTER           =
+LATEX_EXTRA_STYLESHEET =
+LATEX_EXTRA_FILES      =
+PDF_HYPERLINKS         = YES
+USE_PDFLATEX           = YES
+LATEX_BATCHMODE        = NO
+LATEX_HIDE_INDICES     = NO
+LATEX_SOURCE_CODE      = NO
+LATEX_BIB_STYLE        = plain
+#---------------------------------------------------------------------------
+# Configuration options related to the RTF output
+#---------------------------------------------------------------------------
+GENERATE_RTF           = NO
+RTF_OUTPUT             = rtf
+COMPACT_RTF            = NO
+RTF_HYPERLINKS         = NO
+RTF_STYLESHEET_FILE    =
+RTF_EXTENSIONS_FILE    =
+RTF_SOURCE_CODE        = NO
+#---------------------------------------------------------------------------
+# Configuration options related to the man page output
+#---------------------------------------------------------------------------
+GENERATE_MAN           = NO
+MAN_OUTPUT             = man
+MAN_EXTENSION          = .3
+MAN_SUBDIR             =
+MAN_LINKS              = NO
+#---------------------------------------------------------------------------
+# Configuration options related to the XML output
+#---------------------------------------------------------------------------
+GENERATE_XML           = NO
+XML_OUTPUT             = xml
+XML_PROGRAMLISTING     = YES
+#---------------------------------------------------------------------------
+# Configuration options related to the DOCBOOK output
+#---------------------------------------------------------------------------
+GENERATE_DOCBOOK       = NO
+DOCBOOK_OUTPUT         = docbook
+DOCBOOK_PROGRAMLISTING = NO
+#---------------------------------------------------------------------------
+# Configuration options for the AutoGen Definitions output
+#---------------------------------------------------------------------------
+GENERATE_AUTOGEN_DEF   = NO
+#---------------------------------------------------------------------------
+# Configuration options related to the Perl module output
+#---------------------------------------------------------------------------
+GENERATE_PERLMOD       = NO
+PERLMOD_LATEX          = NO
+PERLMOD_PRETTY         = YES
+PERLMOD_MAKEVAR_PREFIX =
+#---------------------------------------------------------------------------
+# Configuration options related to the preprocessor
+#---------------------------------------------------------------------------
+ENABLE_PREPROCESSING   = YES
+MACRO_EXPANSION        = YES
+EXPAND_ONLY_PREDEF     = NO
+SEARCH_INCLUDES        = YES
+INCLUDE_PATH           =
+INCLUDE_FILE_PATTERNS  =
+PREDEFINED             = DOXYGEN \
+                         TSRMLS_C= \
+                         TSRMLS_D= \
+                         TSRMLS_CC= \
+                         TSRMLS_DC= \
+                         PHP_RAPHF_API=
+EXPAND_AS_DEFINED      =
+SKIP_FUNCTION_MACROS   = YES
+#---------------------------------------------------------------------------
+# Configuration options related to external references
+#---------------------------------------------------------------------------
+TAGFILES               =
+GENERATE_TAGFILE       =
+ALLEXTERNALS           = NO
+EXTERNAL_GROUPS        = YES
+EXTERNAL_PAGES         = YES
+PERL_PATH              = /usr/bin/perl
+#---------------------------------------------------------------------------
+# Configuration options related to the dot tool
+#---------------------------------------------------------------------------
+CLASS_DIAGRAMS         = YES
+MSCGEN_PATH            =
+DIA_PATH               =
+HIDE_UNDOC_RELATIONS   = YES
+HAVE_DOT               = YES
+DOT_NUM_THREADS        = 0
+DOT_FONTNAME           = Helvetica
+DOT_FONTSIZE           = 10
+DOT_FONTPATH           =
+CLASS_GRAPH            = NO
+COLLABORATION_GRAPH    = YES
+GROUP_GRAPHS           = YES
+UML_LOOK               = NO
+UML_LIMIT_NUM_FIELDS   = 10
+TEMPLATE_RELATIONS     = NO
+INCLUDE_GRAPH          = YES
+INCLUDED_BY_GRAPH      = YES
+CALL_GRAPH             = YES
+CALLER_GRAPH           = YES
+GRAPHICAL_HIERARCHY    = YES
+DIRECTORY_GRAPH        = YES
+DOT_IMAGE_FORMAT       = png
+INTERACTIVE_SVG        = NO
+DOT_PATH               =
+DOTFILE_DIRS           =
+MSCFILE_DIRS           =
+DIAFILE_DIRS           =
+PLANTUML_JAR_PATH      =
+PLANTUML_INCLUDE_PATH  =
+DOT_GRAPH_MAX_NODES    = 50
+MAX_DOT_GRAPH_DEPTH    = 0
+DOT_TRANSPARENT        = NO
+DOT_MULTI_TARGETS      = NO
+GENERATE_LEGEND        = YES
+DOT_CLEANUP            = YES
+PHP_ARG_ENABLE(raphf, whether to enable raphf support,
+[  --enable-raphf           Enable resource and persistent handles factory support])
+
+if test "$PHP_RAPHF" != "no"; then
+       PHP_INSTALL_HEADERS(ext/raphf, php_raphf.h php_raphf_api.h)
+       PHP_NEW_EXTENSION(raphf, php_raphf.c, $ext_shared)
+fi
+\r
+\r
+ARG_ENABLE("raphf", "for raphf support", "no");\r
+\r
+if (PHP_RAPHF == "yes") {\r
+               EXTENSION("raphf", "php_raphf.c");\r
+\r
+               AC_DEFINE("HAVE_RAPHF", 1);\r
+               PHP_INSTALL_HEADERS("ext/raphf", "php_raphf.h");\r
+}\r
+/*
+    +--------------------------------------------------------------------+
+    | PECL :: raphf                                                      |
+    +--------------------------------------------------------------------+
+    | Redistribution and use in source and binary forms, with or without |
+    | modification, are permitted provided that the conditions mentioned |
+    | in the accompanying LICENSE file are met.                          |
+    +--------------------------------------------------------------------+
+    | Copyright (c) 2013, Michael Wallner <mike@php.net>                 |
+    +--------------------------------------------------------------------+
+*/
+
+#ifndef PHP_RAPHF_H
+#define PHP_RAPHF_H
+
+extern zend_module_entry raphf_module_entry;
+#define phpext_raphf_ptr &raphf_module_entry
+
+#define PHP_RAPHF_VERSION "1.1.0"
+
+#ifdef PHP_WIN32
+#      define PHP_RAPHF_API __declspec(dllexport)
+#elif defined(__GNUC__) && __GNUC__ >= 4
+#      define PHP_RAPHF_API extern __attribute__ ((visibility("default")))
+#else
+#      define PHP_RAPHF_API extern
+#endif
+
+#ifdef ZTS
+#      include "TSRM.h"
+#endif
+
+#include "php_raphf_api.h"
+
+#endif /* PHP_RAPHF_H */
+
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * End:
+ * vim600: noet sw=4 ts=4 fdm=marker
+ * vim<600: noet sw=4 ts=4
+ */
+/*
+    +--------------------------------------------------------------------+
+    | PECL :: raphf                                                      |
+    +--------------------------------------------------------------------+
+    | Redistribution and use in source and binary forms, with or without |
+    | modification, are permitted provided that the conditions mentioned |
+    | in the accompanying LICENSE file are met.                          |
+    +--------------------------------------------------------------------+
+    | Copyright (c) 2013, Michael Wallner <mike@php.net>                 |
+    +--------------------------------------------------------------------+
+*/
+
+#ifndef PHP_RAPHF_API_H
+#define PHP_RAPHF_API_H
+
+/**
+ * A resource constructor.
+ *
+ * @param opaque is the \a data from php_persistent_handle_provide()
+ * @param init_arg is the \a init_arg from php_resource_factory_init()
+ * @return the created (persistent) handle
+ */
+typedef void *(*php_resource_factory_handle_ctor_t)(void *opaque,
+               void *init_arg TSRMLS_DC);
+
+/**
+ * The copy constructor of a resource.
+ *
+ * @param opaque the factory's data
+ * @param handle the (persistent) handle to copy
+ */
+typedef void *(*php_resource_factory_handle_copy_t)(void *opaque,
+               void *handle TSRMLS_DC);
+
+/**
+ * The destructor of a resource.
+ *
+ * @param opaque the factory's data
+ * @param handle the handle to destroy
+ */
+typedef void (*php_resource_factory_handle_dtor_t)(void *opaque,
+               void *handle TSRMLS_DC);
+
+/**
+ * The resource ops consisting of a ctor, a copy ctor and a dtor.
+ *
+ * Define this ops and register them with php_persistent_handle_provide()
+ * in MINIT.
+ */
+typedef struct php_resource_factory_ops {
+       /** The resource constructor */
+       php_resource_factory_handle_ctor_t ctor;
+       /** The resource's copy constructor */
+       php_resource_factory_handle_copy_t copy;
+       /** The resource's destructor */
+       php_resource_factory_handle_dtor_t dtor;
+} php_resource_factory_ops_t;
+
+/**
+ * The resource factory.
+ */
+typedef struct php_resource_factory {
+       /** The resource ops */
+       php_resource_factory_ops_t fops;
+       /** Opaque user data */
+       void *data;
+       /** User data destructor */
+       void (*dtor)(void *data);
+       /** How often this factory is referenced */
+       unsigned refcount;
+} php_resource_factory_t;
+
+/**
+ * Initialize a resource factory.
+ *
+ * If you register a \a dtor for a resource factory used with a persistent
+ * handle provider, be sure to call php_persistent_handle_cleanup() for your
+ * registered provider in MSHUTDOWN, else the dtor will point to no longer
+ * available memory if the extension has already been unloaded.
+ *
+ * @param f the factory to initialize; if NULL allocated on the heap
+ * @param fops the resource ops to assign to the factory
+ * @param data opaque user data; may be NULL
+ * @param dtor a destructor for the data; may be NULL
+ * @return \a f or an allocated resource factory
+ */
+PHP_RAPHF_API php_resource_factory_t *php_resource_factory_init(
+               php_resource_factory_t *f, php_resource_factory_ops_t *fops, void *data,
+               void (*dtor)(void *data));
+
+/**
+ * Increase the refcount of the resource factory.
+ *
+ * @param rf the resource factory
+ * @return the new refcount
+ */
+PHP_RAPHF_API unsigned php_resource_factory_addref(php_resource_factory_t *rf);
+
+/**
+ * Destroy the resource factory.
+ *
+ * If the factory's refcount reaches 0, the \a dtor for \a data is called.
+ *
+ * @param f the resource factory
+ */
+PHP_RAPHF_API void php_resource_factory_dtor(php_resource_factory_t *f);
+
+/**
+ * Destroy and free the resource factory.
+ *
+ * Calls php_resource_factory_dtor() and frees \æ f if the factory's refcount
+ * reached 0.
+ *
+ * @param f the resource factory
+ */
+PHP_RAPHF_API void php_resource_factory_free(php_resource_factory_t **f);
+
+/**
+ * Construct a resource by the resource factory \a f
+ *
+ * @param f the resource factory
+ * @param init_arg for the resource constructor
+ * @return the new resource
+ */
+PHP_RAPHF_API void *php_resource_factory_handle_ctor(php_resource_factory_t *f,
+               void *init_arg TSRMLS_DC);
+
+/**
+ * Create a copy of the resource \a handle
+ *
+ * @param f the resource factory
+ * @param handle the resource to copy
+ * @return the copy
+ */
+PHP_RAPHF_API void *php_resource_factory_handle_copy(php_resource_factory_t *f,
+               void *handle TSRMLS_DC);
+
+/**
+ * Destroy (and free) the resource
+ *
+ * @param f the resource factory
+ * @param handle the resource to destroy
+ */
+PHP_RAPHF_API void php_resource_factory_handle_dtor(php_resource_factory_t *f,
+               void *handle TSRMLS_DC);
+
+/**
+ * Persistent handles storage
+ */
+typedef struct php_persistent_handle_list {
+       /** Storage of free resources */
+       HashTable free;
+       /** Count of acquired resources */
+       ulong used;
+} php_persistent_handle_list_t;
+
+/**
+ * Definition of a persistent handle provider.
+ * Holds a resource factory an a persistent handle list.
+ */
+typedef struct php_persistent_handle_provider {
+        /**
+         * The list of free handles.
+         * Hash of "ident" => array(handles) entries. Persistent handles are
+         * acquired out of this list.
+         */
+       php_persistent_handle_list_t list;
+
+       /**
+        * The resource factory.
+        * New handles are created by this factory.
+        */
+       php_resource_factory_t rf;
+} php_persistent_handle_provider_t;
+
+typedef struct php_persistent_handle_factory php_persistent_handle_factory_t;
+
+/**
+ * Wakeup the persistent handle on re-acquisition.
+ */
+typedef void (*php_persistent_handle_wakeup_t)(
+               php_persistent_handle_factory_t *f, void **handle TSRMLS_DC);
+/**
+ * Retire the persistent handle on release.
+ */
+typedef void (*php_persistent_handle_retire_t)(
+               php_persistent_handle_factory_t *f, void **handle TSRMLS_DC);
+
+/**
+ * Definition of a persistent handle factory.
+ *
+ * php_persistent_handle_concede() will return a pointer to a
+ * php_persistent_handle_factory if a provider for the \a name_str has
+ * been registered with php_persistent_handle_provide().
+ */
+struct php_persistent_handle_factory {
+       /** The persistent handle provider */
+       php_persistent_handle_provider_t *provider;
+       /** The persistent handle wakeup routine; may be NULL */
+       php_persistent_handle_wakeup_t wakeup;
+       /** The persistent handle retire routine; may be NULL */
+       php_persistent_handle_retire_t retire;
+
+       /** The ident for which this factory manages resources */
+       struct {
+               /** ident string */
+               char *str;
+               /** ident length */
+               size_t len;
+       } ident;
+
+       /** Whether it has to be free'd on php_persistent_handle_abandon() */
+       unsigned free_on_abandon:1;
+};
+
+/**
+ * Register a persistent handle provider in MINIT.
+ *
+ * Registers a factory provider for \a name_str with \a fops resource factory
+ * ops. Call this in your MINIT.
+ *
+ * A php_resource_factory will be created with \a fops, \a data and \a dtor
+ * and will be stored together with a php_persistent_handle_list in the global
+ * raphf hash.
+ *
+ * A php_persistent_handle_factory can then be retrieved by
+ * php_persistent_handle_concede() at runtime.
+ *
+ * @param name_str the provider name, e.g. "http\Client\Curl"
+ * @param name_len the provider name length, e.g. strlen("http\Client\Curl")
+ * @param fops the resource factory ops
+ * @param data opaque user data
+ * @param dtor \a data destructor
+ * @return SUCCESS/FAILURE
+ */
+PHP_RAPHF_API int /* SUCCESS|FAILURE */ php_persistent_handle_provide(
+               const char *name_str, size_t name_len, php_resource_factory_ops_t *fops,
+               void *data, void (*dtor)(void *) TSRMLS_DC);
+
+/**
+ * Retrieve a persistent handle factory at runtime.
+ *
+ * If a persistent handle provider has been registered for \a name_str, a new
+ * php_persistent_handle_factory creating resources in the \a ident_str
+ * namespace will be constructed.
+ *
+ * The wakeup routine \a wakeup and the retire routine \a retire will be
+ * assigned to the new php_persistent_handle_factory.
+ *
+ * @param a pointer to a factory; allocated on the heap if NULL
+ * @param name_str the provider name, e.g. "http\Client\Curl"
+ * @param name_len the provider name length, e.g. strlen("http\Client\Curl")
+ * @param ident_str the subsidiary namespace, e.g. "php.net:80"
+ * @param ident_len the subsidiary namespace lenght, e.g. strlen("php.net:80")
+ * @param wakeup any persistent handle wakeup routine
+ * @param retire any persistent handle retire routine
+ * @return \a a or an allocated persistent handle factory
+ */
+PHP_RAPHF_API php_persistent_handle_factory_t *php_persistent_handle_concede(
+               php_persistent_handle_factory_t *a, const char *name_str,
+               size_t name_len, const char *ident_str, size_t ident_len,
+               php_persistent_handle_wakeup_t wakeup,
+               php_persistent_handle_retire_t retire TSRMLS_DC);
+
+/**
+ * Abandon the persistent handle factory.
+ *
+ * Destroy a php_persistent_handle_factory created by
+ * php_persistent_handle_concede(). If the memory for the factory was allocated,
+ * it will automatically be free'd.
+ *
+ * @param a the persistent handle factory to destroy
+ */
+PHP_RAPHF_API void php_persistent_handle_abandon(
+               php_persistent_handle_factory_t *a);
+
+/**
+ * Acquire a persistent handle.
+ *
+ * That is, either re-use a resource from the free list or create a new handle.
+ *
+ * If a handle is acquired from the free list, the
+ * php_persistent_handle_factory::wakeup callback will be executed for that
+ * handle.
+ *
+ * @param a the persistent handle factory
+ * @param init_arg the \a init_arg for php_resource_factory_handle_ctor()
+ * @return the acquired resource
+ */
+PHP_RAPHF_API void *php_persistent_handle_acquire(
+               php_persistent_handle_factory_t *a, void *init_arg TSRMLS_DC);
+
+/**
+ * Release a persistent handle.
+ *
+ * That is, either put it back into the free list for later re-use or clean it
+ * up with php_resource_factory_handle_dtor().
+ *
+ * If a handle is put back into the free list, the
+ * php_persistent_handle_factory::retire callback will be executed for that
+ * handle.
+ *
+ * @param a the persistent handle factory
+ * @param handle the handle to release
+ */
+PHP_RAPHF_API void php_persistent_handle_release(
+               php_persistent_handle_factory_t *a, void *handle TSRMLS_DC);
+
+/**
+ * Copy a persistent handle.
+ *
+ * Let the underlying resource factory copy the \a handle.
+ *
+ * @param a the persistent handle factory
+ * @param handle the resource to accrete
+ */
+PHP_RAPHF_API void *php_persistent_handle_accrete(
+               php_persistent_handle_factory_t *a, void *handle TSRMLS_DC);
+
+/**
+ * Retrieve persistent handle resource factory ops.
+ *
+ * These ops can be used to mask a persistent handle factory as
+ * resource factory itself, so you can transparently use the
+ * resource factory API, both for persistent and non-persistent
+ * ressources.
+ *
+ * Example:
+ * ~~~~~~~~~~~~~~~{.c}
+ * php_resource_factory_t *create_my_rf(const char *persistent_id_str,
+ *                                      size_t persistent_id_len TSRMLS_DC)
+ * {
+ *     php_resource_factory_t *rf;
+ *
+ *     if (persistent_id_str) {
+ *         php_persistent_handle_factory_t *pf;
+ *         php_resource_factory_ops_t *ops;
+ *
+ *         ops = php_persistent_handle_get_resource_factory_ops();
+ *
+ *         pf = php_persistent_handle_concede(NULL, "my", 2,
+ *             persistent_id_str, persistent_id_len, NULL, NULL TSRMLS_CC);
+ *
+ *         rf = php_persistent_handle_resource_factory_init(NULL, pf);
+ *     } else {
+ *         rf = php_resource_factory_init(NULL, &myops, NULL, NULL);
+ *     }
+ *     return rf;
+ * }
+ * ~~~~~~~~~~~~~~~
+ */
+PHP_RAPHF_API php_resource_factory_ops_t *
+php_persistent_handle_get_resource_factory_ops(void);
+
+/**
+ * Create a resource factory for persistent handles.
+ *
+ * This will create a resource factory with persistent handle ops, which wraps
+ * the provided reource factory \a pf.
+ *
+ * @param a the persistent handle resource factory to initialize
+ * @param pf the resource factory to wrap
+ */
+PHP_RAPHF_API php_resource_factory_t *
+php_persistent_handle_resource_factory_init(php_resource_factory_t *a,
+               php_persistent_handle_factory_t *pf);
+
+/**
+ * Check whether a resource factory is a persistent handle resource factory.
+ *
+ * @param a the resource factory to check
+ */
+PHP_RAPHF_API zend_bool php_resource_factory_is_persistent(
+               php_resource_factory_t *a);
+
+/**
+ * Clean persistent handles up.
+ *
+ * Destroy persistent handles of provider \a name_str and in subsidiary
+ * namespace \a ident_str.
+ *
+ * If \a name_str is NULL, all persistent handles of all providers with a
+ * matching \a ident_str will be cleaned up.
+ *
+ * If \a ident_str is NULL all persistent handles of the provider will be
+ * cleaned up.
+ *
+ * Ergo, if both, \a name_str and \a ident_str are NULL, then all
+ * persistent handles will be cleaned up.
+ *
+ * You must call this in MSHUTDOWN, if your resource factory ops hold a
+ * registered php_resource_factory::dtor, else the dtor will point to
+ * memory not any more available if the extension has already been unloaded.
+ *
+ * @param name_str the provider name; may be NULL
+ * @param name_len the provider name length
+ * @param ident_str the subsidiary namespace name; may be NULL
+ * @param ident_len the subsidiary namespace name length
+ */
+PHP_RAPHF_API void php_persistent_handle_cleanup(const char *name_str,
+               size_t name_len, const char *ident_str, size_t ident_len TSRMLS_DC);
+
+/**
+ * Retrieve statistics about the current process/thread's persistent handles.
+ *
+ * @return a HashTable like:
+ * ~~~~~~~~~~~~~~~
+ *     [
+ *         "name" => [
+ *             "ident" => [
+ *                 "used" => 1,
+ *                 "free" => 0,
+ *             ]
+ *         ]
+ *     ]
+ * ~~~~~~~~~~~~~~~
+ */
+PHP_RAPHF_API HashTable *php_persistent_handle_statall(HashTable *ht TSRMLS_DC);
+
+#endif /* PHP_RAPHF_API_H */
+
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * End:
+ * vim600: noet sw=4 ts=4 fdm=marker
+ * vim<600: noet sw=4 ts=4
+ */
+/*
+    +--------------------------------------------------------------------+
+    | PECL :: raphf                                                      |
+    +--------------------------------------------------------------------+
+    | Redistribution and use in source and binary forms, with or without |
+    | modification, are permitted provided that the conditions mentioned |
+    | in the accompanying LICENSE file are met.                          |
+    +--------------------------------------------------------------------+
+    | Copyright (c) 2013, Michael Wallner <mike@php.net>                 |
+    +--------------------------------------------------------------------+
+*/
+
+#ifdef HAVE_CONFIG_H
+#      include "config.h"
+#endif
+
+#include "php.h"
+#include "php_ini.h"
+#include "ext/standard/info.h"
+#include "php_raphf.h"
+
+struct php_persistent_handle_globals {
+       ulong limit;
+       HashTable hash;
+};
+
+ZEND_BEGIN_MODULE_GLOBALS(raphf)
+       struct php_persistent_handle_globals persistent_handle;
+ZEND_END_MODULE_GLOBALS(raphf)
+
+#ifdef ZTS
+#      define PHP_RAPHF_G ((zend_raphf_globals *) \
+               (*((void ***) tsrm_ls))[TSRM_UNSHUFFLE_RSRC_ID(raphf_globals_id)])
+#else
+#      define PHP_RAPHF_G (&raphf_globals)
+#endif
+
+ZEND_DECLARE_MODULE_GLOBALS(raphf)
+
+#if PHP_VERSION_ID < 50500
+#undef SUCCESS
+#undef FAILURE
+typedef enum {
+       SUCCESS = 0,
+       FAILURE = -1
+} ZEND_RESULT_CODE;
+#endif
+
+#ifndef PHP_RAPHF_DEBUG_PHANDLES
+#      define PHP_RAPHF_DEBUG_PHANDLES 0
+#endif
+#if PHP_RAPHF_DEBUG_PHANDLES
+#      undef inline
+#      define inline
+#endif
+
+php_resource_factory_t *php_resource_factory_init(php_resource_factory_t *f,
+               php_resource_factory_ops_t *fops, void *data, void (*dtor)(void *data))
+{
+       if (!f) {
+               f = emalloc(sizeof(*f));
+       }
+       memset(f, 0, sizeof(*f));
+
+       memcpy(&f->fops, fops, sizeof(*fops));
+
+       f->data = data;
+       f->dtor = dtor;
+
+       f->refcount = 1;
+
+       return f;
+}
+
+unsigned php_resource_factory_addref(php_resource_factory_t *rf)
+{
+       return ++rf->refcount;
+}
+
+void php_resource_factory_dtor(php_resource_factory_t *f)
+{
+       --f->refcount;
+
+       if (!f->refcount) {
+               if (f->dtor) {
+                       f->dtor(f->data);
+               }
+       }
+}
+
+void php_resource_factory_free(php_resource_factory_t **f)
+{
+       if (*f) {
+               php_resource_factory_dtor(*f);
+               if (!(*f)->refcount) {
+                       efree(*f);
+                       *f = NULL;
+               }
+       }
+}
+
+void *php_resource_factory_handle_ctor(php_resource_factory_t *f,
+               void *init_arg TSRMLS_DC)
+{
+       if (f->fops.ctor) {
+               return f->fops.ctor(f->data, init_arg TSRMLS_CC);
+       }
+       return NULL;
+}
+
+void *php_resource_factory_handle_copy(php_resource_factory_t *f,
+               void *handle TSRMLS_DC)
+{
+       if (f->fops.copy) {
+               return f->fops.copy(f->data, handle TSRMLS_CC);
+       }
+       return NULL;
+}
+
+void php_resource_factory_handle_dtor(php_resource_factory_t *f,
+               void *handle TSRMLS_DC)
+{
+       if (f->fops.dtor) {
+               f->fops.dtor(f->data, handle TSRMLS_CC);
+       }
+}
+
+php_resource_factory_t *php_persistent_handle_resource_factory_init(
+               php_resource_factory_t *a, php_persistent_handle_factory_t *pf)
+{
+       return php_resource_factory_init(a,
+                       php_persistent_handle_get_resource_factory_ops(), pf,
+                       (void(*)(void*)) php_persistent_handle_abandon);
+}
+
+zend_bool php_resource_factory_is_persistent(php_resource_factory_t *a)
+{
+       return a->dtor == (void(*)(void *)) php_persistent_handle_abandon;
+}
+
+
+static inline php_persistent_handle_list_t *php_persistent_handle_list_init(
+               php_persistent_handle_list_t *list)
+{
+       int free_list;
+
+       if ((free_list = !list)) {
+               list = pemalloc(sizeof(php_persistent_handle_list_t), 1);
+       }
+
+       list->used = 0;
+
+       if (SUCCESS != zend_hash_init(&list->free, 0, NULL, NULL, 1)) {
+               if (free_list) {
+                       pefree(list, 1);
+               }
+               list = NULL;
+       }
+
+       return list;
+}
+
+static int php_persistent_handle_apply_stat(void *p TSRMLS_DC, int argc,
+               va_list argv, zend_hash_key *key)
+{
+       php_persistent_handle_list_t **list = p;
+       zval *zsubentry, *zentry = va_arg(argv, zval *);
+
+       MAKE_STD_ZVAL(zsubentry);
+       array_init(zsubentry);
+       add_assoc_long_ex(zsubentry, ZEND_STRS("used"), (*list)->used);
+       add_assoc_long_ex(zsubentry, ZEND_STRS("free"),
+                       zend_hash_num_elements(&(*list)->free));
+       add_assoc_zval_ex(zentry, key->arKey, key->nKeyLength, zsubentry);
+
+       return ZEND_HASH_APPLY_KEEP;
+}
+
+static int php_persistent_handle_apply_statall(void *p TSRMLS_DC, int argc,
+               va_list argv, zend_hash_key *key)
+{
+       php_persistent_handle_provider_t *provider = p;
+       HashTable *ht = va_arg(argv, HashTable *);
+       zval *zentry;
+
+       MAKE_STD_ZVAL(zentry);
+       array_init(zentry);
+
+       zend_hash_apply_with_arguments(&provider->list.free TSRMLS_CC,
+                       php_persistent_handle_apply_stat, 1, zentry);
+       zend_symtable_update(ht, key->arKey, key->nKeyLength, &zentry,
+                       sizeof(zval *), NULL);
+
+       return ZEND_HASH_APPLY_KEEP;
+}
+
+static int php_persistent_handle_apply_cleanup_ex(void *pp, void *arg TSRMLS_DC)
+{
+       php_resource_factory_t *rf = arg;
+       void **handle = pp;
+
+#if PHP_RAPHF_DEBUG_PHANDLES
+       fprintf(stderr, "DESTROY: %p\n", *handle);
+#endif
+       php_resource_factory_handle_dtor(rf, *handle TSRMLS_CC);
+       return ZEND_HASH_APPLY_REMOVE;
+}
+
+static int php_persistent_handle_apply_cleanup(void *pp, void *arg TSRMLS_DC)
+{
+       php_resource_factory_t *rf = arg;
+       php_persistent_handle_list_t **listp = pp;
+
+       zend_hash_apply_with_argument(&(*listp)->free,
+                       php_persistent_handle_apply_cleanup_ex, rf TSRMLS_CC);
+       if ((*listp)->used) {
+               return ZEND_HASH_APPLY_KEEP;
+       }
+       zend_hash_destroy(&(*listp)->free);
+#if PHP_RAPHF_DEBUG_PHANDLES
+       fprintf(stderr, "LSTFREE: %p\n", *listp);
+#endif
+       pefree(*listp, 1);
+       *listp = NULL;
+       return ZEND_HASH_APPLY_REMOVE;
+}
+
+static inline void php_persistent_handle_list_dtor(
+               php_persistent_handle_list_t *list,
+               php_persistent_handle_provider_t *provider TSRMLS_DC)
+{
+#if PHP_RAPHF_DEBUG_PHANDLES
+       fprintf(stderr, "LSTDTOR: %p\n", list);
+#endif
+       zend_hash_apply_with_argument(&list->free,
+                       php_persistent_handle_apply_cleanup_ex, &provider->rf TSRMLS_CC);
+       zend_hash_destroy(&list->free);
+}
+
+static inline void php_persistent_handle_list_free(
+               php_persistent_handle_list_t **list,
+               php_persistent_handle_provider_t *provider TSRMLS_DC)
+{
+       php_persistent_handle_list_dtor(*list, provider TSRMLS_CC);
+#if PHP_RAPHF_DEBUG_PHANDLES
+       fprintf(stderr, "LSTFREE: %p\n", *list);
+#endif
+       pefree(*list, 1);
+       *list = NULL;
+}
+
+static int php_persistent_handle_list_apply_dtor(void *listp,
+               void *provider TSRMLS_DC)
+{
+       php_persistent_handle_list_free(listp, provider TSRMLS_CC);
+       return ZEND_HASH_APPLY_REMOVE;
+}
+
+static inline php_persistent_handle_list_t *php_persistent_handle_list_find(
+               php_persistent_handle_provider_t *provider, const char *ident_str,
+               size_t ident_len TSRMLS_DC)
+{
+       php_persistent_handle_list_t **list, *new_list;
+       ZEND_RESULT_CODE rv = zend_symtable_find(&provider->list.free, ident_str,
+                       ident_len + 1, (void *) &list);
+
+       if (SUCCESS == rv) {
+#if PHP_RAPHF_DEBUG_PHANDLES
+               fprintf(stderr, "LSTFIND: %p\n", *list);
+#endif
+               return *list;
+       }
+
+       if ((new_list = php_persistent_handle_list_init(NULL))) {
+               rv = zend_symtable_update(&provider->list.free, ident_str, ident_len+1,
+                               (void *) &new_list,     sizeof(php_persistent_handle_list_t *),
+                               (void *) &list);
+               if (SUCCESS == rv) {
+#if PHP_RAPHF_DEBUG_PHANDLES
+                       fprintf(stderr, "LSTFIND: %p (new)\n", *list);
+#endif
+                       return *list;
+               }
+               php_persistent_handle_list_free(&new_list, provider TSRMLS_CC);
+       }
+
+       return NULL;
+}
+
+static int php_persistent_handle_apply_cleanup_all(void *p TSRMLS_DC, int argc,
+               va_list argv, zend_hash_key *key)
+{
+       php_persistent_handle_provider_t *provider = p;
+       const char *ident_str = va_arg(argv, const char *);
+       size_t ident_len = va_arg(argv, size_t);
+       php_persistent_handle_list_t *list;
+
+       if (ident_str && ident_len) {
+               if ((list = php_persistent_handle_list_find(provider, ident_str,
+                               ident_len TSRMLS_CC))) {
+                       zend_hash_apply_with_argument(&list->free,
+                                       php_persistent_handle_apply_cleanup_ex,
+                                       &provider->rf TSRMLS_CC);
+               }
+       } else {
+               zend_hash_apply_with_argument(&provider->list.free,
+                               php_persistent_handle_apply_cleanup, &provider->rf TSRMLS_CC);
+       }
+
+       return ZEND_HASH_APPLY_KEEP;
+}
+
+static void php_persistent_handle_hash_dtor(void *p)
+{
+       php_persistent_handle_provider_t *provider;
+       TSRMLS_FETCH();
+
+       provider = (php_persistent_handle_provider_t *) p;
+       zend_hash_apply_with_argument(&provider->list.free,
+                       php_persistent_handle_list_apply_dtor, provider TSRMLS_CC);
+       zend_hash_destroy(&provider->list.free);
+       php_resource_factory_dtor(&provider->rf);
+}
+
+PHP_RAPHF_API ZEND_RESULT_CODE php_persistent_handle_provide(const char *name_str,
+               size_t name_len, php_resource_factory_ops_t *fops, void *data,
+               void (*dtor)(void *) TSRMLS_DC)
+{
+       ZEND_RESULT_CODE status = FAILURE;
+       php_persistent_handle_provider_t provider;
+
+       if (php_persistent_handle_list_init(&provider.list)) {
+               if (php_resource_factory_init(&provider.rf, fops, data, dtor)) {
+#if PHP_RAPHF_DEBUG_PHANDLES
+                       fprintf(stderr, "PROVIDE: %p %s\n", PHP_RAPHF_G, name_str);
+#endif
+
+                       status = zend_symtable_update(&PHP_RAPHF_G->persistent_handle.hash,
+                                       name_str, name_len+1, (void *) &provider,
+                                       sizeof(php_persistent_handle_provider_t), NULL);
+                       if (SUCCESS != status) {
+                               php_resource_factory_dtor(&provider.rf);
+                       }
+               }
+       }
+
+       return status;
+}
+
+php_persistent_handle_factory_t *php_persistent_handle_concede(
+               php_persistent_handle_factory_t *a, const char *name_str,
+               size_t name_len, const char *ident_str, size_t ident_len,
+               php_persistent_handle_wakeup_t wakeup,
+               php_persistent_handle_retire_t retire TSRMLS_DC)
+{
+       ZEND_RESULT_CODE status = FAILURE;
+       php_persistent_handle_factory_t *free_a = NULL;
+
+       if (!a) {
+               free_a = a = emalloc(sizeof(*a));
+       }
+       memset(a, 0, sizeof(*a));
+
+       status = zend_symtable_find(&PHP_RAPHF_G->persistent_handle.hash, name_str,
+                       name_len+1, (void *) &a->provider);
+
+       if (SUCCESS == status) {
+               a->ident.str = estrndup(ident_str, ident_len);
+               a->ident.len = ident_len;
+
+               a->wakeup = wakeup;
+               a->retire = retire;
+
+               if (free_a) {
+                       a->free_on_abandon = 1;
+               }
+       } else {
+               if (free_a) {
+                       efree(free_a);
+               }
+               a = NULL;
+       }
+
+#if PHP_RAPHF_DEBUG_PHANDLES
+       fprintf(stderr, "CONCEDE: %p %p (%s) (%s)\n", PHP_RAPHF_G,
+                       a ? a->provider : NULL, name_str, ident_str);
+#endif
+
+       return a;
+}
+
+PHP_RAPHF_API void php_persistent_handle_abandon(
+               php_persistent_handle_factory_t *a)
+{
+       zend_bool f = a->free_on_abandon;
+
+#if PHP_RAPHF_DEBUG_PHANDLES
+       fprintf(stderr, "ABANDON: %p\n", a->provider);
+#endif
+
+       STR_FREE(a->ident.str);
+       memset(a, 0, sizeof(*a));
+       if (f) {
+               efree(a);
+       }
+}
+
+void *php_persistent_handle_acquire(
+               php_persistent_handle_factory_t *a, void *init_arg  TSRMLS_DC)
+{
+       int key;
+       ZEND_RESULT_CODE rv;
+       ulong index;
+       void **handle_ptr, *handle = NULL;
+       php_persistent_handle_list_t *list;
+
+       list = php_persistent_handle_list_find(a->provider, a->ident.str,
+                       a->ident.len TSRMLS_CC);
+       if (list) {
+               zend_hash_internal_pointer_end(&list->free);
+               key = zend_hash_get_current_key(&list->free, NULL, &index, 0);
+               rv = zend_hash_get_current_data(&list->free, (void *) &handle_ptr);
+               if (HASH_KEY_NON_EXISTANT != key && SUCCESS == rv) {
+                       handle = *handle_ptr;
+                       if (a->wakeup) {
+                               a->wakeup(a, &handle TSRMLS_CC);
+                       }
+                       zend_hash_index_del(&list->free, index);
+               } else {
+                       handle = php_resource_factory_handle_ctor(&a->provider->rf,
+                                       init_arg TSRMLS_CC);
+               }
+#if PHP_RAPHF_DEBUG_PHANDLES
+               fprintf(stderr, "CREATED: %p\n", *handle);
+#endif
+               if (handle) {
+                       ++a->provider->list.used;
+                       ++list->used;
+               }
+       }
+
+       return handle;
+}
+
+void *php_persistent_handle_accrete(
+               php_persistent_handle_factory_t *a, void *handle TSRMLS_DC)
+{
+       void *new_handle = NULL;
+       php_persistent_handle_list_t *list;
+
+       new_handle = php_resource_factory_handle_copy(&a->provider->rf,
+                       handle TSRMLS_CC);
+       if (handle) {
+               list = php_persistent_handle_list_find(a->provider, a->ident.str,
+                               a->ident.len TSRMLS_CC);
+               if (list) {
+                       ++list->used;
+               }
+               ++a->provider->list.used;
+       }
+
+       return new_handle;
+}
+
+void php_persistent_handle_release(
+               php_persistent_handle_factory_t *a, void *handle TSRMLS_DC)
+{
+       php_persistent_handle_list_t *list;
+
+       list = php_persistent_handle_list_find(a->provider, a->ident.str,
+                       a->ident.len TSRMLS_CC);
+       if (list) {
+               if (a->provider->list.used >= PHP_RAPHF_G->persistent_handle.limit) {
+#if PHP_RAPHF_DEBUG_PHANDLES
+                       fprintf(stderr, "DESTROY: %p\n", *handle);
+#endif
+                       php_resource_factory_handle_dtor(&a->provider->rf,
+                                       handle TSRMLS_CC);
+               } else {
+                       if (a->retire) {
+                               a->retire(a, &handle TSRMLS_CC);
+                       }
+                       zend_hash_next_index_insert(&list->free, (void *) &handle,
+                                       sizeof(void *), NULL);
+               }
+
+               --a->provider->list.used;
+               --list->used;
+       }
+}
+
+void php_persistent_handle_cleanup(const char *name_str, size_t name_len,
+               const char *ident_str, size_t ident_len TSRMLS_DC)
+{
+       php_persistent_handle_provider_t *provider;
+       php_persistent_handle_list_t *list;
+       ZEND_RESULT_CODE rv;
+
+       if (name_str && name_len) {
+               rv = zend_symtable_find(&PHP_RAPHF_G->persistent_handle.hash, name_str,
+                               name_len+1, (void *) &provider);
+
+               if (SUCCESS == rv) {
+                       if (ident_str && ident_len) {
+                               list = php_persistent_handle_list_find(provider, ident_str,
+                                               ident_len TSRMLS_CC);
+                               if (list) {
+                                       zend_hash_apply_with_argument(&list->free,
+                                                       php_persistent_handle_apply_cleanup_ex,
+                                                       &provider->rf TSRMLS_CC);
+                               }
+                       } else {
+                               zend_hash_apply_with_argument(&provider->list.free,
+                                               php_persistent_handle_apply_cleanup,
+                                               &provider->rf TSRMLS_CC);
+                       }
+               }
+       } else {
+               zend_hash_apply_with_arguments(
+                               &PHP_RAPHF_G->persistent_handle.hash TSRMLS_CC,
+                               php_persistent_handle_apply_cleanup_all, 2, ident_str,
+                               ident_len);
+       }
+}
+
+HashTable *php_persistent_handle_statall(HashTable *ht TSRMLS_DC)
+{
+       if (zend_hash_num_elements(&PHP_RAPHF_G->persistent_handle.hash)) {
+               if (!ht) {
+                       ALLOC_HASHTABLE(ht);
+                       zend_hash_init(ht, 0, NULL, ZVAL_PTR_DTOR, 0);
+               }
+               zend_hash_apply_with_arguments(
+                               &PHP_RAPHF_G->persistent_handle.hash TSRMLS_CC,
+                               php_persistent_handle_apply_statall, 1, ht);
+       } else if (ht) {
+               ht = NULL;
+       }
+
+       return ht;
+}
+
+static php_resource_factory_ops_t php_persistent_handle_resource_factory_ops = {
+       (php_resource_factory_handle_ctor_t) php_persistent_handle_acquire,
+       (php_resource_factory_handle_copy_t) php_persistent_handle_accrete,
+       (php_resource_factory_handle_dtor_t) php_persistent_handle_release
+};
+
+php_resource_factory_ops_t *php_persistent_handle_get_resource_factory_ops(void)
+{
+       return &php_persistent_handle_resource_factory_ops;
+}
+
+ZEND_BEGIN_ARG_INFO_EX(ai_raphf_stat_persistent_handles, 0, 0, 0)
+ZEND_END_ARG_INFO();
+static PHP_FUNCTION(raphf_stat_persistent_handles)
+{
+       if (SUCCESS == zend_parse_parameters_none()) {
+               object_init(return_value);
+               if (php_persistent_handle_statall(HASH_OF(return_value) TSRMLS_CC)) {
+                       return;
+               }
+               zval_dtor(return_value);
+       }
+       RETURN_FALSE;
+}
+
+ZEND_BEGIN_ARG_INFO_EX(ai_raphf_clean_persistent_handles, 0, 0, 0)
+       ZEND_ARG_INFO(0, name)
+       ZEND_ARG_INFO(0, ident)
+ZEND_END_ARG_INFO();
+static PHP_FUNCTION(raphf_clean_persistent_handles)
+{
+       char *name_str = NULL, *ident_str = NULL;
+       int name_len = 0, ident_len = 0;
+
+       if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s!s!",
+                       &name_str, &name_len, &ident_str, &ident_len)) {
+               php_persistent_handle_cleanup(name_str, name_len, ident_str,
+                               ident_len TSRMLS_CC);
+       }
+}
+
+static const zend_function_entry raphf_functions[] = {
+       ZEND_NS_FENTRY("raphf", stat_persistent_handles,
+                       ZEND_FN(raphf_stat_persistent_handles),
+                       ai_raphf_stat_persistent_handles, 0)
+       ZEND_NS_FENTRY("raphf", clean_persistent_handles,
+                       ZEND_FN(raphf_clean_persistent_handles),
+                       ai_raphf_clean_persistent_handles, 0)
+       {0}
+};
+
+PHP_INI_BEGIN()
+       STD_PHP_INI_ENTRY("raphf.persistent_handle.limit", "-1", PHP_INI_SYSTEM,
+                       OnUpdateLong, persistent_handle.limit, zend_raphf_globals,
+                       raphf_globals)
+PHP_INI_END()
+
+static HashTable *php_persistent_handles_global_hash;
+
+static PHP_GINIT_FUNCTION(raphf)
+{
+       raphf_globals->persistent_handle.limit = -1;
+
+       zend_hash_init(&raphf_globals->persistent_handle.hash, 0, NULL,
+                       php_persistent_handle_hash_dtor, 1);
+       if (php_persistent_handles_global_hash) {
+               zend_hash_copy(&raphf_globals->persistent_handle.hash,
+                               php_persistent_handles_global_hash, NULL, NULL,
+                               sizeof(php_persistent_handle_provider_t));
+       }
+}
+
+static PHP_GSHUTDOWN_FUNCTION(raphf)
+{
+       zend_hash_destroy(&raphf_globals->persistent_handle.hash);
+}
+
+PHP_MINIT_FUNCTION(raphf)
+{
+       php_persistent_handles_global_hash = &PHP_RAPHF_G->persistent_handle.hash;
+       REGISTER_INI_ENTRIES();
+       return SUCCESS;
+}
+
+PHP_MSHUTDOWN_FUNCTION(raphf)
+{
+       UNREGISTER_INI_ENTRIES();
+       php_persistent_handles_global_hash = NULL;
+       return SUCCESS;
+}
+
+static int php_persistent_handle_apply_info_ex(void *p TSRMLS_DC, int argc,
+               va_list argv, zend_hash_key *key)
+{
+       php_persistent_handle_list_t **list = p;
+       zend_hash_key *super_key = va_arg(argv, zend_hash_key *);
+       char used[21], free[21];
+
+       slprintf(used, sizeof(used), "%u", (*list)->used);
+       slprintf(free, sizeof(free), "%d", zend_hash_num_elements(&(*list)->free));
+
+       php_info_print_table_row(4, super_key->arKey, key->arKey, used, free);
+
+       return ZEND_HASH_APPLY_KEEP;
+}
+
+static int php_persistent_handle_apply_info(void *p TSRMLS_DC, int argc,
+               va_list argv, zend_hash_key *key)
+{
+       php_persistent_handle_provider_t *provider = p;
+
+       zend_hash_apply_with_arguments(&provider->list.free TSRMLS_CC,
+                       php_persistent_handle_apply_info_ex, 1, key);
+
+       return ZEND_HASH_APPLY_KEEP;
+}
+
+PHP_MINFO_FUNCTION(raphf)
+{
+       php_info_print_table_start();
+       php_info_print_table_header(2,
+                       "Resource and persistent handle factory support", "enabled");
+       php_info_print_table_row(2, "Extension version", PHP_RAPHF_VERSION);
+       php_info_print_table_end();
+
+       php_info_print_table_start();
+       php_info_print_table_colspan_header(4, "Persistent handles in this "
+#ifdef ZTS
+                       "thread"
+#else
+                       "process"
+#endif
+       );
+       php_info_print_table_header(4, "Provider", "Ident", "Used", "Free");
+       zend_hash_apply_with_arguments(
+                       &PHP_RAPHF_G->persistent_handle.hash TSRMLS_CC,
+                       php_persistent_handle_apply_info, 0);
+       php_info_print_table_end();
+
+       DISPLAY_INI_ENTRIES();
+}
+
+zend_module_entry raphf_module_entry = {
+       STANDARD_MODULE_HEADER,
+       "raphf",
+       raphf_functions,
+       PHP_MINIT(raphf),
+       PHP_MSHUTDOWN(raphf),
+       NULL,
+       NULL,
+       PHP_MINFO(raphf),
+       PHP_RAPHF_VERSION,
+       ZEND_MODULE_GLOBALS(raphf),
+       PHP_GINIT(raphf),
+       PHP_GSHUTDOWN(raphf),
+       NULL,
+       STANDARD_MODULE_PROPERTIES_EX
+};
+/* }}} */
+
+#ifdef COMPILE_DL_RAPHF
+ZEND_GET_MODULE(raphf)
+#endif
+
+
+/*
+ * Local variables:
+ * tab-width: 4
+ * c-basic-offset: 4
+ * End:
+ * vim600: noet sw=4 ts=4 fdm=marker
+ * vim<600: noet sw=4 ts=4
+ */
+--TEST--
+pecl/http-v2 - general and stat
+--SKIPIF--
+<?php
+if (!extension_loaded("http")) {
+       die("skip pecl/http needed");
+}
+if (!class_exists("http\\Client", false)) {
+       die("skip pecl/http-v2 with curl support needed");
+}
+?>
+--FILE--
+<?php
+echo "Test\n";
+
+$h = (array) raphf\stat_persistent_handles();
+var_dump(array_intersect_key($h, array_flip(preg_grep("/^http/", array_keys($h)))));
+
+$c = new http\Client("curl", "php.net:80");
+do {
+       $c->enqueue(new http\Client\Request("GET", "http://php.net"));
+} while (count($c) < 3);
+
+$h = (array) raphf\stat_persistent_handles();
+var_dump(array_intersect_key($h, array_flip(preg_grep("/^http/", array_keys($h)))));
+
+unset($c);
+
+$h = (array) raphf\stat_persistent_handles();
+var_dump(array_intersect_key($h, array_flip(preg_grep("/^http/", array_keys($h)))));
+
+?>
+Done
+--EXPECTF--
+Test
+array(2) {
+  ["http\Client\Curl"]=>
+  array(0) {
+  }
+  ["http\Client\Curl\Request"]=>
+  array(0) {
+  }
+}
+array(2) {
+  ["http\Client\Curl"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(1)
+      ["free"]=>
+      int(0)
+    }
+  }
+  ["http\Client\Curl\Request"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(3)
+      ["free"]=>
+      int(0)
+    }
+  }
+}
+array(2) {
+  ["http\Client\Curl"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(0)
+      ["free"]=>
+      int(1)
+    }
+  }
+  ["http\Client\Curl\Request"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(0)
+      ["free"]=>
+      int(3)
+    }
+  }
+}
+Done
+--TEST--
+pecl/http-v2 - clean with name and id
+--SKIPIF--
+<?php
+if (!extension_loaded("http")) {
+       die("skip pecl/http needed");
+}
+if (!class_exists("http\\Client", false)) {
+       die("skip pecl/http-v2 with curl support needed");
+}
+?>
+--FILE--
+<?php
+echo "Test\n";
+
+$c = new http\Client("curl", "php.net:80");
+do {
+       $c->enqueue(new http\Client\Request("GET", "http://php.net"));
+} while (count($c) < 3);
+
+unset($c);
+
+$h = (array) raphf\stat_persistent_handles();
+var_dump(array_intersect_key($h, array_flip(preg_grep("/^http/", array_keys($h)))));
+
+
+raphf\clean_persistent_handles("http\\Client\\Curl");
+raphf\clean_persistent_handles("http\\Client\\Curl\\Request", "php.net:80");
+
+$h = (array) raphf\stat_persistent_handles();
+var_dump(array_intersect_key($h, array_flip(preg_grep("/^http/", array_keys($h)))));
+
+?>
+Done
+--EXPECTF--
+Test
+array(2) {
+  ["http\Client\Curl"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(0)
+      ["free"]=>
+      int(1)
+    }
+  }
+  ["http\Client\Curl\Request"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(0)
+      ["free"]=>
+      int(3)
+    }
+  }
+}
+array(2) {
+  ["http\Client\Curl"]=>
+  array(0) {
+  }
+  ["http\Client\Curl\Request"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(0)
+      ["free"]=>
+      int(0)
+    }
+  }
+}
+Done
+--TEST--
+pecl/http-v2 - clean with id only
+--SKIPIF--
+<?php
+if (!extension_loaded("http")) {
+       die("skip pecl/http needed");
+}
+if (!class_exists("http\\Client", false)) {
+       die("skip pecl/http-v2 with curl support needed");
+}
+?>
+--FILE--
+<?php
+echo "Test\n";
+
+$c = new http\Client("curl", "php.net:80");
+do {
+       $c->enqueue(new http\Client\Request("GET", "http://php.net"));
+} while (count($c) < 3);
+
+unset($c);
+
+$h = (array) raphf\stat_persistent_handles();
+var_dump(array_intersect_key($h, array_flip(preg_grep("/^http/", array_keys($h)))));
+
+raphf\clean_persistent_handles(null, "php.net:80");
+
+$h = (array) raphf\stat_persistent_handles();
+var_dump(array_intersect_key($h, array_flip(preg_grep("/^http/", array_keys($h)))));
+
+?>
+Done
+--EXPECTF--
+Test
+array(2) {
+  ["http\Client\Curl"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(0)
+      ["free"]=>
+      int(1)
+    }
+  }
+  ["http\Client\Curl\Request"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(0)
+      ["free"]=>
+      int(3)
+    }
+  }
+}
+array(2) {
+  ["http\Client\Curl"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(0)
+      ["free"]=>
+      int(0)
+    }
+  }
+  ["http\Client\Curl\Request"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(0)
+      ["free"]=>
+      int(0)
+    }
+  }
+}
+Done
+--TEST--
+pecl/http-v2 - partial clean
+--SKIPIF--
+<?php
+if (!extension_loaded("http")) {
+       die("skip pecl/http needed");
+}
+if (!class_exists("http\\Client", false)) {
+       die("skip pecl/http-v2 with curl support needed");
+}
+?>
+--FILE--
+<?php
+echo "Test\n";
+
+$h = (array) raphf\stat_persistent_handles();
+var_dump(array_intersect_key($h, array_flip(preg_grep("/^http/", array_keys($h)))));
+
+$c = new http\Client("curl", "php.net:80");
+$c2 = new http\Client("curl", "php.net:80");
+do {
+       $c->enqueue(new http\Client\Request("GET", "http://php.net"));
+       $c2->enqueue(new http\Client\Request("GET", "http://php.net"));
+} while (count($c) < 3);
+
+$h = (array) raphf\stat_persistent_handles();
+var_dump(array_intersect_key($h, array_flip(preg_grep("/^http/", array_keys($h)))));
+
+unset($c);
+
+$h = (array) raphf\stat_persistent_handles();
+var_dump(array_intersect_key($h, array_flip(preg_grep("/^http/", array_keys($h)))));
+
+raphf\clean_persistent_handles();
+
+$h = (array) raphf\stat_persistent_handles();
+var_dump(array_intersect_key($h, array_flip(preg_grep("/^http/", array_keys($h)))));
+
+?>
+Done
+--EXPECTF--
+Test
+array(2) {
+  ["http\Client\Curl"]=>
+  array(0) {
+  }
+  ["http\Client\Curl\Request"]=>
+  array(0) {
+  }
+}
+array(2) {
+  ["http\Client\Curl"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(2)
+      ["free"]=>
+      int(0)
+    }
+  }
+  ["http\Client\Curl\Request"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(6)
+      ["free"]=>
+      int(0)
+    }
+  }
+}
+array(2) {
+  ["http\Client\Curl"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(1)
+      ["free"]=>
+      int(1)
+    }
+  }
+  ["http\Client\Curl\Request"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(3)
+      ["free"]=>
+      int(3)
+    }
+  }
+}
+array(2) {
+  ["http\Client\Curl"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(1)
+      ["free"]=>
+      int(0)
+    }
+  }
+  ["http\Client\Curl\Request"]=>
+  array(1) {
+    ["php.net:80"]=>
+    array(2) {
+      ["used"]=>
+      int(3)
+      ["free"]=>
+      int(0)
+    }
+  }
+}
+Done
\9cÝÆ¿¢è\89õp¡4ºÈ0¸.|\97¯\ 2\0\0\0GBMB
\ No newline at end of file