File Not Found<title>\n </head>\n <body>\n <h1>404 - File ", $pt, " Not Found</h1>\n </body>\n</html>"; exit; } $b = pathinfo($a); if (!isset($b['extension'])) { header('Content-Type: text/plain'); header('Content-Length: ' . filesize($a)); readfile($a); exit; } if (isset($mimes[$b['extension']])) { if ($mimes[$b['extension']] === 1) { include $a; exit; } if ($mimes[$b['extension']] === 2) { highlight_file($a); exit; } header('Content-Type: ' .$mimes[$b['extension']]); header('Content-Length: ' . filesize($a)); readfile($a); exit; } } class Extract_Phar { static $temp; static $origdir; const GZ = 0x1000; const BZ2 = 0x2000; const MASK = 0x3000; const START = 'pharext_installer.php'; const LEN = 6697; static function go($return = false) { $fp = fopen(__FILE__, 'rb'); fseek($fp, self::LEN); $L = unpack('V', $a = (binary)fread($fp, 4)); $m = (binary)''; do { $read = 8192; if ($L[1] - strlen($m) < 8192) { $read = $L[1] - strlen($m); } $last = (binary)fread($fp, $read); $m .= $last; } while (strlen($last) && strlen($m) < $L[1]); if (strlen($m) < $L[1]) { die('ERROR: manifest length read was "' . strlen($m) .'" should be "' . $L[1] . '"'); } $info = self::_unpack($m); $f = $info['c']; if ($f & self::GZ) { if (!function_exists('gzinflate')) { die('Error: zlib extension is not enabled -' . ' gzinflate() function needed for zlib-compressed .phars'); } } if ($f & self::BZ2) { if (!function_exists('bzdecompress')) { die('Error: bzip2 extension is not enabled -' . ' bzdecompress() function needed for bz2-compressed .phars'); } } $temp = self::tmpdir(); if (!$temp || !is_writable($temp)) { $sessionpath = session_save_path(); if (strpos ($sessionpath, ";") !== false) $sessionpath = substr ($sessionpath, strpos ($sessionpath, ";")+1); if (!file_exists($sessionpath) || !is_dir($sessionpath)) { die('Could not locate temporary directory to extract phar'); } $temp = $sessionpath; } $temp .= '/pharextract/'.basename(__FILE__, '.phar'); self::$temp = $temp; self::$origdir = getcwd(); @mkdir($temp, 0777, true); $temp = realpath($temp); if (!file_exists($temp . DIRECTORY_SEPARATOR . md5_file(__FILE__))) { self::_removeTmpFiles($temp, getcwd()); @mkdir($temp, 0777, true); @file_put_contents($temp . '/' . md5_file(__FILE__), ''); foreach ($info['m'] as $path => $file) { $a = !file_exists(dirname($temp . '/' . $path)); @mkdir(dirname($temp . '/' . $path), 0777, true); clearstatcache(); if ($path[strlen($path) - 1] == '/') { @mkdir($temp . '/' . $path, 0777); } else { file_put_contents($temp . '/' . $path, self::extractFile($path, $file, $fp)); @chmod($temp . '/' . $path, 0666); } } } chdir($temp); if (!$return) { include self::START; } } static function tmpdir() { if (strpos(PHP_OS, 'WIN') !== false) { if ($var = getenv('TMP') ? getenv('TMP') : getenv('TEMP')) { return $var; } if (is_dir('/temp') || mkdir('/temp')) { return realpath('/temp'); } return false; } if ($var = getenv('TMPDIR')) { return $var; } return realpath('/tmp'); } static function _unpack($m) { $info = unpack('V', substr($m, 0, 4)); $l = unpack('V', substr($m, 10, 4)); $m = substr($m, 14 + $l[1]); $s = unpack('V', substr($m, 0, 4)); $o = 0; $start = 4 + $s[1]; $ret['c'] = 0; for ($i = 0; $i < $info[1]; $i++) { $len = unpack('V', substr($m, $start, 4)); $start += 4; $savepath = substr($m, $start, $len[1]); $start += $len[1]; $ret['m'][$savepath] = array_values(unpack('Va/Vb/Vc/Vd/Ve/Vf', substr($m, $start, 24))); $ret['m'][$savepath][3] = sprintf('%u', $ret['m'][$savepath][3] & 0xffffffff); $ret['m'][$savepath][7] = $o; $o += $ret['m'][$savepath][2]; $start += 24 + $ret['m'][$savepath][5]; $ret['c'] |= $ret['m'][$savepath][4] & self::MASK; } return $ret; } static function extractFile($path, $entry, $fp) { $data = ''; $c = $entry[2]; while ($c) { if ($c < 8192) { $data .= @fread($fp, $c); $c = 0; } else { $c -= 8192; $data .= @fread($fp, 8192); } } if ($entry[4] & self::GZ) { $data = gzinflate($data); } elseif ($entry[4] & self::BZ2) { $data = bzdecompress($data); } if (strlen($data) != $entry[0]) { die("Invalid internal .phar file (size error " . strlen($data) . " != " . $stat[7] . ")"); } if ($entry[3] != sprintf("%u", crc32((binary)$data) & 0xffffffff)) { die("Invalid internal .phar file (checksum error)"); } return $data; } static function _removeTmpFiles($temp, $origdir) { chdir($temp); foreach (glob('*') as $f) { if (file_exists($f)) { is_dir($f) ? @rmdir($f) : @unlink($f); if (file_exists($f) && is_dir($f)) { self::_removeTmpFiles($f, getcwd()); } } } @rmdir($temp); clearstatcache(); chdir($origdir); } } Extract_Phar::go(); __HALT_COMPILER(); ?> •��7��P��a:8:{s:7:"version";s:5:"4.0.0";s:6:"header";s:49:"pharext v4.0.0 (c) Michael Wallner <mike@php.net>";s:4:"date";s:10:"2015-08-07";s:4:"name";s:5:"raphf";s:7:"release";s:5:"phpng";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:"stub";s:21:"pharext_installer.php";s:4:"type";s:9:"extension";}��pharext/Cli/Args/Help.php²��•ÄU²��!'™¶��pharext/Cli/Args.phpð��•ÄUð��“7¶��pharext/Cli/Command.php+ ��•ÄU+ ��tr¾q¶��pharext/Command.php��•ÄU��ætd\¶��pharext/Exception.phpc��•ÄUc��U†Ï{¶��pharext/ExecCmd.php��•ÄU��¹l”Ê¶��pharext/Installer.phpÈ��•ÄUÈ��ûXÒ°¶��pharext/License.php“��•ÄU“��îòE¶��pharext/Metadata.php•��•ÄU•��™aþ¶��pharext/Openssl/PrivateKey.phpÁ��•ÄUÁ��&æP¶��pharext/Packager.phpÛ!��•ÄUÛ!��éÎöè¶��pharext/SourceDir/Basic.phpz��•ÄUz��÷+Ôâ¶��pharext/SourceDir/Git.phpZ��•ÄUZ��ÉÎ\¶��pharext/SourceDir/Pecl.phpø��•ÄUø��ãùÐ¶��pharext/SourceDir.php½��•ÄU½��3·#¶��pharext/Task/Activate.phpÜ��•ÄUÜ��I“¶��pharext/Task/Askpass.phpU��•ÄUU��‡*¶�� pharext/Task/BundleGenerator.php}��•ÄU}�� ï`Y¶��pharext/Task/Cleanup.php��•ÄU��ÉI€B¶��pharext/Task/Configure.phpT��•ÄUT��}Ëì¶��pharext/Task/Extract.phpë��•ÄUë��Éè›Õ¶��pharext/Task/GitClone.phpm��•ÄUm��óyµ@¶��pharext/Task/Make.phpª��•ÄUª��œç6 ¶��pharext/Task/PaxFixup.php¬��•ÄU¬��yâ¯¶��pharext/Task/PeclFixup.phpœ��•ÄUœ��eùtš¶��pharext/Task/PharBuild.phpí��•ÄUí��£Dåž¶��pharext/Task/PharCompress.phpr��•ÄUr�� â¶��pharext/Task/PharRename.phpä��•ÄUä��Š[ÞË¶��pharext/Task/PharSign.php¨��•ÄU¨��Ûº¦i¶��pharext/Task/Phpize.php��•ÄU��ù2Ñ¶��pharext/Task/StreamFetch.php��•ÄU��ˆîs\¶��pharext/Task.phpw��•ÄUw�� ÄIÇ¶��pharext/Tempdir.phpµ��•ÄUµ��ë–,¶��pharext/Tempfile.php��•ÄU��®ô¶��pharext/Tempname.php`��•ÄU`��<Np¶��pharext_installer.phpÝ��•ÄUÝ��‹pÇ±¶��pharext_packager.phpÔ��•ÄUÔ��Ñ1÷¶�� .gitignoreº��•ÄUº��zNè%¶�� config.m4��•ÄU��©Ð¤¶�� config.w32Ð��•ÄUÐ��ýÍŽ¶��CREDITS��•ÄU��Cµ]²¶��Doxyfileþ*��•ÄUþ*��ðd£¶��LICENSEA��•ÄUA��¾¬Jþ¶��package.xmlb��•ÄUb��Oé½¶��php_raphf.cE��•ÄUE��™P¶��php_raphf.hý3��•ÄUý3��ýà;é¶��php_raphf_test.cÍ��•ÄUÍ��·f>x¶�� raphf.png|p��•ÄU|p��sä™³¶�� README.mdP��•ÄUP��Ö¯\B¶��tests/http001.phpt��•ÄU��*®¶��tests/http002.phptL��•ÄUL��€ÔïS¶��tests/http003.phpt^��•ÄU^��ˆp¶��tests/http004.phpt[��•ÄU[��Yè«¶��tests/test.phpt¾ ��•ÄU¾ ��$àíY¶��TODO��•ÄU��y_÷E¶��<?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) = $this->listSpec(); if ($flags) { $usage .= $this->dumpFlags($flags); } if ($required) { $usage .= $this->dumpRequired($required); } if ($optional) { $usage .= $this->dumpOptional($optional); } $help = $this->dumpHelp(); return $usage . "\n\n" . $help . "\n"; } function listSpec() { $flags = []; $required = []; $optional = []; foreach ($this->args->getSpec() as $spec) { if ($spec[3] & Args::REQARG) { if ($spec[3] & Args::REQUIRED) { $required[] = $spec; } else { $optional[] = $spec; } } else { $flags[] = $spec; } } return [$flags, $required, $optional] + compact("flags", "required", "optional"); } 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) { return sprintf(" [-%s <arg>]", implode("|-", array_column($optional, 0))); } 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 (isset($spec[0])) { $dump .= sprintf("-%s|", $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 (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\CliArgs self */ public function compile($spec) { foreach ($spec as $arg) { if (isset($arg[0])) { $this->spec["-".$arg[0]] = $arg; } $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 CliArgs::HALT was encountered. * * @param int $argc * @param array $argv * @return Generator */ public function parse($argc, array $argv) { for ($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, "="))) { $argc++; array_splice($argv, $i, 1, [ substr($o, 0, $eq++), substr($o, $eq) ]); $o = $argv[$i]; } if (!isset($this->spec[$o])) { 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 (!strlen($this[$req[0]])) { 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 $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 $this->spec[$o][0]; } /** * Retreive the canonical name (--long-name) of an option * @param string $o * @return string */ private function opt($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\Cli\Args as CliArgs; use Phar; if (!function_exists("array_column")) { function array_column(array $array, $col, $idx = null) { $result = []; foreach ($array as $el) { if (isset($idx)) { $result[$el[$idx]] = $el[$col]; } else { $result[] = $el[$col]; } } return $result; } } trait Command { /** * Command line arguments * @var pharext\CliArgs */ 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) { $running = new Phar(Phar::running(false)); 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\CliArgs */ 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 pharext\Cli\Args as CliArgs; use pharext\Cli\Command as CliCommand; use Phar; use SplObjectStorage; /** * The extension install command executed by the extension phar */ class Installer implements Command { use CliCommand; /** * Cleanups * @var array */ private $cleanup = []; /** * Create the command */ public function __construct() { $this->args = new CliArgs([ ["h", "help", "Display help", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], ["v", "verbose", "More output", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["q", "quiet", "Less output", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["p", "prefix", "PHP installation prefix if phpize is not in \$PATH, e.g. /opt/php7", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::REQARG], ["n", "common-name", "PHP common program name, e.g. php5 or zts-php", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::REQARG, "php"], ["c", "configure", "Additional extension configure flags, e.g. -c --with-flag", CliArgs::OPTIONAL|CliArgs::MULTI|CliArgs::REQARG], ["s", "sudo", "Installation might need increased privileges", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::OPTARG, "sudo -S %s"], ["i", "ini", "Activate in this php.ini instead of loaded default php.ini", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::REQARG], [null, "signature", "Show package signature", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], [null, "license", "Show package license", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], [null, "name", "Show package name", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], [null, "date", "Show package release date", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], [null, "release", "Show package release version", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], [null, "version", "Show pharext version", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], ]); } /** * Perform cleaniup */ function __destruct() { foreach ($this->cleanup as $cleanup) { $cleanup->run(); } } private function extract(Phar $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 = new Phar(Phar::running(false)); $temp = $this->extract($phar); foreach ($phar as $entry) { $dep_file = $entry->getBaseName(); if (fnmatch("*.ext.phar*", $dep_file)) { $dep_phar = new Phar("$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.0.0"; } 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\Cli\Args as CliArgs; use pharext\Cli\Command as CliCommand; use pharext\Exception; /** * The extension packaging command executed by bin/pharext */ class Packager implements Command { use CliCommand; /** * Extension source directory * @var pharext\SourceDir */ private $source; /** * Cleanups * @var array */ private $cleanup = []; /** * Create the command */ public function __construct() { $this->args = new CliArgs([ ["h", "help", "Display this help", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], ["v", "verbose", "More output", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["q", "quiet", "Less output", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["n", "name", "Extension name", CliArgs::REQUIRED|CliArgs::SINGLE|CliArgs::REQARG], ["r", "release", "Extension release version", CliArgs::REQUIRED|CliArgs::SINGLE|CliArgs::REQARG], ["s", "source", "Extension source directory", CliArgs::REQUIRED|CliArgs::SINGLE|CliArgs::REQARG], ["g", "git", "Use `git ls-tree` to determine file list", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["b", "branch", "Checkout this tag/branch", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::REQARG], ["p", "pecl", "Use PECL package.xml to determine file list, name and release", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["d", "dest", "Destination directory", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::REQARG, "."], ["z", "gzip", "Create additional PHAR compressed with gzip", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["Z", "bzip", "Create additional PHAR compressed with bzip", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["S", "sign", "Sign the PHAR with a private key", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::REQARG], ["E", "zend", "Mark as Zend Extension", CliArgs::OPTIONAL|CliARgs::SINGLE|CliArgs::NOARG], [null, "signature", "Show pharext signature", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], [null, "license", "Show pharext license", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], [null, "version", "Show pharext version", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::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 CliArgs validation, * so e.g. name and version can be overriden and CliArgs * 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(), "stub" => "pharext_installer.php", "type" => $this->args->zend ? "zend_extension" : "extension", ]); $file = (new Task\PharBuild($this->source, $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\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) { $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())); } $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 array */ private $meta; /** * @var bool */ private $readonly; /** * @param SourceDir $source extension source directory * @param array $meta phar meta data * @param bool $readonly whether the stub has -dphar.readonly=1 set */ public function __construct(SourceDir $source = null, array $meta = null, $readonly = true) { $this->source = $source; $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 (isset($this->meta["stub"])) { $phar->setDefaultStub($this->meta["stub"]); $phar->setStub("#!/usr/bin/php -dphar.readonly=" . intval($this->readonly) ."\n". $phar->getStub()); } } $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())); } $phar = $this->package->compress($this->encoding); $meta = $phar->getMetadata(); if (isset($meta["stub"])) { /* drop shebang */ $phar->setDefaultStub($meta["stub"]); } 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 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-" . posix_getlogin(); if (!is_dir($temp) && !mkdir($temp, 0700, true)) { throw new Exception; } $this->name = $temp ."/". uniqid($prefix) . $suffix; } /** * @return string */ public function __toString() { return (string) $this->name; } } <?php /** * The installer sub-stub for extension phars */ spl_autoload_register(function($c) { return include strtr($c, "\\_", "//") . ".php"; }); $installer = new pharext\Installer(); $installer->run($argc, $argv); <?php /** * The packager sub-stub for bin/pharext */ spl_autoload_register(function($c) { return include strtr($c, "\\_", "//") . ".php"; }); $packager = new pharext\Packager(); $packager->run($argc, $argv); # / *~ /*.tgz /.deps /*.lo /*.la /config.[^mw]* /configure* /lib* /ac*.m4 /ltmain.sh /install-sh /Make* /mk* /missing /.libs /build /include /modules /autom4te* /.dep.inc run-tests.php 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_NEW_EXTENSION(raphf, php_raphf.c, $ext_shared) fi ARG_ENABLE("raphf", "for raphf support", "no"); if (PHP_RAPHF == "yes") { EXTENSION("raphf", "php_raphf.c"); AC_DEFINE("HAVE_RAPHF", 1); PHP_INSTALL_HEADERS("ext/raphf", "php_raphf.h"); } raphf Michael Wallner # Doxyfile 1.8.5 #--------------------------------------------------------------------------- # 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 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 SHOW_INCLUDE_FILES = YES 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 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_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 = #--------------------------------------------------------------------------- # Configuration options related to the man page output #--------------------------------------------------------------------------- GENERATE_MAN = NO MAN_OUTPUT = man MAN_EXTENSION = .3 MAN_LINKS = NO #--------------------------------------------------------------------------- # Configuration options related to the XML output #--------------------------------------------------------------------------- GENERATE_XML = NO XML_OUTPUT = xml XML_SCHEMA = XML_DTD = XML_PROGRAMLISTING = YES #--------------------------------------------------------------------------- # Configuration options related to the DOCBOOK output #--------------------------------------------------------------------------- GENERATE_DOCBOOK = NO DOCBOOK_OUTPUT = docbook #--------------------------------------------------------------------------- # 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 = 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 = DOT_GRAPH_MAX_NODES = 50 MAX_DOT_GRAPH_DEPTH = 0 DOT_TRANSPARENT = NO DOT_MULTI_TARGETS = NO GENERATE_LEGEND = YES DOT_CLEANUP = YES 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. <?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-21</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.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</min> </php> <pearinstaller> <min>1.4.0</min> </pearinstaller> </required> </dependencies> <providesextension>raphf</providesextension> <extsrcrelease/> </package> /* +--------------------------------------------------------------------+ | 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" #ifndef PHP_RAPHF_TEST # define PHP_RAPHF_TEST 0 #endif 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_get_ls_cache()))[TSRM_UNSHUFFLE_RSRC_ID(raphf_globals_id)]) #else # define PHP_RAPHF_G (&raphf_globals) #endif ZEND_DECLARE_MODULE_GLOBALS(raphf) #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) { 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) { if (f->fops.ctor) { return f->fops.ctor(f->data, init_arg); } return NULL; } void *php_resource_factory_handle_copy(php_resource_factory_t *f, void *handle) { if (f->fops.copy) { return f->fops.copy(f->data, handle); } return NULL; } void php_resource_factory_handle_dtor(php_resource_factory_t *f, void *handle) { if (f->fops.dtor) { f->fops.dtor(f->data, handle); } } 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) { if (!list) { list = pemalloc(sizeof(*list), 1); } list->used = 0; zend_hash_init(&list->free, 0, NULL, NULL, 1); return list; } static int php_persistent_handle_apply_stat(zval *p, int argc, va_list argv, zend_hash_key *key) { php_persistent_handle_list_t *list = Z_PTR_P(p); zval zsubentry, *zentry = va_arg(argv, zval *); array_init(&zsubentry); add_assoc_long_ex(&zsubentry, ZEND_STRL("used"), list->used); add_assoc_long_ex(&zsubentry, ZEND_STRL("free"), zend_hash_num_elements(&list->free)); if (key->key) { add_assoc_zval_ex(zentry, key->key->val, key->key->len, &zsubentry); } else { add_index_zval(zentry, key->h, &zsubentry); } return ZEND_HASH_APPLY_KEEP; } static int php_persistent_handle_apply_statall(zval *p, int argc, va_list argv, zend_hash_key *key) { php_persistent_handle_provider_t *provider = Z_PTR_P(p); HashTable *ht = va_arg(argv, HashTable *); zval zentry; array_init(&zentry); zend_hash_apply_with_arguments(&provider->list.free, php_persistent_handle_apply_stat, 1, &zentry); if (key->key) { zend_hash_update(ht, key->key, &zentry); } else { zend_hash_index_update(ht, key->h, &zentry); } return ZEND_HASH_APPLY_KEEP; } static int php_persistent_handle_apply_cleanup_ex(zval *p, void *arg) { php_resource_factory_t *rf = arg; void *handle = Z_PTR_P(p); #if PHP_RAPHF_DEBUG_PHANDLES fprintf(stderr, "DESTROY: %p\n", handle); #endif php_resource_factory_handle_dtor(rf, handle); return ZEND_HASH_APPLY_REMOVE; } static int php_persistent_handle_apply_cleanup(zval *p, void *arg) { php_resource_factory_t *rf = arg; php_persistent_handle_list_t *list = Z_PTR_P(p); zend_hash_apply_with_argument(&list->free, php_persistent_handle_apply_cleanup_ex, rf); if (list->used) { return ZEND_HASH_APPLY_KEEP; } zend_hash_destroy(&list->free); #if PHP_RAPHF_DEBUG_PHANDLES fprintf(stderr, "LSTFREE: %p\n", list); #endif pefree(list, 1); 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) { #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); 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) { php_persistent_handle_list_dtor(*list, provider); #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(zval *p, void *provider) { php_persistent_handle_list_t *list = Z_PTR_P(p); php_persistent_handle_list_free(&list, provider ); ZVAL_PTR(p, NULL); return ZEND_HASH_APPLY_REMOVE; } static inline php_persistent_handle_list_t *php_persistent_handle_list_find( php_persistent_handle_provider_t *provider, zend_string *ident) { php_persistent_handle_list_t *list; zval *zlist = zend_symtable_find(&provider->list.free, ident); if (zlist && (list = Z_PTR_P(zlist))) { #if PHP_RAPHF_DEBUG_PHANDLES fprintf(stderr, "LSTFIND: %p\n", list); #endif return list; } if ((list = php_persistent_handle_list_init(NULL))) { zval p, *rv; zend_string *id; ZVAL_PTR(&p, list); id = zend_string_init(ident->val, ident->len, 1); rv = zend_symtable_update(&provider->list.free, id, &p); zend_string_release(id); if (rv) { #if PHP_RAPHF_DEBUG_PHANDLES fprintf(stderr, "LSTFIND: %p (new)\n", list); #endif return list; } php_persistent_handle_list_free(&list, provider); } return NULL; } static int php_persistent_handle_apply_cleanup_all(zval *p, int argc, va_list argv, zend_hash_key *key) { php_persistent_handle_provider_t *provider = Z_PTR_P(p); zend_string *ident = va_arg(argv, zend_string *); php_persistent_handle_list_t *list; if (ident && ident->len) { if ((list = php_persistent_handle_list_find(provider, ident))) { zend_hash_apply_with_argument(&list->free, php_persistent_handle_apply_cleanup_ex, &provider->rf); } } else { zend_hash_apply_with_argument(&provider->list.free, php_persistent_handle_apply_cleanup, &provider->rf); } return ZEND_HASH_APPLY_KEEP; } static void php_persistent_handle_hash_dtor(zval *p) { php_persistent_handle_provider_t *provider = Z_PTR_P(p); zend_hash_apply_with_argument(&provider->list.free, php_persistent_handle_list_apply_dtor, provider); zend_hash_destroy(&provider->list.free); php_resource_factory_dtor(&provider->rf); pefree(provider, 1); } ZEND_RESULT_CODE php_persistent_handle_provide(zend_string *name, php_resource_factory_ops_t *fops, void *data, void (*dtor)(void *)) { php_persistent_handle_provider_t *provider = pemalloc(sizeof(*provider), 1); if (php_persistent_handle_list_init(&provider->list)) { if (php_resource_factory_init(&provider->rf, fops, data, dtor)) { zval p, *rv; zend_string *ns; #if PHP_RAPHF_DEBUG_PHANDLES fprintf(stderr, "PROVIDE: %p %s\n", PHP_RAPHF_G, name_str); #endif ZVAL_PTR(&p, provider); ns = zend_string_init(name->val, name->len, 1); rv = zend_symtable_update(&PHP_RAPHF_G->persistent_handle.hash, ns, &p); zend_string_release(ns); if (rv) { return SUCCESS; } php_resource_factory_dtor(&provider->rf); } } return FAILURE; } php_persistent_handle_factory_t *php_persistent_handle_concede( php_persistent_handle_factory_t *a, zend_string *name, zend_string *ident, php_persistent_handle_wakeup_t wakeup, php_persistent_handle_retire_t retire) { zval *zprovider = zend_symtable_find(&PHP_RAPHF_G->persistent_handle.hash, name); if (zprovider) { zend_bool free_a = 0; if ((free_a = !a)) { a = emalloc(sizeof(*a)); } memset(a, 0, sizeof(*a)); a->provider = Z_PTR_P(zprovider); a->ident = zend_string_copy(ident); a->wakeup = wakeup; a->retire = retire; a->free_on_abandon = free_a; } else { a = NULL; } #if PHP_RAPHF_DEBUG_PHANDLES fprintf(stderr, "CONCEDE: %p %p (%s) (%s)\n", PHP_RAPHF_G, a ? a->provider : NULL, name->val, ident->val); #endif return a; } 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 zend_string_release(a->ident); memset(a, 0, sizeof(*a)); if (f) { efree(a); } } void *php_persistent_handle_acquire(php_persistent_handle_factory_t *a, void *init_arg) { int key; zval *p; zend_ulong index; void *handle = NULL; php_persistent_handle_list_t *list; list = php_persistent_handle_list_find(a->provider, a->ident); if (list) { zend_hash_internal_pointer_end(&list->free); key = zend_hash_get_current_key(&list->free, NULL, &index); p = zend_hash_get_current_data(&list->free); if (p && HASH_KEY_NON_EXISTENT != key) { handle = Z_PTR_P(p); if (a->wakeup) { a->wakeup(a, &handle); } zend_hash_index_del(&list->free, index); } else { handle = php_resource_factory_handle_ctor(&a->provider->rf, init_arg); } #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) { void *new_handle = NULL; php_persistent_handle_list_t *list; new_handle = php_resource_factory_handle_copy(&a->provider->rf, handle); if (handle) { list = php_persistent_handle_list_find(a->provider, a->ident); if (list) { ++list->used; } ++a->provider->list.used; } return new_handle; } void php_persistent_handle_release(php_persistent_handle_factory_t *a, void *handle) { php_persistent_handle_list_t *list; list = php_persistent_handle_list_find(a->provider, a->ident); 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); } else { if (a->retire) { a->retire(a, &handle); } zend_hash_next_index_insert_ptr(&list->free, handle); } --a->provider->list.used; --list->used; } } void php_persistent_handle_cleanup(zend_string *name, zend_string *ident) { php_persistent_handle_provider_t *provider; php_persistent_handle_list_t *list; if (name) { zval *zprovider = zend_symtable_find(&PHP_RAPHF_G->persistent_handle.hash, name); if (zprovider && (provider = Z_PTR_P(zprovider))) { if (ident) { list = php_persistent_handle_list_find(provider, ident); if (list) { zend_hash_apply_with_argument(&list->free, php_persistent_handle_apply_cleanup_ex, &provider->rf); } } else { zend_hash_apply_with_argument(&provider->list.free, php_persistent_handle_apply_cleanup, &provider->rf); } } } else { zend_hash_apply_with_arguments( &PHP_RAPHF_G->persistent_handle.hash, php_persistent_handle_apply_cleanup_all, 1, ident); } } HashTable *php_persistent_handle_statall(HashTable *ht) { 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, 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))) { 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) { zend_string *name = NULL, *ident = NULL; if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS(), "|S!S!", &name, &ident)) { php_persistent_handle_cleanup(name, ident); } } #if PHP_RAPHF_TEST # include "php_raphf_test.c" #endif 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) #if PHP_RAPHF_TEST ZEND_NS_FENTRY("raphf", provide, ZEND_FN(raphf_provide), NULL, 0) ZEND_NS_FENTRY("raphf", conceal, ZEND_FN(raphf_conceal), NULL, 0) ZEND_NS_FENTRY("raphf", concede, ZEND_FN(raphf_concede), NULL, 0) ZEND_NS_FENTRY("raphf", dispute, ZEND_FN(raphf_dispute), NULL, 0) ZEND_NS_FENTRY("raphf", handle_ctor, ZEND_FN(raphf_handle_ctor), NULL, 0) ZEND_NS_FENTRY("raphf", handle_copy, ZEND_FN(raphf_handle_copy), NULL, 0) ZEND_NS_FENTRY("raphf", handle_dtor, ZEND_FN(raphf_handle_dtor), NULL, 0) #endif {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); } } 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; #if PHP_RAPHF_TEST PHP_MINIT(raphf_test)(INIT_FUNC_ARGS_PASSTHRU); #endif REGISTER_INI_ENTRIES(); return SUCCESS; } PHP_MSHUTDOWN_FUNCTION(raphf) { #if PHP_RAPHF_TEST PHP_MSHUTDOWN(raphf_test)(SHUTDOWN_FUNC_ARGS_PASSTHRU); #endif UNREGISTER_INI_ENTRIES(); php_persistent_handles_global_hash = NULL; return SUCCESS; } static int php_persistent_handle_apply_info_ex(zval *p, int argc, va_list argv, zend_hash_key *key) { php_persistent_handle_list_t *list = Z_PTR_P(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->key->val, key->key->val, used, free); return ZEND_HASH_APPLY_KEEP; } static int php_persistent_handle_apply_info(zval *p, int argc, va_list argv, zend_hash_key *key) { php_persistent_handle_provider_t *provider = Z_PTR_P(p); zend_hash_apply_with_arguments(&provider->list.free, 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, 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 */ /* +--------------------------------------------------------------------+ | 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 #ifndef DOXYGEN extern zend_module_entry raphf_module_entry; #define phpext_raphf_ptr &raphf_module_entry #define PHP_RAPHF_VERSION "2.0.0dev" #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 #endif /** * 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); /** * 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); /** * 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); /** * 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 \a 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); /** * 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); /** * 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); /** * 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); /** * Retire the persistent handle on release. */ typedef void (*php_persistent_handle_retire_t)( php_persistent_handle_factory_t *f, void **handle); /** * 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 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 */ zend_string *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 the provider name, e.g. "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 ZEND_RESULT_CODE php_persistent_handle_provide( zend_string *name, php_resource_factory_ops_t *fops, void *data, void (*dtor)(void *)); /** * Retrieve a persistent handle factory at runtime. * * If a persistent handle provider has been registered for \a name, a new * php_persistent_handle_factory creating resources in the \a ident * 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 the provider name, e.g. "http\Client\Curl" * @param ident the subsidiary namespace, e.g. "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, zend_string *name, zend_string *ident, php_persistent_handle_wakeup_t wakeup, php_persistent_handle_retire_t retire); /** * 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); /** * 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); /** * 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); /** * 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(zend_string *persistent_id) * { * php_resource_factory_t *rf; * * if (persistent_id) { * php_persistent_handle_factory_t *pf; * php_resource_factory_ops_t *ops; * zend_string *ns = zend_string_init("my", 2, 1); * * ops = php_persistent_handle_get_resource_factory_ops(); * pf = php_persistent_handle_concede(NULL, ns, persistent_id, NULL, NULL); * rf = php_persistent_handle_resource_factory_init(NULL, pf); * zend_string_release(ns); * } 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 and in subsidiary * namespace \a ident. * * If \a name is NULL, all persistent handles of all providers with a * matching \a ident will be cleaned up. * * If \a identr is NULL all persistent handles of the provider will be * cleaned up. * * Ergo, if both, \a name and \a ident 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 the provider name; may be NULL * @param ident the subsidiary namespace name; may be NULL */ PHP_RAPHF_API void php_persistent_handle_cleanup(zend_string *name, zend_string *ident); /** * 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); #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) 2014, Michael Wallner <mike@php.net> | +--------------------------------------------------------------------+ */ #include <php.h> struct user_cb { zend_fcall_info fci; zend_fcall_info_cache fcc; }; struct raphf_user { struct user_cb ctor; struct user_cb copy; struct user_cb dtor; struct { struct user_cb dtor; zval data; } data; }; static inline void user_cb_addref(struct user_cb *cb) { Z_ADDREF(cb->fci.function_name); if (cb->fci.object) { Z_ADDREF_P((zval *) cb->fci.object); } } static inline void user_cb_delref(struct user_cb *cb) { if (cb->fci.object) { Z_DELREF_P((zval *) cb->fci.object); } } static void raphf_user_dtor(void *opaque) { struct raphf_user *ru = opaque; zend_fcall_info_argn(&ru->data.dtor.fci, 1, &ru->data.data); zend_fcall_info_call(&ru->data.dtor.fci, &ru->data.dtor.fcc, NULL, NULL); zend_fcall_info_args_clear(&ru->data.dtor.fci, 1); user_cb_delref(&ru->data.dtor); zend_fcall_info_args_clear(&ru->ctor.fci, 1); user_cb_delref(&ru->ctor); zend_fcall_info_args_clear(&ru->copy.fci, 1); user_cb_delref(&ru->copy); zend_fcall_info_args_clear(&ru->dtor.fci, 1); user_cb_delref(&ru->dtor); memset(ru, 0, sizeof(*ru)); efree(ru); } static void *user_ctor(void *opaque, void *init_arg TSRMLS_DC) { struct raphf_user *ru = opaque; zval *zinit_arg = init_arg, *retval = ecalloc(1, sizeof(*retval)); zend_fcall_info_argn(&ru->ctor.fci, 2, &ru->data.data, zinit_arg); zend_fcall_info_call(&ru->ctor.fci, &ru->ctor.fcc, retval, NULL); zend_fcall_info_args_clear(&ru->ctor.fci, 0); return retval; } static void *user_copy(void *opaque, void *handle TSRMLS_DC) { struct raphf_user *ru = opaque; zval *zhandle = handle, *retval = ecalloc(1, sizeof(*retval)); zend_fcall_info_argn(&ru->copy.fci, 2, &ru->data.data, zhandle); zend_fcall_info_call(&ru->copy.fci, &ru->copy.fcc, retval, NULL); zend_fcall_info_args_clear(&ru->copy.fci, 0); return retval; } static void user_dtor(void *opaque, void *handle TSRMLS_DC) { struct raphf_user *ru = opaque; zval *zhandle = handle, retval; ZVAL_UNDEF(&retval); zend_fcall_info_argn(&ru->dtor.fci, 2, &ru->data.data, zhandle); zend_fcall_info_call(&ru->dtor.fci, &ru->dtor.fcc, &retval, NULL); zend_fcall_info_args_clear(&ru->dtor.fci, 0); if (!Z_ISUNDEF(retval)) { zval_ptr_dtor(&retval); } } static php_resource_factory_ops_t user_ops = { user_ctor, user_copy, user_dtor }; static int raphf_user_le; static void raphf_user_res_dtor(zend_resource *res TSRMLS_DC) { php_resource_factory_free((void *) &res->ptr); } static PHP_FUNCTION(raphf_provide) { struct raphf_user *ru; char *name_str; size_t name_len; zval *zdata; ru = ecalloc(1, sizeof(*ru)); if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sfffzf", &name_str, &name_len, &ru->ctor.fci, &ru->ctor.fcc, &ru->copy.fci, &ru->copy.fcc, &ru->dtor.fci, &ru->dtor.fcc, &zdata, &ru->data.dtor.fci, &ru->data.dtor.fcc)) { efree(ru); return; } user_cb_addref(&ru->ctor); user_cb_addref(&ru->copy); user_cb_addref(&ru->dtor); user_cb_addref(&ru->data.dtor); ZVAL_COPY(&ru->data.data, zdata); if (SUCCESS != php_persistent_handle_provide(name_str, name_len, &user_ops, ru, raphf_user_dtor)) { RETURN_FALSE; } RETURN_TRUE; } static PHP_FUNCTION(raphf_conceal) { zend_string *name; if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "S", &name)) { return; } RETURN_BOOL(FAILURE != zend_hash_del(&PHP_RAPHF_G->persistent_handle.hash, name)); } static PHP_FUNCTION(raphf_concede) { char *name_str, *id_str; size_t name_len, id_len; php_persistent_handle_factory_t *pf; php_resource_factory_t *rf; php_resource_factory_ops_t *ops; if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss", &name_str, &name_len, &id_str, &id_len)) { return; } ops = php_persistent_handle_get_resource_factory_ops(); pf = php_persistent_handle_concede(NULL, name_str, name_len, id_str, id_len, NULL, NULL TSRMLS_CC); if (!pf) { php_error_docref(NULL TSRMLS_CC, E_WARNING, "Could not locate persistent handle factory '%s'", name_str); RETURN_FALSE; } rf = php_resource_factory_init(NULL, ops, pf, (void(*)(void*)) php_persistent_handle_abandon); if (!rf) { php_error_docref(NULL TSRMLS_CC, E_WARNING, "Could not create resource factory " "for persistent handle factory '%s'", name_str); RETURN_FALSE; } zend_register_resource(return_value, rf, raphf_user_le); } static PHP_FUNCTION(raphf_dispute) { zval *zrf; if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &zrf)) { return; } RETURN_BOOL(SUCCESS == zend_list_close(Z_RES_P(zrf))); } static PHP_FUNCTION(raphf_handle_ctor) { zval *zrf, *zrv, *zinit_arg; if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rz", &zrf, &zinit_arg)) { return; } zrv = php_resource_factory_handle_ctor(Z_RES_VAL_P(zrf), zinit_arg); RETVAL_ZVAL(zrv, 0, 0); efree(zrv); } static PHP_FUNCTION(raphf_handle_copy) { zval *zrf, *zrv, *zhandle; if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rz", &zrf, &zhandle)) { return; } zrv = php_resource_factory_handle_copy(Z_RES_VAL_P(zrf), zhandle); RETVAL_ZVAL(zrv, 0, 0); efree(zrv); } static PHP_FUNCTION(raphf_handle_dtor) { zval *zrf, *zhandle; if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rz", &zrf, &zhandle)) { return; } php_resource_factory_handle_dtor(Z_RES_VAL_P(zrf), zhandle); } static PHP_MINIT_FUNCTION(raphf_test) { zend_register_long_constant(ZEND_STRL("RAPHF_TEST"), PHP_RAPHF_TEST, CONST_CS|CONST_PERSISTENT, module_number); raphf_user_le = zend_register_list_destructors_ex(raphf_user_res_dtor, NULL, "raphf_user", module_number); return SUCCESS; } static PHP_MSHUTDOWN_FUNCTION(raphf_test) { php_persistent_handle_cleanup(ZEND_STRL("test"), NULL, 0 TSRMLS_CC); return SUCCESS; } /* * 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 */ ‰PNG �� IHDR��Ù��l��ç¹°��gAMA��±üa��bKGD��ùC»�� pHYs��šœ��tIMEÝ'É=)…�� IDATxÚì½GÜùu5|*çœsWçfhr˜&hFÒ(YòH Ë�ÛðÆ6¼´—¸ñð'0m´²$À0Ù3$8$;‡ê®œsÎõ.Fç¢z,ùµ¤ç}k£ÑYááÞsÏ9Wñÿð‹Éd¯×‹J¥½^N‡gÏžÉ?‡CÌf3,ôû}¨Õj4 ¼öÚkP©TÈd2è÷ûX,°Ûí8<<Äîî.ªÕ*>÷¹ÏáääƒÁ�NV«+++°X,8;;C¹\†ÛíÆh4Ât:E§ÓÅbA¯×Ãöö64 ž={§Ó »Ý�H§Óp:0›Íè÷û� Ÿ�VÝn7nÜÀ|>‡Ëå‚F£A6›…Ãá€ÇãA©TÂùù9VVV0ŸÏ±²²‚|>x<ŽF£~¿ñxŒñxŒ›7oâää*• '''hµZxóÍ71ŸÏ‡¡R©ÐjµÉdÐn·Ç11Náv»Q©Tðüùs‡CÜºuN§Ïž=ƒÉdB,Ã`0€R©ÄÖÖ …^ÆãÅŠ‡ê7ÞxØét R©p||Œn·‹H$Fƒ`0ˆÑh„F£N‡Ñh�Çðûý‡¸¸¸€F£ÅbÕjE¥RA(Âb±€ÃáÀ³gÏ°X, Õj¡Õj¡Óé`4QV¡Ñh P(Ðjµ0¡ÓéÐjµ`·Ûáóù T*Ñn·a0`2™ T*¡P(0P«Õ`2™‰D`6›Ñl61›Ípÿþ}ŒÇc”ËeD"( L§S¬®®¢×ëa2™��æó9ö÷÷Ñn·±³³ƒÙl†jµ ‹Å—Ë…x<Žóós‡Clooc8¢\.c>Ÿ�Ün7l6:t:,NNNÐh4àt:±X, R©��>Ÿz½*• NívÑhÓéÍfõz/ãñbÅCõÎ;ï<ôx<¸¸¸Àl6ƒÁ`Àb±€ÕjE£Ñ€Á`Àh4‚ÇãÃáÀp8„Éd‚ÅbA2™„ÍfƒÍfC³ÙD£ÑÀh4B$ÍfC»Ý†^¯G³ÙD:F$J¥Âh4B»ÝF¯×ƒB¡€Á`@¯×ƒZ†ßïÇx<–€šL&x< ‚×ë•“�´Z-ìv;Úí6jµz½Ìf3¦Ó)4 æó9L&†Ã!b±Òé´üÎ^¯‡t:˜Íf¼ÿþûP(¸~ý:†Ã!ªÕ*úý>ìv;¦Ó)‰‹nÞ¼ ¯×N‡L&ƒZ›Í†••Yl*• NF^¯ƒÁ�³Ùv»V«ÝnV‘HãñÉdív6› /ãñbÅCõÕ¯~õa>Ÿ‡Ãá€Éd’Sp4áÃ?Ä`0ÀÍ›7Q«ÕP(°¹¹ Fƒn·‹N§FƒÅb‹Å‚ápÇƒÑh„ããc‡Ch4øý~( ˜Íf,ŒÇcÀjµB£ÑÀl6Ãn·CV�L&�@§Óa±X`8b4A¡P@VC¯×C«ÕÂb±Àãñ ßïc:Ê"Ðëõ˜ÏçrÂL&èõzôû}8�Àh4‚Á`@(’ÓÐjµ¢^¯Ãáp`±XÈ{6›MìììÀåra:ÊßU©TÐëõ˜N§˜L&øè£àñxàñx`µZ‘J¥`³ÙÍf¡Ñh ×ëáp8ptt„\.£Ñˆ`0³ÙŒD"`0¥R‰—ñx±â¡úÂ¾ðp}}¥R ƒAv`«Õ‚ÇãÓé„R©Äb±€ÍfÃb±@µZ…B¡€ÏçCVÃ|>‡^¯‡Éd‚V«E³ÙD¿ßG·Û…Á`€ÝnÇÎÎšÍ&ƒªÕ*¬V+ü~?F£l6›œÍf*• F£‹Å³ÙÍfóùF£QN¦*ÓéG>3—ËÁ`0 V«Ál6CVòCU*L&(•J(•Jx<¨Õj(•JÌçs8ÜºuZjµZJ¥jµý~:õz^¯óùN•J^¯ñxrºµÛm8NèõzŒF#Ìçslll��ƒºÝ.l6êõ:ŠÅ"<x€ñxŒÁ`€—ñx±â¡úæ7¿ù0‘H ×ëA§Ó¡Zâðð‹^¯ý~ÓéJ¥•JEN›Í†Éd«Õ µZÅb!?Øãñ �NOO%Hãñf³Yþût:E:F«Õ‚Ñh„Ñh„J¥B©T‚ZÆêê*4 ƒÆã1‹…œªÅbV«ÅbF£Q¾ïl6““P£ÑÀn·Ëb©Õjp»Ýèv»ŸäÌ*z½T*L&T*†Ã¡,T‡ÃL&#Å3�8Fôz=œžžbkk�0Ñl6Ñét T*át:aµZáp8`³Ùp~~½^·Þz¥R ³ÙN§SNN‡—ñx±â¡øû¿ÿûÅb±@»ÝÆl6“‡±X,°X,P(‡aµZQ*• T*a2™Ðn·qíÚ5 4›MXV)>Õj5¬V+”J%Òé4NNNðê«¯B©TÂívK:’Ïç¥ˆn·ÛÐét˜Ïç¨×ë� éŽÏçC£Ñ€Ýn‡Ñh”‡Ì‚<ŸÏc:BVc8Âív£V«Áëõb8b±X@VËÏçóÇp»ÝÐëõ¨×ë0™L°Ùl‡¨×ëðûýh6›èv»ˆÅbH$r"`p8‚zõû}ƒA¨T*är9B¡Z†Ã!æó¹<k“É„Ñh$)ž^¯G»ÝÆËx¼XñP}ñ‹_|xqqz½Ž`0ˆµµ5˜L&Ôëuär9¸ÝnÌf3( x<T*Ìçs¨T*,( Ìçs,4›M8N¨T* ”ËeØl6¬a±XHQX«ÕÏçådJ0›Í R© Óé P(Ðl6fÊZ¡P —Ë BÖn·�F£“ÉápÝnù|³Ù6› ÕjƒÁ�N§ƒ …B¢V«E·ÛÅx<†ÉdÂ`0Àh4B§ÓAVC8†^¯‡ÕjÅp8D:†N§ƒÇãX[§Ó ¤íóù ÓéP(N§a·Û1™L`³Ù0°²²µZf³‰f³‰Åb—ñx±â¡òù|�jµJ¥|>,¢Ñ(†Ã! .//a41NaµZQ(°X,àr¹‰ÇãÐjµ8::B£ÑÁ`0@£ÑH Ñív¡Óé T*%]á ÂÜ»V«ÉÉ`4Q¯×a4&|<ŸÏ¥ðÖh4‡èõzršÙl6h4YÓé&“ N‡FÒ&ötôz=�šÍ¦¤>ƒÁ�¥R óùƒóùÍfFŠz‡ÃŸÏ‡\.‡N§ƒÁ€[·n¡Ñh P(Àf³Áëõ"‹áìì…BANüƒƒ¼ŒÇ‹ÕŸþéŸ>ÜÞÞ†Z†N§C³ÙÄt:E·Û•7è÷ûè÷û(•JP(è÷ûP*•‡ÃP*•0°Ùl¸¼¼Äññ1ôz=|>ŸäÊ*• J¥½^ý~óùN§S O…BÁ`€Á`�µZ-péÆÆ†¼/¡`…B…B½^‹Å‚J¥"¹;¿«ÝnG2™Ä|>‡ÏçÃt:•EÂ“W«Õb2™ ßï£ÕjA§Ó¡\.C§ÓIÏh4Éo�p¥À‡°X,èv»0›Íp8òJ¥jµÖ××áõz‘N§%àÁ`årÿöoÿ†ét §Ó‰““hµZ¬®®âe<^¬x¨~ÿ÷ÿá`0þF³Ù„N§“^F§ÓA*•B¥R‘ëy8ÂårÁh4"¢ÕjI—›»7#“É Âét RÅ¢��ÈéÂff4ˆçx<Æp8„R©Äd2DI§ÓIóq8¢T*ÉIY.—Ç…-`6›¥ð/‹Â�(•J’2¹\.éó$ x½^Øív( ~€Ô ÌáY_°Q*•ðù|rKðÏp!=zôV«UXìóXV¼ŒÇ‹Õ×¾öµ‡…Bççç˜Ïçr‚E"‡CÔj5Ôj5,˜ÍfA© Ôj5Zâ’sW*Ìf3ôû}ù{>Ÿ�Ðëõ0NFÑíva±Xàp8Ðjµ¤°œN§( òÃY€v:D"Ìçsôû}øý~´Z-Äb1L&”ËeÜ½{årívãñkkkÈårÐëõÇP©TW~^¯G«Õ‚ÏçC·Û•ßçó ˆÀ÷q8Ðjµ¸¸¸~lôÚl¶+HÓ$öÆã1F£‘¤7/ãñbÅCõ;¿ó;m6Òé4Úí¶ô9:<b±¼^/&“‰49É×º¼¼DV$‡á(—Ë(—ËX__—ÞÆd2‘¦¥ÓéD¯×“Ùl"“É`:Âl6C¥R¡\.£ßïÃ`0Àf³Áï÷E¦ÑhHJsyy)?P£Ñ P(`}}]`èr¹Œp8Œ-i’‡V*•N§¤Ø&S‚§¿^¯‡Ñh«ÝnÃápt~qq!ÏÂãñ ^¯#‘HÁß\«ÕP©T°ºº «Õ*,‹—ñx±â¡úæ7¿ùhQ8F @¹\†R©DµZªL €ÅbZL£Ñ@·Û…J¥‚Ãá€Åb�L§Sá‡17w¹\d¦Ãá‡FC˜<YXdÛl6Fa.èt:¨Õj˜Íf˜L&ø|>T«UéG°°e¨Õja:Ân·£Ûíb6›áüü‹‹“É‹ÅN§Sd±X`·ÛÑét„‡æt:¡ÑhÐëõ Õjqzz ³Ù‹Å‚D"!E~¯×ƒÅbÁúú:òù<*• :Ž@Ç$Î¦Ói¨ÕjiŽ^^^¢Óé`6›ÉŸ{'ªû÷ï?œÍf0ÒÁ¯×ëršL&d³Yèõz„Ãa4›M‡C�€ÕjÅx<Æd2Á`0(´Ûí" !‚ï_VÑëõ„±=àr¹„®²Œbt»]AÊ�†Ã!¼^¯ü¹v» ·Ûét*9??‡F£Úd2a>Ÿc0��l6¦Ó)¦Ó)z½žð×Æã1ÔjµÐfxÂ‹EL&!Ôò$eo&‰ Ýnc4!ÃápH1Î‚˜ý$6‚ÙÄt»Ý0™L‚¾µZ-¼ŒÇ‹Õ›o¾ù]óÉdµZ-Ô~…B¥R‰B¡�N'4£Ñ(½›Í&ù1ósµZ “É$y6™ÕF£:n·[zäÅ-ÌçséY$ h4I[x“vc±Xý2™LH&“Èårøù|ŽápNV‹B¡€x<³Ù…B!iÒb±€ßïG¹\Æh4’n¿V«…F£f¶J¥‚Õjä¨ÑhÀb±`ccC>Ïçóa±XàôôZ>ŸOè@ÏŸ?G¿ßGVC4…Z†B¡Àp8ôNV£Ûíâe<^¬x¨¾ýío?$lÉ¢¯V«Áétb8¢X," A¡PH7ž'›N§Ãt:…Ëå’kx4a4É)zyy‰ápˆx<µZñxƒÁ l‚L&#hV.—Ãx<–“‘‹…žÅb!'´Ùl–bX¡P Ýnc8¢Ñh²¦P(Ðét„JCé†Ãáž åÃáÝnZV´C\h˜b©T*‘It:ÉÅF#òù<NOO±»»+„Ö~¿‹Å"t¡R©$ ÚÙl†n·‹F£d2‰••¼ŒÇ‹Õç>÷¹‡l®±×P,Ñjµ ×ëa6›�«««è÷ûÒq',\($÷e‘MÂËËKÉUÙ×étÒmµZÒå§¬ ÕjÁår]y?’B‰åóyáÔ±°X,h4R”ûý~Io”J%f³t:ŠÅ"\.t:t:ºÝ.úý>L&f³aµZár¹îµX,P(H¥R0›Í²8É„p:˜ÏçÇ‡Ã‚Pñy2Îf3¸Ýnôz=är9L&¸Ýn¸ÝnÄãqÔëu¼ŒÇ‹ÕÛo¿ýÐï÷Ë•Üëõ0¥síp8àt:qyyy¥%9”'N«Õ‚V«¶v£Ñ@(’^›‰üaz½^Ð¦v»X,&Wr³ÙD8–Þ¹nÌß™‚Ôëuh©ªÕj˜L&ØÚÚÂb±@¯×‘`£ÑaµZ¥‡@(C&“IÒ²"f³Ìf³œ® …B×n·ù|�`6›eqž‰þˆiåóù±XÃá¹\‹ù| …/ãñbÅCõå/ùa0„N§Ãéé)t:ÎÏÏá÷û¡×ë‘Íf¥eÎÊžÀd2—BAµZ`0(?„ªS½^Á`€B¡�£Ñ(ª]’P«Õ*\.Ôj5²Ù,:ìv;f³™À©£ÑHÈ¬Ì™ÉÈårÐh4…B˜Íf˜ÏçH&“P«Õ˜Ïç(—ËØÙÙZUÀà2*g2™„²3%àBR}LÎû:äãY,èõzèõz¸\.ôû}á¼ÅãqA¢ìv;*• l6^ÆãÅŠ‡ê«_ýêCþæœ<í´Z-ÎÏÏát:1ŸÏá÷ûQ«Õ„Z�‹EÄtÁ`PÐjlòù¼¤NGh3kkkh4èt:0øðÃáÑh4899‘‚÷îÝ»P©TøøãE»£V«¥ÉÈ^…ÕjÅh4’š$ %‡ŒvéÙˆ%¬Ûï÷%¿¦èp: ›Àl6Ã`0ˆ¬a<Kss>ŸÃjµ¢ÕjÉÉ;›Íàñx$=S*•"'!° P(°ººŠÑh„—ñx±â¡zýõ×úý~ôz=á|ñdªV«0™LX]]E«ÕBµZ…V«…Ûí†B¡âu0H…=¥R)_Šâ<´ô€¨V«˜ÏçR0gv»Ý¢!r¹\P(BFP*•’÷×j5øý~Ìf3„Ãa8ù=ô£ Èn<K2ŸÏa6›Ñh4®4c™"‘r´X,‰D„\ËÞÉ«f³“É~¿étZH·z½^ ~�¨T*p¹\¨Õjèt:ƒp8H¥R°X,è÷ûèt:x+ªx<þÐl6c{{‡*•J®n�ƒh4èõzÂIëõzh4ÒùW(ò÷˜†å"ÎcŸ¤Ýnm‡M@æø.—Éd•JjµZÐ,•ŒF#èõzÌf3T*lmmÉ©ùôéS‘@¬¯¯c8~Òqÿ9¥F¯×K_*•Ðëõ`4Eë¤Óé ×ëÑëõ®, VƒÁ�Ç#é‚,¢©Áâ‚S«ÕÈårR‘%Þï÷a41DêO1âññ1*• ^ÆãÅŠ‡êÿðMâÕKo‡ÕÕUi¼QÁÊ^‹V«E.—“æ‰CÉƒÕj…ÅbA§ÓÏçC¡P)û7v»]±ìßF¹þ{½ZÌf3”J¥ðÖ”J%²Ù¬¤1N‰D:ëëë0¨T*(•JÒ±ŸL&"ê;>>–f$õO@@ <›$Æò{) Ôj5)¬—û5ü-Íf&“IôY.—KD‘H:N™L±XÍf“ÉÑh/ãñ‚ÅãÞ½{—¯}—Ë…““Aa …ìv»Øk©T*´Ûm)î‰úý>¬V«@ºZ+++ØÛÛƒÛíÆd2A£ÑÀd2A»Ý†B¡8˜’V“É$Ww±X„R©”^Êd2A(†ËåB¯×Ö‚Ûí†ÙlÆÚÚ²Ù,ž>}ŠÝÝ]ôû}9¹‰ö¸Ýn û4Ká©W©T R©`±Xí¢c›“v»]ôU#º\.Éùçó9r¹\.— i‹EŒnjµ4ô±2™Œ¤u/ãñâÄCI©4O¿‹‹øý~QÕRÇ"”]{î|RGÎÎÎ¤Î×úú:2™Œô/t:œN§¸±ï Ñh`µZ…Œêñx ×ë…5¾œ¿›L&Qâa …B…Bx÷ÝwÑï÷ñÆo`8ŠÌÜjµÂf³ Ê5›Í„¡NvÀh4B«Õ ÓÆÆ:F£,2™ŒÀ0Eêt:¨V«¨×ë¢Çj·Ûh4¢ébQM½S¿ß¿@ °¹×ëÅËx¼xñP}ùË_~8F1ŸÏ¹¡ÄVXÌÉm6†|A³ÙŒz½.×&)þ¥RIòvž<QhpÉÿNžIŸLØ8ŒÅbâK@²œM&îÞ½‹‹‹|øá‡ØÞÞoÁb±“ÉƒÁ�¯×‹D"N§ƒX,›Í&,oƒÁðÉÃø9‰V©T"ÊBeÑ¯P($Ía_&—Ë¡ÝnckkKÄ$åòä§NJVãüü‹ÅBrùÃÃC¸\.Üºuv»V/ãñbÅC9›Íðæ›oÂív#Nãüü6› ÉdRdê¹\6›MPj‚T*•ô/XW*´ÛmÌçs!^ŽF#øý~awët:qE"òåp8ðÁÈ d2™ V«qûöm©¨êõz( ¨ÕjxõÕWqvv†D"!Wú|>—Â”Z¦^¯‡p8Œµµ54›M 1ôÇÐjµ(—ËXYYÁÖÖ–]®¯¯‹‹,šŒF#F£‘ôMØíçŸaaìr¹¤ïC¿?—Ë³ÙŒ³³3hµZ¬‰ˆ’Ìô—ñx±â¡úË¿üË‡J¥årY<õìv;€äµ»»»èv»¨V«˜Íf¢”-‹‚ªÐNù•W^'ØH$«ÕŠÉd‚b±(ð¦ÏçC¹\–œ×jµ"™LÂï÷Ãçóa<#‘HH#”ýö]H�µÛíÈf³§¾ùæ›"_ŸÍf‡ƒˆF£¨ÕjòïhGVVj4RÃ”ËeFÄãqÑ±?Â”Àd2ÁjµŠï^V–g¦Ó)Âá° cN§^¯ù|ÑhëëëÒ,e:CCÍ—ñxqâ¡øÞ÷¾·˜L&èv»øàƒðÙÏ~V])»¦4a>Ÿ‹¥3;í½^O¸Z‘HD®g:Á²7Ã«–¦ü¡PH¤Âñä#|œÍf1qÿþ}±å¢¯{*•‚Á`@«Õ’�G£Qa)”Ëe4 lnn"ŸÏK~ìv»át:]#šf±XÄ*šÀÙ””³·²¹¹‰V«·Û-§ål66ŒÈXg_Šð@ èµLÑhTNýñxŒ^¯‡>ø�o½õ–è¨£Ñ(ñ H‘ñà þ‹âA¸ýWÁLÿÿŒG¿ßób±(ñ Læÿëxý›ìÕ·¿ýí‡ì“¼ùæ›£Ò–‹½�â½Ç“|²ž)ž£¬B£ÑA5H/D«ÕJß†ü/."þýL&Ç�Ðh4H&“X]]…ËåÂÙÙvvv cÁËàP±k·Û‘ÉdÐívåïrÃ( T*8N §‡°¯”ÍfÅÕˆÄXÊ?Hl¥ÄA£Ñˆ Òf³I³—Jòýl6jµš€~¿‡Íf¹\N No¼ñ²Ù,æó¹,n¢z½.µ†^¯íãqvv‹Å“É$ú«ét ¯×‹`0(ñÐét˜Ífp¹\âÞËŠñH¥Rðz½ËËK¬¬¬ÀétþÒxt:˜ÍfIm6Òé4ºÝ.âñ¸X¶¡,—Ëp8².šÍæ¨>—ËawwWå*•JPQV+·3)_Œ='™&šÍæ_9¿êþXŽ‡êßøÆÃ÷Þ{>ŸO‚AÒ#Œ¤–èõz(•JØl6éV¥'ÙÓ•J …âŠáÈh4ÓM…B!A¦¿:¡dÂÏf³¡PH8p888@8Æáá¡ÀÄÕjÁ`BÌ\[[C§ÓSÌF£!t"vÿN'¦Ó)ªÕª°h\IÔl<#Êûv»]Ù8¥RéŠò—RýeOv¥R)¶ÖË˜Ýn°€l¦rï½÷œN§,öˆúý> …ºÝ®¸ùr¡¨ÕjÔëu)¾'“‰¨˜—{m6›@ç<èH®V«"YžPÂþ’Á`@ Ó~}}GGG…B8>>–ú¦ZÂï÷ãàà@œœ–Ð-¸^¯#›Í¢ÑhÈçsQRKF¤R©” ;ÐëõäÖµZ0ÂŽ_ž8c4¡P(¤åá4NåÐ!€A=Z Ðƒÿ'?ù ¼^¯0Iþßö‡Ýn‡F£‘g®øîw¿» `8Š?‚ÙlFVC©T¶3U´¸‘÷Öï÷?!BþÜfŒèt:…^¯(™¾LqÈzæƒ¡ù%¸<H B¡ôvø°Ÿ={&vÉn·[z9Åb~¿ZçççWXÛäóQÚÐëõ„Y@V™&“I\j3™Œøý•ËeaeeE‚±ºº •J…'OžÀl6c6›! £œ‚E I\m4‡ÃÈårƒò]È)äæfäfÏçrÐðp Ÿ<UÃtgb<è¥×ëQV1ö¾~ý:Úí¶˜œúý~1Í¡D¦^¯C§Ó!‰|RÔ«Tr`<þ\|4‡¤ûÙlöñâÏ2™Œ0.ƒÜn·4¬9@‚RòÉÚ'3ƒ^!4Ï©×ëH&“ò=‹B¡Œ<"sŸ·1½¹1xr=ììì \.cssn·[bö¿ÙôFŸ\(ÿøÿ¸` a6›qI§Óòeø&³ÙLaioœÉdpxx(5M!yZåÉÈÓbÙkÐ*OŸÏ‡X,¥R‰ÍÍM¬¬¬HÁIn ¢o¾ù&Þ{ï=”J%)@ÉP(8??G¥RA<Çb±÷¤ÿüÏÿ”Åi4%¥8>>dåðæ�� IDATF±XD"‘Àp8L§ÓÁn·#£R©ˆ ‘"EÖ0¤9œœœ J*I_ˆÓÓS\\\ P(HCöoOêX{PfÂ´œ–ÐÎÚn·Ë" p¹\¢¦çjµ†Ã!=z$ßƒ§;k–Åb!‡á}ƒÁ�«Õ ƒÁ€-Ü¾}[€ŠñxŒÏ|æ3x÷Ýw…ÂÄÙ`\p´ ôŸk©R©ˆEÁ`€Ïça©ÏçC¥RÁéé©@êô5ämÍú”‡:™L+™fsSÑ^�f³™�4t¬¢öíõ×_Çb±LÍì_¶?˜½q¨†J¥‚úæÍ›Èår888üýøøXN”ÕÕUÔëuôz=x<™^H²æ£GÏç%íãb!x±üâ‰Á^þw´cŠÄÑ5£Ñ‰DB†Èííí¡Ýncmm J¥ÿñÿ!ŽÙl7oÞ”SŠSêŒL&“XD³Þ##áøø�PV±··'´ ét ƒÁ€·Þzn·ûûûP*•ƒâ—ÁÏbJC•0g{±Fk6›8;;ÃÓ§Oq~~.llÆþ¢ŸÏ§Ÿÿy6›ÉÍe0ÄÄ4•JáÞ½{²¸9—#}ø;©€æëÅŽŸÇz<‰Èj2™°¹¹ …BÿøÇ²÷÷÷‘J¥p~~.©Ú/{o¾?àƒß¸qCêçt:d2)ö/ZgLÙçóZþsüoü>T\/iÂÇc¬¯¯ãúõë¨ÕjØÛÛû_íl6‹n·+Ö©T ê‹‹”J%‘˜s‚ÅÆÆêõ:ŽŽŽàt:‹ÅM¢¨×ëÉIÌT€@¶Ÿ~x„S ˜°žXN‹(`!Ûn·±¹¹‰\.‡J¥«ÕŠõõuhµZ¤Ói¹®9Åƒ> Bàƒè÷ûH$( p8˜ÏçX__Ç|>—|}:¢R©HzI³¦§¹\NØv»] îÁ` µÇ›ò´^NõÚíö=k†ét*J¸x»saŒàmÃFñd2‚5ÓÙl†7nÀl6ÃårÁétJêÆ¦-oåÅ¹ü=>½Áx{˜L&<þáp×¯_Ù›Élî²”X^ø\ÐË/ÖM•Ôï÷Q,ñÎ;ïˆt„ô)Ú‡ú}Ø¨&Iš¿‰ŸÉõIô‘ ×ðò‹1Îçó¨×ëâñÈÃñÚd™†OHÂÛÛÛùÅÈóûý2?¸Óéˆ…Ñö(è< …°²²ƒÁ�¿ß/hV«•tÌf³auu‡¡P.—K–ÏçÃÖÖ–,\Šô†Ã¡Ð`h …àóùP¯×Õq¹\Rƒ) ¹U)¡gï†ßm±XÀ`0a:òä Æ•ßKð†ô!¯×+4{=Ì@B2»ÉÕ«V«8;;y·Ûk×® Ôn0Ä¨Åh4ÂápÀjµbss7oÞ”´Q¥Raeen·^¯›››rCqÜk%„9Ë™P>'£p1‹ çÏy‚d*p“Ó$Õn·ãÁƒØÜÜ„R©ÄŸÿùŸcwwñx\@Zº¹Ýn‘Õ,è£T†^‰tãu82Îˆ’“?û³?ƒÙl–‚‘Ë¹Ì¬}¨(°ZÒ÷óûý²Îâñ¸LµÛíXYY‘45„Ïær8†Ïç»â@¿ÿÓþ˜L&0™L(‹Ÿ”F+++¨T*RË05a‡œÁ¢ët:•<Øív# ¡V«‰çGÔP¤·ŒL½þúë¸}û¶:‰Qð·¿¿/6ËœæÑï÷Ñl6¥ÓÏšÅ`0 _ñô£¢Õl6£ÝnË÷äìß7nH*Õh4Yâ¨ÕZ†r¹,§û1¼-hriµZÅq—(É¤ï;=yV«UlooË9zgg———Fò¼9.ÕëõâßøÂá0Þ}÷]S(Q¡=öææ&~úÓŸb±Xœ+ÎSÞØØzË`0ˆ¯Å½{÷P.—¡ÕjåæN¥RÂlw»Ýâ)Oòî›o¾‰@ Ë‹‹‡C¬]ËÃá°è´Íçs|üñÇ2³™Y †{÷îÁëõ ÷ñôôF<@¡P@¡P€V«•ÚŽ0;3›Í†o~ó›²ykµ¬V« á¼í“É$¼^¯8qU*$ að |ç;ß×ës!ÚƒÿOûƒé3Ùÿ@à“>™Åb‘“ V«É(š‚ØívádÑÅU£ÑH1ÈùLdp€œB¡ÀÖÖ– twîÜÆ3eÞ‘HDd’ÍÞ„Ñh`a>Ÿ‹Á?ƒ§ÓéÄv«T*ÁívKŠÐh4dáðtÕh48::B·ÛÅÚÚšÜ°årYÆŸòvæÉÄ[nssSÜfkµ´ZÈèù`kµš,¨f³)·2{DÜ<ô0h4(‹(•J’ŽÆb1„Ãa¬¬¬ Âh4bssS€`0(–ÕL·].—ÜRn·[Ð4öé0‹Åäû²¦"û�šÊXVAhý~?~÷w_ûÚ×àñx°¶¶†ÍÍM$“IhµZ±Œ#c¤\.# ÉÁÄvE“”ÖÐçîÝ»ø“?ù¬¯¯£Ýn#‰ yãÆ ifÓÑŠ>ûÝnWD¤lZß»wOØ[[[2mfÙÎ€Ïßn·£Z¢Z"ŸÏËaÊ²€ë—ëvyÔÓ/ÚÌ4¨”™LFNjr˜JqÊ;=û6›MI‡¡Òû½2”…sFQQ>‡Ãb±(‹Âår!‘”ÓWWWáóùp~~.-nN6Yg°ÐfŸƒ½+‚´†&§P(°¶¶†½½=q„eNÎ x<Ñb1 œMÅiív>ŸgggÈd2¢Âå¼*šÎÐœ¥ßïãàà@`a¶h<£Õj%ä ®®® 0ÀC…z*Ë#Ãô.‰ Ñh V«áòò?ýéOÅR› ‰ÍfÃîî.B¡òù<²Ù¬pü‚Á …ªÕªÔ‰ñxz½‡‡‡h·ÛhµZˆF£X,°ÛíâQ*•„¢¤R©„´Ì¾$×]Š···át:ñ…/|ï¿ÿ>Úí¶l`ŸˆD"2X}OöCÃá°¤Ú½^·nÝB6›EµZ…×ë†Ñh„ÙlF,“zh53:W©T ½^ï½?è Â6J¥‚Òçó¡Õj¡ÙlJ·»X,J±~çÎ¡™¤Ói‘4 I™¾â¤Þˆ‚¿gÏžá‡?ü!t:|>"‘ÎÎÎpyy §Ó)SÉ"áµl6›%E`Z7N1›Í Ñh°¹¹)´ö%\.—°¸):œÏçÂøv»Ýxã7 P(ž®V«â‹Á¥ ‡‡‡˜ÏçÈf³"AçxÔ\.'è!OM�¡PHü6šÍ¦Œý)•JB"e}I�‰øÚÚNOO1Éd°½½-N·§§§W†ì1McZH„‹ðu,ƒN§Ãþþ>Þ}÷]èõzƒAiK”ËeY¼¬'‰ÄòPËårxÿý÷ñïÿþïøøãÅ¥‰›o6›I=N»*‘Ûí¶l:²(\.>ÿùÏ‹6KV#•JáîÝ»rYCïúÁ` ŒhF£J¥Rê%ZàÑÀ”`Y@ét———2W› kª§Õ[4•rãWÙ\Ó&“ Êjµz…:ÃüÈÈÑÑ‘)ƒ}-")²Z"N¬LNÓ;wî`4áÑ£GˆD"2ö”¬ ·Ûd2‰n·‹ë×¯Ë&èv»RT/í¡x!›ÍŠÅ™F£Ëåðƒð*A ‹Å"º&ª}Ëå²¤wz½Gxƒô¤5óp8Äd2Ýn¾Ú|>'Y»Ý.3É|1ò[è›±µµ%-¢±t;28<<Äl6Ãµk×¤qúüùsäóyär91eo†VÛ4æ<>>†ÃáÀ½{÷D)×ë±X,pëÖ-Ìf3<þ¡PGÆÖÈév»(‹¸ÿ¾€ z½ûûû8==E"‘ÀÖÖ–¨†‰Øy½^d³YA$U*•|7ŽM"#Ÿ)^V“ÅÌt‹ ^‹Å">ˆ´XF°É¹dÉBÒðññ±x–”J%ŒF#1we[€ÙÑ²·äb±À×¿þu1Q%ô«îÅbñ‰† ´ƒƒI/ªÕª,ŠeêÏµk×dtùxD$Yè25"ÆÔ‡sª666°··‡z½ŽT*“É$H½ØØäUn6›±±±!jž’¬Êå²q4!ÊÈ›££#looË ãt:å»¯T*ù+ „B!¼óÎ;èõzxòä‰Ü²ì›1ãTG»Ý.¬tö &“ r¹"‘ˆL£$=Š‚u af¢•Óéûûûðz½p:²ˆ…‚4ó;vvv$ƒ³ÙGGGr"sü,[-LÍidêñx$ÅÇ( ˜L&ò]x#år9ôû}cwwWZ(³ÙLšÚìv:¡¤ ‡C¡¥•J%¡¦q!2I&“²†ø¾GGGÂŠÅb&žžÊš\~f„ã{½vwwe &AFƒl6{%´Î#-¯ÛíJ“Üëõ¢ßïËgìïïÃf³!ÿÊûCI›b¯×¯×‹b±(ˆ:»Ý.<?~-àìììÊ¤Äå¾=8ñƒïqyy ¿ß/5D"‘À;wý"‹y8Ê÷¡OÅ5 ñJ'½GV£P( R©ÀápàÆ’2,d³YñX'©9™LŠcae²ˆ@y<|üñÇRƒ‘AÁoõt:-§!§‘¥Aš§£x½^a¼,/¦EÁ`ÙlöÊðÆƒ}3KgšIà…éaäX,¿ß/z«`0(3‘ Òé´¸øòE=1Zþë¿þ:NPS¢¹ÙlVN}ÞâËÃÞ)]Ñh4’Êóö…Bp88::)Ë²Cñ£G Õj±»»·Û-ïÃÃœæ5“ÉDjíR©„‹‹iøÛl6ÑÖ‘¢ÑhàõzÇqãÆ D£Q˜L&É8Úí6²Ù,<Ï¯½?ÔL}hÅŽ~.— N·Û».²£»Ý.666$HF£Ož<¹Òä46g9Ac±XàæÍ›¸¸¸nÕ®:NÐ;žvüÌ7nÈcó5ãÁƒ888x•õK,ƒF£A8h>›ÍJ^}qqV+}1¦Š´ Ëd2(•JÐëõØØØ¸âdËÁ¤1 ™dB ¦˜ôF§±èh4’÷åÉ¹Ì¶`‰ †^¯a Ãá±>‹EžM§ÓÁöö¶‘Ëå²ô¹ ûý>Âá°*• ÉdÃáÛÛÛØßß¿’‰Ìçsi½îõz¥ôx<Ðjµxþü¹øÇollàþýû8::’[z4!•JI¯0QåÅb!ó–766$ÍnµZh·Û¸¸¸ÀÊÊŠÔBìi-?3Òôü~¿üVn¬z½ŽZ†@ p%TH“?ËAíÄ)®_¿ŽŸüä'èt:‚püùUö‡’¨?¬X,¢^¯Ãn·KMÃ>;ê„My’ŽÇc4 øýþ+'S4•J%iûZf³Â$“€Œæíä@6 œžžâéÓ§xë·pûöm¨T*œžž"£V«‰"÷•W^A³ÙDV“q<z½Ÿÿüç1›ÍÉd„fU(® ŠßùÎwä¤î÷û¨V«RóÑÒLV‹ÑµT”m×ÆX6ÂYO\\\È©½üÒétp¹\’nT*Ióþ§xP3Å˜ð¶h6›¸¼¼”–»Õj5šÍ¦@üÔÓ-³<(ì\,ØØØOFZQ'“IX,Ü½{W¨UgggWâ1qíÚ5a—,3H^yåL§S$“Iø|>Ìf3œžžJ <…wÊ´³Ë–×ÇèªT*Ù°T…ü²x°>å\l¶¨Ú.‹Bçä›_g(¯]»&(T·ÛE*•’æE~œÈøìÙ3ä…ÃaL§S¤Y°.ÿx¢€¤¹F¼òÊ+¢"V«R¼s$)›™$Åò¤âB'SºÙlÊúÕÕU™Ùí???‡ÇãÁÖÖ†Ã!ö÷÷a6›‘Ïç¥???G:–ÏaŽN§!"¤$¸ 1oá¦%û€Ï`0`ss«««RP/ÅTh,g~-¿ôz½0ê[‰ŽŽŽÏçÿÇxÏ´˜7!¬—ž<y"¾÷f³×®]C¯×C½^—aè|e£Ùe/&“ étZho$FÛív˜L&Äãñ+ñ €43Ö{F¼1œN§hÍ¨d ÂLñ(›Ö¬1—ÓE¦àÍfSnB¶†¶¶¶þ[<¸>©McVÁßS.—ñ³Ÿý«««rÈüºûCI\6³Ù,4ƒÁ ƒ§IybqHõg,Ã`0Àáá¡öø"4:›ÍP.—¥‘Ûjµp||ŒP($Œr ŽŽŽäÇòE6…ÏçÃ¿øEÌf3qFp»ÝøÒ—¾—Ë…ÓÓSlmmassS T¿ßgÏž¡Ñhˆ}—Ñh”[ŒµM¿ßG4•T€c_ ÙÅbR©¥R‰ë×¯õ‡{ggG¨8ü~ÍfSŒEV«ôÏ8_xù`"A 79âè—Åƒ½F yú§R)Ü¸qëëëò½©Xfm™H$¤¶[îv»]ìííÉâÞÛÛ“æ/¥T\d³YŸ–ãqvv†x<.¼}†¬£`0ˆÝÝ]Aü(-—ËÒ 8Â6ÑrºH2Ãƒ”:88€Ïçû¥ñ`MR©¤óx<˜N§(—Ëxíµ×¤ÕÍfíý¡ænãàîP($^r�ppp€7n ‘Hˆ%ø~¿/jÖ¯ýëxþüù•“ÊZ±p´ŒÉdÈxY—N§ås©>]&t’›ÈAãgggðx<(•J"ìõzÂçÛÛÛ“æ$óir"§Ó©Pv–OÃ/}éKWb¹P§Ó©ûÙÏ~†»wïâòò³Ù+++Ò'#•‰í“É$Ú(ŠS3™ŒP3™Ì•MFíÁ–û÷ï£R©È ó_¯»Ý.’Éä•l‚,ŒýèGðx<ø‹¿øéÕí#·ðÓ„[Ž6â¼d¿ß/ršB¡ 4;ZÉ]^^"‹Ó¾µµ5!•ófˆSb8àB¡Pàþýûxüø±¬Çét*¶Ô=òFdí8™LN§¡Õjño}K¼BR©Ô•x°Í6@:ò@4E±X„Ãá€Ïç•D.—ûö‡²Ñh N‹›Q"‘€Ùl†Ãá~Z*•’ü•BÊB¡ ©Ä`0@³ÙÄÚÚÚ•šŒ©âÞÞšÍ&´Z-l6îÜ¹#Ã°s¹œðçó9R©”�ËiË`0¦§&^¿~]]3™�¶··±³³#f/<J¥nÝº%Á©T*H&“òì#ùý~¸ÝnD"Ñy1…¥Ó’Ãá¸ÒßJ¥R¸¸¸Àl6C6›E"‘º-)Pìélll •J]©S˜F‘¼¼¼ÄÉÉ ¬Vërô/ŠG>Ÿ—›gù”§D4g§½½=iÎZV\»vM”Á”øj·ÛrÐÄb1Ü¸q?úÑL&‘ÉdÍfà¢ü…sÃ¼^/Ö××±¹¹yÅ.€ƒ:TAd³Y¬a±X`ggG¦g’^W¯×‘ÏçÅ‡9]d©P($Åfl–E»dïS!°··‡½½=”Ëe<þ\ìÜšÍ&NOOQ¯×ãý¡ÜÜÜŸÃá@¡PÀl6ÊÊîî.Âá0¢Ñ(|>Ÿì~Ne¤áH0¼rR-l�ŠÅ"~ðƒ�� …ÖÖÖ°±±[·na8âñãÇBy:99¹lææwîÜ‘<š ßJ¥‚íímapVç÷j4q)â€ºR©„½½=¡ÉÐ×òw¦[„çé£Á‘«ì©ñ&[„MoƒÁ |Èv» §Ó‰ÕÕU™ˆrëÖ-Pn·Û%•á3³ÙlÐëõ°X,²ˆS©šÍ&nÝºu%½^©T *• '''âu²|[î¿wïúý>¶¶¶J¥ðOÿôOÒzˆÅbâ¸¼x™>F"Ôëu|÷»ßß”@ €V«%ÈaµZE*•ºYùOŸ>[®ZÐÆâèèü±ÔÕl•ôz=É.ØD_Feys/$œNãóù`0P*•¤ Â‚?Æññ1Êå²XÂ9N„B!ißüßØj·Û×_{{{úàE"™ÙDp•J%ƒØí¾ÿ¾8ú,çôlÔíììÈ¿?==•Ñ£„QYèÿä'?Áññ1.//¯œÄìU)•JüÝßýòù<ÎÏÏ‹ÅP©Tpyy)€›ÉdÂ;w°²²"Sz`áÁ˜\´ßû½ßC$A ÀóçÏ±½½-`�9…$ƒîíí!àââ6›Mê¾Yõ4éaÀ—O`Jb–{‹FÈ*• _ýêW…º½½-ua4òßÿ}œŸŸ_I³ }þóŸÇ‡~ˆ¯|å+¸ÿ>šÍ&ÎÏÏqqq!VjD&—ãÇ™eôÅ BúéÓ§"¥aëv»1ðäÉ¹¡™MðöàáI ˆ[8±ÎÎÎ„¾¦ÑhP,±µµ%ƒû–y¦Ô+N§Sá·~ë·¤n&!¹×ëÁl6‹•µoäd’ƒ‰DDÇ¹Ï¿éþPw»]iÄºÝnÒ‡¦4©TJè>jµét»»»P*•ø×ýWÄb11ç_²V«ÅÏ~ö3˜Íf|éK__‡G ª¨ÑhÄ3ƒ|<Âf³‰ì# R‹ÅËåpvv&ý*ÇƒD"!'e¡P> y”œ#Ì[ŒßÓjµ"`0àüü\¬"‘r¹œÔ”‰D¯½öšÈ83™t*ÒÌh°É†&‰ÆVKÒ ³ÙŒL&s%Å&ÐB/‘z½‹Å›Í†Á` NOÉdRdô“Éûûû{óE6y¿ßÇéé)þê¯þ Íf?þñÑívñöÛo³ÿôôÍfó jÇø)\__Çåå%NOO¥õÀZ•‡èòMÅ ÄZo™AÁf0oŽ|>Ç›Í†>úf³Yüé¹c±˜¸Z-?3Ê³¸ñ˜:Ïf3µD‹À[:F*•’¿±³³#Þ’ìÙrâo²?Ô¼n)<Fb–ÂJ¹\¾b&ât:áñxÐl6Q*•àñxÄpeùE§ZjÁÈí+ H$RR¯³|:q�Á²/‰`G~P·ÛÅÊÊŠèšhj³Œn>yòN§7oÞÄþþ>åÁÑ:Œ‹+"NÃëõ Á€òÄ‡0Âh¿~ýºlb2U8�µ�Ó\ZËQ.Do“å]¤X–Ëe‘Y(•J XVqâB …(šÚXVT«U$“I|å+_AµZÅÿù?ÿGäz’y¿Ìø àb±Xpxx((){ˆtcìI[¶àÿ2]d å÷û¯ØK0ýe”ýÍjµ*©éåå¥Ô¬Ë/Nz¹¼¼Äõë×ÅA*•J¡ÓéÈ÷#Ð’ÏçeÓ³¥aµZáp8„0@äù7Ýj$›ÍJqIò-eÞ”·sÇSR>±²²‚••$‰+ÖøbÎ¾ººŠv»ÓÓS‘•ÐzëÓþjµ@@ÆýÜ¿ßùÎwP.—åôyüø1>ûÙÏ »áÚµk8??½k'ª¶Éãã ÄáñxwïÞ•ïÁô‹°ð²)ŠÕjåu½^Çúúº¤|TýR:Ab)Õœöa·Û%0¿ÈÛƒñX[[ …†§¼9éVVñôéS\y—Ë…`0ˆ@ �»ÝŽoûÛèõz(‹899Íf³Î„ŽÇãW6g#¯¬¬È;NñÆo X,Šø•Eÿl6C0D§ÓÁx<– Búo%n`ZPºÂM¿³³ƒçÏŸw’¾õl{,›:-³dˆŽF#ñ!mkÙ_d9=çaÎÍÍõÛï÷áóùpyyùï5{1šÍü´R©\Ü±xäè‹‹i–ËeL—<Ù™LF¨E<¥>ý°X§Äb1!y¾óÎ;¸}û6NOOát:ñ¹Ï}ßûÞ÷D¨HnQ3*«kµÅZŽ~¹\–¡ÝL©t:¶··Å²ž„î9a„¹ør:DfÁêêªØYºg;ƒü¾ÍÍMQ~ói? ópÔì`0€R©ÄÉÉ‰¸óv»]ôû}I{i…Àöh4 Fƒ?ú£?ú„C§Vãý÷ßG©T” [ö.)ñàT(àt:qíÚ5ìîî dÿýï¸}û6Þ{ï=ñwd£ž�“Åb}ëoúxF#¡N§›Í&Ýjµ*h%‘ÜN§#³Ÿ—7OF™Z³œš.±Ù®àå÷žL&xe³Y„B!üßØjœÐv$AVÃêê*†Ã¡xA«vtt$b>½^/1AŒåS‚Å?5I\MÂ0sýe^£ÑˆP(„·ß~÷îÝ“¹¾¾ŽT*…üàB²e h7@û3×¯½öæó9úý¾<øåF&9pkkkÂE¬T*’JFÜ½{™LÅbñŠ-¹ÍfC<Ý×ññ±˜ö0˜Ïç(‹ÂvÉçóðù|¢îV«Õøàƒ®Ô*¬ÉÈ“T«Õxòä‰h 8M’òšå°X,†x<“É„/~ñ‹Â`/‹Ò¬w»Ý°Ùl¸¸¸Ù¾×ëýoé"Ä …þöoÿNGê§B¡€Ñh„?þã?Æp8”´Z¯×KíI¿G:Ÿ!—ËáââápXâV«…·ÞzƒÁ�[[[Øßß—øòwa“<þüJª¨P(„äëõzqrr‚h4ŠN§s%í£ºšœUÖ~ñx\tuõz]ÔÝÝnWÔ¿îþP–äµ9Ç¥'A×Ør¹•J%j\.NûX6ž\þñÅb¯¾ú*Âá0nß¯–&�� IDAT¾étŠGÉàÿøÇ¢\žL&XYYÁüÁ ªöê«¯JšDuíêêªþ·Z-!»ŽF#lmm! a6›!™L"ŸÏÃjµ"•J]éq@^,“áuÝJÙ>{läÑQ¤JR±XÄÙÙ™Ácó™T 6j9c+•JI¾NÁà§)Bd}8Q“yÀCŒMf…B! nzgºÝn¼ýöÛðx<‡Ãè÷û¢1£â—Œ‹Å‚D"¯×+úåC’é¢×ëÆÌo¼@ |M4ívétZ4bOÞ¸q{{{x÷Ýw‘L&…3Øï÷EþÔét`2™DûÅþ']†Ãa,©å?Í]díùúë¯ãÁƒ’5ðÙQû×ívQ.—Q«Õppp ZC¶Š�àääDÌ}˜ùüÚûƒ„à™¿rî/;õ$„r’ ÙçdqP†¾|º¢5™LBÁùÆ7¾ ŸÏãââ·oßÆÑÑ "‘¶¶¶ðÏÿüÏbÖòÚk¯áììÉdRš€‘HOŸ>ŠõW+++÷’Çæõz¥®zòäÉ£ <)Ž,•J8??¿"6eÚÈ›ƒ·>ÿ™ô7ÞxCÜ±Xøó&bnyJ ½E–©cË2ÊDŽežý<È¤™N§R¤ƒA1+b¯‹Òétâðð———0›Í¢Ã#âóùD·|H’SÈÚëöíÛøìg?‹b±ˆóós‰G4•1K¸>þp:’BôÑGâ§È>×l6ÃG}‹Å‚ñx,uk\Þ<�€çÏŸË�ùet‘1& u43(–&óù\�²ápˆÍÍM”ËeÜºuKRQ¦³üÿ¿éþP“Ä»ì=žH$®8Q&Ïi‚$¶Ò#‘éÚòDæ»„¾™k3ƒ¢Cóx<ÂõbÁúà‡?ü¡äõù|ÿò/ÿ"´£ƒƒ8Ü½{ÑhT S‚cqNOO¯˜x²QKGZš�‘rEq&óxJ)8„·¬Á`q=Ëu&å0³Ùn·[Ná½½=iz//’åúb™Áð7ó7ØßßÇ÷¿ÿ}looËˆ£¯|å+âFT“uH0D2™„Á`@¡P2‰HàÉ°§X–àÍ2]‰Äh4Â;wññÇ‹MœÉdÂÉÉ ?~,-Š>úN§×¯_—»V«I¯Œ5æT*u…©â÷û1ŸÏRO$â±ÉóòM6¥eÃì€1ãÉxUòøñcÇ8¤ƒSs‚Á ŽŽŽ’ÿMö‡šì�úƒh·Û˜L&²H:r¹œ°)R©”(K}>Ÿ°+–ƒ¤×ë…SF X,ŠE×l6“éö‰D+++ÂuËår²èÊûþûï¨ÛíâöíÛ0™Lâ7o±Xp~~.'R>ŸG"‘@6›½Ro®3„ŠåóùP«ÕD`j·ÛÑn·áv»¥%@_½Z§Ó)è%½þ írr ‘/§Ó)DgÒ(åù4]©Tpýúué÷üõ_ÿµÊS(ˆF£b�JD.•JIKçä‹‹¤Óilllu*“ÉHL ÖÐ\v¦ÔŸñ(•JR§ñ;>~üf³ÛÛÛèt:ØÝÝ•xð÷x<KÂ~&“ nÜ¸!Ên >ŸétZ@,ö5].ž>}z…ô@^+¹L º]^^Ân·‹·?g5°ßåt:dy°X,‡¥¶üMö‡: ›Í »¡X,â3Ÿù’É¤äç×®]çY^rpª_t“qÁìîîÂd2É¬^zø-ç¯øMÊÔb±@:F(’ÓÔl6ceeEÐ¦eÿs !«Õªè÷ûˆÅb8??G2™£¦n@@,íŒF£¤UG<™rµZOF“þºÏç^ÐÎí·û·ú5™L’š’˜|~~•J¯×+sÃ¨À^®ùÌ•J%ño}K¸xjµ¯¼ò ’É¤¬é‡á÷û…ÅÂÙ\´WcÚÅÑ¬¼)³Ù¬X#}Ú®›Ï–õ7u‡œ³LíÓjº(—J%!7Óä‡™¤^~'Xä4Òº`_HF£<ßgÏžý7ôÖÖæó¹hÜÖ××Eâ¤×ëq~~~åséµ‡¥ÇÈç•J¥„:F£_w¨¹k94W -½®]»&·MµZÅÚÚ¢Ñ(2™ŒðÀ8³‰Þ{|Ñä…óÏø y’ü?íYSÛé™öobÐŠ$$@ƒñ†ín·S§&NW¥jªf¦æd²U–“|¾A*‡ù"ÉA*©¤;®ôô¤Ûv³X€¬]BBBìzÞù]%œdÞtú=¢ðQ¯¶Ðóÿ?ÏýÜ÷uý.jbæ?´¬‡ÍÏÏ["‘°_ýêW¶¼¼lóóóHrÒ<xð@ €ÁÁA‹ÅblkkK´\š½Jˆ±±1‹Åböo}KyX»»»¶°° ²/âÙýý}å#ã,Îd2öÁØññ±Ý¿_T&8¨âý~¿åóyËårj2°yP¢y<žKÚÅ^ÈL2™´þç¶T*¥—vyyÙö÷÷e'c{{ûRWN!Z¾N§cårÙÆÇÇÙl*‡ÍëõÚþþ¾ÊžÞ2ÕÄÄ„»¨)( ¶··g•JÅ>|hfvi=ü~¿Æð;Øx|>ŸÆ‘HDšÑ££#Ù˜ü®á¤zÓ´‰¨wyyYœM QlÅPÝ‡B!EI=}úT´+”úT _õýpüøÇ?^Íçó—r¶À¯Ÿ<??××ívkž€‘¯7¥cssÓ*•ŠJ2x˜ á!|þùç¢,Q§»\.«ÕjÖl6UrÀÊp:ªÉ)Ý8(8qÀ,sÇZ__×‹×××g·nÝ²`0hï¾û®vjÜ™¸OÂ…ðûý …¬ÝnÛöö¶Œ§§§§F5˜¦arpp`ýýýV©T”2sttd@@PVRlP´›™¹ÝnÍq€-..ZVS‰IJåÚÚš,xï^¡½£Ôååð ŒˆÐF2“OOO5®à¡t:å,//ë4±íím9Ä‡‡‡¥Æè]F£a‘HÄÜn·½zõÊŠÅ¢N´ÑÑQ[ZZ²ÙÙYëv»öèÑ#U3ÀOéðöÎ³Ùì%i!8ñŸ<ybûûûânð{öFæ’A‹ÅBÂ’D4²¾¯ú~ô_\\X<·ÙÙYÕ«Ü›@I…g€Œ§¿¿_œ‡^ûwïNÈŒÈšƒƒûÓŸþd‡CZD`ÂäöîîîÊ¸GˆD±XÔŽLøƒYvræ=^¯W°IÊ( 0?üá¥tçGý€DlooÏ²Ù¬ºž###š¯pŸ ”Â¶3m_Î\.§MpM/û‚FÐìì¬år9^ÙØH¨ šÍ¦Õj5«Õj—8‘è9�2j4’sŠ}ùò¥9ŽK0˜Þî"ëN×–¦D>Ÿ×fãv»56ù[ëö ·ÒÙÜÜ´f³iËËËš±ñÒÐlà3ãà&ƒ¬÷Nî±®y4àÝ ü¢Ú€Â¨àððPò1bj¿êûÑŸN§eÁ =…¥!‡mnnN"–mNZÊLÝ{ÂÞ›¦Ói5.€bÞ¾}ÛÂá°:@xŒFFFlmmÍJ¥’ýö·¿ÕÎ�ŠŒ¡",F”„HàSë»\.k·Û–H$. ¢{[¶˜ý¸Çäóy+•Jvrrb›››2B &L{ ‰DdˆÅÊ–ú¿·TäÄ!–•õ@ÝM) …*×ëb%ˆ¦Ä¬n||ÜÆÇÇÑh¨s:22¢î"âçÅÅE•÷üB5??oñxÜ&''í£>²õõuÛØØ\hppÐjµšÖƒ\jÖƒTP^ÜÞ¸Ñï~÷;EYMMM™×ë•A—áX¼Þ_N§Sw9þ=(žÃ`0hù|^ Öƒ,ìb±x Ýpvvfÿ?ÞvÞW¯^i—&Êív[,ÓîóùÔaCPÊüÀétÊÌØûƒ³±¸$h”J%í(N§S`Ô±±1iÔÎÎÎ,ÛÙÙ™•J%ÕÄ”Ä™Ò‰k·ÛºÄ·Z-5$(_Ù#‘ˆÍÎÎ §Ì†ZÃívkþ·¿¿oápØÖ××ÍétÚ½{÷dÎ„`Ûn·•2I3ÀëõÚÔÔ”(K Šò"râ¿ùkssSJ·Ûmù|ÞÂá° ÿ¯õàI&“"CE"1JºÝ®0ÝtÏÞtÓlBAö6/{¡P°ééi½œ¨aÊå²Ý½{×Tbñàõ6Å°ñ‡B! ™Ýn·†Ê”áÌ¹`N}Ó´‰^pppÐ^¾|)[ ùx<n333 áâHrHÀ8_õýèïïï—@@ YÍVKlXt°ë;<<ÔîòòåË¿xX&''mhhHísvev@†®ápØ?~,Åˆ1î´„ñ¥Ói¡¡ÿéŸþI{\×\º\.»}û¶}ó›ß´¡¡!H0÷¢K @åùóçbRæb~zzj{{{*ƒr¹œLƒÇÇÇJ¼ä¡$âçÁVÿ¦zž]¸ZÚÄÄ„ÍÍÍé.ð÷®ÇÇ¬c,“¼ŒÓ”;ÃùÞSŸr”Mà†ááa‹Åb2òàÎÍÍÙ³gÏd½g=p·³¡pÄãñK¹jµZMsSFœâ7¾Ù`ã;ÝÝÝµÓÓSe¤™™e2)YH”‹S`hhÈ\.—šEÄ1OüªïG?“{†”<ÐešäºO”s@@¾)‡ÃaÕjÕ)ôfpœÇã‘6è ZB.Ë�O�™ðÅ°ÃÌÌÌØÈÈˆíììÈ"€e<×ƒH„k¯}†¹cËËË²ÚPd2 YªÎÍÍ©Y188h>ŸÏ€Œ§œLVËb±˜† ëëëò°Q~ÑÎ³{÷îi¦Ó{z0T><<´Ç›Óé´z½.Ç.˜7×N"<6‚½½==Hx¹Ó°› =½•Èéé©mllèŸ3À¦Œs8šsmmmÙáá¡Pñx\0ÑÞö=Ï†ËåX––;Š÷óósÉ´z×˜RïÝŸ± ˜AHb„òðÛÙÙ•Šþ�³Z·Ûm+++šâOû*ïëÑ?;;k[[[æt:-‹i·Åb–L&ÕR/•JÂjÑí"ûÉ›6Ôì´¾IsAèÙè§ƒ599i‘HDÌ<”Á`Pª"l+•ŠvlÇc[[[Öh44: áÁé477§ShrrR¾ RVÚí¶Íü·”P(Í™ót»] {ùË_ênùÙgŸY©T2§Ó©Ÿóüü\.m.Ï½s20i³³³’nÍÎÎÚææ¦Z__Ÿ•J%ÜÉnÇk‡ª‚4¸NG%Z$Ñ¬¨P(\’+áóûýò3óÊår–L&5ô†çQ©T$4ðûý’U“ë½N0òƒjß‡B!¡¿éNCñe{Sô@W‘n/–\Ð¥RIÅ/^È×È½½ÛíJÈ€§ŒÍý}?z×£Œ6í`EÍfÓnÜ¸!hãÍ›7Íív[6›µl6k>ŸOe.dù½¿Pà£‚ïÇ ;;ÆÉ`0h>ŸÏ\.—°c”(wîÜ1§Ói}ô‘vóããc[XX°n·k¯^½RÐ@žÞÝÎívÛüÇ˜Ëå²7nX©TÚ›M³Ù¼Ôbž7>>n¯_¿V{†óš½½=™)£Ñ¨²¡d}öÙg2.,,Øøø¸ýñ@³·YD÷æ·Ûµl6k¡PH;øÂÂ‚<^(8z!±”2Ìuô]Äz´Z-k·Ûz1z…·l€”î¬›êÒÒ’œœX:õybbBÐÙ-Å`õ"ØØŒ¹#“F‰ˆ’‚çn?X+½¿xø!G§R)K¥RRœüùÏÖ‰åv»UØòò²MMMÙŸÿügUŒ6þÑ÷£w=`ÞÑmÁÔH4vì"½š°z½n.—Ë’É¤µZ-K$2U²H~¿_¥b/Ñ‚R__ŸE£QQ_Ab³Œ©u\.—ÛíÊbÂÃ‰ÑëõZ2™´t:métúñ Õîî®•ËeµéÏÏÏ-JÝl6e’d8‹öääD TÒAã€¾µµeÃÃÃ²ƒ`‘Á$é÷û-›ÍÚÎÎŽ -Jï%ž».É0X*âñ¸fZ”J¼d5ûý~Ù<<år9´7n\Šx¢B@Ñ+=ë·Õj–H$¬¿¿ß²Ù¬:y¢T¥R)óûýq€:Ïd2J²U÷š\�o8âÂòupp qL.—»ôÑ½½yó¦¼w¬ ê½zUÌ”gggòmË8 ^¯k~÷eß7×c ‹ÙgŸ}f‡‡‡ …ìáÃ‡–H$„Ñ¢”á®@Ë·ëþðÍ¯zUÔô}}}Òye³Y8¢ÉÛš˜˜PûøèèÈîÝ»g©TÊŠÅ¢MOO[¹\V§,r>Ÿ7§Ó©Å£>N¥R—fO”–¥RIò™?üPô½{÷TwS.î€l«× “H$¤�yÓ6ƒÄgjjÊ666Ô ‡ÃÒ f³Y{ñâÅ_@:qjg2±™™s»ÝöâÅu7éàú|>ƒ¢bqÇèÈ]T@/½¦jú—/_Z©TºtcýèÇãqk4–ËåÔÐˆF£RÏ3·Tî6á|kkk²!õ~_$UÆb1Ù_¶··"„Âápˆ¸½½-Fïïåt:X,*•'›Í^zIãñ¸}ñÅ*Açææ”8va||\ž³¥¥%k·Ûö¼D{±Ž[·n ÙÂÂ‚ŒŒX¥R±ÝÝ]Ío˜}y<ÛÜÜ”>+•JY©T²µµ5ÛØØ¸ôÀÑ!óx<²i�ËÅÀ–/w †€Ì0Pàƒ¢ì!yü,Œt:ý‹‰D´Ðh4”Cˆ!wF~Næ]ü.—ËööölßþøÇ?Z2™¼T®€#ácxxXFIû ÏÏÏíùóçöêÕ«¿Øgx<¥—¼xñÂ^¼x¡qï™™+‹¢ë ²p8¬!.ÆS,ŒHI¥RöñÇÿ5¥\ 0Çcù|^ó*Æ+4@òù¼Z„³Ù¬ýéOÒÙ+kC|Ôu$ºZJqr0—ËÙÚÚÚ%W;ê:z|xÈèXEËŸ '�êþª¯V«e;;;öeÞÔ=ù|^ë1@§fvvVü§OŸênïýøøØâñ¸°}}}¶¾¾.–n·k£££Z|èTGGGJ$ ‡ÃÖjµleeEI“ÐiA—J%›žž‘™æHßñxÜ^¼xa_ûÚ×¤ ¨ÕjæñxtBòbÞºuëR¶u¹\ž€Y »'‚h4*åÿþþ¾Œxœ¨4`’`ù¨V«mggG³¼MÌjh¢°À‡Ã¦¦¦ÌãñØ“'OdÏùÏÿüOûä“OÅåeeE6Ô6©TÊB¡6‰b±x oÆÅû9ÖR¿àS‹F£ìîîÚ[o½¥Nr¿-//[4MÌ^¹\VìÒÙÙ™MLLˆ‡áñxô¼„Ãaóz½699©—ŒT¡L&c·oß–¢(•J]8ÓÈà4"ó€ö‡jäCC…® b‚l6+d›†ÌT*¥´Ò/ó~°™òYR©”9~úÓŸ®NLLØÇl‡CmmŽÞ`0(é’'¾¨jµª{§–ÇãQª&;<÷““Eðt»]«V«¶°° ™öjèÑÑQiÿ0-F"‘K0ö/..ì·Þ²b±(‰N,³±±1]èévñ°‚ï^\\T›øõë×xCf£9@®ðÔÔ”Pe$¢„B!)_¿~&w„Ÿüä'Ößßo‰DBJ<aÇîÜ¹cÑhÔ~ûÛßZ¿½ýöÛÖn·õ²¬¬¬(zŠÝ–}ã„Zfƒƒƒò¡AÎ¢•ÍŠ‘ Þ-¿ß¯õdÈÊð4ú×¾ö5Ëçóöøñc›žžVç´R©ˆÜ8Ám<·ññqÍ(q;ÐçDàž)znnNG*#6z·Û4¿ßo…BAÝãZfËËË¶¼¼lÕjUód3 i˜Œ•Tâ ·ïûÙÔëõjß÷‹_ü¢ûêÕ+»ÿ¾u»]kµZVVUbÌÎÎÚúúºÛÝ»w5/•JJ©CM×®X,*Éáp¨)À„ppP`¯ýëÒ3öÆÿð×Ìe¸§ôv´îÝ»gwïÞµv»m›››–Ëå,‰È,Ç‰Gâˆßïƒ5—Zfëëë©p÷b¿:Î%ËG»Ý–ŽŽïÎëõÚÌÌŒD»Ç5 {çw¬ÑhèÎ‚ú¡ôÛo¿mëëë¶½½mo¿ý¶”(Ü³ÆÆÆleeEiš·oßÖ:0€…q˜ÉdÄ§„hËX¥ Í’ÃÃÃöðáCÝÃ8e9‰è*âñŠÅböèÑ#{ùò¥ýæ7¿I·V«Ùöö¶º4ËEPix½^1&Ýn·>³×ëµÁÁA•t{{{:Aéüö–ß$µ’˜‰î±V«™×ëµÅÅEÑ¾FGGíóÏ?·\.gvxx(|Ò¾³³3¶••{ùò¥}™÷ƒÆ§ùÅÅ…9nß¾½Úét4`ˆFc‚Á%ìz�˜$\°3¼õÖ[v÷î]»¸¸°¥¥%»sçŽår9ã8]ŽŽŽlkkË<<:årYÁ {{{ÇÕ¤”›™™Ñ<effÆB¡ÍÌÌÈ‡Öl6í½÷ÞSp¡qC¡U*‚‘.±‹Ó@€›Á)€„Š’êæÍ›633#.ÉÓ§O5lµùùyûôÓOmhhÈæææÔBôè‘À3FÃfgg¥Ø²ýèG–N§bqûöm úyH›Í¦J¬ññqËd2V(´V(1ŠÅ¢E£QÍœ‚Á …Ãa{ýúµ0kóûNOOÛ£Gtr3to6›¶²²"û eMI¹‰|jµZöôéSEüžœœØÃ‡ÕjÙÌÌŒ$lÌM‘.õŠðý£ñz½ºÌÏÏÛðð°-//[0”!ôÑ£Gê�¢bÇ·»»kóóó: È,çE=::²÷ßß666twþ2ïŽ{ÖÃñôéÓÕgÏžIÝ€°ÐMµZÕ?CU©TÄ$8›»Ëå²ùùy«×ëR-³+˜6::ªÿŸÎ$w˜€t˜ñp"Ü¸qÃnÝº¥€üM@@'^¯)[½^O¤V«©3È)·±±!æßÙÙ™¼QívÛ²Ù¬E£Q×—ÌŒn2™´n·« n2¹Z–½xñBA05z-Bæñxl{{[w¨o|ãj#3ÔäÏK§ÓV«Õ¬T*iÀÎz èe‰¸\.‹Çãš…Ñ-…nŒõ( É€Êc§Ó±h4* Ûµµ5iA™‡Öj5iTQªà)„\¯×íõë×Z"— K%“IQ‚ |À·—Ïçm~~^ee&“Ñà;Z&“±-©/À‡CŸB"Ç‚a8ìDL£¹\Nø…/ó~ôÚi$ÖøÙÏ~Ö…qçóù¤ßZ\\”w D±×ëUn–ÏçSÍÉ»A©TR#„Z¹\¶¥¥%Ûßß×‡K6z?ðqp4àÁSRÙ*‹–Éd¤Š@kÈ]ä“O>‘WŒÏ…ä†Ùð>; Õ‹‹‹Åbr.OOOÛÑÑ‘”åøˆ°%ìÓéØþþ¾ƒA‘ª@•ÑU}çwìââÂö÷÷u!¥“ÙÐää¤ÿ½ÙØKKKò5‘ái¿„-îR4~þÚzT*»yó¦5›MJyáäÞ»œô˜Ri&0s8š}"Øm·Ûöé§ŸÚ»ï¾«{Ûÿ¶˜1‘â@/•Jò÷Ä|Á8 ™m=¸~0°>>>¶Ç[7==mÝn÷¯®Ç?ò~ô®‡ãÉ“'«üM¹\¶ÃÃCåf¡ºFÝqtt¤K"`âRÛí¶ìú¹\Îîß¿¯Ë*ô&äÿP‘Úí¶0Ù^¯W¤')e1ÀÕëuI”B¡Bé¡¨xöì™ [6›•âbppP‹†M¦7ëøø¸% Qˆé^ÑiŠF£¶»»kív[§®Ïç“‰!,I0Ø<’É¤Åãqóù|öêÕ+»uë–.ô€e(ÅQƒ€³kµZÇ…F@Q©T„sèS`LÌçóöàÁƒK˜pdeÃÃÃ²Ö åãžŠ•a:P$²˜Q¹ ¤§‰‚5É³gÏlddäïZéàÜn·Ö·2°ßïWb£‰¿µccc6::*$Öë×¯õŒommÙòòò% ª/û~ô®‡ã?øÁêÚÚšáæççÕ™ …B²œ÷Ö˜øjðQkÎ:==µX,¦öf«ÕÒ‹‚ÎÃâ^·0¡z¢¸tú|>Í>°VÐ%üàƒÔCkÈðüZ¥R•ùRµZU{˜[NeþÝÄÄ„J .Û|”a4isÊY4UøßÍ›7mmmÍ¦§§m}}Ý|>ŸTù‘HÄÖÖÖTÎýõh4Ò>b¶d=è�³Œ-€ïÐðøßÖƒv>.3Ì^êoïz ¥ùÓív¿òz€`„SçW]z‹‹‹¶¾¾®õðûýj¸°_öýè]Çw¿ûÝUÂ‰maaAG4júJ¥b‡‡‡ †cŽˆÙ5/AÖ¨“3™ŒMMM©•ÇÍårÙÚÚšëÈ200 »\¿$Wù|Þ"‘ˆ2±ˆ2=99‘à“ ¯¤%üD½ßÕ8ÀÞ�øââB-|JšL&cwîÜ±óós5-@°£Á„÷x<¶¼¼lµZMß•Ëå²Ï?ÿ\vy†Ù×ëquÖÃ199¹ŠQìàà ÂÀ}>ŸôrÝn×~ýë_K~Ã.¨™Æ��ÕIDATÐÍëõŠîK‡…úždLZ»dôâqBõžN§U6ré$B”Å¤nO¥R:žéƒAk6› xcøMH]<Ø‚½¡ñØ€s2sAÉ.ˆyx×jµªpAÔÌ©PŒ¦ Úš…R©d»»»æp8ìÙ³g¶¶¶¦Ü³ëõ¸:ëáøÆ7¾±zpp`7oÞà‘#–äp^VKR§ÅÅEé™± Qr¹\R«ß¸qÃ¼^¯Ž\”äyÑ=±‰‰ ‰‚Ùˆ‚©NšQ¿ÝºuK^ µµ5 A³Ù¬þß™™]¦=æ^½æ>\ÙápXêï³³3•’�K{ñ¸[Âqìt:–ËålqqÑnÞ¼i}ô‘Ô/[[[º˜'“I«T*6;;k>ŸÏ>ùäá®×ãj‡ã»ßýîj/”|0´ééiùØ ;ŽÍÏÏ[__ŸKõ^™>Lò´¦¢¦ÀÆÿ‰‹ÿáá¡¾,À$0ïP6›M)E- ’f%“I«Õj‰Dìøøø’¶òòñ›¹ÃÔøÐ`ý~¿2€{Cé€_â$@–lggGƒÐjµjñxÜ&&&ì¿þë¿ìèèÈâñ¸4tç°Á\¯ÇÕYÇw¾óUZäänÁt§LÀJ¢ÑhX©T’‚–<mãh4ª!2Ð˜óós &i§riDŠ‹È&3‡D"a“““Â~¡_Ößß/µb…BÁ<…B!ÛÚÚÒ°›’ÈétZ8 ˜ø%,9\ŽQîw:YHÐjRæÐCU±´´$ÅVˆããc»sçŽõõõY*•(ÆëõZµZ•ŸÌçó)âz=®Îz8Þ}÷ÝU—Ë%\P”+—ËV«Õ,šÇã±ýý}¹>‘¢ Èår Å]«ÕäÇ¡³„ÝÝ¶CZˆºLóù¼ÍÍÍÙÌÌŒJ$[•JÅ¶··íÆâ‚`íGØº³³£ðt´et¥ÊY8V}Ïð¼ÓéHUÍ”ŸîW4µv»NXî±±1ÛÞÞÖ]¤¿¿ßÆÇÇíððPˆ¸¡¡!\àgU‡-åz=®Îz8ž>}ºê÷ûUcÖëuiÜ˜O9NÛØØ°ƒƒ!Ô˜“¸Ýn)’<x`FC–ˆ@ ù†Ëå’æëõë×*(-H(Ä‰«š�6¬”5H”�s†B!]Jiõv:óz½!@/"— &$—j4ˆqKïííY(Òî>00 {@¯8õôôT¿7_2–J5Ç£Yäb†»ããã ’»^«³Žÿ÷_×ë’ÓRÙË4$g7‹©Ì˜žž¶Ï>ûÌFFF,HlI}Mö1ÆGšÔøÁ`PÙYÌ'P5cã€¥xrr"z®Ûí–¤ˆ�.£¨¨÷öö,‹ÉÍŠÀJ1Ÿ› j‡b±hÙlÖÊå²ÍÍÍÉ²¿ýd±X‚®¤,Z×£££æt:¥&èÍQÛÃr¼^«³Žý×]å>??×Àb¤ÓiÙB�…P·Ã«p»Ý644d…BÁFGGíààÀb±˜h=gggŠ6eC;4^¢HŠÎð™ …‚Õëu›™™‘L†¬âF£aÇÇÇFE=Bƒ·´´¤äÏD"!f<DXìÌƒ …‚:j8²…‚% ‡Ã:0)`Ž‰ÈÎÔÔ”¢w°Ë0Ó¡TøBiv½Wk=÷ïß_%k‹mKÄ¿ÀO‚Á D®|ÙÁ`P0.ÁhQ#3/AÀÔVØmÒY„ÁFÊƒð –lß€RQòJµOŒ(XõtÞH*¶ƒƒËd2—¢…`Œt:u§¶¶¶Œa‘^% ;99‘=õh5PoårYpQ²ÉdÒ®×ãj‡ãÛßþö*_äôô´Š_|ñ…ƒAAbp53Ü#§ !m§Ó±¹¹9e"ïììHŽƒ¥‚9G4pS"f¨¯wwwåµj·ÛšÙ@xeGÆÙn·•Ë¼¶¶fff³³³ªÃ‹òåc3aÇìv»—òœ>æóyµ—Q>…O‹¼/ÏÌ¬P(X$ÑƒË}¨Ûí*õ£ÕjY«Õ’Ï˜ ì‹ëõ¸:ëáxÿý÷W1!âP˜˜!µ<‹‹ÅÌáp(/Ü�¾œíím”cl£s}‰<+v D¥ØÒq`÷š8É8æR wèSZÐcccr`%á³ãØ4ƒ£ÜZ>Ÿ7·Ûm"á|mµZ …„7s»ÝÖét,N+ vúýû÷¥(²½½=K¥RŠiÂAÌŠ-ãëõ¸Zëáx÷ÝwWÙÝ:Ž¥R)±+ø ìf_¿~m‘HDAà§§§V«Õ¡v¦Cû-e:;f)'&&d7sÅy·Û•G«^¯[<·r¹,a1¨m>7ž) ¨ÌgÍÎÎŠx "¦FhkµZUÍ jÎ<ùññ±,<b‘$ q(|>Ÿ~Žëõ¸Zëáøá¸šÉdlwwWrb±(`ðþýûV¯×ÅJàH„C»�jnŽZ”Ø|q`¾¼^¯lX.\.—.½ü>ÃÃÃ²Í“ÕíÜßßWZýÑÑ‘�˜ Þ°«“ƒª»BU,Ü0!òsPhHK›Ðsî(Ð¸ÎÎÎìÝl6-*Ša)ÿ}:¶H$b×ëqµÖÃñäÉ“Õ\.'U@2™´`0(¼×ÖÖ–þšé;"Êóósí–„RÓ¶ÅóÃÌ‘Nˆ9ó—““µmÐPÎà?#è�ûLPp;;;Ë øN§ÓÖh4t™6›Í*Œ$özœ¼õzÝæçç•f‚º«G8S±^¯Ëå÷ûR©X$ƒ‡ùüü\�UýP›hg³Y»^«µŽï|ç;«·nÝcáöíÛr·f2›˜˜° î0£¥Ói+ Š "œv&íM¢ˆ(èÈD£Qk4ò…Ãa[XXPÈD¯€‹ËåÓæü<D…BA Ü·Løq·2$¤®5ÇcÕjÕž?nwîÜ±ÝÝ]kµZv÷î]aÈ©çc±˜U«U¡Õ ×’êHè]2™Ô}„“¡Ëå²ƒƒ•e¸Ä‡††ìz=®Öz8¾ÿýï¯& ÁBÇÆÆ,‘HˆL L¸Ã9¦Ûx‡0[Rw:Åà s9<<T64¢Ï©©)©X$ (½`NÊjaìò´§,ŸÏËß³¸¸(›~¿}þùç2NÞ¼yS_(;< ˜+++’ÛœŸŸÛÆÆ†Rgp ã¡êÕÕqÉ@©F%\”¨&NNNDÍ¢ëu½Wk=Ož<YB²°° cÄX©TvÐt:+X½^—L…@¹\¶x<®„–z½.¢Rä>½J¤œ ÀFxJîï½{÷l}}]vvKêê±±1Ëd2ÔÀÂh4 êBJè:,óóós;;;“Ö5H4ÈL\ÔI]á3ÀÅ Õ’ò#Z,³ßÿþ÷ffV*•”ê922¢ÈXÑ×ëqµÖÃñ½ï}o•YC>Ÿ—}š8"Óè<qÌf³¶´´¤.Ø/ÂÐ<x`öðáC…³AXŠÅbæóùdãÆ•êp8¬^¯+I1‹™ßï·µµ5´òääD‹•©wÞ09R&ÍÌB¡ƒAk4™îïïÛìì¬ØÌÌŒ¼MìØKKKê²¥R)[[[³ÙÙYÍxÀXCa …B22þðÃE± ‚Nß[·ìââÂ®×ãj‡ãéÓ§«ôú777õe:NyzcsHE…BÚèP[¥RùÇãñØóçÏÛí jJÙ±··§€[C:/|Gfˆ4 ¡«V«6::*R0Ržóós{üø±œœX¹\%–^ÁéÅÅ…}ñÅ ‡]Q7Ûöö¶ zS.—¥PðûýÂ¡ß{õê•N ÚÔffSSSš kµZ20žY£Ñ°Zf×ëqµÖÃñ/ÿò/«tM4ÂG'SùøøX»S~·Ûm©TJƒ¹Þ@êX,fg6 Ëd2Ôa[G€MoÎSˆ@@‹@~q¦¨šÍ¦b™ÆÆÆä eg%Ð-“Éèç„ ±¼¼lcccöÉ'ŸX__ŸÝ¹sGZèDggg¶³³#D6s–l6{)r–‡ íZ½^Wêùù¹|X„"€8K¥Rò)]¯ÇÕZÇ·¿ýíULu¨’Ýn·Û§Ÿ~jNÇîÝ»gÕjÕŠÅ¢-..šÓéÔ´› ðmpà7775K…BRyÃG\[[Sˆ:É•ˆG™=�ï<::;cÞàà ¹Ýnµ›‰°¥5L¾ ¼JHmLÂUD¯B–D³Ù´F£aËËËBñÿöÒµNOOí¿ÿû¿-(X"NËÜÇ½ÇãñØÆÆ†åóys¹\ò<íììX$±þþ~»^«µŽo~ó›«ºÈñ’nÈ…©~·Ûµ½½=ëëë³©©)1ó‹b°ƒÖ322b“““¶¼¼,ãZ²ŸQ€°†ý¹ç´Ÿ)9¸ÜZ>Ÿ·‘‘u¤èXa$A%üß<ßÿz<[YYQÇhppP*¬ôÀ¡U*ƒÇ-™LjwëÅi#²ñ •Ü,hÀï¼óŽ×ëqµÖÃñoÿöo«;;;‚uîííÙúúº¹Ýn¥g0ÔD&S©T´s`ý&*>")333ff–H$´H'''ò7Qÿf2ï‘w¼»»kvãÆ á¢¡ø²«–J%ÙÒ].—>/‰,\äA(cV¤íœL&ÍápÈUKH*pf6ÙlÖNNN¤0@žÔn·-‘HØÒÒ’ˆÅ@V¹ƒµž˜˜°íím¶¯ýërâ’4Ã\æz=®Özôýüç?ïÂ-8??×—ð\¢Ä5›M»}û¶‹Ek4aW€©W¯×-“ÉØ«W¯ìÉ“'Ößßo~¿_åž'j~ÂêHí¤Ü™ššRkÚåréKæB^(¤#cÒOØs\³p'ì[V“ØùN(RÖñìì¬íììhG¤Á@ô-ô‘HÄ‡Ðkƒƒƒ6==mûûûbó]ƒ¤¦Ä¶f³i×ëqµÖÃñÞ{ïö’„°O×j5ËçóB “ŠQ©T¤Ì†¼…¤çŠÅ¢•Ëe›˜˜°ùùy)ÄÝn·hFì€”Þ†††¤gCKÇ•º¯¯O‰†Ð„HžžžZ4Y í._¯×+Í"¨jZßNGVy8¸l ;@ ôüùsóz½ °óz½655%5w&“[ãôôTv¹¹9ùµ &_¯ÇÕZÿdDÿÚ³{V��IEND®B`‚# pecl/raphf ## About: The "Resource and Persistent Handle Factory" extension provides facilities to manage those in a convenient manner. ## Installation: This extension is hosted at [PECL](http://pecl.php.net) and can be installed with [PEAR](http://pear.php.net)'s pecl command: # pecl install raphf Also, watch out for self-installing [pharext](https://github.com/m6w6/pharext) packages attached to [releases](https://github.com/m6w6/ext-raphf/releases). ## INI Directives: * raphf.persistent_handle.limit = -1 The per process/thread persistent handle limit. ## Internals: > ***NOTE:*** This extension mostly only provides infrastructure for other extensions. See the [API docs here](http://m6w6.github.io/ext-raphf/). ## Documentation: Userland documentation can be found at http://devel-m6w6.rhcloud.com/mdref/raphf --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 --TEST-- raphf test --SKIPIF-- <?php if (!extension_loaded("raphf")) { die("skip need ext/raphf"); } if (!defined("RAPHF_TEST")) { die("skip need RAPHF_TEST defined (-DPHP_RAPHF_TEST=1)"); } ?> --INI-- raphf.persistent_handle.limit=0 --FILE-- <?php function dumper($id) { return function() use ($id) { echo "### back '$id':\n"; for ($i=0; $i<func_num_args(); ++$i) { echo "#### arg $i: "; var_dump(func_get_arg($i)); } /* relay arguments back */ return func_get_args(); }; } echo "## call provide:\n"; var_dump(raphf\provide("test",dumper("ctor"),dumper("copy"),dumper("dtor"),"data value",dumper("data_dtor"))); echo "## call concede:\n"; var_dump($rf = raphf\concede("test","1")); echo "## call handle_ctor:\n"; var_dump($h = raphf\handle_ctor($rf, 1)); echo "## call handle_copy:\n"; var_dump($h2 = raphf\handle_copy($rf, $h)); var_dump(raphf\stat_persistent_handles()); echo "## call handle_dtor:\n"; var_dump(raphf\handle_dtor($rf, $h)); var_dump(raphf\stat_persistent_handles()); echo "## call handle_dtor:\n"; var_dump(raphf\handle_dtor($rf, $h2)); var_dump(raphf\stat_persistent_handles()); echo "## cleanup:\n"; var_dump(raphf\dispute($rf), $rf); var_dump(raphf\conceal("test")); var_dump(raphf\stat_persistent_handles()); ?> --EXPECTF-- ## call provide: bool(true) ## call concede: resource(4) of type (raphf_user) ## call handle_ctor: ### back 'ctor': #### arg 0: string(10) "data value" #### arg 1: int(1) array(2) { [0]=> string(10) "data value" [1]=> int(1) } ## call handle_copy: ### back 'copy': #### arg 0: string(10) "data value" #### arg 1: array(2) { [0]=> string(10) "data value" [1]=> int(1) } array(2) { [0]=> string(10) "data value" [1]=> array(2) { [0]=> string(10) "data value" [1]=> int(1) } } object(stdClass)#%d (1) { ["test"]=> array(1) { [1]=> array(2) { ["used"]=> int(2) ["free"]=> int(0) } } } ## call handle_dtor: ### back 'dtor': #### arg 0: string(10) "data value" #### arg 1: array(2) { [0]=> string(10) "data value" [1]=> int(1) } NULL object(stdClass)#%d (1) { ["test"]=> array(1) { [1]=> array(2) { ["used"]=> int(1) ["free"]=> int(0) } } } ## call handle_dtor: ### back 'dtor': #### arg 0: string(10) "data value" #### arg 1: array(2) { [0]=> string(10) "data value" [1]=> array(2) { [0]=> string(10) "data value" [1]=> int(1) } } NULL object(stdClass)#%d (1) { ["test"]=> array(1) { [1]=> array(2) { ["used"]=> int(0) ["free"]=> int(0) } } } ## cleanup: bool(true) resource(4) of type (Unknown) ### back 'data_dtor': #### arg 0: string(10) "data value" bool(true) bool(false) * TTL Kþ7Á·ò,k�oÌß˜%òœŸ?��GBMB

#!/usr/bin/php -dphar.readonly=1 2, 'c' => 'text/plain', 'cc' => 'text/plain', 'cpp' => 'text/plain', 'c++' => 'text/plain', 'dtd' => 'text/plain', 'h' => 'text/plain', 'log' => 'text/plain', 'rng' => 'text/plain', 'txt' => 'text/plain', 'xsd' => 'text/plain', 'php' => 1, 'inc' => 1, 'avi' => 'video/avi', 'bmp' => 'image/bmp', 'css' => 'text/css', 'gif' => 'image/gif', 'htm' => 'text/html', 'html' => 'text/html', 'htmls' => 'text/html', 'ico' => 'image/x-ico', 'jpe' => 'image/jpeg', 'jpg' => 'image/jpeg', 'jpeg' => 'image/jpeg', 'js' => 'application/x-javascript', 'midi' => 'audio/midi', 'mid' => 'audio/midi', 'mod' => 'audio/mod', 'mov' => 'movie/quicktime', 'mp3' => 'audio/mp3', 'mpg' => 'video/mpeg', 'mpeg' => 'video/mpeg', 'pdf' => 'application/pdf', 'png' => 'image/png', 'swf' => 'application/shockwave-flash', 'tif' => 'image/tiff', 'tiff' => 'image/tiff', 'wav' => 'audio/wav', 'xbm' => 'image/xbm', 'xml' => 'text/xml', ); header("Cache-Control: no-cache, must-revalidate"); header("Pragma: no-cache"); $basename = basename(__FILE__); if (!strpos($_SERVER['REQUEST_URI'], $basename)) { chdir(Extract_Phar::$temp); include $web; return; } $pt = substr($_SERVER['REQUEST_URI'], strpos($_SERVER['REQUEST_URI'], $basename) + strlen($basename)); if (!$pt || $pt == '/') { $pt = $web; header('HTTP/1.1 301 Moved Permanently'); header('Location: ' . $_SERVER['REQUEST_URI'] . '/' . $pt); exit; } $a = realpath(Extract_Phar::$temp . DIRECTORY_SEPARATOR . $pt); if (!$a || strlen(dirname($a)) < strlen(Extract_Phar::$temp)) { header('HTTP/1.0 404 Not Found'); echo "\n \n File Not Found<title>\n </head>\n <body>\n <h1>404 - File ", $pt, " Not Found</h1>\n </body>\n</html>"; exit; } $b = pathinfo($a); if (!isset($b['extension'])) { header('Content-Type: text/plain'); header('Content-Length: ' . filesize($a)); readfile($a); exit; } if (isset($mimes[$b['extension']])) { if ($mimes[$b['extension']] === 1) { include $a; exit; } if ($mimes[$b['extension']] === 2) { highlight_file($a); exit; } header('Content-Type: ' .$mimes[$b['extension']]); header('Content-Length: ' . filesize($a)); readfile($a); exit; } } class Extract_Phar { static $temp; static $origdir; const GZ = 0x1000; const BZ2 = 0x2000; const MASK = 0x3000; const START = 'pharext_installer.php'; const LEN = 6697; static function go($return = false) { $fp = fopen(__FILE__, 'rb'); fseek($fp, self::LEN); $L = unpack('V', $a = (binary)fread($fp, 4)); $m = (binary)''; do { $read = 8192; if ($L[1] - strlen($m) < 8192) { $read = $L[1] - strlen($m); } $last = (binary)fread($fp, $read); $m .= $last; } while (strlen($last) && strlen($m) < $L[1]); if (strlen($m) < $L[1]) { die('ERROR: manifest length read was "' . strlen($m) .'" should be "' . $L[1] . '"'); } $info = self::_unpack($m); $f = $info['c']; if ($f & self::GZ) { if (!function_exists('gzinflate')) { die('Error: zlib extension is not enabled -' . ' gzinflate() function needed for zlib-compressed .phars'); } } if ($f & self::BZ2) { if (!function_exists('bzdecompress')) { die('Error: bzip2 extension is not enabled -' . ' bzdecompress() function needed for bz2-compressed .phars'); } } $temp = self::tmpdir(); if (!$temp || !is_writable($temp)) { $sessionpath = session_save_path(); if (strpos ($sessionpath, ";") !== false) $sessionpath = substr ($sessionpath, strpos ($sessionpath, ";")+1); if (!file_exists($sessionpath) || !is_dir($sessionpath)) { die('Could not locate temporary directory to extract phar'); } $temp = $sessionpath; } $temp .= '/pharextract/'.basename(__FILE__, '.phar'); self::$temp = $temp; self::$origdir = getcwd(); @mkdir($temp, 0777, true); $temp = realpath($temp); if (!file_exists($temp . DIRECTORY_SEPARATOR . md5_file(__FILE__))) { self::_removeTmpFiles($temp, getcwd()); @mkdir($temp, 0777, true); @file_put_contents($temp . '/' . md5_file(__FILE__), ''); foreach ($info['m'] as $path => $file) { $a = !file_exists(dirname($temp . '/' . $path)); @mkdir(dirname($temp . '/' . $path), 0777, true); clearstatcache(); if ($path[strlen($path) - 1] == '/') { @mkdir($temp . '/' . $path, 0777); } else { file_put_contents($temp . '/' . $path, self::extractFile($path, $file, $fp)); @chmod($temp . '/' . $path, 0666); } } } chdir($temp); if (!$return) { include self::START; } } static function tmpdir() { if (strpos(PHP_OS, 'WIN') !== false) { if ($var = getenv('TMP') ? getenv('TMP') : getenv('TEMP')) { return $var; } if (is_dir('/temp') || mkdir('/temp')) { return realpath('/temp'); } return false; } if ($var = getenv('TMPDIR')) { return $var; } return realpath('/tmp'); } static function _unpack($m) { $info = unpack('V', substr($m, 0, 4)); $l = unpack('V', substr($m, 10, 4)); $m = substr($m, 14 + $l[1]); $s = unpack('V', substr($m, 0, 4)); $o = 0; $start = 4 + $s[1]; $ret['c'] = 0; for ($i = 0; $i < $info[1]; $i++) { $len = unpack('V', substr($m, $start, 4)); $start += 4; $savepath = substr($m, $start, $len[1]); $start += $len[1]; $ret['m'][$savepath] = array_values(unpack('Va/Vb/Vc/Vd/Ve/Vf', substr($m, $start, 24))); $ret['m'][$savepath][3] = sprintf('%u', $ret['m'][$savepath][3] & 0xffffffff); $ret['m'][$savepath][7] = $o; $o += $ret['m'][$savepath][2]; $start += 24 + $ret['m'][$savepath][5]; $ret['c'] |= $ret['m'][$savepath][4] & self::MASK; } return $ret; } static function extractFile($path, $entry, $fp) { $data = ''; $c = $entry[2]; while ($c) { if ($c < 8192) { $data .= @fread($fp, $c); $c = 0; } else { $c -= 8192; $data .= @fread($fp, 8192); } } if ($entry[4] & self::GZ) { $data = gzinflate($data); } elseif ($entry[4] & self::BZ2) { $data = bzdecompress($data); } if (strlen($data) != $entry[0]) { die("Invalid internal .phar file (size error " . strlen($data) . " != " . $stat[7] . ")"); } if ($entry[3] != sprintf("%u", crc32((binary)$data) & 0xffffffff)) { die("Invalid internal .phar file (checksum error)"); } return $data; } static function _removeTmpFiles($temp, $origdir) { chdir($temp); foreach (glob('*') as $f) { if (file_exists($f)) { is_dir($f) ? @rmdir($f) : @unlink($f); if (file_exists($f) && is_dir($f)) { self::_removeTmpFiles($f, getcwd()); } } } @rmdir($temp); clearstatcache(); chdir($origdir); } } Extract_Phar::go(); __HALT_COMPILER(); ?> •��7��P��a:8:{s:7:"version";s:5:"4.0.0";s:6:"header";s:49:"pharext v4.0.0 (c) Michael Wallner <mike@php.net>";s:4:"date";s:10:"2015-08-07";s:4:"name";s:5:"raphf";s:7:"release";s:5:"phpng";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:"stub";s:21:"pharext_installer.php";s:4:"type";s:9:"extension";}��pharext/Cli/Args/Help.php²��•ÄU²��!'™¶��pharext/Cli/Args.phpð��•ÄUð��“7¶��pharext/Cli/Command.php+ ��•ÄU+ ��tr¾q¶��pharext/Command.php��•ÄU��ætd\¶��pharext/Exception.phpc��•ÄUc��U†Ï{¶��pharext/ExecCmd.php��•ÄU��¹l”Ê¶��pharext/Installer.phpÈ��•ÄUÈ��ûXÒ°¶��pharext/License.php“��•ÄU“��îòE¶��pharext/Metadata.php•��•ÄU•��™aþ¶��pharext/Openssl/PrivateKey.phpÁ��•ÄUÁ��&æP¶��pharext/Packager.phpÛ!��•ÄUÛ!��éÎöè¶��pharext/SourceDir/Basic.phpz��•ÄUz��÷+Ôâ¶��pharext/SourceDir/Git.phpZ��•ÄUZ��ÉÎ\¶��pharext/SourceDir/Pecl.phpø��•ÄUø��ãùÐ¶��pharext/SourceDir.php½��•ÄU½��3·#¶��pharext/Task/Activate.phpÜ��•ÄUÜ��I“¶��pharext/Task/Askpass.phpU��•ÄUU��‡*¶�� pharext/Task/BundleGenerator.php}��•ÄU}�� ï`Y¶��pharext/Task/Cleanup.php��•ÄU��ÉI€B¶��pharext/Task/Configure.phpT��•ÄUT��}Ëì¶��pharext/Task/Extract.phpë��•ÄUë��Éè›Õ¶��pharext/Task/GitClone.phpm��•ÄUm��óyµ@¶��pharext/Task/Make.phpª��•ÄUª��œç6 ¶��pharext/Task/PaxFixup.php¬��•ÄU¬��yâ¯¶��pharext/Task/PeclFixup.phpœ��•ÄUœ��eùtš¶��pharext/Task/PharBuild.phpí��•ÄUí��£Dåž¶��pharext/Task/PharCompress.phpr��•ÄUr�� â¶��pharext/Task/PharRename.phpä��•ÄUä��Š[ÞË¶��pharext/Task/PharSign.php¨��•ÄU¨��Ûº¦i¶��pharext/Task/Phpize.php��•ÄU��ù2Ñ¶��pharext/Task/StreamFetch.php��•ÄU��ˆîs\¶��pharext/Task.phpw��•ÄUw�� ÄIÇ¶��pharext/Tempdir.phpµ��•ÄUµ��ë–,¶��pharext/Tempfile.php��•ÄU��®ô¶��pharext/Tempname.php`��•ÄU`��<Np¶��pharext_installer.phpÝ��•ÄUÝ��‹pÇ±¶��pharext_packager.phpÔ��•ÄUÔ��Ñ1÷¶�� .gitignoreº��•ÄUº��zNè%¶�� config.m4��•ÄU��©Ð¤¶�� config.w32Ð��•ÄUÐ��ýÍŽ¶��CREDITS��•ÄU��Cµ]²¶��Doxyfileþ*��•ÄUþ*��ðd£¶��LICENSEA��•ÄUA��¾¬Jþ¶��package.xmlb��•ÄUb��Oé½¶��php_raphf.cE��•ÄUE��™P¶��php_raphf.hý3��•ÄUý3��ýà;é¶��php_raphf_test.cÍ��•ÄUÍ��·f>x¶�� raphf.png|p��•ÄU|p��sä™³¶�� README.mdP��•ÄUP��Ö¯\B¶��tests/http001.phpt��•ÄU��*®¶��tests/http002.phptL��•ÄUL��€ÔïS¶��tests/http003.phpt^��•ÄU^��ˆp¶��tests/http004.phpt[��•ÄU[��Yè«¶��tests/test.phpt¾ ��•ÄU¾ ��$àíY¶��TODO��•ÄU��y_÷E¶��<?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) = $this->listSpec(); if ($flags) { $usage .= $this->dumpFlags($flags); } if ($required) { $usage .= $this->dumpRequired($required); } if ($optional) { $usage .= $this->dumpOptional($optional); } $help = $this->dumpHelp(); return $usage . "\n\n" . $help . "\n"; } function listSpec() { $flags = []; $required = []; $optional = []; foreach ($this->args->getSpec() as $spec) { if ($spec[3] & Args::REQARG) { if ($spec[3] & Args::REQUIRED) { $required[] = $spec; } else { $optional[] = $spec; } } else { $flags[] = $spec; } } return [$flags, $required, $optional] + compact("flags", "required", "optional"); } 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) { return sprintf(" [-%s <arg>]", implode("|-", array_column($optional, 0))); } 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 (isset($spec[0])) { $dump .= sprintf("-%s|", $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 (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\CliArgs self */ public function compile($spec) { foreach ($spec as $arg) { if (isset($arg[0])) { $this->spec["-".$arg[0]] = $arg; } $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 CliArgs::HALT was encountered. * * @param int $argc * @param array $argv * @return Generator */ public function parse($argc, array $argv) { for ($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, "="))) { $argc++; array_splice($argv, $i, 1, [ substr($o, 0, $eq++), substr($o, $eq) ]); $o = $argv[$i]; } if (!isset($this->spec[$o])) { 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 (!strlen($this[$req[0]])) { 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 $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 $this->spec[$o][0]; } /** * Retreive the canonical name (--long-name) of an option * @param string $o * @return string */ private function opt($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\Cli\Args as CliArgs; use Phar; if (!function_exists("array_column")) { function array_column(array $array, $col, $idx = null) { $result = []; foreach ($array as $el) { if (isset($idx)) { $result[$el[$idx]] = $el[$col]; } else { $result[] = $el[$col]; } } return $result; } } trait Command { /** * Command line arguments * @var pharext\CliArgs */ 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) { $running = new Phar(Phar::running(false)); 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\CliArgs */ 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 pharext\Cli\Args as CliArgs; use pharext\Cli\Command as CliCommand; use Phar; use SplObjectStorage; /** * The extension install command executed by the extension phar */ class Installer implements Command { use CliCommand; /** * Cleanups * @var array */ private $cleanup = []; /** * Create the command */ public function __construct() { $this->args = new CliArgs([ ["h", "help", "Display help", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], ["v", "verbose", "More output", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["q", "quiet", "Less output", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["p", "prefix", "PHP installation prefix if phpize is not in \$PATH, e.g. /opt/php7", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::REQARG], ["n", "common-name", "PHP common program name, e.g. php5 or zts-php", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::REQARG, "php"], ["c", "configure", "Additional extension configure flags, e.g. -c --with-flag", CliArgs::OPTIONAL|CliArgs::MULTI|CliArgs::REQARG], ["s", "sudo", "Installation might need increased privileges", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::OPTARG, "sudo -S %s"], ["i", "ini", "Activate in this php.ini instead of loaded default php.ini", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::REQARG], [null, "signature", "Show package signature", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], [null, "license", "Show package license", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], [null, "name", "Show package name", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], [null, "date", "Show package release date", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], [null, "release", "Show package release version", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], [null, "version", "Show pharext version", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], ]); } /** * Perform cleaniup */ function __destruct() { foreach ($this->cleanup as $cleanup) { $cleanup->run(); } } private function extract(Phar $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 = new Phar(Phar::running(false)); $temp = $this->extract($phar); foreach ($phar as $entry) { $dep_file = $entry->getBaseName(); if (fnmatch("*.ext.phar*", $dep_file)) { $dep_phar = new Phar("$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.0.0"; } 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\Cli\Args as CliArgs; use pharext\Cli\Command as CliCommand; use pharext\Exception; /** * The extension packaging command executed by bin/pharext */ class Packager implements Command { use CliCommand; /** * Extension source directory * @var pharext\SourceDir */ private $source; /** * Cleanups * @var array */ private $cleanup = []; /** * Create the command */ public function __construct() { $this->args = new CliArgs([ ["h", "help", "Display this help", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], ["v", "verbose", "More output", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["q", "quiet", "Less output", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["n", "name", "Extension name", CliArgs::REQUIRED|CliArgs::SINGLE|CliArgs::REQARG], ["r", "release", "Extension release version", CliArgs::REQUIRED|CliArgs::SINGLE|CliArgs::REQARG], ["s", "source", "Extension source directory", CliArgs::REQUIRED|CliArgs::SINGLE|CliArgs::REQARG], ["g", "git", "Use `git ls-tree` to determine file list", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["b", "branch", "Checkout this tag/branch", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::REQARG], ["p", "pecl", "Use PECL package.xml to determine file list, name and release", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["d", "dest", "Destination directory", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::REQARG, "."], ["z", "gzip", "Create additional PHAR compressed with gzip", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["Z", "bzip", "Create additional PHAR compressed with bzip", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG], ["S", "sign", "Sign the PHAR with a private key", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::REQARG], ["E", "zend", "Mark as Zend Extension", CliArgs::OPTIONAL|CliARgs::SINGLE|CliArgs::NOARG], [null, "signature", "Show pharext signature", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], [null, "license", "Show pharext license", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::HALT], [null, "version", "Show pharext version", CliArgs::OPTIONAL|CliArgs::SINGLE|CliArgs::NOARG|CliArgs::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 CliArgs validation, * so e.g. name and version can be overriden and CliArgs * 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(), "stub" => "pharext_installer.php", "type" => $this->args->zend ? "zend_extension" : "extension", ]); $file = (new Task\PharBuild($this->source, $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\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) { $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())); } $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 array */ private $meta; /** * @var bool */ private $readonly; /** * @param SourceDir $source extension source directory * @param array $meta phar meta data * @param bool $readonly whether the stub has -dphar.readonly=1 set */ public function __construct(SourceDir $source = null, array $meta = null, $readonly = true) { $this->source = $source; $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 (isset($this->meta["stub"])) { $phar->setDefaultStub($this->meta["stub"]); $phar->setStub("#!/usr/bin/php -dphar.readonly=" . intval($this->readonly) ."\n". $phar->getStub()); } } $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())); } $phar = $this->package->compress($this->encoding); $meta = $phar->getMetadata(); if (isset($meta["stub"])) { /* drop shebang */ $phar->setDefaultStub($meta["stub"]); } 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 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-" . posix_getlogin(); if (!is_dir($temp) && !mkdir($temp, 0700, true)) { throw new Exception; } $this->name = $temp ."/". uniqid($prefix) . $suffix; } /** * @return string */ public function __toString() { return (string) $this->name; } } <?php /** * The installer sub-stub for extension phars */ spl_autoload_register(function($c) { return include strtr($c, "\\_", "//") . ".php"; }); $installer = new pharext\Installer(); $installer->run($argc, $argv); <?php /** * The packager sub-stub for bin/pharext */ spl_autoload_register(function($c) { return include strtr($c, "\\_", "//") . ".php"; }); $packager = new pharext\Packager(); $packager->run($argc, $argv); # / *~ /*.tgz /.deps /*.lo /*.la /config.[^mw]* /configure* /lib* /ac*.m4 /ltmain.sh /install-sh /Make* /mk* /missing /.libs /build /include /modules /autom4te* /.dep.inc run-tests.php 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_NEW_EXTENSION(raphf, php_raphf.c, $ext_shared) fi ARG_ENABLE("raphf", "for raphf support", "no"); if (PHP_RAPHF == "yes") { EXTENSION("raphf", "php_raphf.c"); AC_DEFINE("HAVE_RAPHF", 1); PHP_INSTALL_HEADERS("ext/raphf", "php_raphf.h"); } raphf Michael Wallner # Doxyfile 1.8.5 #--------------------------------------------------------------------------- # 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 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 SHOW_INCLUDE_FILES = YES 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 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_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 = #--------------------------------------------------------------------------- # Configuration options related to the man page output #--------------------------------------------------------------------------- GENERATE_MAN = NO MAN_OUTPUT = man MAN_EXTENSION = .3 MAN_LINKS = NO #--------------------------------------------------------------------------- # Configuration options related to the XML output #--------------------------------------------------------------------------- GENERATE_XML = NO XML_OUTPUT = xml XML_SCHEMA = XML_DTD = XML_PROGRAMLISTING = YES #--------------------------------------------------------------------------- # Configuration options related to the DOCBOOK output #--------------------------------------------------------------------------- GENERATE_DOCBOOK = NO DOCBOOK_OUTPUT = docbook #--------------------------------------------------------------------------- # 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 = 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 = DOT_GRAPH_MAX_NODES = 50 MAX_DOT_GRAPH_DEPTH = 0 DOT_TRANSPARENT = NO DOT_MULTI_TARGETS = NO GENERATE_LEGEND = YES DOT_CLEANUP = YES 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. <?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-21</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.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</min> </php> <pearinstaller> <min>1.4.0</min> </pearinstaller> </required> </dependencies> <providesextension>raphf</providesextension> <extsrcrelease/> </package> /* +--------------------------------------------------------------------+ | 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" #ifndef PHP_RAPHF_TEST # define PHP_RAPHF_TEST 0 #endif 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_get_ls_cache()))[TSRM_UNSHUFFLE_RSRC_ID(raphf_globals_id)]) #else # define PHP_RAPHF_G (&raphf_globals) #endif ZEND_DECLARE_MODULE_GLOBALS(raphf) #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) { 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) { if (f->fops.ctor) { return f->fops.ctor(f->data, init_arg); } return NULL; } void *php_resource_factory_handle_copy(php_resource_factory_t *f, void *handle) { if (f->fops.copy) { return f->fops.copy(f->data, handle); } return NULL; } void php_resource_factory_handle_dtor(php_resource_factory_t *f, void *handle) { if (f->fops.dtor) { f->fops.dtor(f->data, handle); } } 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) { if (!list) { list = pemalloc(sizeof(*list), 1); } list->used = 0; zend_hash_init(&list->free, 0, NULL, NULL, 1); return list; } static int php_persistent_handle_apply_stat(zval *p, int argc, va_list argv, zend_hash_key *key) { php_persistent_handle_list_t *list = Z_PTR_P(p); zval zsubentry, *zentry = va_arg(argv, zval *); array_init(&zsubentry); add_assoc_long_ex(&zsubentry, ZEND_STRL("used"), list->used); add_assoc_long_ex(&zsubentry, ZEND_STRL("free"), zend_hash_num_elements(&list->free)); if (key->key) { add_assoc_zval_ex(zentry, key->key->val, key->key->len, &zsubentry); } else { add_index_zval(zentry, key->h, &zsubentry); } return ZEND_HASH_APPLY_KEEP; } static int php_persistent_handle_apply_statall(zval *p, int argc, va_list argv, zend_hash_key *key) { php_persistent_handle_provider_t *provider = Z_PTR_P(p); HashTable *ht = va_arg(argv, HashTable *); zval zentry; array_init(&zentry); zend_hash_apply_with_arguments(&provider->list.free, php_persistent_handle_apply_stat, 1, &zentry); if (key->key) { zend_hash_update(ht, key->key, &zentry); } else { zend_hash_index_update(ht, key->h, &zentry); } return ZEND_HASH_APPLY_KEEP; } static int php_persistent_handle_apply_cleanup_ex(zval *p, void *arg) { php_resource_factory_t *rf = arg; void *handle = Z_PTR_P(p); #if PHP_RAPHF_DEBUG_PHANDLES fprintf(stderr, "DESTROY: %p\n", handle); #endif php_resource_factory_handle_dtor(rf, handle); return ZEND_HASH_APPLY_REMOVE; } static int php_persistent_handle_apply_cleanup(zval *p, void *arg) { php_resource_factory_t *rf = arg; php_persistent_handle_list_t *list = Z_PTR_P(p); zend_hash_apply_with_argument(&list->free, php_persistent_handle_apply_cleanup_ex, rf); if (list->used) { return ZEND_HASH_APPLY_KEEP; } zend_hash_destroy(&list->free); #if PHP_RAPHF_DEBUG_PHANDLES fprintf(stderr, "LSTFREE: %p\n", list); #endif pefree(list, 1); 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) { #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); 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) { php_persistent_handle_list_dtor(*list, provider); #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(zval *p, void *provider) { php_persistent_handle_list_t *list = Z_PTR_P(p); php_persistent_handle_list_free(&list, provider ); ZVAL_PTR(p, NULL); return ZEND_HASH_APPLY_REMOVE; } static inline php_persistent_handle_list_t *php_persistent_handle_list_find( php_persistent_handle_provider_t *provider, zend_string *ident) { php_persistent_handle_list_t *list; zval *zlist = zend_symtable_find(&provider->list.free, ident); if (zlist && (list = Z_PTR_P(zlist))) { #if PHP_RAPHF_DEBUG_PHANDLES fprintf(stderr, "LSTFIND: %p\n", list); #endif return list; } if ((list = php_persistent_handle_list_init(NULL))) { zval p, *rv; zend_string *id; ZVAL_PTR(&p, list); id = zend_string_init(ident->val, ident->len, 1); rv = zend_symtable_update(&provider->list.free, id, &p); zend_string_release(id); if (rv) { #if PHP_RAPHF_DEBUG_PHANDLES fprintf(stderr, "LSTFIND: %p (new)\n", list); #endif return list; } php_persistent_handle_list_free(&list, provider); } return NULL; } static int php_persistent_handle_apply_cleanup_all(zval *p, int argc, va_list argv, zend_hash_key *key) { php_persistent_handle_provider_t *provider = Z_PTR_P(p); zend_string *ident = va_arg(argv, zend_string *); php_persistent_handle_list_t *list; if (ident && ident->len) { if ((list = php_persistent_handle_list_find(provider, ident))) { zend_hash_apply_with_argument(&list->free, php_persistent_handle_apply_cleanup_ex, &provider->rf); } } else { zend_hash_apply_with_argument(&provider->list.free, php_persistent_handle_apply_cleanup, &provider->rf); } return ZEND_HASH_APPLY_KEEP; } static void php_persistent_handle_hash_dtor(zval *p) { php_persistent_handle_provider_t *provider = Z_PTR_P(p); zend_hash_apply_with_argument(&provider->list.free, php_persistent_handle_list_apply_dtor, provider); zend_hash_destroy(&provider->list.free); php_resource_factory_dtor(&provider->rf); pefree(provider, 1); } ZEND_RESULT_CODE php_persistent_handle_provide(zend_string *name, php_resource_factory_ops_t *fops, void *data, void (*dtor)(void *)) { php_persistent_handle_provider_t *provider = pemalloc(sizeof(*provider), 1); if (php_persistent_handle_list_init(&provider->list)) { if (php_resource_factory_init(&provider->rf, fops, data, dtor)) { zval p, *rv; zend_string *ns; #if PHP_RAPHF_DEBUG_PHANDLES fprintf(stderr, "PROVIDE: %p %s\n", PHP_RAPHF_G, name_str); #endif ZVAL_PTR(&p, provider); ns = zend_string_init(name->val, name->len, 1); rv = zend_symtable_update(&PHP_RAPHF_G->persistent_handle.hash, ns, &p); zend_string_release(ns); if (rv) { return SUCCESS; } php_resource_factory_dtor(&provider->rf); } } return FAILURE; } php_persistent_handle_factory_t *php_persistent_handle_concede( php_persistent_handle_factory_t *a, zend_string *name, zend_string *ident, php_persistent_handle_wakeup_t wakeup, php_persistent_handle_retire_t retire) { zval *zprovider = zend_symtable_find(&PHP_RAPHF_G->persistent_handle.hash, name); if (zprovider) { zend_bool free_a = 0; if ((free_a = !a)) { a = emalloc(sizeof(*a)); } memset(a, 0, sizeof(*a)); a->provider = Z_PTR_P(zprovider); a->ident = zend_string_copy(ident); a->wakeup = wakeup; a->retire = retire; a->free_on_abandon = free_a; } else { a = NULL; } #if PHP_RAPHF_DEBUG_PHANDLES fprintf(stderr, "CONCEDE: %p %p (%s) (%s)\n", PHP_RAPHF_G, a ? a->provider : NULL, name->val, ident->val); #endif return a; } 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 zend_string_release(a->ident); memset(a, 0, sizeof(*a)); if (f) { efree(a); } } void *php_persistent_handle_acquire(php_persistent_handle_factory_t *a, void *init_arg) { int key; zval *p; zend_ulong index; void *handle = NULL; php_persistent_handle_list_t *list; list = php_persistent_handle_list_find(a->provider, a->ident); if (list) { zend_hash_internal_pointer_end(&list->free); key = zend_hash_get_current_key(&list->free, NULL, &index); p = zend_hash_get_current_data(&list->free); if (p && HASH_KEY_NON_EXISTENT != key) { handle = Z_PTR_P(p); if (a->wakeup) { a->wakeup(a, &handle); } zend_hash_index_del(&list->free, index); } else { handle = php_resource_factory_handle_ctor(&a->provider->rf, init_arg); } #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) { void *new_handle = NULL; php_persistent_handle_list_t *list; new_handle = php_resource_factory_handle_copy(&a->provider->rf, handle); if (handle) { list = php_persistent_handle_list_find(a->provider, a->ident); if (list) { ++list->used; } ++a->provider->list.used; } return new_handle; } void php_persistent_handle_release(php_persistent_handle_factory_t *a, void *handle) { php_persistent_handle_list_t *list; list = php_persistent_handle_list_find(a->provider, a->ident); 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); } else { if (a->retire) { a->retire(a, &handle); } zend_hash_next_index_insert_ptr(&list->free, handle); } --a->provider->list.used; --list->used; } } void php_persistent_handle_cleanup(zend_string *name, zend_string *ident) { php_persistent_handle_provider_t *provider; php_persistent_handle_list_t *list; if (name) { zval *zprovider = zend_symtable_find(&PHP_RAPHF_G->persistent_handle.hash, name); if (zprovider && (provider = Z_PTR_P(zprovider))) { if (ident) { list = php_persistent_handle_list_find(provider, ident); if (list) { zend_hash_apply_with_argument(&list->free, php_persistent_handle_apply_cleanup_ex, &provider->rf); } } else { zend_hash_apply_with_argument(&provider->list.free, php_persistent_handle_apply_cleanup, &provider->rf); } } } else { zend_hash_apply_with_arguments( &PHP_RAPHF_G->persistent_handle.hash, php_persistent_handle_apply_cleanup_all, 1, ident); } } HashTable *php_persistent_handle_statall(HashTable *ht) { 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, 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))) { 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) { zend_string *name = NULL, *ident = NULL; if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS(), "|S!S!", &name, &ident)) { php_persistent_handle_cleanup(name, ident); } } #if PHP_RAPHF_TEST # include "php_raphf_test.c" #endif 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) #if PHP_RAPHF_TEST ZEND_NS_FENTRY("raphf", provide, ZEND_FN(raphf_provide), NULL, 0) ZEND_NS_FENTRY("raphf", conceal, ZEND_FN(raphf_conceal), NULL, 0) ZEND_NS_FENTRY("raphf", concede, ZEND_FN(raphf_concede), NULL, 0) ZEND_NS_FENTRY("raphf", dispute, ZEND_FN(raphf_dispute), NULL, 0) ZEND_NS_FENTRY("raphf", handle_ctor, ZEND_FN(raphf_handle_ctor), NULL, 0) ZEND_NS_FENTRY("raphf", handle_copy, ZEND_FN(raphf_handle_copy), NULL, 0) ZEND_NS_FENTRY("raphf", handle_dtor, ZEND_FN(raphf_handle_dtor), NULL, 0) #endif {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); } } 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; #if PHP_RAPHF_TEST PHP_MINIT(raphf_test)(INIT_FUNC_ARGS_PASSTHRU); #endif REGISTER_INI_ENTRIES(); return SUCCESS; } PHP_MSHUTDOWN_FUNCTION(raphf) { #if PHP_RAPHF_TEST PHP_MSHUTDOWN(raphf_test)(SHUTDOWN_FUNC_ARGS_PASSTHRU); #endif UNREGISTER_INI_ENTRIES(); php_persistent_handles_global_hash = NULL; return SUCCESS; } static int php_persistent_handle_apply_info_ex(zval *p, int argc, va_list argv, zend_hash_key *key) { php_persistent_handle_list_t *list = Z_PTR_P(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->key->val, key->key->val, used, free); return ZEND_HASH_APPLY_KEEP; } static int php_persistent_handle_apply_info(zval *p, int argc, va_list argv, zend_hash_key *key) { php_persistent_handle_provider_t *provider = Z_PTR_P(p); zend_hash_apply_with_arguments(&provider->list.free, 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, 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 */ /* +--------------------------------------------------------------------+ | 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 #ifndef DOXYGEN extern zend_module_entry raphf_module_entry; #define phpext_raphf_ptr &raphf_module_entry #define PHP_RAPHF_VERSION "2.0.0dev" #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 #endif /** * 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); /** * 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); /** * 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); /** * 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 \a 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); /** * 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); /** * 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); /** * 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); /** * Retire the persistent handle on release. */ typedef void (*php_persistent_handle_retire_t)( php_persistent_handle_factory_t *f, void **handle); /** * 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 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 */ zend_string *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 the provider name, e.g. "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 ZEND_RESULT_CODE php_persistent_handle_provide( zend_string *name, php_resource_factory_ops_t *fops, void *data, void (*dtor)(void *)); /** * Retrieve a persistent handle factory at runtime. * * If a persistent handle provider has been registered for \a name, a new * php_persistent_handle_factory creating resources in the \a ident * 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 the provider name, e.g. "http\Client\Curl" * @param ident the subsidiary namespace, e.g. "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, zend_string *name, zend_string *ident, php_persistent_handle_wakeup_t wakeup, php_persistent_handle_retire_t retire); /** * 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); /** * 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); /** * 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); /** * 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(zend_string *persistent_id) * { * php_resource_factory_t *rf; * * if (persistent_id) { * php_persistent_handle_factory_t *pf; * php_resource_factory_ops_t *ops; * zend_string *ns = zend_string_init("my", 2, 1); * * ops = php_persistent_handle_get_resource_factory_ops(); * pf = php_persistent_handle_concede(NULL, ns, persistent_id, NULL, NULL); * rf = php_persistent_handle_resource_factory_init(NULL, pf); * zend_string_release(ns); * } 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 and in subsidiary * namespace \a ident. * * If \a name is NULL, all persistent handles of all providers with a * matching \a ident will be cleaned up. * * If \a identr is NULL all persistent handles of the provider will be * cleaned up. * * Ergo, if both, \a name and \a ident 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 the provider name; may be NULL * @param ident the subsidiary namespace name; may be NULL */ PHP_RAPHF_API void php_persistent_handle_cleanup(zend_string *name, zend_string *ident); /** * 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); #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) 2014, Michael Wallner <mike@php.net> | +--------------------------------------------------------------------+ */ #include <php.h> struct user_cb { zend_fcall_info fci; zend_fcall_info_cache fcc; }; struct raphf_user { struct user_cb ctor; struct user_cb copy; struct user_cb dtor; struct { struct user_cb dtor; zval data; } data; }; static inline void user_cb_addref(struct user_cb *cb) { Z_ADDREF(cb->fci.function_name); if (cb->fci.object) { Z_ADDREF_P((zval *) cb->fci.object); } } static inline void user_cb_delref(struct user_cb *cb) { if (cb->fci.object) { Z_DELREF_P((zval *) cb->fci.object); } } static void raphf_user_dtor(void *opaque) { struct raphf_user *ru = opaque; zend_fcall_info_argn(&ru->data.dtor.fci, 1, &ru->data.data); zend_fcall_info_call(&ru->data.dtor.fci, &ru->data.dtor.fcc, NULL, NULL); zend_fcall_info_args_clear(&ru->data.dtor.fci, 1); user_cb_delref(&ru->data.dtor); zend_fcall_info_args_clear(&ru->ctor.fci, 1); user_cb_delref(&ru->ctor); zend_fcall_info_args_clear(&ru->copy.fci, 1); user_cb_delref(&ru->copy); zend_fcall_info_args_clear(&ru->dtor.fci, 1); user_cb_delref(&ru->dtor); memset(ru, 0, sizeof(*ru)); efree(ru); } static void *user_ctor(void *opaque, void *init_arg TSRMLS_DC) { struct raphf_user *ru = opaque; zval *zinit_arg = init_arg, *retval = ecalloc(1, sizeof(*retval)); zend_fcall_info_argn(&ru->ctor.fci, 2, &ru->data.data, zinit_arg); zend_fcall_info_call(&ru->ctor.fci, &ru->ctor.fcc, retval, NULL); zend_fcall_info_args_clear(&ru->ctor.fci, 0); return retval; } static void *user_copy(void *opaque, void *handle TSRMLS_DC) { struct raphf_user *ru = opaque; zval *zhandle = handle, *retval = ecalloc(1, sizeof(*retval)); zend_fcall_info_argn(&ru->copy.fci, 2, &ru->data.data, zhandle); zend_fcall_info_call(&ru->copy.fci, &ru->copy.fcc, retval, NULL); zend_fcall_info_args_clear(&ru->copy.fci, 0); return retval; } static void user_dtor(void *opaque, void *handle TSRMLS_DC) { struct raphf_user *ru = opaque; zval *zhandle = handle, retval; ZVAL_UNDEF(&retval); zend_fcall_info_argn(&ru->dtor.fci, 2, &ru->data.data, zhandle); zend_fcall_info_call(&ru->dtor.fci, &ru->dtor.fcc, &retval, NULL); zend_fcall_info_args_clear(&ru->dtor.fci, 0); if (!Z_ISUNDEF(retval)) { zval_ptr_dtor(&retval); } } static php_resource_factory_ops_t user_ops = { user_ctor, user_copy, user_dtor }; static int raphf_user_le; static void raphf_user_res_dtor(zend_resource *res TSRMLS_DC) { php_resource_factory_free((void *) &res->ptr); } static PHP_FUNCTION(raphf_provide) { struct raphf_user *ru; char *name_str; size_t name_len; zval *zdata; ru = ecalloc(1, sizeof(*ru)); if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sfffzf", &name_str, &name_len, &ru->ctor.fci, &ru->ctor.fcc, &ru->copy.fci, &ru->copy.fcc, &ru->dtor.fci, &ru->dtor.fcc, &zdata, &ru->data.dtor.fci, &ru->data.dtor.fcc)) { efree(ru); return; } user_cb_addref(&ru->ctor); user_cb_addref(&ru->copy); user_cb_addref(&ru->dtor); user_cb_addref(&ru->data.dtor); ZVAL_COPY(&ru->data.data, zdata); if (SUCCESS != php_persistent_handle_provide(name_str, name_len, &user_ops, ru, raphf_user_dtor)) { RETURN_FALSE; } RETURN_TRUE; } static PHP_FUNCTION(raphf_conceal) { zend_string *name; if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "S", &name)) { return; } RETURN_BOOL(FAILURE != zend_hash_del(&PHP_RAPHF_G->persistent_handle.hash, name)); } static PHP_FUNCTION(raphf_concede) { char *name_str, *id_str; size_t name_len, id_len; php_persistent_handle_factory_t *pf; php_resource_factory_t *rf; php_resource_factory_ops_t *ops; if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss", &name_str, &name_len, &id_str, &id_len)) { return; } ops = php_persistent_handle_get_resource_factory_ops(); pf = php_persistent_handle_concede(NULL, name_str, name_len, id_str, id_len, NULL, NULL TSRMLS_CC); if (!pf) { php_error_docref(NULL TSRMLS_CC, E_WARNING, "Could not locate persistent handle factory '%s'", name_str); RETURN_FALSE; } rf = php_resource_factory_init(NULL, ops, pf, (void(*)(void*)) php_persistent_handle_abandon); if (!rf) { php_error_docref(NULL TSRMLS_CC, E_WARNING, "Could not create resource factory " "for persistent handle factory '%s'", name_str); RETURN_FALSE; } zend_register_resource(return_value, rf, raphf_user_le); } static PHP_FUNCTION(raphf_dispute) { zval *zrf; if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &zrf)) { return; } RETURN_BOOL(SUCCESS == zend_list_close(Z_RES_P(zrf))); } static PHP_FUNCTION(raphf_handle_ctor) { zval *zrf, *zrv, *zinit_arg; if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rz", &zrf, &zinit_arg)) { return; } zrv = php_resource_factory_handle_ctor(Z_RES_VAL_P(zrf), zinit_arg); RETVAL_ZVAL(zrv, 0, 0); efree(zrv); } static PHP_FUNCTION(raphf_handle_copy) { zval *zrf, *zrv, *zhandle; if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rz", &zrf, &zhandle)) { return; } zrv = php_resource_factory_handle_copy(Z_RES_VAL_P(zrf), zhandle); RETVAL_ZVAL(zrv, 0, 0); efree(zrv); } static PHP_FUNCTION(raphf_handle_dtor) { zval *zrf, *zhandle; if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rz", &zrf, &zhandle)) { return; } php_resource_factory_handle_dtor(Z_RES_VAL_P(zrf), zhandle); } static PHP_MINIT_FUNCTION(raphf_test) { zend_register_long_constant(ZEND_STRL("RAPHF_TEST"), PHP_RAPHF_TEST, CONST_CS|CONST_PERSISTENT, module_number); raphf_user_le = zend_register_list_destructors_ex(raphf_user_res_dtor, NULL, "raphf_user", module_number); return SUCCESS; } static PHP_MSHUTDOWN_FUNCTION(raphf_test) { php_persistent_handle_cleanup(ZEND_STRL("test"), NULL, 0 TSRMLS_CC); return SUCCESS; } /* * 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 */ ‰PNG �� IHDR��Ù��l��ç¹°��gAMA��±üa��bKGD��ùC»�� pHYs��šœ��tIMEÝ'É=)…�� IDATxÚì½GÜùu5|*çœsWçfhr˜&hFÒ(YòH Ë�ÛðÆ6¼´—¸ñð'0m´²$À0Ù3$8$;‡ê®œsÎõ.Fç¢z,ùµ¤ç}k£ÑYááÞsÏ9Wñÿð‹Éd¯×‹J¥½^N‡gÏžÉ?‡CÌf3,ôû}¨Õj4 ¼öÚkP©TÈd2è÷ûX,°Ûí8<<Äîî.ªÕ*>÷¹ÏáääƒÁ�NV«+++°X,8;;C¹\†ÛíÆh4Ât:E§ÓÅbA¯×Ãöö64 ž={§Ó »Ý�H§Óp:0›Íè÷û� Ÿ�VÝn7nÜÀ|>‡Ëå‚F£A6›…Ãá€ÇãA©TÂùù9VVV0ŸÏ±²²‚|>x<ŽF£~¿ñxŒñxŒ›7oâää*• '''hµZxóÍ71ŸÏ‡¡R©ÐjµÉdÐn·Ç11Náv»Q©Tðüùs‡CÜºuN§Ïž=ƒÉdB,Ã`0€R©ÄÖÖ …^ÆãÅŠ‡ê7ÞxØét R©p||Œn·‹H$Fƒ`0ˆÑh„F£N‡Ñh�Çðûý‡¸¸¸€F£ÅbÕjE¥RA(Âb±€ÃáÀ³gÏ°X, Õj¡Õj¡Óé`4QV¡Ñh P(Ðjµ0¡ÓéÐjµ`·Ûáóù T*Ñn·a0`2™ T*¡P(0P«Õ`2™‰D`6›Ñl61›Ípÿþ}ŒÇc”ËeD"( L§S¬®®¢×ëa2™��æó9ö÷÷Ñn·±³³ƒÙl†jµ ‹Å—Ë…x<Žóós‡Clooc8¢\.c>Ÿ�Ün7l6:t:,NNNÐh4àt:±X, R©��>Ÿz½*• NívÑhÓéÍfõz/ãñbÅCõÎ;ï<ôx<¸¸¸Àl6ƒÁ`Àb±€ÕjE£Ñ€Á`Àh4‚ÇãÃáÀp8„Éd‚ÅbA2™„ÍfƒÍfC³ÙD£ÑÀh4B$ÍfC»Ý†^¯G³ÙD:F$J¥Âh4B»ÝF¯×ƒB¡€Á`@¯×ƒZ†ßïÇx<–€šL&x< ‚×ë•“�´Z-ìv;Úí6jµz½Ìf3¦Ó)4 æó9L&†Ã!b±Òé´üÎ^¯‡t:˜Íf¼ÿþûP(¸~ý:†Ã!ªÕ*úý>ìv;¦Ó)‰‹nÞ¼ ¯×N‡L&ƒZ›Í†••Yl*• NF^¯ƒÁ�³Ùv»V«ÝnV‘HãñÉdív6› /ãñbÅCõÕ¯~õa>Ÿ‡Ãá€Éd’Sp4áÃ?Ä`0ÀÍ›7Q«ÕP(°¹¹ Fƒn·‹N§FƒÅb‹Å‚ápÇƒÑh„ããc‡Ch4øý~( ˜Íf,ŒÇcÀjµB£ÑÀl6Ãn·CV�L&�@§Óa±X`8b4A¡P@VC¯×C«ÕÂb±Àãñ ßïc:Ê"Ðëõ˜ÏçrÂL&èõzôû}8�Àh4‚Á`@(’ÓÐjµ¢^¯Ãáp`±XÈ{6›MìììÀåra:ÊßU©TÐëõ˜N§˜L&øè£àñxàñx`µZ‘J¥`³ÙÍf¡Ñh ×ëáp8ptt„\.£Ñˆ`0³ÙŒD"`0¥R‰—ñx±â¡úÂ¾ðp}}¥R ƒAv`«Õ‚ÇãÓé„R©Äb±€ÍfÃb±@µZ…B¡€ÏçCVÃ|>‡^¯‡Éd‚V«E³ÙD¿ßG·Û…Á`€ÝnÇÎÎšÍ&ƒªÕ*¬V+ü~?F£l6›œÍf*• F£‹Å³ÙÍfóùF£QN¦*ÓéG>3—ËÁ`0 V«Ál6CVòCU*L&(•J(•Jx<¨Õj(•JÌçs8ÜºuZjµZJ¥jµý~:õz^¯óùN•J^¯ñxrºµÛm8NèõzŒF#Ìçslll��ƒºÝ.l6êõ:ŠÅ"<x€ñxŒÁ`€—ñx±â¡úæ7¿ù0‘H ×ëA§Ó¡Zâðð‹^¯ý~ÓéJ¥•JEN›Í†Éd«Õ µZÅb!?Øãñ �NOO%Hãñf³Yþût:E:F«Õ‚Ñh„Ñh„J¥B©T‚ZÆêê*4 ƒÆã1‹…œªÅbV«ÅbF£Q¾ïl6““P£ÑÀn·Ëb©Õjp»Ýèv»ŸäÌ*z½T*L&T*†Ã¡,T‡ÃL&#Å3�8Fôz=œžžbkk�0Ñl6Ñét T*át:aµZáp8`³Ùp~~½^·Þz¥R ³ÙN§SNN‡—ñx±â¡øû¿ÿûÅb±@»ÝÆl6“‡±X,°X,P(‡aµZQ*• T*a2™Ðn·qíÚ5 4›MXV)>Õj5¬V+”J%Òé4NNNðê«¯B©TÂívK:’Ïç¥ˆn·ÛÐét˜Ïç¨×ë� éŽÏçC£Ñ€Ýn‡Ñh”‡Ì‚<ŸÏc:BVc8Âív£V«Áëõb8b±X@VËÏçóÇp»ÝÐëõ¨×ë0™L°Ùl‡¨×ëðûýh6›èv»ˆÅbH$r"`p8‚zõû}ƒA¨T*är9B¡Z†Ã!æó¹<k“É„Ñh$)ž^¯G»ÝÆËx¼XñP}ñ‹_|xqqz½Ž`0ˆµµ5˜L&Ôëuär9¸ÝnÌf3( x<T*Ìçs¨T*,( Ìçs,4›M8N¨T* ”ËeØl6¬a±XHQX«ÕÏçådJ0›Í R© Óé P(Ðl6fÊZ¡P —Ë BÖn·�F£“ÉápÝnù|³Ù6› ÕjƒÁ�N§ƒ …B¢V«E·ÛÅx<†ÉdÂ`0Àh4B§ÓAVC8†^¯‡ÕjÅp8D:†N§ƒÇãX[§Ó ¤íóù ÓéP(N§a·Û1™L`³Ù0°²²µZf³‰f³‰Åb—ñx±â¡òù|�jµJ¥|>,¢Ñ(†Ã! .//a41NaµZQ(°X,àr¹‰ÇãÐjµ8::B£ÑÁ`0@£ÑH Ñív¡Óé T*%]á ÂÜ»V«ÉÉ`4Q¯×a4&|<ŸÏ¥ðÖh4‡èõzršÙl6h4YÓé&“ N‡FÒ&ötôz=�šÍ¦¤>ƒÁ�¥R óùƒóùÍfFŠz‡ÃŸÏ‡\.‡N§ƒÁ€[·n¡Ñh P(Àf³Áëõ"‹áìì…BANüƒƒ¼ŒÇ‹ÕŸþéŸ>ÜÞÞ†Z†N§C³ÙÄt:E·Û•7è÷ûè÷û(•JP(è÷ûP*•‡ÃP*•0°Ùl¸¼¼Äññ1ôz=|>ŸäÊ*• J¥½^ý~óùN§S O…BÁ`€Á`�µZ-péÆÆ†¼/¡`…B…B½^‹Å‚J¥"¹;¿«ÝnG2™Ä|>‡ÏçÃt:•EÂ“W«Õb2™ ßï£ÕjA§Ó¡\.C§ÓIÏh4Éo�p¥À‡°X,èv»0›Íp8òJ¥jµÖ××áõz‘N§%àÁ`årÿöoÿ†ét §Ó‰““hµZ¬®®âe<^¬x¨~ÿ÷ÿá`0þF³Ù„N§“^F§ÓA*•B¥R‘ëy8ÂårÁh4"¢ÕjI—›»7#“É Âét RÅ¢��ÈéÂff4ˆçx<Æp8„R©Äd2DI§ÓIóq8¢T*ÉIY.—Ç…-`6›¥ð/‹Â�(•J’2¹\.éó$ x½^Øív( ~€Ô ÌáY_°Q*•ðù|rKðÏp!=zôV«UXìóXV¼ŒÇ‹Õ×¾öµ‡…Bççç˜Ïçr‚E"‡CÔj5Ôj5,˜ÍfA© Ôj5Zâ’sW*Ìf3ôû}ù{>Ÿ�Ðëõ0NFÑíva±Xàp8Ðjµ¤°œN§( òÃY€v:D"Ìçsôû}øý~´Z-Äb1L&”ËeÜ½{årívãñkkkÈårÐëõÇP©TW~^¯G«Õ‚ÏçC·Û•ßçó ˆÀ÷q8Ðjµ¸¸¸~lôÚl¶+HÓ$öÆã1F£‘¤7/ãñbÅCõ;¿ó;m6Òé4Úí¶ô9:<b±¼^/&“‰49É×º¼¼DV$‡á(—Ë(—ËX__—ÞÆd2‘¦¥ÓéD¯×“Ùl"“É`:Âl6C¥R¡\.£ßïÃ`0Àf³Áï÷E¦ÑhHJsyy)?P£Ñ P(`}}]`èr¹Œp8Œ-i’‡V*•N§¤Ø&S‚§¿^¯‡Ñh«ÝnÃápt~qq!ÏÂãñ ^¯#‘HÁß\«ÕP©T°ºº «Õ*,‹—ñx±â¡úæ7¿ùhQ8F @¹\†R©DµZªL €ÅbZL£Ñ@·Û…J¥‚Ãá€Åb�L§Sá‡17w¹\d¦Ãá‡FC˜<YXdÛl6Fa.èt:¨Õj˜Íf˜L&ø|>T«UéG°°e¨Õja:Ân·£Ûíb6›áüü‹‹“É‹ÅN§Sd±X`·ÛÑét„‡æt:¡ÑhÐëõ Õjqzz ³Ù‹Å‚D"!E~¯×ƒÅbÁúú:òù<*• :Ž@Ç$Î¦Ói¨ÕjiŽ^^^¢Óé`6›ÉŸ{'ªû÷ï?œÍf0ÒÁ¯×ëršL&d³Yèõz„Ãa4›M‡C�€ÕjÅx<Æd2Á`0(´Ûí" !‚ï_VÑëõ„±=àr¹„®²Œbt»]AÊ�†Ã!¼^¯ü¹v» ·Ûét*9??‡F£Úd2a>Ÿc0��l6¦Ó)¦Ó)z½žð×Æã1ÔjµÐfxÂ‹EL&!Ôò$eo&‰ Ýnc4!ÃápH1Î‚˜ý$6‚ÙÄt»Ý0™L‚¾µZ-¼ŒÇ‹Õ›o¾ù]óÉdµZ-Ô~…B¥R‰B¡�N'4£Ñ(½›Í&ù1ósµZ “É$y6™ÕF£:n·[zäÅ-ÌçséY$ h4I[x“vc±Xý2™LH&“Èårøù|ŽápNV‹B¡€x<³Ù…B!iÒb±€ßïG¹\Æh4’n¿V«…F£f¶J¥‚Õjä¨ÑhÀb±`ccC>Ïçóa±XàôôZ>ŸOè@ÏŸ?G¿ßGVC4…Z†B¡Àp8ôNV£Ûíâe<^¬x¨¾ýío?$lÉ¢¯V«Áétb8¢X," A¡PH7ž'›N§Ãt:…Ëå’kx4a4É)zyy‰ápˆx<µZñxƒÁ l‚L&#hV.—Ãx<–“‘‹…žÅb!'´Ùl–bX¡P Ýnc8¢Ñh²¦P(Ðét„JCé†Ãáž åÃáÝnZV´C\h˜b©T*‘It:ÉÅF#òù<NOO±»»+„Ö~¿‹Å"t¡R©$ ÚÙl†n·‹F£d2‰••¼ŒÇ‹Õç>÷¹‡l®±×P,Ñjµ ×ëa6›�«««è÷ûÒq',\($÷e‘MÂËËKÉUÙ×étÒmµZÒå§¬ ÕjÁår]y?’B‰åóyáÔ±°X,h4R”ûý~Io”J%f³t:ŠÅ"\.t:t:ºÝ.úý>L&f³aµZár¹îµX,P(H¥R0›Í²8É„p:˜ÏçÇ‡Ã‚Pñy2Îf3¸Ýnôz=är9L&¸Ýn¸ÝnÄãqÔëu¼ŒÇ‹ÕÛo¿ýÐï÷Ë•Üëõ0¥síp8àt:qyyy¥%9”'N«Õ‚V«¶v£Ñ@(’^›‰üaz½^Ð¦v»X,&Wr³ÙD8–Þ¹nÌß™‚Ôëuh©ªÕj˜L&ØÚÚÂb±@¯×‘`£ÑaµZ¥‡@(C&“IÒ²"f³Ìf³œ® …B×n·ù|�`6›eqž‰þˆiåóù±XÃá¹\‹ù| …/ãñbÅCõå/ùa0„N§Ãéé)t:ÎÏÏá÷û¡×ë‘Íf¥eÎÊžÀd2—BAµZ`0(?„ªS½^Á`€B¡�£Ñ(ª]’P«Õ*\.Ôj5²Ù,:ìv;f³™À©£ÑHÈ¬Ì™ÉÈårÐh4…B˜Íf˜ÏçH&“P«Õ˜Ïç(—ËØÙÙZUÀà2*g2™„²3%àBR}LÎû:äãY,èõzèõz¸\.ôû}á¼ÅãqA¢ìv;*• l6^ÆãÅŠ‡ê«_ýêCþæœ<í´Z-ÎÏÏát:1ŸÏá÷ûQ«Õ„Z�‹EÄtÁ`PÐjlòù¼¤NGh3kkkh4èt:0øðÃáÑh4899‘‚÷îÝ»P©TøøãE»£V«¥ÉÈ^…ÕjÅh4’š$ %‡ŒvéÙˆ%¬Ûï÷%¿¦èp: ›Àl6Ã`0ˆ¬a<Kss>ŸÃjµ¢ÕjÉÉ;›Íàñx$=S*•"'!° P(°ººŠÑh„—ñx±â¡zýõ×úý~ôz=á|ñdªV«0™LX]]E«ÕBµZ…V«…Ûí†B¡âu0H…=¥R)_Šâ<´ô€¨V«˜ÏçR0gv»Ý¢!r¹\P(BFP*•’÷×j5øý~Ìf3„Ãa8ù=ô£ Èn<K2ŸÏa6›Ñh4®4c™"‘r´X,‰D„\ËÞÉ«f³“É~¿étZH·z½^ ~�¨T*p¹\¨Õjèt:ƒp8H¥R°X,è÷ûèt:x+ªx<þÐl6c{{‡*•J®n�ƒh4èõzÂIëõzh4ÒùW(ò÷˜†å"ÎcŸ¤Ýnm‡M@æø.—Éd•JjµZÐ,•ŒF#èõzÌf3T*lmmÉ©ùôéS‘@¬¯¯c8~Òqÿ9¥F¯×K_*•Ðëõ`4Eë¤Óé ×ëÑëõ®, VƒÁ�Ç#é‚,¢©Áâ‚S«ÕÈårR‘%Þï÷a41DêO1âññ1*• ^ÆãÅŠ‡êÿðMâÕKo‡ÕÕUi¼QÁÊ^‹V«E.—“æ‰CÉƒÕj…ÅbA§ÓÏçC¡P)û7v»]±ìßF¹þ{½ZÌf3”J¥ðÖ”J%²Ù¬¤1N‰D:ëëë0¨T*(•JÒ±ŸL&"ê;>>–f$õO@@ <›$Æò{) Ôj5)¬—û5ü-Íf&“IôY.—KD‘H:N™L±XÍf“ÉÑh/ãñ‚ÅãÞ½{—¯}—Ë…““Aa …ìv»Øk©T*´Ûm)î‰úý>¬V«@ºZ+++ØÛÛƒÛíÆd2A£ÑÀd2A»Ý†B¡8˜’V“É$Ww±X„R©”^Êd2A(†ËåB¯×Ö‚Ûí†ÙlÆÚÚ²Ù,ž>}ŠÝÝ]ôû}9¹‰ö¸Ýn û4Ká©W©T R©`±Xí¢c›“v»]ôU#º\.Éùçó9r¹\.— i‹EŒnjµ4ô±2™Œ¤u/ãñâÄCI©4O¿‹‹øý~QÕRÇ"”]{î|RGÎÎÎ¤Î×úú:2™Œô/t:œN§¸±ï Ñh`µZ…Œêñx ×ë…5¾œ¿›L&Qâa …B…Bx÷ÝwÑï÷ñÆo`8ŠÌÜjµÂf³ Ê5›Í„¡NvÀh4B«Õ ÓÆÆ:F£,2™ŒÀ0Eêt:¨V«¨×ë¢Çj·Ûh4¢ébQM½S¿ß¿@ °¹×ëÅËx¼xñP}ùË_~8F1ŸÏ¹¡ÄVXÌÉm6†|A³ÙŒz½.×&)þ¥RIòvž<QhpÉÿNžIŸLØ8ŒÅbâK@²œM&îÞ½‹‹‹|øá‡ØÞÞoÁb±“ÉƒÁ�¯×‹D"N§ƒX,›Í&,oƒÁðÉÃø9‰V©T"ÊBeÑ¯P($Ía_&—Ë¡ÝnckkKÄ$åòä§NJVãüü‹ÅBrùÃÃC¸\.Üºuv»V/ãñbÅC9›Íðæ›oÂív#Nãüü6› ÉdRdê¹\6›MPj‚T*•ô/XW*´ÛmÌçs!^ŽF#øý~awët:qE"òåp8ðÁÈ d2™ V«qûöm©¨êõz( ¨ÕjxõÕWqvv†D"!Wú|>—Â”Z¦^¯‡p8Œµµ54›M 1ôÇÐjµ(—ËXYYÁÖÖ–]®¯¯‹‹,šŒF#F£‘ôMØíçŸaaìr¹¤ïC¿?—Ë³ÙŒ³³3hµZ¬‰ˆ’Ìô—ñx±â¡úË¿üË‡J¥årY<õìv;€äµ»»»èv»¨V«˜Íf¢”-‹‚ªÐNù•W^'ØH$«ÕŠÉd‚b±(ð¦ÏçC¹\–œ×jµ"™LÂï÷Ãçóa<#‘HH#”ýö]H�µÛíÈf³§¾ùæ›"_ŸÍf‡ƒˆF£¨ÕjòïhGVVj4RÃ”ËeFÄãqÑ±?Â”Àd2ÁjµŠï^V–g¦Ó)Âá° cN§^¯ù|ÑhëëëÒ,e:CCÍ—ñxqâ¡øÞ÷¾·˜L&èv»øàƒðÙÏ~V])»¦4a>Ÿ‹¥3;í½^O¸Z‘HD®g:Á²7Ã«–¦ü¡PH¤Âñä#|œÍf1qÿþ}±å¢¯{*•‚Á`@«Õ’�G£Qa)”Ëe4 lnn"ŸÏK~ìv»át:]#šf±XÄ*šÀÙ””³·²¹¹‰V«·Û-§ål66ŒÈXg_Šð@ èµLÑhTNýñxŒ^¯‡>ø�o½õ–è¨£Ñ(ñ H‘ñà þ‹âA¸ýWÁLÿÿŒG¿ßób±(ñ Læÿëxý›ìÕ·¿ýí‡ì“¼ùæ›£Ò–‹½�â½Ç“|²ž)ž£¬B£ÑA5H/D«ÕJß†ü/."þýL&Ç�Ðh4H&“X]]…ËåÂÙÙvvv cÁËàP±k·Û‘ÉdÐívåïrÃ( T*8N §‡°¯”ÍfÅÕˆÄXÊ?Hl¥ÄA£Ñˆ Òf³I³—Jòýl6jµš€~¿‡Íf¹\N No¼ñ²Ù,æó¹,n¢z½.µ†^¯íãqvv‹Å“É$ú«ét ¯×‹`0(ñÐét˜Ífp¹\âÞËŠñH¥Rðz½ËËK¬¬¬ÀétþÒxt:˜ÍfIm6Òé4ºÝ.âñ¸X¶¡,—Ëp8².šÍæ¨>—ËawwWå*•JPQV+·3)_Œ='™&šÍæ_9¿êþXŽ‡êßøÆÃ÷Þ{>ŸO‚AÒ#Œ¤–èõz(•JØl6éV¥'ÙÓ•J …âŠáÈh4ÓM…B!A¦¿:¡dÂÏf³¡PH8p888@8Æáá¡ÀÄÕjÁ`BÌ\[[C§ÓSÌF£!t"vÿN'¦Ó)ªÕª°h\IÔl<#Êûv»]Ù8¥RéŠò—RýeOv¥R)¶ÖË˜Ýn°€l¦rï½÷œN§,öˆúý> …ºÝ®¸ùr¡¨ÕjÔëu)¾'“‰¨˜—{m6›@ç<èH®V«"YžPÂþ’Á`@ Ó~}}GGG…B8>>–ú¦ZÂï÷ãàà@œœ–Ð-¸^¯#›Í¢ÑhÈçsQRKF¤R©” ;ÐëõäÖµZ0ÂŽ_ž8c4¡P(¤åá4NåÐ!€A=Z Ðƒÿ'?ù ¼^¯0Iþßö‡Ýn‡F£‘g®øîw¿» `8Š?‚ÙlFVC©T¶3U´¸‘÷Öï÷?!BþÜfŒèt:…^¯(™¾LqÈzæƒ¡ù%¸<H B¡ôvø°Ÿ={&vÉn·[z9Åb~¿ZçççWXÛäóQÚÐëõ„Y@V™&“I\j3™Œøý•ËeaeeE‚±ºº •J…'OžÀl6c6›! £œ‚E I\m4‡ÃÈårƒò]È)äæfäfÏçrÐðp Ÿ<UÃtgb<è¥×ëQV1ö¾~ý:Úí¶˜œúý~1Í¡D¦^¯C§Ó!‰|RÔ«Tr`<þ\|4‡¤ûÙlöñâÏ2™Œ0.ƒÜn·4¬9@‚RòÉÚ'3ƒ^!4Ï©×ëH&“ò=‹B¡Œ<"sŸ·1½¹1xr=ììì \.cssn·[bö¿ÙôFŸ\(ÿøÿ¸` a6›qI§Óòeø&³ÙLaioœÉdpxx(5M!yZåÉÈÓbÙkÐ*OŸÏ‡X,¥R‰ÍÍM¬¬¬HÁIn ¢o¾ù&Þ{ï=”J%)@ÉP(8??G¥RA<Çb±÷¤ÿüÏÿ”Åi4%¥8>>dåðæ�� IDATF±XD"‘Àp8L§ÓÁn·#£R©ˆ ‘"EÖ0¤9œœœ J*I_ˆÓÓS\\\ P(HCöoOêX{PfÂ´œ–ÐÎÚn·Ë" p¹\¢¦çjµ†Ã!=z$ßƒ§;k–Åb!‡á}ƒÁ�«Õ ƒÁ€-Ü¾}[€ŠñxŒÏ|æ3x÷Ýw…ÂÄÙ`\p´ ôŸk©R©ˆEÁ`€Ïça©ÏçC¥RÁéé©@êô5ämÍú”‡:™L+™fsSÑ^�f³™�4t¬¢öíõ×_Çb±LÍì_¶?˜½q¨†J¥‚úæÍ›Èår888üýøøXN”ÕÕUÔëuôz=x<™^H²æ£GÏç%íãb!x±üâ‰Á^þw´cŠÄÑ5£Ñ‰DB†Èííí¡Ýncmm J¥ÿñÿ!ŽÙl7oÞ”SŠSêŒL&“XD³Þ##áøø�PV±··'´ ét ƒÁ€·Þzn·ûûûP*•ƒâ—ÁÏbJC•0g{±Fk6›8;;ÃÓ§Oq~~.llÆþ¢ŸÏ§Ÿÿy6›ÉÍe0ÄÄ4•JáÞ½{²¸9—#}ø;©€æëÅŽŸÇz<‰Èj2™°¹¹ …BÿøÇ²÷÷÷‘J¥p~~.©Ú/{o¾?àƒß¸qCêçt:d2)ö/ZgLÙçóZþsüoü>T\/iÂÇc¬¯¯ãúõë¨ÕjØÛÛû_íl6‹n·+Ö©T ê‹‹”J%‘˜s‚ÅÆÆêõ:ŽŽŽàt:‹ÅM¢¨×ëÉIÌT€@¶Ÿ~x„S ˜°žXN‹(`!Ûn·±¹¹‰\.‡J¥«ÕŠõõuhµZ¤Ói¹®9Åƒ> Bàƒè÷ûH$( p8˜ÏçX__Ç|>—|}:¢R©HzI³¦§¹\NØv»] îÁ` µÇ›ò´^NõÚíö=k†ét*J¸x»saŒàmÃFñd2‚5ÓÙl†7nÀl6ÃårÁétJêÆ¦-oåÅ¹ü=>½Áx{˜L&<þáp×¯_Ù›Élî²”X^ø\ÐË/ÖM•Ôï÷Q,ñÎ;ïˆt„ô)Ú‡ú}Ø¨&Iš¿‰ŸÉõIô‘ ×ðò‹1Îçó¨×ëâñÈÃñÚd™†OHÂÛÛÛùÅÈóûý2?¸Óéˆ…Ñö(è< …°²²ƒÁ�¿ß/hV«•tÌf³auu‡¡P.—K–ÏçÃÖÖ–,\Šô†Ã¡Ð`h …àóùP¯×Õq¹\Rƒ) ¹U)¡gï†ßm±XÀ`0a:òä Æ•ßKð†ô!¯×+4{=Ì@B2»ÉÕ«V«8;;y·Ûk×® Ôn0Ä¨Åh4ÂápÀjµbss7oÞ”´Q¥Raeen·^¯›››rCqÜk%„9Ë™P>'£p1‹ çÏy‚d*p“Ó$Õn·ãÁƒØÜÜ„R©ÄŸÿùŸcwwñx\@Zº¹Ýn‘Õ,è£T†^‰tãu82Îˆ’“?û³?ƒÙl–‚‘Ë¹Ì¬}¨(°ZÒ÷óûý²Îâñ¸LµÛíXYY‘45„Ïær8†Ïç»â@¿ÿÓþ˜L&0™L(‹Ÿ”F+++¨T*RË05a‡œÁ¢ët:•<Øív# ¡V«‰çGÔP¤·ŒL½þúë¸}û¶:‰Qð·¿¿/6ËœæÑï÷Ñl6¥ÓÏšÅ`0 _ñô£¢Õl6£ÝnË÷äìß7nH*Õh4Yâ¨ÕZ†r¹,§û1¼-hriµZÅq—(É¤ï;=yV«UlooË9zgg———Fò¼9.ÕëõâßøÂá0Þ}÷]S(Q¡=öææ&~úÓŸb±Xœ+ÎSÞØØzË`0ˆ¯Å½{÷P.—¡ÕjåæN¥RÂlw»Ýâ)Oòî›o¾‰@ Ë‹‹‡C¬]ËÃá°è´Íçs|üñÇ2³™Y †{÷îÁëõ ÷ñôôF<@¡P@¡P€V«•ÚŽ0;3›Í†o~ó›²ykµ¬V« á¼í“É$¼^¯8qU*$ að |ç;ß×ës!ÚƒÿOûƒé3Ùÿ@à“>™Åb‘“ V«É(š‚ØívádÑÅU£ÑH1ÈùLdp€œB¡ÀÖÖ– twîÜÆ3eÞ‘HDd’ÍÞ„Ñh`a>Ÿ‹Á?ƒ§ÓéÄv«T*ÁívKŠÐh4dáðtÕh48::B·ÛÅÚÚšÜ°årYÆŸòvæÉÄ[nssSÜfkµ´ZÈèù`kµš,¨f³)·2{DÜ<ô0h4(‹(•J’ŽÆb1„Ãa¬¬¬ Âh4bssS€`0(–ÕL·].—ÜRn·[Ð4öé0‹Åäû²¦"û�šÊXVAhý~?~÷w_ûÚ×àñx°¶¶†ÍÍM$“IhµZ±Œ#c¤\.# ÉÁÄvE“”ÖÐçîÝ»ø“?ù¬¯¯£Ýn#‰ yãÆ ifÓÑŠ>ûÝnWD¤lZß»wOØ[[[2mfÙÎ€Ïßn·£Z¢Z"ŸÏËaÊ²€ë—ëvyÔÓ/ÚÌ4¨”™LFNjr˜JqÊ;=û6›MI‡¡Òû½2”…sFQQ>‡Ãb±(‹Âår!‘”ÓWWWáóùp~~.-nN6Yg°ÐfŸƒ½+‚´†&§P(°¶¶†½½=q„eNÎ x<Ñb1 œMÅiív>ŸgggÈd2¢Âå¼*šÎÐœ¥ßïãàà@`a¶h<£Õj%ä ®®® 0ÀC…z*Ë#Ãô.‰ Ñh V«áòò?ýéOÅR› ‰ÍfÃîî.B¡òù<²Ù¬pü‚Á …ªÕªÔ‰ñxz½‡‡‡h·ÛhµZˆF£X,°ÛíâQ*•„¢¤R©„´Ì¾$×]Š···át:ñ…/|ï¿ÿ>Úí¶l`ŸˆD"2X}OöCÃá°¤Ú½^·nÝB6›EµZ…×ë†Ñh„ÙlF,“zh53:W©T ½^ï½?è Â6J¥‚Òçó¡Õj¡ÙlJ·»X,J±~çÎ¡™¤Ói‘4 I™¾â¤Þˆ‚¿gÏžá‡?ü!t:|>"‘ÎÎÎpyy §Ó)SÉ"áµl6›%E`Z7N1›Í Ñh°¹¹)´ö%\.—°¸):œÏçÂøv»Ýxã7 P(ž®V«â‹Á¥ ‡‡‡˜ÏçÈf³"AçxÔ\.'è!OM�¡PHü6šÍ¦Œý)•JB"e}I�‰øÚÚNOO1Éd°½½-N·§§§W†ì1McZH„‹ðu,ƒN§Ãþþ>Þ}÷]èõzƒAiK”ËeY¼¬'‰ÄòPËårxÿý÷ñïÿþïøøãÅ¥‰›o6›I=N»*‘Ûí¶l:²(\.>ÿùÏ‹6KV#•JáîÝ»rYCïúÁ` ŒhF£J¥Rê%ZàÑÀ”`Y@ét———2W› kª§Õ[4•rãWÙ\Ó&“ Êjµz…:ÃüÈÈÑÑ‘)ƒ}-")²Z"N¬LNÓ;wî`4áÑ£GˆD"2ö”¬ ·Ûd2‰n·‹ë×¯Ë&èv»RT/í¡x!›ÍŠÅ™F£Ëåðƒð*A ‹Å"º&ª}Ëå²¤wz½Gxƒô¤5óp8Äd2Ýn¾Ú|>'Y»Ý.3É|1ò[è›±µµ%-¢±t;28<<Äl6Ãµk×¤qúüùsäóyär91eo†VÛ4æ<>>†ÃáÀ½{÷D)×ë±X,pëÖ-Ìf3<þ¡PGÆÖÈév»(‹¸ÿ¾€ z½ûûû8==E"‘ÀÖÖ–¨†‰Øy½^d³YA$U*•|7ŽM"#Ÿ)^V“ÅÌt‹ ^‹Å">ˆ´XF°É¹dÉBÒðññ±x–”J%ŒF#1we[€ÙÑ²·äb±À×¿þu1Q%ô«îÅbñ‰† ´ƒƒI/ªÕª,ŠeêÏµk×dtùxD$Yè25"ÆÔ‡sª666°··‡z½ŽT*“É$H½ØØäUn6›±±±!jž’¬Êå²q4!ÊÈ›££#looË ãt:å»¯T*ù+ „B!¼óÎ;èõzxòä‰Ü²ì›1ãTG»Ý.¬tö &“ r¹"‘ˆL£$=Š‚u af¢•Óéûûûðz½p:²ˆ…‚4ó;vvv$ƒ³ÙGGGr"sü,[-LÍidêñx$ÅÇ( ˜L&ò]x#år9ôû}cwwWZ(³ÙLšÚìv:¡¤ ‡C¡¥•J%¡¦q!2I&“²†ø¾GGGÂŠÅb&žžÊš\~f„ã{½vwwe &AFƒl6{%´Î#-¯ÛíJ“Üëõ¢ßïËgìïïÃf³!ÿÊûCI›b¯×¯×‹b±(ˆ:»Ý.<?~-àìììÊ¤Äå¾=8ñƒïqyy ¿ß/5D"‘À;wý"‹y8Ê÷¡OÅ5 ñJ'½GV£P( R©ÀápàÆ’2,d³YñX'©9™LŠcae²ˆ@y<|üñÇRƒ‘AÁoõt:-§!§‘¥Aš§£x½^a¼,/¦EÁ`ÙlöÊðÆƒ}3KgšIà…éaäX,¿ß/z«`0(3‘ Òé´¸øòE=1Zþë¿þ:NPS¢¹ÙlVN}ÞâËÃÞ)]Ñh4’Êóö…Bp88::)Ë²Cñ£G Õj±»»·Û-ïÃÃœæ5“ÉDjíR©„‹‹iøÛl6ÑÖ‘¢ÑhàõzÇqãÆ D£Q˜L&É8Úí6²Ù,<Ï¯½?ÔL}hÅŽ~.— N·Û».²£»Ý.666$HF£Ož<¹Òä46g9Ac±XàæÍ›¸¸¸nÕ®:NÐ;žvüÌ7nÈcó5ãÁƒ888x•õK,ƒF£A8h>›ÍJ^}qqV+}1¦Š´ Ëd2(•JÐëõØØØ¸âdËÁ¤1 ™dB ¦˜ôF§±èh4’÷åÉ¹Ì¶`‰ †^¯a Ãá±>‹EžM§ÓÁöö¶‘Ëå²ô¹ ûý>Âá°*• ÉdÃáÛÛÛØßß¿’‰Ìçsi½îõz¥ôx<Ðjµxþü¹øÇollàþýû8::’[z4!•JI¯0QåÅb!ó–766$ÍnµZh·Û¸¸¸ÀÊÊŠÔBìi-?3Òôü~¿üVn¬z½ŽZ†@ p%TH“?ËAíÄ)®_¿ŽŸüä'èt:‚püùUö‡’¨?¬X,¢^¯Ãn·KMÃ>;ê„My’ŽÇc4 øýþ+'S4•J%iûZf³Â$“€Œæíä@6 œžžâéÓ§xë·pûöm¨T*œžž"£V«‰"÷•W^A³ÙDV“q<z½Ÿÿüç1›ÍÉd„fU(® ŠßùÎwä¤î÷û¨V«RóÑÒLV‹ÑµT”m×ÆX6ÂYO\\\È©½üÒétp¹\’nT*Ióþ§xP3Å˜ð¶h6›¸¼¼”–»Õj5šÍ¦@üÔÓ-³<(ì\,ØØØOFZQ'“IX,Ü½{W¨UgggWâ1qíÚ5a—,3H^yåL§S$“Iø|>Ìf3œžžJ <…wÊ´³Ë–×ÇèªT*Ù°T…ü²x°>å\l¶¨Ú.‹Bçä›_g(¯]»&(T·ÛE*•’æE~œÈøìÙ3ä…ÃaL§S¤Y°.ÿx¢€¤¹F¼òÊ+¢"V«R¼s$)›™$Åò¤âB'SºÙlÊúÕÕU™Ùí???‡ÇãÁÖÖ†Ã!ö÷÷a6›‘Ïç¥???G:–ÏaŽN§!"¤$¸ 1oá¦%û€Ï`0`ss«««RP/ÅTh,g~-¿ôz½0ê[‰ŽŽŽÏçÿÇxÏ´˜7!¬—ž<y"¾÷f³×®]C¯×C½^—aè|e£Ùe/&“ étZho$FÛív˜L&Äãñ+ñ €43Ö{F¼1œN§hÍ¨d ÂLñ(›Ö¬1—ÓE¦àÍfSnB¶†¶¶¶þ[<¸>©McVÁßS.—ñ³Ÿý«««rÈüºûCI\6³Ù,4ƒÁ ƒ§IybqHõg,Ã`0Àáá¡öø"4:›ÍP.—¥‘Ûjµp||ŒP($Œr ŽŽŽäÇòE6…ÏçÃ¿øEÌf3qFp»ÝøÒ—¾—Ë…ÓÓSlmmassS T¿ßgÏž¡Ñhˆ}—Ñh”[ŒµM¿ßG4•T€c_ ÙÅbR©¥R‰ë×¯õ‡{ggG¨8ü~ÍfSŒEV«ôÏ8_xù`"A 79âè—Åƒ½F yú§R)Ü¸qëëëò½©Xfm™H$¤¶[îv»]ìííÉâÞÛÛ“æ/¥T\d³YŸ–ãqvv†x<.¼}†¬£`0ˆÝÝ]Aü(-—ËÒ 8Â6ÑrºH2Ãƒ”:88€Ïçû¥ñ`MR©¤óx<˜N§(—Ëxíµ×¤ÕÍfíý¡ænãàîP($^r�ppp€7n ‘Hˆ%ø~¿/jÖ¯ýëxþüù•“ÊZ±p´ŒÉdÈxY—N§ås©>]&t’›ÈAãgggðx<(•J"ìõzÂçÛÛÛ“æ$óir"§Ó©Pv–OÃ/}éKWb¹P§Ó©ûÙÏ~†»wïâòò³Ù+++Ò'#•‰í“É$Ú(ŠS3™ŒP3™Ì•MFíÁ–û÷ï£R©È ó_¯»Ý.’Éä•l‚,ŒýèGðx<ø‹¿øéÕí#·ðÓ„[Ž6â¼d¿ß/ršB¡ 4;ZÉ]^^"‹Ó¾µµ5!•ófˆSb8àB¡Pàþýûxüø±¬Çét*¶Ô=òFdí8™LN§¡Õjño}K¼BR©Ô•x°Í6@:ò@4E±X„Ãá€Ïç•D.—ûö‡²Ñh N‹›Q"‘€Ùl†Ãá~Z*•’ü•BÊB¡ ©Ä`0@³ÙÄÚÚÚ•šŒ©âÞÞšÍ&´Z-l6îÜ¹#Ã°s¹œðçó9R©”�ËiË`0¦§&^¿~]]3™�¶··±³³#f/<J¥nÝº%Á©T*H&“òì#ùý~¸ÝnD"Ñy1…¥Ó’Ãá¸ÒßJ¥R¸¸¸Àl6C6›E"‘º-)Pìélll •J]©S˜F‘¼¼¼ÄÉÉ ¬Vërô/ŠG>Ÿ—›gù”§D4g§½½=iÎZV\»vM”Á”øj·ÛrÐÄb1Ü¸q?úÑL&‘ÉdÍfà¢ü…sÃ¼^/Ö××±¹¹yÅ.€ƒ:TAd³Y¬a±X`ggG¦g’^W¯×‘ÏçÅ‡9]d©P($Åfl–E»dïS!°··‡½½=”Ëe<þ\ìÜšÍ&NOOQ¯×ãý¡ÜÜÜŸÃá@¡PÀl6ÊÊîî.Âá0¢Ñ(|>Ÿì~Ne¤áH0¼rR-l�ŠÅ"~ðƒ�� …ÖÖÖ°±±[·na8âñãÇBy:99¹lææwîÜ‘<š ßJ¥‚íímapVç÷j4q)â€ºR©„½½=¡ÉÐ×òw¦[„çé£Á‘«ì©ñ&[„MoƒÁ |Èv» §Ó‰ÕÕU™ˆrëÖ-Pn·Û%•á3³ÙlÐëõ°X,²ˆS©šÍ&nÝºu%½^©T *• '''âu²|[î¿wïúý>¶¶¶J¥ðOÿôOÒzˆÅbâ¸¼x™>F"Ôëu|÷»ßß”@ €V«%ÈaµZE*•ºYùOŸ>[®ZÐÆâèèü±ÔÕl•ôz=É.ØD_Feys/$œNãóù`0P*•¤ Â‚?Æññ1Êå²XÂ9N„B!ißüßØj·Û×_{{{úàE"™ÙDp•J%ƒØí¾ÿ¾8ú,çôlÔíììÈ¿?==•Ñ£„QYèÿä'?Áññ1.//¯œÄìU)•JüÝßýòù<ÎÏÏ‹ÅP©Tpyy)€›ÉdÂ;w°²²"Sz`áÁ˜\´ßû½ßC$A ÀóçÏ±½½-`�9…$ƒîíí!àââ6›Mê¾Yõ4éaÀ—O`Jb–{‹FÈ*• _ýêW…º½½-ua4òßÿ}œŸŸ_I³ }þóŸÇ‡~ˆ¯|å+¸ÿ>šÍ&ÎÏÏqqq!VjD&—ãÇ™eôÅ BúéÓ§"¥aëv»1ðäÉ¹¡™MðöàáI ˆ[8±ÎÎÎ„¾¦ÑhP,±µµ%ƒû–y¦Ô+N§Sá·~ë·¤n&!¹×ëÁl6‹•µoäd’ƒ‰DDÇ¹Ï¿éþPw»]iÄºÝnÒ‡¦4©TJè>jµét»»»P*•ø×ýWÄb11ç_²V«ÅÏ~ö3˜Íf|éK__‡G ª¨ÑhÄ3ƒ|<Âf³‰ì# R‹ÅËåpvv&ý*ÇƒD"!'e¡P> y”œ#Ì[ŒßÓjµ"`0àüü\¬"‘r¹œÔ”‰D¯½öšÈ83™t*ÒÌh°É†&‰ÆVKÒ ³ÙŒL&s%Å&ÐB/‘z½‹Å›Í†Á` NOÉdRdô“Éûûû{óE6y¿ßÇéé)þê¯þ Íf?þñÑívñöÛo³ÿôôÍfó jÇø)\__Çåå%NOO¥õÀZ•‡èòMÅ ÄZo™AÁf0oŽ|>Ç›Í†>úf³Yüé¹c±˜¸Z-?3Ê³¸ñ˜:Ïf3µD‹À[:F*•’¿±³³#Þ’ìÙrâo²?Ô¼n)<Fb–ÂJ¹\¾b&ât:áñxÐl6Q*•àñxÄpeùE§ZjÁÈí+ H$RR¯³|:q�Á²/‰`G~P·ÛÅÊÊŠèšhj³Œn>yòN§7oÞÄþþ>åÁÑ:Œ‹+"NÃëõ Á€òÄ‡0Âh¿~ýºlb2U8�µ�Ó\ZËQ.Do“å]¤X–Ëe‘Y(•J XVqâB …(šÚXVT«U$“I|å+_AµZÅÿù?ÿGäz’y¿Ìø àb±Xpxx((){ˆtcìI[¶àÿ2]d å÷û¯ØK0ýe”ýÍjµ*©éåå¥Ô¬Ë/Nz¹¼¼Äõë×ÅA*•J¡ÓéÈ÷#Ð’ÏçeÓ³¥aµZáp8„0@äù7Ýj$›ÍJqIò-eÞ”·sÇSR>±²²‚••$‰+ÖøbÎ¾ººŠv»ÓÓS‘•ÐzëÓþjµ@@ÆýÜ¿ßùÎwP.—åôyüø1>ûÙÏ »áÚµk8??½k'ª¶Éãã ÄáñxwïÞ•ïÁô‹°ð²)ŠÕjåu½^Çúúº¤|TýR:Ab)Õœöa·Û%0¿ÈÛƒñX[[ …†§¼9éVVñôéS\y—Ë…`0ˆ@ �»ÝŽoûÛèõz(‹899Íf³Î„ŽÇãW6g#¯¬¬È;NñÆo X,Šø•Eÿl6C0D§ÓÁx<– Búo%n`ZPºÂM¿³³ƒçÏŸw’¾õl{,›:-³dˆŽF#ñ!mkÙ_d9=çaÎÍÍõÛï÷áóùpyyùï5{1šÍü´R©\Ü±xäè‹‹i–ËeL—<Ù™LF¨E<¥>ý°X§Äb1!y¾óÎ;¸}û6NOOát:ñ¹Ï}ßûÞ÷D¨HnQ3*«kµÅZŽ~¹\–¡ÝL©t:¶··Å²ž„î9a„¹ør:DfÁêêªØYºg;ƒü¾ÍÍMQ~ói? ópÔì`0€R©ÄÉÉ‰¸óv»]ôû}I{i…Àöh4 Fƒ?ú£?ú„C§Vãý÷ßG©T” [ö.)ñàT(àt:qíÚ5ìîî dÿýï¸}û6Þ{ï=ñwd£ž�“Åb}ëoúxF#¡N§›Í&Ýjµ*h%‘ÜN§#³Ÿ—7OF™Z³œš.±Ù®àå÷žL&xe³Y„B!üßØjœÐv$AVÃêê*†Ã¡xA«vtt$b>½^/1AŒåS‚Å?5I\MÂ0sýe^£ÑˆP(„·ß~÷îÝ“¹¾¾ŽT*…üàB²e h7@û3×¯½öæó9úý¾<øåF&9pkkkÂE¬T*’JFÜ½{™LÅbñŠ-¹ÍfC<Ý×ññ±˜ö0˜Ïç(‹ÂvÉçóðù|¢îV«Õøàƒ®Ô*¬ÉÈ“T«Õxòä‰h 8M’òšå°X,†x<“É„/~ñ‹Â`/‹Ò¬w»Ý°Ùl¸¸¸Ù¾×ëýoé"Ä …þöoÿNGê§B¡€Ñh„?þã?Æp8”´Z¯×KíI¿G:Ÿ!—ËáââápXâV«…·ÞzƒÁ�[[[Øßß—øòwa“<þüJª¨P(„äëõzqrr‚h4ŠN§s%í£ºšœUÖ~ñx\tuõz]ÔÝÝnWÔ¿îþP–äµ9Ç¥'A×Ør¹•J%j\.NûX6ž\þñÅb¯¾ú*Âá0nß¯–&�� IDAT¾étŠGÉàÿøÇ¢\žL&XYYÁüÁ ªöê«¯JšDuíêêªþ·Z-!»ŽF#lmm! a6›!™L"ŸÏÃjµ"•J]éq@^,“áuÝJÙ>{läÑQ¤JR±XÄÙÙ™Ácó™T 6j9c+•JI¾NÁà§)Bd}8Q“yÀCŒMf…B! nzgºÝn¼ýöÛðx<‡Ãè÷û¢1£â—Œ‹Å‚D"¯×+úåC’é¢×ëÆÌo¼@ |M4ívétZ4bOÞ¸q{{{x÷Ýw‘L&…3Øï÷EþÔét`2™DûÅþ']†Ãa,©å?Í]díùúë¯ãÁƒ’5ðÙQû×ívQ.—Q«Õppp ZC¶Š�àääDÌ}˜ùüÚûƒ„à™¿rî/;õ$„r’ ÙçdqP†¾|º¢5™LBÁùÆ7¾ ŸÏãââ·oßÆÑÑ "‘¶¶¶ðÏÿüÏbÖòÚk¯áììÉdRš€‘HOŸ>ŠõW+++÷’Çæõz¥®zòäÉ£ <)Ž,•J8??¿"6eÚÈ›ƒ·>ÿ™ô7ÞxCÜ±Xøó&bnyJ ½E–©cË2ÊDŽežý<È¤™N§R¤ƒA1+b¯‹Òétâðð———0›Í¢Ã#âóùD·|H’SÈÚëöíÛøìg?‹b±ˆóós‰G4•1K¸>þp:’BôÑGâ§È>×l6ÃG}‹Å‚ñx,uk\Þ<�€çÏŸË�ùet‘1& u43(–&óù\�²ápˆÍÍM”ËeÜºuKRQ¦³üÿ¿éþP“Ä»ì=žH$®8Q&Ïi‚$¶Ò#‘éÚòDæ»„¾™k3ƒ¢Cóx<ÂõbÁúà‡?ü¡äõù|ÿò/ÿ"´£ƒƒ8Ü½{ÑhT S‚cqNOO¯˜x²QKGZš�‘rEq&óxJ)8„·¬Á`q=Ëu&å0³Ùn·[Ná½½=iz//’åúb™Áð7ó7ØßßÇ÷¿ÿ}looËˆ£¯|å+âFT“uH0D2™„Á`@¡P2‰HàÉ°§X–àÍ2]‰Äh4Â;wññÇ‹MœÉdÂÉÉ ?~,-Š>úN§×¯_—»V«I¯Œ5æT*u…©â÷û1ŸÏRO$â±ÉóòM6¥eÃì€1ãÉxUòøñcÇ8¤ƒSs‚Á ŽŽŽ’ÿMö‡šì�úƒh·Û˜L&²H:r¹œ°)R©”(K}>Ÿ°+–ƒ¤×ë…SF X,ŠE×l6“éö‰D+++ÂuËår²èÊûþûï¨ÛíâöíÛ0™Lâ7o±Xp~~.'R>ŸG"‘@6›½Ro®3„ŠåóùP«ÕD`j·ÛÑn·áv»¥%@_½Z§Ó)è%½þ írr ‘/§Ó)DgÒ(åù4]©Tpýúué÷üõ_ÿµÊS(ˆF£b�JD.•JIKçä‹‹¤Óilllu*“ÉHL ÖÐ\v¦ÔŸñ(•JR§ñ;>~üf³ÛÛÛèt:ØÝÝ•xð÷x<KÂ~&“ nÜ¸!Ên >ŸétZ@,ö5].ž>}z…ô@^+¹L º]^^Ân·‹·?g5°ßåt:dy°X,‡¥¶üMö‡: ›Í »¡X,â3Ÿù’É¤äç×®]çY^rpª_t“qÁìîîÂd2É¬^zø-ç¯øMÊÔb±@:F(’ÓÔl6ceeEÐ¦eÿs !«Õªè÷ûˆÅb8??G2™£¦n@@,íŒF£¤UG<™rµZOF“þºÏç^ÐÎí·û·ú5™L’š’˜|~~•J¯×+sÃ¨À^®ùÌ•J%ño}K¸xjµ¯¼ò ’É¤¬é‡á÷û…ÅÂÙ\´WcÚÅÑ¬¼)³Ù¬X#}Ú®›Ï–õ7u‡œ³LíÓjº(—J%!7Óä‡™¤^~'Xä4Òº`_HF£<ßgÏžý7ôÖÖæó¹hÜÖ××Eâ¤×ëq~~~åséµ‡¥ÇÈç•J¥„:F£_w¨¹k94W -½®]»&·MµZÅÚÚ¢Ñ(2™ŒðÀ8³‰Þ{|Ñä…óÏø y’ü?íYSÛé™öobÐŠ$$@ƒñ†ín·S§&NW¥jªf¦æd²U–“|¾A*‡ù"ÉA*©¤;®ôô¤Ûv³X€¬]BBBìzÞù]%œdÞtú=¢ðQ¯¶Ðóÿ?ÏýÜ÷uý.jbæ?´¬‡ÍÏÏ["‘°_ýêW¶¼¼lóóóHrÒ<xð@ €ÁÁA‹ÅblkkK´\š½Jˆ±±1‹Åböo}KyX»»»¶°° ²/âÙýý}å#ã,Îd2öÁØññ±Ý¿_T&8¨âý~¿åóyËårj2°yP¢y<žKÚÅ^ÈL2™´þç¶T*¥—vyyÙö÷÷e'c{{ûRWN!Z¾N§cårÙÆÇÇÙl*‡ÍëõÚþþ¾ÊžÞ2ÕÄÄ„»¨)( ¶··g•JÅ>|hfvi=ü~¿Æð;Øx|>ŸÆ‘HDšÑ££#Ù˜ü®á¤zÓ´‰¨wyyYœM QlÅPÝ‡B!EI=}úT´+”úT _õýpüøÇ?^Íçó—r¶À¯Ÿ<??××ívkž€‘¯7¥cssÓ*•ŠJ2x˜ á!|þùç¢,Q§»\.«ÕjÖl6UrÀÊp:ªÉ)Ý8(8qÀ,sÇZ__×‹×××g·nÝ²`0hï¾û®vjÜ™¸OÂ…ðûý …¬ÝnÛöö¶Œ§§§§F5˜¦arpp`ýýýV©T”2sttd@@PVRlP´›™¹ÝnÍq€-..ZVS‰IJåÚÚš,xï^¡½£Ôååð ŒˆÐF2“OOO5®à¡t:å,//ë4±íím9Ä‡‡‡¥Æè]F£a‘HÄÜn·½zõÊŠÅ¢N´ÑÑQ[ZZ²ÙÙYëv»öèÑ#U3ÀOéðöÎ³Ùì%i!8ñŸ<ybûûûânð{öFæ’A‹ÅBÂ’D4²¾¯ú~ô_\\X<·ÙÙYÕ«Ü›@I…g€Œ§¿¿_œ‡^ûwïNÈŒÈšƒƒûÓŸþd‡CZD`ÂäöîîîÊ¸GˆD±XÔŽLøƒYvræ=^¯W°IÊ( 0?üá¥tçGý€DlooÏ²Ù¬ºž###š¯pŸ ”Â¶3m_Î\.§MpM/û‚FÐìì¬år9^ÙØH¨ šÍ¦Õj5«Õj—8‘è9�2j4’sŠ}ùò¥9ŽK0˜Þî"ëN×–¦D>Ÿ×fãv»56ù[ëö ·ÒÙÜÜ´f³iËËËš±ñÒÐlà3ãà&ƒ¬÷Nî±®y4àÝ ü¢Ú€Â¨àððPò1bj¿êûÑŸN§eÁ =…¥!‡mnnN"–mNZÊLÝ{ÂÞ›¦Ói5.€bÞ¾}ÛÂá°:@xŒFFFlmmÍJ¥’ýö·¿ÕÎ�ŠŒ¡",F”„HàSë»\.k·Û–H$. ¢{[¶˜ý¸Çäóy+•Jvrrb›››2B &L{ ‰DdˆÅÊ–ú¿·TäÄ!–•õ@ÝM) …*×ëb%ˆ¦Ä¬n||ÜÆÇÇÑh¨s:22¢î"âçÅÅE•÷üB5??oñxÜ&''í£>²õõuÛØØ\hppÐjµšÖƒ\jÖƒTP^ÜÞ¸Ñï~÷;EYMMM™×ë•A—áX¼Þ_N§Sw9þ=(žÃ`0hù|^ Öƒ,ìb±x Ýpvvfÿ?ÞvÞW¯^i—&Êív[,ÓîóùÔaCPÊüÀétÊÌØûƒ³±¸$h”J%í(N§S`Ô±±1iÔÎÎÎ,ÛÙÙ™•J%ÕÄ”Ä™Ò‰k·ÛºÄ·Z-5$(_Ù#‘ˆÍÎÎ §Ì†ZÃívkþ·¿¿oápØÖ××ÍétÚ½{÷dÎ„`Ûn·•2I3ÀëõÚÔÔ”(K Šò"râ¿ùkssSJ·Ûmù|ÞÂá° ÿ¯õàI&“"CE"1JºÝ®0ÝtÏÞtÓlBAö6/{¡P°ééi½œ¨aÊå²Ý½{×Tbñàõ6Å°ñ‡B! ™Ýn·†Ê”áÌ¹`N}Ó´‰^pppÐ^¾|)[ ùx<n333 áâHrHÀ8_õýèïïï—@@ YÍVKlXt°ë;<<ÔîòòåË¿xX&''mhhHísvev@†®ápØ?~,Åˆ1î´„ñ¥Ói¡¡ÿéŸþI{\×\º\.»}û¶}ó›ß´¡¡!H0÷¢K @åùóçbRæb~zzj{{{*ƒr¹œLƒÇÇÇJ¼ä¡$âçÁVÿ¦zž]¸ZÚÄÄ„ÍÍÍé.ð÷®ÇÇ¬c,“¼ŒÓ”;ÃùÞSŸr”Mà†ááa‹Åb2òàÎÍÍÙ³gÏd½g=p·³¡pÄãñK¹jµZMsSFœâ7¾Ù`ã;ÝÝÝµÓÓSe¤™™e2)YH”‹S`hhÈ\.—šEÄ1OüªïG?“{†”<ÐešäºO”s@@¾)‡ÃaÕjÕ)ôfpœÇã‘6è ZB.Ë�O�™ðÅ°ÃÌÌÌØÈÈˆíììÈ"€e<×ƒH„k¯}†¹cËËË²ÚPd2 YªÎÍÍ©Y188h>ŸÏ€Œ§œLVËb±˜† ëëëò°Q~ÑÎ³{÷îi¦Ó{z0T><<´Ç›Óé´z½.Ç.˜7×N"<6‚½½==Hx¹Ó°› =½•Èéé©mllèŸ3À¦Œs8šsmmmÙáá¡Pñx\0ÑÞö=Ï†ËåX––;Š÷óósÉ´z×˜RïÝŸ± ˜AHb„òðÛÙÙ•Šþ�³Z·Ûm+++šâOû*ïëÑ?;;k[[[æt:-‹i·Åb–L&ÕR/•JÂjÑí"ûÉ›6Ôì´¾IsAèÙè§ƒ599i‘HDÌ<”Á`Pª"l+•ŠvlÇc[[[Öh44: áÁé477§ShrrR¾ RVÚí¶Íü·”P(Í™ót»] {ùË_ênùÙgŸY©T2§Ó©Ÿóüü\.m.Ï½s20i³³³’nÍÎÎÚææ¦Z__Ÿ•J%ÜÉnÇk‡ª‚4¸NG%Z$Ñ¬¨P(\’+áóûýò3óÊår–L&5ô†çQ©T$4ðûý’U“ë½N0òƒjß‡B!¡¿éNCñe{Sô@W‘n/–\Ð¥RIÅ/^È×È½½ÛíJÈ€§ŒÍý}?z×£Œ6í`EÍfÓnÜ¸!hãÍ›7Íív[6›µl6k>ŸOe.dù½¿Pà£‚ïÇ ;;ÆÉ`0h>ŸÏ\.—°c”(wîÜ1§Ói}ô‘vóããc[XX°n·k¯^½RÐ@žÞÝÎívÛüÇ˜Ëå²7nX©TÚ›M³Ù¼Ôbž7>>n¯_¿V{†óš½½=™)£Ñ¨²¡d}öÙg2.,,Øøø¸ýñ@³·YD÷æ·Ûµl6k¡PH;øÂÂ‚<^(8z!±”2Ìuô]Äz´Z-k·Ûz1z…·l€”î¬›êÒÒ’œœX:õybbBÐÙ-Å`õ"ØØŒ¹#“F‰ˆ’‚çn?X+½¿xø!G§R)K¥RRœüùÏÖ‰åv»UØòò²MMMÙŸÿügUŒ6þÑ÷£w=`ÞÑmÁÔH4vì"½š°z½n.—Ë’É¤µZ-K$2U²H~¿_¥b/Ñ‚R__ŸE£QQ_Ab³Œ©u\.—ÛíÊbÂÃ‰ÑëõZ2™´t:métúñ Õîî®•ËeµéÏÏÏ-JÝl6e’d8‹öääD TÒAã€¾µµeÃÃÃ²ƒ`‘Á$é÷û-›ÍÚÎÎŽ -Jï%ž».É0X*âñ¸fZ”J¼d5ûý~Ù<<år9´7n\Šx¢B@Ñ+=ë·Õj–H$¬¿¿ß²Ù¬:y¢T¥R)óûýq€:Ïd2J²U÷š\�o8âÂòupp qL.—»ôÑ½½yó¦¼w¬ ê½zUÌ”gggòmË8 ^¯k~÷eß7×c ‹ÙgŸ}f‡‡‡ …ìáÃ‡–H$„Ñ¢”á®@Ë·ëþðÍ¯zUÔô}}}Òye³Y8¢ÉÛš˜˜PûøèèÈîÝ»g©TÊŠÅ¢MOO[¹\V§,r>Ÿ7§Ó©Å£>N¥R—fO”–¥RIò™?üPô½{÷TwS.î€l«× “H$¤�yÓ6ƒÄgjjÊ666Ô ‡ÃÒ f³Y{ñâÅ_@:qjg2±™™s»ÝöâÅu7éàú|>ƒ¢bqÇèÈ]T@/½¦jú—/_Z©TºtcýèÇãqk4–ËåÔÐˆF£RÏ3·Tî6á|kkk²!õ~_$UÆb1Ù_¶··"„Âápˆ¸½½-Fïïåt:X,*•'›Í^zIãñ¸}ñÅ*Açææ”8va||\ž³¥¥%k·Ûö¼D{±Ž[·n ÙÂÂ‚ŒŒX¥R±ÝÝ]Ío˜}y<ÛÜÜ”>+•JY©T²µµ5ÛØØ¸ôÀÑ!óx<²i�ËÅÀ–/w †€Ì0Pàƒ¢ì!yü,Œt:ý‹‰D´Ðh4”Cˆ!wF~Næ]ü.—ËööölßþøÇ?Z2™¼T®€#ácxxXFIû ÏÏÏíùóçöêÕ«¿Øgx<¥—¼xñÂ^¼x¡qï™™+‹¢ë ²p8¬!.ÆS,ŒHI¥RöñÇÿ5¥\ 0Çcù|^ó*Æ+4@òù¼Z„³Ù¬ýéOÒÙ+kC|Ôu$ºZJqr0—ËÙÚÚÚ%W;ê:z|xÈèXEËŸ '�êþª¯V«e;;;öeÞÔ=ù|^ë1@§fvvVü§OŸênïýøøØâñ¸°}}}¶¾¾.–n·k£££Z|èTGGGJ$ ‡ÃÖjµleeEI“ÐiA—J%›žž‘™æHßñxÜ^¼xa_ûÚ×¤ ¨ÕjæñxtBòbÞºuëR¶u¹\ž€Y »'‚h4*åÿþþ¾Œxœ¨4`’`ù¨V«mggG³¼MÌjh¢°À‡Ã¦¦¦ÌãñØ“'OdÏùÏÿüOûä“OÅåeeE6Ô6©TÊB¡6‰b±x oÆÅû9ÖR¿àS‹F£ìîîÚ[o½¥Nr¿-//[4MÌ^¹\VìÒÙÙ™MLLˆ‡áñxô¼„Ãaóz½699©—ŒT¡L&c·oß–¢(•J]8ÓÈà4"ó€ö‡jäCC…® b‚l6+d›†ÌT*¥´Ò/ó~°™òYR©”9~úÓŸ®NLLØÇl‡CmmŽÞ`0(é’'¾¨jµª{§–ÇãQª&;<÷““Eðt»]«V«¶°° ™öjèÑÑQiÿ0-F"‘K0ö/..ì·Þ²b±(‰N,³±±1]èévñ°‚ï^\\T›øõë×xCf£9@®ðÔÔ”Pe$¢„B!)_¿~&w„Ÿüä'Ößßo‰DBJ<aÇîÜ¹cÑhÔ~ûÛßZ¿½ýöÛÖn·õ²¬¬¬(zŠÝ–}ã„Zfƒƒƒò¡AÎ¢•ÍŠ‘ Þ-¿ß¯õdÈÊð4ú×¾ö5Ëçóöøñc›žžVç´R©ˆÜ8Ám<·ññqÍ(q;ÐçDàž)znnNG*#6z·Û4¿ßo…BAÝãZfËËË¶¼¼lÕjUód3 i˜Œ•Tâ ·ïûÙÔëõjß÷‹_ü¢ûêÕ+»ÿ¾u»]kµZVVUbÌÎÎÚúúºÛÝ»w5/•JJ©CM×®X,*Éáp¨)À„ppP`¯ýëÒ3öÆÿð×Ìe¸§ôv´îÝ»gwïÞµv»m›››–Ëå,‰È,Ç‰Gâˆßïƒ5—Zfëëë©p÷b¿:Î%ËG»Ý–ŽŽïÎëõÚÌÌŒD»Ç5 {çw¬ÑhèÎ‚ú¡ôÛo¿mëëë¶½½mo¿ý¶”(Ü³ÆÆÆleeEiš·oßÖ:0€…q˜ÉdÄ§„hËX¥ Í’ÃÃÃöðáCÝÃ8e9‰è*âñŠÅböèÑ#{ùò¥ýæ7¿I·V«Ùöö¶º4ËEPix½^1&Ýn·>³×ëµÁÁA•t{{{:Aéüö–ß$µ’˜‰î±V«™×ëµÅÅEÑ¾FGGíóÏ?·\.gvxx(|Ò¾³³3¶••{ùò¥}™÷ƒÆ§ùÅÅ…9nß¾½Úét4`ˆFc‚Á%ìz�˜$\°3¼õÖ[v÷î]»¸¸°¥¥%»sçŽår9ã8]ŽŽŽlkkË<<:årYÁ {{{ÇÕ¤”›™™Ñ<effÆB¡ÍÌÌÈ‡Öl6í½÷ÞSp¡qC¡U*‚‘.±‹Ó@€›Á)€„Š’êæÍ›633#.ÉÓ§O5lµùùyûôÓOmhhÈæææÔBôè‘À3FÃfgg¥Ø²ýèG–N§bqûöm úyH›Í¦J¬ññqËd2V(´V(1ŠÅ¢E£QÍœ‚Á …Ãa{ýúµ0kóûNOOÛ£Gtr3to6›¶²²"û eMI¹‰|jµZöôéSEüžœœØÃ‡ÕjÙÌÌŒ$lÌM‘.õŠðý£ñz½ºÌÏÏÛðð°-//[0”!ôÑ£Gê�¢bÇ·»»kóóó: È,çE=::²÷ßß666twþ2ïŽ{ÖÃñôéÓÕgÏžIÝ€°ÐMµZÕ?CU©TÄ$8›»Ëå²ùùy«×ëR-³+˜6::ªÿŸÎ$w˜€t˜ñp"Ü¸qÃnÝº¥€üM@@'^¯)[½^O¤V«©3È)·±±!æßÙÙ™¼QívÛ²Ù¬E£Q×—ÌŒn2™´n·« n2¹Z–½xñBA05z-Bæñxl{{[w¨o|ãj#3ÔäÏK§ÓV«Õ¬T*iÀÎz èe‰¸\.‹Çãš…Ñ-…nŒõ( É€Êc§Ó±h4* Ûµµ5iA™‡Öj5iTQªà)„\¯×íõë×Z"— K%“IQ‚ |À·—Ïçm~~^ee&“Ñà;Z&“±-©/À‡CŸB"Ç‚a8ìDL£¹\Nø…/ó~ôÚi$ÖøÙÏ~Ö…qçóù¤ßZ\\”w D±×ëUn–ÏçSÍÉ»A©TR#„Z¹\¶¥¥%Ûßß×‡K6z?ðqp4àÁSRÙ*‹–Éd¤Š@kÈ]ä“O>‘WŒÏ…ä†Ùð>; Õ‹‹‹Åbr.OOOÛÑÑ‘”åøˆ°%ìÓéØþþ¾ƒA‘ª@•ÑU}çwìââÂö÷÷u!¥“ÙÐää¤ÿ½ÙØKKKò5‘ái¿„-îR4~þÚzT*»yó¦5›MJyáäÞ»œô˜Ri&0s8š}"Øm·Ûöé§ŸÚ»ï¾«{Ûÿ¶˜1‘â@/•Jò÷Ä|Á8 ™m=¸~0°>>>¶Ç[7==mÝn÷¯®Ç?ò~ô®‡ãÉ“'«üM¹\¶ÃÃCåf¡ºFÝqtt¤K"`âRÛí¶ìú¹\Îîß¿¯Ë*ô&äÿP‘Úí¶0Ù^¯W¤')e1ÀÕëuI”B¡Bé¡¨xöì™ [6›•âbppP‹†M¦7ëøø¸% Qˆé^ÑiŠF£¶»»kív[§®Ïç“‰!,I0Ø<’É¤Åãqóù|öêÕ+»uë–.ô€e(ÅQƒ€³kµZÇ…F@Q©T„sèS`LÌçóöàÁƒK˜pdeÃÃÃ²Ö åãžŠ•a:P$²˜Q¹ ¤§‰‚5É³gÏlddäïZéàÜn·Ö·2°ßïWb£‰¿µccc6::*$Öë×¯õŒommÙòòò% ª/û~ô®‡ã?øÁêÚÚšáæççÕ™ …B²œ÷Ö˜øjðQkÎ:==µX,¦öf«ÕÒ‹‚ÎÃâ^·0¡z¢¸tú|>Í>°VÐ%üàƒÔCkÈðüZ¥R•ùRµZU{˜[NeþÝÄÄ„J .Û|”a4isÊY4UøßÍ›7mmmÍ¦§§m}}Ý|>ŸTù‘HÄÖÖÖTÎýõh4Ò>b¶d=è�³Œ-€ïÐðøßÖƒv>.3Ì^êoïz ¥ùÓív¿òz€`„SçW]z‹‹‹¶¾¾®õðûýj¸°_öýè]Çw¿ûÝUÂ‰maaAG4júJ¥b‡‡‡ †cŽˆÙ5/AÖ¨“3™ŒMMM©•ÇÍårÙÚÚšëÈ200 »\¿$Wù|Þ"‘ˆ2±ˆ2=99‘à“ ¯¤%üD½ßÕ8ÀÞ�øââB-|JšL&cwîÜ±óós5-@°£Á„÷x<¶¼¼lµZMß•Ëå²Ï?ÿ\vy†Ù×ëquÖÃ199¹ŠQìàà ÂÀ}>ŸôrÝn×~ýë_K~Ã.¨™Æ��ÕIDATÐÍëõŠîK‡…úždLZ»dôâqBõžN§U6ré$B”Å¤nO¥R:žéƒAk6› xcøMH]<Ø‚½¡ñØ€s2sAÉ.ˆyx×jµªpAÔÌ©PŒ¦ Úš…R©d»»»æp8ìÙ³g¶¶¶¦Ü³ëõ¸:ëáøÆ7¾±zpp`7oÞà‘#–äp^VKR§ÅÅEé™± Qr¹\R«ß¸qÃ¼^¯Ž\”äyÑ=±‰‰ ‰‚Ùˆ‚©NšQ¿ÝºuK^ µµ5 A³Ù¬þß™™]¦=æ^½æ>\ÙápXêï³³3•’�K{ñ¸[Âqìt:–ËålqqÑnÞ¼i}ô‘Ô/[[[º˜'“I«T*6;;k>ŸÏ>ùäá®×ãj‡ã»ßýîj/”|0´ééiùØ ;ŽÍÏÏ[__ŸKõ^™>Lò´¦¢¦ÀÆÿ‰‹ÿáá¡¾,À$0ïP6›M)E- ’f%“I«Õj‰Dìøøø’¶òòñ›¹ÃÔøÐ`ý~¿2€{Cé€_â$@–lggGƒÐjµjñxÜ&&&ì¿þë¿ìèèÈâñ¸4tç°Á\¯ÇÕYÇw¾óUZäänÁt§LÀJ¢ÑhX©T’‚–<mãh4ª!2Ð˜óós &i§riDŠ‹È&3‡D"a“““Â~¡_Ößß/µb…BÁ<…B!ÛÚÚÒ°›’ÈétZ8 ˜ø%,9\ŽQîw:YHÐjRæÐCU±´´$ÅVˆããc»sçŽõõõY*•(ÆëõZµZ•ŸÌçó)âz=®Îz8Þ}÷ÝU—Ë%\P”+—ËV«Õ,šÇã±ýý}¹>‘¢ Èår Å]«ÕäÇ¡³„ÝÝ¶CZˆºLóù¼ÍÍÍÙÌÌŒJ$[•JÅ¶··íÆâ‚`íGØº³³£ðt´et¥ÊY8V}Ïð¼ÓéHUÍ”ŸîW4µv»NXî±±1ÛÞÞÖ]¤¿¿ßÆÇÇíððPˆ¸¡¡!\àgU‡-åz=®Îz8ž>}ºê÷ûUcÖëuiÜ˜O9NÛØØ°ƒƒ!Ô˜“¸Ýn)’<x`FC–ˆ@ ù†Ëå’æëõë×*(-H(Ä‰«š�6¬”5H”�s†B!]Jiõv:óz½!@/"— &$—j4ˆqKïííY(Òî>00 {@¯8õôôT¿7_2–J5Ç£Yäb†»ããã ’»^«³Žÿ÷_×ë’ÓRÙË4$g7‹©Ì˜žž¶Ï>ûÌFFF,HlI}Mö1ÆGšÔøÁ`PÙYÌ'P5cã€¥xrr"z®Ûí–¤ˆ�.£¨¨÷öö,‹ÉÍŠÀJ1Ÿ› j‡b±hÙlÖÊå²ÍÍÍÉ²¿ýd±X‚®¤,Z×£££æt:¥&èÍQÛÃr¼^«³Žý×]å>??×Àb¤ÓiÙB�…P·Ã«p»Ý644d…BÁFGGíààÀb±˜h=gggŠ6eC;4^¢HŠÎð™ …‚Õëu›™™‘L†¬âF£aÇÇÇFE=Bƒ·´´¤äÏD"!f<DXìÌƒ …‚:j8²…‚% ‡Ã:0)`Ž‰ÈÎÔÔ”¢w°Ë0Ó¡TøBiv½Wk=÷ïß_%k‹mKÄ¿ÀO‚Á D®|ÙÁ`P0.ÁhQ#3/AÀÔVØmÒY„ÁFÊƒð –lß€RQòJµOŒ(XõtÞH*¶ƒƒËd2—¢…`Œt:u§¶¶¶Œa‘^% ;99‘=õh5PoårYpQ²ÉdÒ®×ãj‡ãÛßþö*_äôô´Š_|ñ…ƒAAbp53Ü#§ !m§Ó±¹¹9e"ïììHŽƒ¥‚9G4pS"f¨¯wwwåµj·ÛšÙ@xeGÆÙn·•Ë¼¶¶fff³³³ªÃ‹òåc3aÇìv»—òœ>æóyµ—Q>…O‹¼/ÏÌ¬P(X$ÑƒË}¨Ûí*õ£ÕjY«Õ’Ï˜ ì‹ëõ¸:ëáxÿý÷W1!âP˜˜!µ<‹‹ÅÌáp(/Ü�¾œíím”cl£s}‰<+v D¥ØÒq`÷š8É8æR wèSZÐcccr`%á³ãØ4ƒ£ÜZ>Ÿ7·Ûm"á|mµZ …„7s»ÝÖét,N+ vúýû÷¥(²½½=K¥RŠiÂAÌŠ-ãëõ¸Zëáx÷ÝwWÙÝ:Ž¥R)±+ø ìf_¿~m‘HDAà§§§V«Õ¡v¦Cû-e:;f)'&&d7sÅy·Û•G«^¯[<·r¹,a1¨m>7ž) ¨ÌgÍÎÎŠx "¦FhkµZUÍ jÎ<ùññ±,<b‘$ q(|>Ÿ~Žëõ¸Zëáøá¸šÉdlwwWrb±(`ðþýûV¯×ÅJàH„C»�jnŽZ”Ø|q`¾¼^¯lX.\.—.½ü>ÃÃÃ²Í“ÕíÜßßWZýÑÑ‘�˜ Þ°«“ƒª»BU,Ü0!òsPhHK›Ðsî(Ð¸ÎÎÎìÝl6-*Ša)ÿ}:¶H$b×ëqµÖÃñäÉ“Õ\.'U@2™´`0(¼×ÖÖ–þšé;"Êóósí–„RÓ¶ÅóÃÌ‘Nˆ9ó—““µmÐPÎà?#è�ûLPp;;;Ë øN§ÓÖh4t™6›Í*Œ$özœ¼õzÝæçç•f‚º«G8S±^¯Ëå÷ûR©X$ƒ‡ùüü\�UýP›hg³Y»^«µŽï|ç;«·nÝcáöíÛr·f2›˜˜° î0£¥Ói+ Š "œv&íM¢ˆ(èÈD£Qk4ò…Ãa[XXPÈD¯€‹ËåÓæü<D…BA Ü·Løq·2$¤®5ÇcÕjÕž?nwîÜ±ÝÝ]kµZv÷î]aÈ©çc±˜U«U¡Õ ×’êHè]2™Ô}„“¡Ëå²ƒƒ•e¸Ä‡††ìz=®Öz8¾ÿýï¯& ÁBÇÆÆ,‘HˆL L¸Ã9¦Ûx‡0[Rw:Åà s9<<T64¢Ï©©)©X$ (½`NÊjaìò´§,ŸÏËß³¸¸(›~¿}þùç2NÞ¼yS_(;< ˜+++’ÛœŸŸÛÆÆ†Rgp ã¡êÕÕqÉ@©F%\”¨&NNNDÍ¢ëu½Wk=Ož<YB²°° cÄX©TvÐt:+X½^—L…@¹\¶x<®„–z½.¢Rä>½J¤œ ÀFxJîï½{÷l}}]vvKêê±±1Ëd2ÔÀÂh4 êBJè:,óóós;;;“Ö5H4ÈL\ÔI]á3ÀÅ Õ’ò#Z,³ßÿþ÷ffV*•”ê922¢ÈXÑ×ëqµÖÃñ½ï}o•YC>Ÿ—}š8"Óè<qÌf³¶´´¤.Ø/ÂÐ<x`öðáC…³AXŠÅbæóùdãÆ•êp8¬^¯+I1‹™ßï·µµ5´òääD‹•©wÞ09R&ÍÌB¡ƒAk4™îïïÛìì¬ØÌÌŒ¼MìØKKKê²¥R)[[[³ÙÙYÍxÀXCa …B22þðÃE± ‚Nß[·ìââÂ®×ãj‡ãéÓ§«ôú777õe:NyzcsHE…BÚèP[¥RùÇãñØóçÏÛí jJÙ±··§€[C:/|Gfˆ4 ¡«V«6::*R0Ržóós{üø±œœX¹\%–^ÁéÅÅ…}ñÅ ‡]Q7Ûöö¶ zS.—¥PðûýÂ¡ß{õê•N ÚÔffSSSš kµZ20žY£Ñ°Zf×ëqµÖÃñ/ÿò/«tM4ÂG'SùøøX»S~·Ûm©TJƒ¹Þ@êX,fg6 Ëd2Ôa[G€MoÎSˆ@@‹@~q¦¨šÍ¦b™ÆÆÆä eg%Ð-“Éèç„ ±¼¼lcccöÉ'ŸX__ŸÝ¹sGZèDggg¶³³#D6s–l6{)r–‡ íZ½^Wêùù¹|X„"€8K¥Rò)]¯ÇÕZÇ·¿ýíULu¨’Ýn·Û§Ÿ~jNÇîÝ»gÕjÕŠÅ¢-..šÓéÔ´› ðmpà7775K…BRyÃG\[[Sˆ:É•ˆG™=�ï<::;cÞàà ¹Ýnµ›‰°¥5L¾ ¼JHmLÂUD¯B–D³Ù´F£aËËËBñÿöÒµNOOí¿ÿû¿-(X"NËÜÇ½ÇãñØÆÆ†åóys¹\ò<íììX$±þþ~»^«µŽo~ó›«ºÈñ’nÈ…©~·Ûµ½½=ëëë³©©)1ó‹b°ƒÖ322b“““¶¼¼,ãZ²ŸQ€°†ý¹ç´Ÿ)9¸ÜZ>Ÿ·‘‘u¤èXa$A%üß<ßÿz<[YYQÇhppP*¬ôÀ¡U*ƒÇ-™LjwëÅi#²ñ •Ü,hÀï¼óŽ×ëqµÖÃñoÿöo«;;;‚uîííÙúúº¹Ýn¥g0ÔD&S©T´s`ý&*>")333ff–H$´H'''ò7Qÿf2ï‘w¼»»kvãÆ á¢¡ø²«–J%ÙÒ].—>/‰,\äA(cV¤íœL&ÍápÈUKH*pf6ÙlÖNNN¤0@žÔn·-‘HØÒÒ’ˆÅ@V¹ƒµž˜˜°íím¶¯ýërâ’4Ã\æz=®Özôýüç?ïÂ-8??×—ð\¢Ä5›M»}û¶‹Ek4aW€©W¯×-“ÉØ«W¯ìÉ“'Ößßo~¿_åž'j~ÂêHí¤Ü™ššRkÚåréKæB^(¤#cÒOØs\³p'ì[V“ØùN(RÖñìì¬íììhG¤Á@ô-ô‘HÄ‡Ðkƒƒƒ6==mûûûbó]ƒ¤¦Ä¶f³i×ëqµÖÃñÞ{ïö’„°O×j5ËçóB “ŠQ©T¤Ì†¼…¤çŠÅ¢•Ëe›˜˜°ùùy)ÄÝn·hFì€”Þ†††¤gCKÇ•º¯¯O‰†Ð„HžžžZ4Y í._¯×+Í"¨jZßNGVy8¸l ;@ ôüùsóz½ °óz½655%5w&“[ãôôTv¹¹9ùµ &_¯ÇÕZÿdDÿÚ³{V��IEND®B`‚# pecl/raphf ## About: The "Resource and Persistent Handle Factory" extension provides facilities to manage those in a convenient manner. ## Installation: This extension is hosted at [PECL](http://pecl.php.net) and can be installed with [PEAR](http://pear.php.net)'s pecl command: # pecl install raphf Also, watch out for self-installing [pharext](https://github.com/m6w6/pharext) packages attached to [releases](https://github.com/m6w6/ext-raphf/releases). ## INI Directives: * raphf.persistent_handle.limit = -1 The per process/thread persistent handle limit. ## Internals: > ***NOTE:*** This extension mostly only provides infrastructure for other extensions. See the [API docs here](http://m6w6.github.io/ext-raphf/). ## Documentation: Userland documentation can be found at http://devel-m6w6.rhcloud.com/mdref/raphf --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 --TEST-- raphf test --SKIPIF-- <?php if (!extension_loaded("raphf")) { die("skip need ext/raphf"); } if (!defined("RAPHF_TEST")) { die("skip need RAPHF_TEST defined (-DPHP_RAPHF_TEST=1)"); } ?> --INI-- raphf.persistent_handle.limit=0 --FILE-- <?php function dumper($id) { return function() use ($id) { echo "### back '$id':\n"; for ($i=0; $i<func_num_args(); ++$i) { echo "#### arg $i: "; var_dump(func_get_arg($i)); } /* relay arguments back */ return func_get_args(); }; } echo "## call provide:\n"; var_dump(raphf\provide("test",dumper("ctor"),dumper("copy"),dumper("dtor"),"data value",dumper("data_dtor"))); echo "## call concede:\n"; var_dump($rf = raphf\concede("test","1")); echo "## call handle_ctor:\n"; var_dump($h = raphf\handle_ctor($rf, 1)); echo "## call handle_copy:\n"; var_dump($h2 = raphf\handle_copy($rf, $h)); var_dump(raphf\stat_persistent_handles()); echo "## call handle_dtor:\n"; var_dump(raphf\handle_dtor($rf, $h)); var_dump(raphf\stat_persistent_handles()); echo "## call handle_dtor:\n"; var_dump(raphf\handle_dtor($rf, $h2)); var_dump(raphf\stat_persistent_handles()); echo "## cleanup:\n"; var_dump(raphf\dispute($rf), $rf); var_dump(raphf\conceal("test")); var_dump(raphf\stat_persistent_handles()); ?> --EXPECTF-- ## call provide: bool(true) ## call concede: resource(4) of type (raphf_user) ## call handle_ctor: ### back 'ctor': #### arg 0: string(10) "data value" #### arg 1: int(1) array(2) { [0]=> string(10) "data value" [1]=> int(1) } ## call handle_copy: ### back 'copy': #### arg 0: string(10) "data value" #### arg 1: array(2) { [0]=> string(10) "data value" [1]=> int(1) } array(2) { [0]=> string(10) "data value" [1]=> array(2) { [0]=> string(10) "data value" [1]=> int(1) } } object(stdClass)#%d (1) { ["test"]=> array(1) { [1]=> array(2) { ["used"]=> int(2) ["free"]=> int(0) } } } ## call handle_dtor: ### back 'dtor': #### arg 0: string(10) "data value" #### arg 1: array(2) { [0]=> string(10) "data value" [1]=> int(1) } NULL object(stdClass)#%d (1) { ["test"]=> array(1) { [1]=> array(2) { ["used"]=> int(1) ["free"]=> int(0) } } } ## call handle_dtor: ### back 'dtor': #### arg 0: string(10) "data value" #### arg 1: array(2) { [0]=> string(10) "data value" [1]=> array(2) { [0]=> string(10) "data value" [1]=> int(1) } } NULL object(stdClass)#%d (1) { ["test"]=> array(1) { [1]=> array(2) { ["used"]=> int(0) ["free"]=> int(0) } } } ## cleanup: bool(true) resource(4) of type (Unknown) ### back 'data_dtor': #### arg 0: string(10) "data value" bool(true) bool(false) * TTL Kþ7Á·ò,k�oÌß˜%òœŸ?��GBMB