danog/ext-pq
1
0
Fork 0
mirror of https://github.com/danog/ext-pq.git synced 2024-12-02 09:18:02 +01:00
Code Issues Projects Releases Wiki Activity
e29dd4bc37
ext-pq/raphf-1.1.2.ext.phar

6405 lines
155 KiB
Plaintext
Raw Normal View History

add pharext dep [ci skip]
2016-01-19 08:33:11 +01:00
#!/usr/bin/env php
<?php
/**
* The installer sub-stub for extension phars
*/
namespace pharext;
define("PHAREXT_PHAR", __FILE__);
spl_autoload_register(function($c) {
return include strtr($c, "\\_", "//") . ".php";
});
namespace pharext;
class Exception extends \Exception
{
public function __construct($message = null, $code = 0, $previous = null) {
if (!isset($message)) {
$last_error = error_get_last();
$message = $last_error["message"];
if (!$code) {
$code = $last_error["type"];
}
}
parent::__construct($message, $code, $previous);
}
}
namespace pharext;
use pharext\Exception;
/**
* A temporary file/directory name
*/
class Tempname
{
/**
* @var string
*/
private $name;
/**
* @param string $prefix uniqid() prefix
* @param string $suffix e.g. file extension
*/
public function __construct($prefix, $suffix = null) {
$temp = sys_get_temp_dir() . "/pharext-" . $this->getUser();
if (!is_dir($temp) && !mkdir($temp, 0700, true)) {
throw new Exception;
}
$this->name = $temp ."/". uniqid($prefix) . $suffix;
}
private function getUser() {
if (extension_loaded("posix") && function_exists("posix_getpwuid")) {
return posix_getpwuid(posix_getuid())["name"];
}
return trim(`whoami 2>/dev/null`)
?: trim(`id -nu 2>/dev/null`)
?: getenv("USER")
?: get_current_user();
}
/**
* @return string
*/
public function __toString() {
return (string) $this->name;
}
}
namespace pharext;
/**
* Create a new temporary file
*/
class Tempfile extends \SplFileInfo
{
/**
* @var resource
*/
private $handle;
/**
* @param string $prefix uniqid() prefix
* @param string $suffix e.g. file extension
* @throws \pharext\Exception
*/
public function __construct($prefix, $suffix = ".tmp") {
$tries = 0;
$omask = umask(077);
do {
$path = new Tempname($prefix, $suffix);
$this->handle = fopen($path, "x");
} while (!is_resource($this->handle) && $tries++ < 10);
umask($omask);
if (!is_resource($this->handle)) {
throw new Exception("Could not create temporary file");
}
parent::__construct($path);
}
/**
* Unlink the file
*/
public function __destruct() {
if (is_file($this->getPathname())) {
@unlink($this->getPathname());
}
}
/**
* Close the stream
*/
public function closeStream() {
fclose($this->handle);
}
/**
* Retrieve the stream resource
* @return resource
*/
public function getStream() {
return $this->handle;
}
}
namespace pharext;
/**
* Create a temporary directory
*/
class Tempdir extends \SplFileInfo
{
/**
* @param string $prefix prefix to uniqid()
* @throws \pharext\Exception
*/
public function __construct($prefix) {
$temp = new Tempname($prefix);
if (!is_dir($temp) && !mkdir($temp, 0700, true)) {
throw new Exception("Could not create tempdir: ".error_get_last()["message"]);
}
parent::__construct($temp);
}
}
namespace pharext;
use ArrayAccess;
use IteratorAggregate;
use RecursiveDirectoryIterator;
use SplFileInfo;
use pharext\Exception;
class Archive implements ArrayAccess, IteratorAggregate
{
const HALT_COMPILER = "\137\137\150\141\154\164\137\143\157\155\160\151\154\145\162\50\51\73";
const SIGNED = 0x10000;
const SIG_MD5 = 0x0001;
const SIG_SHA1 = 0x0002;
const SIG_SHA256 = 0x0003;
const SIG_SHA512 = 0x0004;
const SIG_OPENSSL= 0x0010;
private static $siglen = [
self::SIG_MD5 => 16,
self::SIG_SHA1 => 20,
self::SIG_SHA256 => 32,
self::SIG_SHA512 => 64,
self::SIG_OPENSSL=> 0
];
private static $sigalg = [
self::SIG_MD5 => "md5",
self::SIG_SHA1 => "sha1",
self::SIG_SHA256 => "sha256",
self::SIG_SHA512 => "sha512",
self::SIG_OPENSSL=> "openssl"
];
private static $sigtyp = [
self::SIG_MD5 => "MD5",
self::SIG_SHA1 => "SHA-1",
self::SIG_SHA256 => "SHA-256",
self::SIG_SHA512 => "SHA-512",
self::SIG_OPENSSL=> "OpenSSL",
];
const PERM_FILE_MASK = 0x01ff;
const COMP_FILE_MASK = 0xf000;
const COMP_GZ_FILE = 0x1000;
const COMP_BZ2_FILE = 0x2000;
const COMP_PHAR_MASK= 0xf000;
const COMP_PHAR_GZ = 0x1000;
const COMP_PHAR_BZ2 = 0x2000;
private $file;
private $fd;
private $stub;
private $manifest;
private $signature;
private $extracted;
function __construct($file = null) {
if (strlen($file)) {
$this->open($file);
}
}
function open($file) {
if (!$this->fd = @fopen($file, "r")) {
throw new Exception;
}
$this->file = $file;
$this->stub = $this->readStub();
$this->manifest = $this->readManifest();
$this->signature = $this->readSignature();
}
function getIterator() {
return new RecursiveDirectoryIterator($this->extract());
}
function extract() {
return $this->extracted ?: $this->extractTo(new Tempdir("archive"));
}
function extractTo($dir) {
if ((string) $this->extracted == (string) $dir) {
return $this->extracted;
}
foreach ($this->manifest["entries"] as $file => $entry) {
fseek($this->fd, $this->manifest["offset"]+$entry["offset"]);
$path = "$dir/$file";
$copy = stream_copy_to_stream($this->fd, $this->outFd($path, $entry["flags"]), $entry["csize"]);
if ($entry["osize"] != $copy) {
throw new Exception("Copied '$copy' of '$file', expected '{$entry["osize"]}' from '{$entry["csize"]}");
}
$crc = hexdec(hash_file("crc32b", $path));
if ($crc !== $entry["crc32"]) {
throw new Exception("CRC mismatch of '$file': '$crc' != '{$entry["crc32"]}");
}
chmod($path, $entry["flags"] & self::PERM_FILE_MASK);
touch($path, $entry["stamp"]);
}
return $this->extracted = $dir;
}
function offsetExists($o) {
return isset($this->entries[$o]);
}
function offsetGet($o) {
$this->extract();
return new SplFileInfo($this->extracted."/$o");
}
function offsetSet($o, $v) {
throw new Exception("Archive is read-only");
}
function offsetUnset($o) {
throw new Exception("Archive is read-only");
}
function getSignature() {
/* compatible with Phar::getSignature() */
return [
"hash_type" => self::$sigtyp[$this->signature["flags"]],
"hash" => strtoupper(bin2hex($this->signature["hash"])),
];
}
function getPath() {
/* compatible with Phar::getPath() */
return new SplFileInfo($this->file);
}
function getMetadata($key = null) {
if (isset($key)) {
return $this->manifest["meta"][$key];
}
return $this->manifest["meta"];
}
private function outFd($path, $flags) {
$dirn = dirname($path);
if (!is_dir($dirn) && !@mkdir($dirn, 0777, true)) {
throw new Exception;
}
if (!$fd = @fopen($path, "w")) {
throw new Exception;
}
switch ($flags & self::COMP_FILE_MASK) {
case self::COMP_GZ_FILE:
if (!@stream_filter_append($fd, "zlib.inflate")) {
throw new Exception;
}
break;
case self::COMP_BZ2_FILE:
if (!@stream_filter_append($fd, "bz2.decompress")) {
throw new Exception;
}
break;
}
}
private function readVerified($fd, $len) {
if ($len != strlen($data = fread($fd, $len))) {
throw new Exception("Unexpected EOF");
}
return $data;
}
private function readFormat($format, $fd, $len) {
if (false === ($data = @unpack($format, $this->readVerified($fd, $len)))) {
throw new Exception;
}
return $data;
}
private function readSingleFormat($format, $fd, $len) {
return current($this->readFormat($format, $fd, $len));
}
private function readStringBinary($fd) {
if (($length = $this->readSingleFormat("V", $fd, 4))) {
return $this->readVerified($this->fd, $length);
}
return null;
}
private function readSerializedBinary($fd) {
if (($length = $this->readSingleFormat("V", $fd, 4))) {
if (false === ($data = unserialize($this->readVerified($fd, $length)))) {
throw new Exception;
}
return $data;
}
return null;
}
private function readStub() {
$stub = "";
while (!feof($this->fd)) {
$line = fgets($this->fd);
$stub .= $line;
if (false !== stripos($line, self::HALT_COMPILER)) {
/* check for '?>' on a separate line */
if ('?>' === $this->readVerified($this->fd, 2)) {
$stub .= '?>' . fgets($this->fd);
} else {
fseek($this->fd, -2, SEEK_CUR);
}
break;
}
}
return $stub;
}
private function readManifest() {
$current = ftell($this->fd);
$header = $this->readFormat("Vlen/Vnum/napi/Vflags", $this->fd, 14);
$alias = $this->readStringBinary($this->fd);
$meta = $this->readSerializedBinary($this->fd);
$entries = [];
for ($i = 0; $i < $header["num"]; ++$i) {
$this->readEntry($entries);
}
$offset = ftell($this->fd);
if (($length = $offset - $current - 4) != $header["len"]) {
throw new Exception("Manifest length read was '$length', expected '{$header["len"]}'");
}
return $header + compact("alias", "meta", "entries", "offset");
}
private function readEntry(array &$entries) {
if (!count($entries)) {
$offset = 0;
} else {
$last = end($entries);
$offset = $last["offset"] + $last["csize"];
}
$file = $this->readStringBinary($this->fd);
if (!strlen($file)) {
throw new Exception("Empty file name encountered at offset '$offset'");
}
$header = $this->readFormat("Vosize/Vstamp/Vcsize/Vcrc32/Vflags", $this->fd, 20);
$meta = $this->readSerializedBinary($this->fd);
$entries[$file] = $header + compact("meta", "offset");
}
private function readSignature() {
fseek($this->fd, -8, SEEK_END);
$sig = $this->readFormat("Vflags/Z4magic", $this->fd, 8);
$end = ftell($this->fd);
if ($sig["magic"] !== "GBMB") {
throw new Exception("Invalid signature magic value '{$sig["magic"]}");
}
switch ($sig["flags"]) {
case self::SIG_OPENSSL:
fseek($this->fd, -12, SEEK_END);
if (($hash = $this->readSingleFormat("V", $this->fd, 4))) {
$offset = 4 + $hash;
fseek($this->fd, -$offset, SEEK_CUR);
$hash = $this->readVerified($this->fd, $hash);
fseek($this->fd, 0, SEEK_SET);
$valid = openssl_verify($this->readVerified($this->fd, $end - $offset - 8),
$hash, @file_get_contents($this->file.".pubkey")) === 1;
}
break;
case self::SIG_MD5:
case self::SIG_SHA1:
case self::SIG_SHA256:
case self::SIG_SHA512:
$offset = 8 + self::$siglen[$sig["flags"]];
fseek($this->fd, -$offset, SEEK_END);
$hash = $this->readVerified($this->fd, self::$siglen[$sig["flags"]]);
$algo = hash_init(self::$sigalg[$sig["flags"]]);
fseek($this->fd, 0, SEEK_SET);
hash_update_stream($algo, $this->fd, $end - $offset);
$valid = hash_final($algo, true) === $hash;
break;
default:
throw new Exception("Invalid signature type '{$sig["flags"]}");
}
return $sig + compact("hash", "valid");
}
}
namespace pharext;
if (extension_loaded("Phar")) {
\Phar::interceptFileFuncs();
\Phar::mapPhar();
$phardir = "phar://".__FILE__;
} else {
$archive = new Archive(__FILE__);
$phardir = $archive->extract();
}
set_include_path("$phardir:". get_include_path());
$installer = new Installer();
$installer->run($argc, $argv);
__HALT_COMPILER(); ?>
@(a:7:{s:7:"version";s:5:"4.1.1";s:6:"header";s:49:"pharext v4.1.1 (c) Michael Wallner <mike@php.net>";s:4:"date";s:10:"2016-01-19";s:4:"name";s:5:"raphf";s:7:"release";s:5:"1.1.2";s:7:"license";s:1345:"Copyright (c) 2013, Michael Wallner <mike@php.net>.
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
";s:4:"type";s:9:"extension";}pharext/Archive.php <0A><>V4-<2D>I<EFBFBD>pharext/Cli/Args/Help.php<68> <0A><>V<EFBFBD> gX'<1F>pharext/Cli/Args.php <0A><>V?n<><6E><EFBFBD>pharext/Cli/Command.phpk <0A><>Vk d<>a<EFBFBD><61>pharext/Command.php <0A><>V<00>m`Ͷpharext/Exception.phpc <0A><>VcU<><55>{<7B>pharext/ExecCmd.php <0A><>V<00>l<EFBFBD>ʶpharext/Installer.php& <0A><>V&<00>d&<26><>pharext/License.php<68> <0A><>V<EFBFBD><00><04>E<EFBFBD>pharext/Metadata.php<68> <0A><>V<EFBFBD><00>ڐ<EFBFBD><DA90>pharext/Openssl/PrivateKey.php<68> <0A><>V<EFBFBD>&<26>P<1A>pharext/Packager.php<68>! <0A><>V<EFBFBD>!0<<3C>pharext/SourceDir/Basic.phpz <0A><>Vz<00>+<2B><><EFBFBD>pharext/SourceDir/Git.phpZ <0A><>VZ<00><08>\<5C>pharext/SourceDir/Pecl.php<68> <0A><>V<EFBFBD><00><08>жpharext/SourceDir.php<68> <0A><>V<EFBFBD>3<>#<0F>pharext/Task/Activate.php<68> <0A><>V<EFBFBD> I<><18>pharext/Task/Askpass.phpU <0A><>VU<00>*<1E><> pharext/Task/BundleGenerator.php} <0A><>V} <20>`Y<>pharext/Task/Cleanup.php <0A><>V<00>I<EFBFBD>B<EFBFBD>pharext/Task/Configure.phpT <0A><>VT}<17><><EFBFBD>pharext/Task/Extract.phpp <0A><>Vp[<5B><>̶pharext/Task/GitClone.phpm <0A><>Vm<00>y<EFBFBD>@<40>pharext/Task/Make.php<68> <0A><>V<EFBFBD><00><>6 <0A>pharext/Task/PaxFixup.php<68> <0A><>V<EFBFBD>y<><79><1B>pharext/Task/PeclFixup.php<68> <0A><>V<EFBFBD>e<>t<EFBFBD><74>pharext/Task/PharBuild.php<68> <0A><>V<EFBFBD>ζ0ɶpharext/Task/PharCompress.phpc <0A><>Vc<00><10>϶pharext/Task/PharRename.php<68> <0A><>V<EFBFBD><00>[<5B>˶pharext/Task/PharSign.php<68> <0A><>V<EFBFBD>ۺ<>i<EFBFBD>pharext/Task/PharStub.php<68> <0A><>V<EFBFBD>Y|<7C><><EFBFBD>pharext/Task/Phpize.php <0A><>V<00> 2Ѷpharext/Task/StreamFetch.php <0A><>V<00><>s\<5C>pharext/Task.phpw <0A><>Vw <20>IǶpharext/Tempdir.php<68> <0A><>V<EFBFBD><00><EFBFBD>,<2C>pharext/Tempfile.php <0A><>V<00><><1E>pharext/Tempname.phpt <0A><>Vt<00>n<<3C><>pharext/Updater.php<68> <0A><>V<EFBFBD><00><>v<16>pharext_installer.php<68> <0A><>V<EFBFBD><19><>q<EFBFBD>pharext_packager.phpb <0A><>Vb<00>V<EFBFBD>϶pharext_updater.phph <0A><>Vh <20><>j<EFBFBD>pharext_package.php2 <0A><>V2vSTҶ package.xmlX <0A><>VX F}i(<28>src/php_raphf_api.hX5 <0A><>VX53<>䷶src/php_raphf_api.cH <0A><>VH<00><>ꀶscripts/gen_travis_yml.php<68> <0A><>V<EFBFBD><00>!_<>tests/http001.phpt <0A><>V *<2A><1B>tests/http002.phptL <0A><>VL<00><><EFBFBD>S<EFBFBD>tests/http003.phpt^ <0A><>V^<14>p<>tests/http004.phpt[ <0A><>V[Y<><1C><>AUTHORS <0A><>V\<5C>H<EFBFBD><48>BUGS* <0A><>V*<<3C><0F>CONTRIBUTING.md<6D> <0A><>V<EFBFBD><00>N<EFBFBD>q<EFBFBD>CREDITS <0A><>VC<>]<5D><>LICENSEA <0A><>VA<00><>J<EFBFBD><4A> README.md <0A><>Vab{<7B><>THANKSd <0A><>Vd<00>D"<22><>TODO <0A><>Vy_<79>E<EFBFBD>Doxyfile<6C>, <0A><>V<EFBFBD>,Mc<4D>ܶ config.m4 <0A><>Vo<>d<EFBFBD><64>
config0.m4<6D> <0A><>V<EFBFBD><00><><EFBFBD>b<EFBFBD>
config.w32<33> <0A><>V<EFBFBD>L<>fO<66> Makefile.frag<61> <0A><>V<EFBFBD>ݯ<><DDAF><EFBFBD> php_raphf.h <0A><>V<00>j<><?php
namespace pharext;
use ArrayAccess;
use IteratorAggregate;
use RecursiveDirectoryIterator;
use SplFileInfo;
use pharext\Exception;
class Archive implements ArrayAccess, IteratorAggregate
{
const HALT_COMPILER = "\137\137\150\141\154\164\137\143\157\155\160\151\154\145\162\50\51\73";
const SIGNED = 0x10000;
const SIG_MD5 = 0x0001;
const SIG_SHA1 = 0x0002;
const SIG_SHA256 = 0x0003;
const SIG_SHA512 = 0x0004;
const SIG_OPENSSL= 0x0010;
private static $siglen = [
self::SIG_MD5 => 16,
self::SIG_SHA1 => 20,
self::SIG_SHA256 => 32,
self::SIG_SHA512 => 64,
self::SIG_OPENSSL=> 0
];
private static $sigalg = [
self::SIG_MD5 => "md5",
self::SIG_SHA1 => "sha1",
self::SIG_SHA256 => "sha256",
self::SIG_SHA512 => "sha512",
self::SIG_OPENSSL=> "openssl"
];
private static $sigtyp = [
self::SIG_MD5 => "MD5",
self::SIG_SHA1 => "SHA-1",
self::SIG_SHA256 => "SHA-256",
self::SIG_SHA512 => "SHA-512",
self::SIG_OPENSSL=> "OpenSSL",
];
const PERM_FILE_MASK = 0x01ff;
const COMP_FILE_MASK = 0xf000;
const COMP_GZ_FILE = 0x1000;
const COMP_BZ2_FILE = 0x2000;
const COMP_PHAR_MASK= 0xf000;
const COMP_PHAR_GZ = 0x1000;
const COMP_PHAR_BZ2 = 0x2000;
private $file;
private $fd;
private $stub;
private $manifest;
private $signature;
private $extracted;
function __construct($file = null) {
if (strlen($file)) {
$this->open($file);
}
}
function open($file) {
if (!$this->fd = @fopen($file, "r")) {
throw new Exception;
}
$this->file = $file;
$this->stub = $this->readStub();
$this->manifest = $this->readManifest();
$this->signature = $this->readSignature();
}
function getIterator() {
return new RecursiveDirectoryIterator($this->extract());
}
function extract() {
return $this->extracted ?: $this->extractTo(new Tempdir("archive"));
}
function extractTo($dir) {
if ((string) $this->extracted == (string) $dir) {
return $this->extracted;
}
foreach ($this->manifest["entries"] as $file => $entry) {
fseek($this->fd, $this->manifest["offset"]+$entry["offset"]);
$path = "$dir/$file";
$copy = stream_copy_to_stream($this->fd, $this->outFd($path, $entry["flags"]), $entry["csize"]);
if ($entry["osize"] != $copy) {
throw new Exception("Copied '$copy' of '$file', expected '{$entry["osize"]}' from '{$entry["csize"]}");
}
$crc = hexdec(hash_file("crc32b", $path));
if ($crc !== $entry["crc32"]) {
throw new Exception("CRC mismatch of '$file': '$crc' != '{$entry["crc32"]}");
}
chmod($path, $entry["flags"] & self::PERM_FILE_MASK);
touch($path, $entry["stamp"]);
}
return $this->extracted = $dir;
}
function offsetExists($o) {
return isset($this->entries[$o]);
}
function offsetGet($o) {
$this->extract();
return new SplFileInfo($this->extracted."/$o");
}
function offsetSet($o, $v) {
throw new Exception("Archive is read-only");
}
function offsetUnset($o) {
throw new Exception("Archive is read-only");
}
function getSignature() {
/* compatible with Phar::getSignature() */
return [
"hash_type" => self::$sigtyp[$this->signature["flags"]],
"hash" => strtoupper(bin2hex($this->signature["hash"])),
];
}
function getPath() {
/* compatible with Phar::getPath() */
return new SplFileInfo($this->file);
}
function getMetadata($key = null) {
if (isset($key)) {
return $this->manifest["meta"][$key];
}
return $this->manifest["meta"];
}
private function outFd($path, $flags) {
$dirn = dirname($path);
if (!is_dir($dirn) && !@mkdir($dirn, 0777, true)) {
throw new Exception;
}
if (!$fd = @fopen($path, "w")) {
throw new Exception;
}
switch ($flags & self::COMP_FILE_MASK) {
case self::COMP_GZ_FILE:
if (!@stream_filter_append($fd, "zlib.inflate")) {
throw new Exception;
}
break;
case self::COMP_BZ2_FILE:
if (!@stream_filter_append($fd, "bz2.decompress")) {
throw new Exception;
}
break;
}
}
private function readVerified($fd, $len) {
if ($len != strlen($data = fread($fd, $len))) {
throw new Exception("Unexpected EOF");
}
return $data;
}
private function readFormat($format, $fd, $len) {
if (false === ($data = @unpack($format, $this->readVerified($fd, $len)))) {
throw new Exception;
}
return $data;
}
private function readSingleFormat($format, $fd, $len) {
return current($this->readFormat($format, $fd, $len));
}
private function readStringBinary($fd) {
if (($length = $this->readSingleFormat("V", $fd, 4))) {
return $this->readVerified($this->fd, $length);
}
return null;
}
private function readSerializedBinary($fd) {
if (($length = $this->readSingleFormat("V", $fd, 4))) {
if (false === ($data = unserialize($this->readVerified($fd, $length)))) {
throw new Exception;
}
return $data;
}
return null;
}
private function readStub() {
$stub = "";
while (!feof($this->fd)) {
$line = fgets($this->fd);
$stub .= $line;
if (false !== stripos($line, self::HALT_COMPILER)) {
/* check for '?>' on a separate line */
if ('?>' === $this->readVerified($this->fd, 2)) {
$stub .= '?>' . fgets($this->fd);
} else {
fseek($this->fd, -2, SEEK_CUR);
}
break;
}
}
return $stub;
}
private function readManifest() {
$current = ftell($this->fd);
$header = $this->readFormat("Vlen/Vnum/napi/Vflags", $this->fd, 14);
$alias = $this->readStringBinary($this->fd);
$meta = $this->readSerializedBinary($this->fd);
$entries = [];
for ($i = 0; $i < $header["num"]; ++$i) {
$this->readEntry($entries);
}
$offset = ftell($this->fd);
if (($length = $offset - $current - 4) != $header["len"]) {
throw new Exception("Manifest length read was '$length', expected '{$header["len"]}'");
}
return $header + compact("alias", "meta", "entries", "offset");
}
private function readEntry(array &$entries) {
if (!count($entries)) {
$offset = 0;
} else {
$last = end($entries);
$offset = $last["offset"] + $last["csize"];
}
$file = $this->readStringBinary($this->fd);
if (!strlen($file)) {
throw new Exception("Empty file name encountered at offset '$offset'");
}
$header = $this->readFormat("Vosize/Vstamp/Vcsize/Vcrc32/Vflags", $this->fd, 20);
$meta = $this->readSerializedBinary($this->fd);
$entries[$file] = $header + compact("meta", "offset");
}
private function readSignature() {
fseek($this->fd, -8, SEEK_END);
$sig = $this->readFormat("Vflags/Z4magic", $this->fd, 8);
$end = ftell($this->fd);
if ($sig["magic"] !== "GBMB") {
throw new Exception("Invalid signature magic value '{$sig["magic"]}");
}
switch ($sig["flags"]) {
case self::SIG_OPENSSL:
fseek($this->fd, -12, SEEK_END);
if (($hash = $this->readSingleFormat("V", $this->fd, 4))) {
$offset = 4 + $hash;
fseek($this->fd, -$offset, SEEK_CUR);
$hash = $this->readVerified($this->fd, $hash);
fseek($this->fd, 0, SEEK_SET);
$valid = openssl_verify($this->readVerified($this->fd, $end - $offset - 8),
$hash, @file_get_contents($this->file.".pubkey")) === 1;
}
break;
case self::SIG_MD5:
case self::SIG_SHA1:
case self::SIG_SHA256:
case self::SIG_SHA512:
$offset = 8 + self::$siglen[$sig["flags"]];
fseek($this->fd, -$offset, SEEK_END);
$hash = $this->readVerified($this->fd, self::$siglen[$sig["flags"]]);
$algo = hash_init(self::$sigalg[$sig["flags"]]);
fseek($this->fd, 0, SEEK_SET);
hash_update_stream($algo, $this->fd, $end - $offset);
$valid = hash_final($algo, true) === $hash;
break;
default:
throw new Exception("Invalid signature type '{$sig["flags"]}");
}
return $sig + compact("hash", "valid");
}
}
<?php
namespace pharext\Cli\Args;
use pharext\Cli\Args;
class Help
{
private $args;
function __construct($prog, Args $args) {
$this->prog = $prog;
$this->args = $args;
}
function __toString() {
$usage = "Usage:\n\n \$ ";
$usage .= $this->prog;
list($flags, $required, $optional, $positional) = $this->listSpec();
if ($flags) {
$usage .= $this->dumpFlags($flags);
}
if ($required) {
$usage .= $this->dumpRequired($required);
}
if ($optional) {
$usage .= $this->dumpOptional($optional);
}
if ($positional) {
$usage .= $this->dumpPositional($positional);
}
$help = $this->dumpHelp($positional);
return $usage . "\n\n" . $help . "\n";
}
function listSpec() {
$flags = [];
$required = [];
$optional = [];
$positional = [];
foreach ($this->args->getSpec() as $spec) {
if (is_numeric($spec[0])) {
$positional[] = $spec;
} elseif ($spec[3] & Args::REQUIRED) {
$required[] = $spec;
} elseif ($spec[3] & (Args::OPTARG|Args::REQARG)) {
$optional[] = $spec;
} else {
$flags[] = $spec;
}
}
return [$flags, $required, $optional, $positional]
+ compact("flags", "required", "optional", "positional");
}
function dumpFlags(array $flags) {
return sprintf(" [-%s]", implode("", array_column($flags, 0)));
}
function dumpRequired(array $required) {
$dump = "";
foreach ($required as $req) {
$dump .= sprintf(" -%s <%s>", $req[0], $req[1]);
}
return $dump;
}
function dumpOptional(array $optional) {
$req = array_filter($optional, function($a) {
return $a[3] & Args::REQARG;
});
$opt = array_filter($optional, function($a) {
return $a[3] & Args::OPTARG;
});
$dump = "";
if ($req) {
$dump .= sprintf(" [-%s <arg>]", implode("|-", array_column($req, 0)));
}
if ($opt) {
$dump .= sprintf(" [-%s [<arg>]]", implode("|-", array_column($opt, 0)));
}
return $dump;
}
function dumpPositional(array $positional) {
$dump = " [--]";
foreach ($positional as $pos) {
if ($pos[3] & Args::REQUIRED) {
$dump .= sprintf(" <%s>", $pos[1]);
} else {
$dump .= sprintf(" [<%s>]", $pos[1]);
}
if ($pos[3] & Args::MULTI) {
$dump .= sprintf(" [<%s>]...", $pos[1]);
}
}
return $dump;
}
function calcMaxLen() {
$spc = $this->args->getSpec();
$max = max(array_map("strlen", array_column($spc, 1)));
$max += $max % 8 + 2;
return $max;
}
function dumpHelp() {
$max = $this->calcMaxLen();
$dump = "";
foreach ($this->args->getSpec() as $spec) {
$dump .= " ";
if (is_numeric($spec[0])) {
$dump .= sprintf("-- %s ", $spec[1]);
} elseif (isset($spec[0])) {
$dump .= sprintf("-%s|", $spec[0]);
}
if (!is_numeric($spec[0])) {
$dump .= sprintf("--%s ", $spec[1]);
}
if ($spec[3] & Args::REQARG) {
$dump .= "<arg> ";
} elseif ($spec[3] & Args::OPTARG) {
$dump .= "[<arg>]";
} else {
$dump .= " ";
}
$dump .= str_repeat(" ", $max-strlen($spec[1])+3*!isset($spec[0]));
$dump .= $spec[2];
if ($spec[3] & Args::REQUIRED) {
$dump .= " (REQUIRED)";
}
if ($spec[3] & Args::MULTI) {
$dump .= " (MULTIPLE)";
}
if (isset($spec[4])) {
$dump .= sprintf(" [%s]", $spec[4]);
}
$dump .= "\n";
}
return $dump;
}
}
<?php
namespace pharext\Cli;
/**
* Command line arguments
*/
class Args implements \ArrayAccess
{
/**
* Optional option
*/
const OPTIONAL = 0x000;
/**
* Required Option
*/
const REQUIRED = 0x001;
/**
* Only one value, even when used multiple times
*/
const SINGLE = 0x000;
/**
* Aggregate an array, when used multiple times
*/
const MULTI = 0x010;
/**
* Option takes no argument
*/
const NOARG = 0x000;
/**
* Option requires an argument
*/
const REQARG = 0x100;
/**
* Option takes an optional argument
*/
const OPTARG = 0x200;
/**
* Option halts processing
*/
const HALT = 0x10000000;
/**
* Original option spec
* @var array
*/
private $orig = [];
/**
* Compiled spec
* @var array
*/
private $spec = [];
/**
* Parsed args
* @var array
*/
private $args = [];
/**
* Compile the original spec
* @param array|Traversable $spec
*/
public function __construct($spec = null) {
if (is_array($spec) || $spec instanceof Traversable) {
$this->compile($spec);
}
}
/**
* Compile the original spec
* @param array|Traversable $spec
* @return pharext\Cli\Args self
*/
public function compile($spec) {
foreach ($spec as $arg) {
if (isset($arg[0]) && is_numeric($arg[0])) {
$arg[3] &= ~0xf00;
$this->spec["--".$arg[0]] = $arg;
} elseif (isset($arg[0])) {
$this->spec["-".$arg[0]] = $arg;
$this->spec["--".$arg[1]] = $arg;
} else {
$this->spec["--".$arg[1]] = $arg;
}
$this->orig[] = $arg;
}
return $this;
}
/**
* Get original spec
* @return array
*/
public function getSpec() {
return $this->orig;
}
/**
* Get compiled spec
* @return array
*/
public function getCompiledSpec() {
return $this->spec;
}
/**
* Parse command line arguments according to the compiled spec.
*
* The Generator yields any parsing errors.
* Parsing will stop when all arguments are processed or the first option
* flagged Cli\Args::HALT was encountered.
*
* @param int $argc
* @param array $argv
* @return Generator
*/
public function parse($argc, array $argv) {
for ($f = false, $p = 0, $i = 0; $i < $argc; ++$i) {
$o = $argv[$i];
if ($o{0} === "-" && strlen($o) > 2 && $o{1} !== "-") {
// multiple short opts, e.g. -vps
$argc += strlen($o) - 2;
array_splice($argv, $i, 1, array_map(function($s) {
return "-$s";
}, str_split(substr($o, 1))));
$o = $argv[$i];
} elseif ($o{0} === "-" && strlen($o) > 2 && $o{1} === "-" && 0 < ($eq = strpos($o, "="))) {
// long opt with argument, e.g. --foo=bar
$argc++;
array_splice($argv, $i, 1, [
substr($o, 0, $eq++),
substr($o, $eq)
]);
$o = $argv[$i];
} elseif ($o === "--") {
// only positional args following
$f = true;
continue;
}
if ($f || !isset($this->spec[$o])) {
if ($o{0} !== "-" && isset($this->spec["--$p"])) {
$this[$p] = $o;
if (!$this->optIsMulti($p)) {
++$p;
}
} else {
yield sprintf("Unknown option %s", $o);
}
} elseif (!$this->optAcceptsArg($o)) {
$this[$o] = true;
} elseif ($i+1 < $argc && !isset($this->spec[$argv[$i+1]])) {
$this[$o] = $argv[++$i];
} elseif ($this->optRequiresArg($o)) {
yield sprintf("Option --%s requires an argument", $this->optLongName($o));
} else {
// OPTARG
$this[$o] = $this->optDefaultArg($o);
}
if ($this->optHalts($o)) {
return;
}
}
}
/**
* Validate that all required options were given.
*
* The Generator yields any validation errors.
*
* @return Generator
*/
public function validate() {
$required = array_filter($this->orig, function($spec) {
return $spec[3] & self::REQUIRED;
});
foreach ($required as $req) {
if ($req[3] & self::MULTI) {
if (is_array($this[$req[0]])) {
continue;
}
} elseif (strlen($this[$req[0]])) {
continue;
}
if (is_numeric($req[0])) {
yield sprintf("Argument <%s> is required", $req[1]);
} else {
yield sprintf("Option --%s is required", $req[1]);
}
}
}
public function toArray() {
$args = [];
foreach ($this->spec as $spec) {
$opt = $this->opt($spec[1]);
$args[$opt] = $this[$opt];
}
return $args;
}
/**
* Retreive the default argument of an option
* @param string $o
* @return mixed
*/
private function optDefaultArg($o) {
$o = $this->opt($o);
if (isset($this->spec[$o][4])) {
return $this->spec[$o][4];
}
return null;
}
/**
* Retrieve the help message of an option
* @param string $o
* @return string
*/
private function optHelp($o) {
$o = $this->opt($o);
if (isset($this->spec[$o][2])) {
return $this->spec[$o][2];
}
return "";
}
/**
* Retrieve option's flags
* @param string $o
* @return int
*/
private function optFlags($o) {
$o = $this->opt($o);
if (isset($this->spec[$o])) {
return $this->spec[$o][3];
}
return null;
}
/**
* Check whether an option is flagged for halting argument processing
* @param string $o
* @return boolean
*/
private function optHalts($o) {
return $this->optFlags($o) & self::HALT;
}
/**
* Check whether an option needs an argument
* @param string $o
* @return boolean
*/
private function optRequiresArg($o) {
return $this->optFlags($o) & self::REQARG;
}
/**
* Check wether an option accepts any argument
* @param string $o
* @return boolean
*/
private function optAcceptsArg($o) {
return $this->optFlags($o) & 0xf00;
}
/**
* Check whether an option can be used more than once
* @param string $o
* @return boolean
*/
private function optIsMulti($o) {
return $this->optFlags($o) & self::MULTI;
}
/**
* Retreive the long name of an option
* @param string $o
* @return string
*/
private function optLongName($o) {
$o = $this->opt($o);
return is_numeric($this->spec[$o][0]) ? $this->spec[$o][0] : $this->spec[$o][1];
}
/**
* Retreive the short name of an option
* @param string $o
* @return string
*/
private function optShortName($o) {
$o = $this->opt($o);
return is_numeric($this->spec[$o][0]) ? null : $this->spec[$o][0];
}
/**
* Retreive the canonical name (--long-name) of an option
* @param string $o
* @return string
*/
private function opt($o) {
if (is_numeric($o)) {
return "--$o";
}
if ($o{0} !== '-') {
if (strlen($o) > 1) {
$o = "-$o";
}
$o = "-$o";
}
return $o;
}
/**@+
* Implements ArrayAccess and virtual properties
*/
function offsetExists($o) {
$o = $this->opt($o);
return isset($this->args[$o]);
}
function __isset($o) {
return $this->offsetExists($o);
}
function offsetGet($o) {
$o = $this->opt($o);
if (isset($this->args[$o])) {
return $this->args[$o];
}
return $this->optDefaultArg($o);
}
function __get($o) {
return $this->offsetGet($o);
}
function offsetSet($o, $v) {
$osn = $this->optShortName($o);
$oln = $this->optLongName($o);
if ($this->optIsMulti($o)) {
if (isset($osn)) {
$this->args["-$osn"][] = $v;
}
$this->args["--$oln"][] = $v;
} else {
if (isset($osn)) {
$this->args["-$osn"] = $v;
}
$this->args["--$oln"] = $v;
}
}
function __set($o, $v) {
$this->offsetSet($o, $v);
}
function offsetUnset($o) {
unset($this->args["-".$this->optShortName($o)]);
unset($this->args["--".$this->optLongName($o)]);
}
function __unset($o) {
$this->offsetUnset($o);
}
/**@-*/
}
<?php
namespace pharext\Cli;
use pharext\Archive;
use Phar;
trait Command
{
/**
* Command line arguments
* @var pharext\Cli\Args
*/
private $args;
/**
* @inheritdoc
* @see \pharext\Command::getArgs()
*/
public function getArgs() {
return $this->args;
}
/**
* Retrieve metadata of the currently running phar
* @param string $key
* @return mixed
*/
public function metadata($key = null) {
if (extension_loaded("Phar")) {
$running = new Phar(Phar::running(false));
} else {
$running = new Archive(PHAREXT_PHAR);
}
if ($key === "signature") {
$sig = $running->getSignature();
return sprintf("%s signature of %s\n%s",
$sig["hash_type"],
$this->metadata("name"),
chunk_split($sig["hash"], 64, "\n"));
}
$metadata = $running->getMetadata();
if (isset($key)) {
return $metadata[$key];
}
return $metadata;
}
/**
* Output pharext vX.Y.Z header
*/
public function header() {
if (!headers_sent()) {
/* only display header, if we didn't generate any output yet */
printf("%s\n\n", $this->metadata("header"));
}
}
/**
* @inheritdoc
* @see \pharext\Command::debug()
*/
public function debug($fmt) {
if ($this->args->verbose) {
vprintf($fmt, array_slice(func_get_args(), 1));
}
}
/**
* @inheritdoc
* @see \pharext\Command::info()
*/
public function info($fmt) {
if (!$this->args->quiet) {
vprintf($fmt, array_slice(func_get_args(), 1));
}
}
/**
* @inheritdoc
* @see \pharext\Command::warn()
*/
public function warn($fmt) {
if (!$this->args->quiet) {
if (!isset($fmt)) {
$fmt = "%s\n";
$arg = error_get_last()["message"];
} else {
$arg = array_slice(func_get_args(), 1);
}
vfprintf(STDERR, "Warning: $fmt", $arg);
}
}
/**
* @inheritdoc
* @see \pharext\Command::error()
*/
public function error($fmt) {
if (!isset($fmt)) {
$fmt = "%s\n";
$arg = error_get_last()["message"];
} else {
$arg = array_slice(func_get_args(), 1);
}
vfprintf(STDERR, "ERROR: $fmt", $arg);
}
/**
* Output command line help message
* @param string $prog
*/
public function help($prog) {
print new Args\Help($prog, $this->args);
}
/**
* Verbosity
* @return boolean
*/
public function verbosity() {
if ($this->args->verbose) {
return true;
} elseif ($this->args->quiet) {
return false;
} else {
return null;
}
}
}
<?php
namespace pharext;
/**
* Command interface
*/
interface Command
{
/**
* Argument error
*/
const EARGS = 1;
/**
* Build error
*/
const EBUILD = 2;
/**
* Signature error
*/
const ESIGN = 3;
/**
* Extract/unpack error
*/
const EEXTRACT = 4;
/**
* Install error
*/
const EINSTALL = 5;
/**
* Retrieve command line arguments
* @return pharext\Cli\Args
*/
public function getArgs();
/**
* Print debug message
* @param string $fmt
* @param string ...$args
*/
public function debug($fmt);
/**
* Print info
* @param string $fmt
* @param string ...$args
*/
public function info($fmt);
/**
* Print warning
* @param string $fmt
* @param string ...$args
*/
public function warn($fmt);
/**
* Print error
* @param string $fmt
* @param string ...$args
*/
public function error($fmt);
/**
* Execute the command
* @param int $argc command line argument count
* @param array $argv command line argument list
*/
public function run($argc, array $argv);
}
<?php
namespace pharext;
class Exception extends \Exception
{
public function __construct($message = null, $code = 0, $previous = null) {
if (!isset($message)) {
$last_error = error_get_last();
$message = $last_error["message"];
if (!$code) {
$code = $last_error["type"];
}
}
parent::__construct($message, $code, $previous);
}
}
<?php
namespace pharext;
/**
* Execute system command
*/
class ExecCmd
{
/**
* Sudo command, if the cmd needs escalated privileges
* @var string
*/
private $sudo;
/**
* Executable of the cmd
* @var string
*/
private $command;
/**
* Passthrough cmd output
* @var bool
*/
private $verbose;
/**
* Output of cmd run
* @var string
*/
private $output;
/**
* Return code of cmd run
* @var int
*/
private $status;
/**
* @param string $command
* @param bool verbose
*/
public function __construct($command, $verbose = false) {
$this->command = $command;
$this->verbose = $verbose;
}
/**
* (Re-)set sudo command
* @param string $sudo
*/
public function setSu($sudo = false) {
$this->sudo = $sudo;
}
/**
* Execute a program with escalated privileges handling interactive password prompt
* @param string $command
* @param bool $verbose
* @return int exit status
*/
private function suExec($command, $verbose = null) {
if (!($proc = proc_open($command, [STDIN,["pipe","w"],["pipe","w"]], $pipes))) {
$this->status = -1;
throw new Exception("Failed to run {$command}");
}
$stdout = $pipes[1];
$passwd = 0;
$checks = 10;
while (!feof($stdout)) {
$R = [$stdout]; $W = []; $E = [];
if (!stream_select($R, $W, $E, null)) {
continue;
}
$data = fread($stdout, 0x1000);
/* only check a few times */
if ($passwd < $checks) {
$passwd++;
if (stristr($data, "password")) {
$passwd = $checks + 1;
printf("\n%s", $data);
continue;
}
} elseif ($passwd > $checks) {
/* new line after pw entry */
printf("\n");
$passwd = $checks;
}
if ($verbose === null) {
print $this->progress($data, 0);
} else {
if ($verbose) {
printf("%s", $data);
}
$this->output .= $data;
}
}
if ($verbose === null) {
$this->progress("", PHP_OUTPUT_HANDLER_FINAL);
}
return $this->status = proc_close($proc);
}
/**
* Output handler that displays some progress while soaking output
* @param string $string
* @param int $flags
* @return string
*/
private function progress($string, $flags) {
static $counter = 0;
static $symbols = ["\\","|","/","-"];
$this->output .= $string;
if (false !== strpos($string, "\n")) {
++$counter;
}
return $flags & PHP_OUTPUT_HANDLER_FINAL
? " \r"
: sprintf(" %s\r", $symbols[$counter % 4]);
}
/**
* Run the command
* @param array $args
* @return \pharext\ExecCmd self
* @throws \pharext\Exception
*/
public function run(array $args = null) {
$exec = escapeshellcmd($this->command);
if ($args) {
$exec .= " ". implode(" ", array_map("escapeshellarg", (array) $args));
}
if ($this->sudo) {
$this->suExec(sprintf($this->sudo." 2>&1", $exec), $this->verbose);
} elseif ($this->verbose) {
ob_start(function($s) {
$this->output .= $s;
return $s;
}, 1);
passthru($exec, $this->status);
ob_end_flush();
} elseif ($this->verbose !== false /* !quiet */) {
ob_start([$this, "progress"], 1);
passthru($exec . " 2>&1", $this->status);
ob_end_flush();
} else {
exec($exec ." 2>&1", $output, $this->status);
$this->output = implode("\n", $output);
}
if ($this->status) {
throw new Exception("Command {$exec} failed ({$this->status})");
}
return $this;
}
/**
* Retrieve exit code of cmd run
* @return int
*/
public function getStatus() {
return $this->status;
}
/**
* Retrieve output of cmd run
* @return string
*/
public function getOutput() {
return $this->output;
}
}
<?php
namespace pharext;
use Phar;
use SplObjectStorage;
/**
* The extension install command executed by the extension phar
*/
class Installer implements Command
{
use Cli\Command;
/**
* Cleanups
* @var array
*/
private $cleanup = [];
/**
* Create the command
*/
public function __construct() {
$this->args = new Cli\Args([
["h", "help", "Display help",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
["v", "verbose", "More output",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
["q", "quiet", "Less output",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
["p", "prefix", "PHP installation prefix if phpize is not in \$PATH, e.g. /opt/php7",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::REQARG],
["n", "common-name", "PHP common program name, e.g. php5 or zts-php",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::REQARG,
"php"],
["c", "configure", "Additional extension configure flags, e.g. -c --with-flag",
Cli\Args::OPTIONAL|Cli\Args::MULTI|Cli\Args::REQARG],
["s", "sudo", "Installation might need increased privileges",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::OPTARG,
"sudo -S %s"],
["i", "ini", "Activate in this php.ini instead of loaded default php.ini",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::REQARG],
[null, "signature", "Show package signature",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
[null, "license", "Show package license",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
[null, "name", "Show package name",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
[null, "date", "Show package release date",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
[null, "release", "Show package release version",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
[null, "version", "Show pharext version",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
]);
}
/**
* Perform cleaniup
*/
function __destruct() {
foreach ($this->cleanup as $cleanup) {
$cleanup->run();
}
}
private function extract($phar) {
$temp = (new Task\Extract($phar))->run($this->verbosity());
$this->cleanup[] = new Task\Cleanup($temp);
return $temp;
}
private function hooks(SplObjectStorage $phars) {
$hook = [];
foreach ($phars as $phar) {
if (isset($phar["pharext_package.php"])) {
$sdir = include $phar["pharext_package.php"];
if ($sdir instanceof SourceDir) {
$this->args->compile($sdir->getArgs());
$hook[] = $sdir;
}
}
}
return $hook;
}
private function load() {
$list = new SplObjectStorage();
$phar = extension_loaded("Phar")
? new Phar(Phar::running(false))
: new Archive(PHAREXT_PHAR);
$temp = $this->extract($phar);
foreach ($phar as $entry) {
$dep_file = $entry->getBaseName();
if (fnmatch("*.ext.phar*", $dep_file)) {
$dep_phar = extension_loaded("Phar")
? new Phar("$temp/$dep_file")
: new Archive("$temp/$dep_file");
$list[$dep_phar] = $this->extract($dep_phar);
}
}
/* the actual ext.phar at last */
$list[$phar] = $temp;
return $list;
}
/**
* @inheritdoc
* @see \pharext\Command::run()
*/
public function run($argc, array $argv) {
try {
/* load the phar(s) */
$list = $this->load();
/* installer hooks */
$hook = $this->hooks($list);
} catch (\Exception $e) {
$this->error("%s\n", $e->getMessage());
exit(self::EEXTRACT);
}
/* standard arg stuff */
$errs = [];
$prog = array_shift($argv);
foreach ($this->args->parse(--$argc, $argv) as $error) {
$errs[] = $error;
}
if ($this->args["help"]) {
$this->header();
$this->help($prog);
exit;
}
try {
foreach (["signature", "name", "date", "license", "release", "version"] as $opt) {
if ($this->args[$opt]) {
printf("%s\n", $this->metadata($opt));
exit;
}
}
} catch (\Exception $e) {
$this->error("%s\n", $e->getMessage());
exit(self::EARGS);
}
foreach ($this->args->validate() as $error) {
$errs[] = $error;
}
if ($errs) {
if (!$this->args["quiet"]) {
$this->header();
}
foreach ($errs as $err) {
$this->error("%s\n", $err);
}
if (!$this->args["quiet"]) {
$this->help($prog);
}
exit(self::EARGS);
}
try {
/* post process hooks */
foreach ($hook as $sdir) {
$sdir->setArgs($this->args);
}
} catch (\Exception $e) {
$this->error("%s\n", $e->getMessage());
exit(self::EARGS);
}
/* install packages */
try {
foreach ($list as $phar) {
$this->info("Installing %s ...\n", basename($phar->getPath()));
$this->install($list[$phar]);
$this->activate($list[$phar]);
$this->info("Successfully installed %s!\n", basename($phar->getPath()));
}
} catch (\Exception $e) {
$this->error("%s\n", $e->getMessage());
exit(self::EINSTALL);
}
}
/**
* Phpize + trinity
*/
private function install($temp) {
// phpize
$phpize = new Task\Phpize($temp, $this->args->prefix, $this->args->{"common-name"});
$phpize->run($this->verbosity());
// configure
$configure = new Task\Configure($temp, $this->args->configure, $this->args->prefix, $this->args->{"common-name"});
$configure->run($this->verbosity());
// make
$make = new Task\Make($temp);
$make->run($this->verbosity());
// install
$sudo = isset($this->args->sudo) ? $this->args->sudo : null;
$install = new Task\Make($temp, ["install"], $sudo);
$install->run($this->verbosity());
}
private function activate($temp) {
if ($this->args->ini) {
$files = [$this->args->ini];
} else {
$files = array_filter(array_map("trim", explode(",", php_ini_scanned_files())));
$files[] = php_ini_loaded_file();
}
$sudo = isset($this->args->sudo) ? $this->args->sudo : null;
$type = $this->metadata("type") ?: "extension";
$activate = new Task\Activate($temp, $files, $type, $this->args->prefix, $this->args{"common-name"}, $sudo);
if (!$activate->run($this->verbosity())) {
$this->info("Extension already activated ...\n");
}
}
}
<?php
namespace pharext;
trait License
{
function findLicense($dir, $file = null) {
if (isset($file)) {
return realpath("$dir/$file");
}
$names = [];
foreach (["{,UN}LICEN{S,C}{E,ING}", "COPY{,ING,RIGHT}"] as $name) {
$names[] = $this->mergeLicensePattern($name, strtolower($name));
}
$exts = [];
foreach (["t{,e}xt", "rst", "asc{,i,ii}", "m{,ark}d{,own}", "htm{,l}"] as $ext) {
$exts[] = $this->mergeLicensePattern(strtoupper($ext), $ext);
}
$pattern = "{". implode(",", $names) ."}{,.{". implode(",", $exts) ."}}";
if (($glob = glob("$dir/$pattern", GLOB_BRACE))) {
return current($glob);
}
}
private function mergeLicensePattern($upper, $lower) {
$pattern = "";
$length = strlen($upper);
for ($i = 0; $i < $length; ++$i) {
if ($lower{$i} === $upper{$i}) {
$pattern .= $upper{$i};
} else {
$pattern .= "[" . $upper{$i} . $lower{$i} . "]";
}
}
return $pattern;
}
public function readLicense($file) {
$text = file_get_contents($file);
switch (strtolower(pathinfo($file, PATHINFO_EXTENSION))) {
case "htm":
case "html":
$text = strip_tags($text);
break;
}
return $text;
}
}
<?php
namespace pharext;
class Metadata
{
static function version() {
return "4.1.1";
}
static function header() {
return sprintf("pharext v%s (c) Michael Wallner <mike@php.net>", self::version());
}
static function date() {
return gmdate("Y-m-d");
}
static function all() {
return [
"version" => self::version(),
"header" => self::header(),
"date" => self::date(),
];
}
}
<?php
namespace pharext\Openssl;
use pharext\Exception;
class PrivateKey
{
/**
* Private key
* @var string
*/
private $key;
/**
* Public key
* @var string
*/
private $pub;
/**
* Read a private key
* @param string $file
* @param string $password
* @throws \pharext\Exception
*/
function __construct($file, $password) {
/* there appears to be a bug with refcount handling of this
* resource; when the resource is stored as property, it cannot be
* "coerced to a private key" on openssl_sign() later in another method
*/
$key = openssl_pkey_get_private("file://$file", $password);
if (!is_resource($key)) {
throw new Exception("Could not load private key");
}
openssl_pkey_export($key, $this->key);
$this->pub = openssl_pkey_get_details($key)["key"];
}
/**
* Sign the PHAR
* @param \Phar $package
*/
function sign(\Phar $package) {
$package->setSignatureAlgorithm(\Phar::OPENSSL, $this->key);
}
/**
* Export the public key to a file
* @param string $file
* @throws \pharext\Exception
*/
function exportPublicKey($file) {
if (!file_put_contents("$file.tmp", $this->pub) || !rename("$file.tmp", $file)) {
throw new Exception;
}
}
}
<?php
namespace pharext;
use Phar;
use pharext\Exception;
/**
* The extension packaging command executed by bin/pharext
*/
class Packager implements Command
{
use Cli\Command;
/**
* Extension source directory
* @var pharext\SourceDir
*/
private $source;
/**
* Cleanups
* @var array
*/
private $cleanup = [];
/**
* Create the command
*/
public function __construct() {
$this->args = new Cli\Args([
["h", "help", "Display this help",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
["v", "verbose", "More output",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
["q", "quiet", "Less output",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
["n", "name", "Extension name",
Cli\Args::REQUIRED|Cli\Args::SINGLE|Cli\Args::REQARG],
["r", "release", "Extension release version",
Cli\Args::REQUIRED|Cli\Args::SINGLE|Cli\Args::REQARG],
["s", "source", "Extension source directory",
Cli\Args::REQUIRED|Cli\Args::SINGLE|Cli\Args::REQARG],
["g", "git", "Use `git ls-tree` to determine file list",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
["b", "branch", "Checkout this tag/branch",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::REQARG],
["p", "pecl", "Use PECL package.xml to determine file list, name and release",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
["d", "dest", "Destination directory",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::REQARG,
"."],
["z", "gzip", "Create additional PHAR compressed with gzip",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
["Z", "bzip", "Create additional PHAR compressed with bzip",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
["S", "sign", "Sign the PHAR with a private key",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::REQARG],
["E", "zend", "Mark as Zend Extension",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
[null, "signature", "Show pharext signature",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
[null, "license", "Show pharext license",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
[null, "version", "Show pharext version",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
]);
}
/**
* Perform cleaniup
*/
function __destruct() {
foreach ($this->cleanup as $cleanup) {
$cleanup->run();
}
}
/**
* @inheritdoc
* @see \pharext\Command::run()
*/
public function run($argc, array $argv) {
$errs = [];
$prog = array_shift($argv);
foreach ($this->args->parse(--$argc, $argv) as $error) {
$errs[] = $error;
}
if ($this->args["help"]) {
$this->header();
$this->help($prog);
exit;
}
try {
foreach (["signature", "license", "version"] as $opt) {
if ($this->args[$opt]) {
printf("%s\n", $this->metadata($opt));
exit;
}
}
} catch (\Exception $e) {
$this->error("%s\n", $e->getMessage());
exit(self::EARGS);
}
try {
/* source needs to be evaluated before Cli\Args validation,
* so e.g. name and version can be overriden and Cli\Args
* does not complain about missing arguments
*/
$this->loadSource();
} catch (\Exception $e) {
$errs[] = $e->getMessage();
}
foreach ($this->args->validate() as $error) {
$errs[] = $error;
}
if ($errs) {
if (!$this->args["quiet"]) {
$this->header();
}
foreach ($errs as $err) {
$this->error("%s\n", $err);
}
printf("\n");
if (!$this->args["quiet"]) {
$this->help($prog);
}
exit(self::EARGS);
}
$this->createPackage();
}
/**
* Download remote source
* @param string $source
* @return string local source
*/
private function download($source) {
if ($this->args->git) {
$task = new Task\GitClone($source, $this->args->branch);
} else {
/* print newline only once */
$done = false;
$task = new Task\StreamFetch($source, function($bytes_pct) use(&$done) {
if (!$done) {
$this->info(" %3d%% [%s>%s] \r",
floor($bytes_pct*100),
str_repeat("=", round(50*$bytes_pct)),
str_repeat(" ", round(50*(1-$bytes_pct)))
);
if ($bytes_pct == 1) {
$done = true;
$this->info("\n");
}
}
});
}
$local = $task->run($this->verbosity());
$this->cleanup[] = new Task\Cleanup($local);
return $local;
}
/**
* Extract local archive
* @param stirng $source
* @return string extracted directory
*/
private function extract($source) {
try {
$task = new Task\Extract($source);
$dest = $task->run($this->verbosity());
} catch (\Exception $e) {
if (false === strpos($e->getMessage(), "checksum mismatch")) {
throw $e;
}
$dest = (new Task\PaxFixup($source))->run($this->verbosity());
}
$this->cleanup[] = new Task\Cleanup($dest);
return $dest;
}
/**
* Localize a possibly remote source
* @param string $source
* @return string local source directory
*/
private function localize($source) {
if (!stream_is_local($source) || ($this->args->git && isset($this->args->branch))) {
$source = $this->download($source);
$this->cleanup[] = new Task\Cleanup($source);
}
$source = realpath($source);
if (!is_dir($source)) {
$source = $this->extract($source);
$this->cleanup[] = new Task\Cleanup($source);
if (!$this->args->git) {
$source = (new Task\PeclFixup($source))->run($this->verbosity());
}
}
return $source;
}
/**
* Load the source dir
* @throws \pharext\Exception
*/
private function loadSource(){
if ($this->args["source"]) {
$source = $this->localize($this->args["source"]);
if ($this->args["pecl"]) {
$this->source = new SourceDir\Pecl($source);
} elseif ($this->args["git"]) {
$this->source = new SourceDir\Git($source);
} elseif (is_file("$source/pharext_package.php")) {
$this->source = include "$source/pharext_package.php";
} else {
$this->source = new SourceDir\Basic($source);
}
if (!$this->source instanceof SourceDir) {
throw new Exception("Unknown source dir $source");
}
foreach ($this->source->getPackageInfo() as $key => $val) {
$this->args->$key = $val;
}
}
}
/**
* Creates the extension phar
*/
private function createPackage() {
try {
$meta = array_merge(Metadata::all(), [
"name" => $this->args->name,
"release" => $this->args->release,
"license" => $this->source->getLicense(),
"type" => $this->args->zend ? "zend_extension" : "extension",
]);
$file = (new Task\PharBuild($this->source, __DIR__."/../pharext_installer.php", $meta))->run($this->verbosity());
} catch (\Exception $e) {
$this->error("%s\n", $e->getMessage());
exit(self::EBUILD);
}
try {
if ($this->args->sign) {
$this->info("Using private key to sign phar ...\n");
$pass = (new Task\Askpass)->run($this->verbosity());
$sign = new Task\PharSign($file, $this->args->sign, $pass);
$pkey = $sign->run($this->verbosity());
}
} catch (\Exception $e) {
$this->error("%s\n", $e->getMessage());
exit(self::ESIGN);
}
if ($this->args->gzip) {
try {
$gzip = (new Task\PharCompress($file, Phar::GZ))->run();
$move = new Task\PharRename($gzip, $this->args->dest, $this->args->name ."-". $this->args->release);
$name = $move->run($this->verbosity());
$this->info("Created gzipped phar %s\n", $name);
if ($this->args->sign) {
$sign = new Task\PharSign($name, $this->args->sign, $pass);
$sign->run($this->verbosity())->exportPublicKey($name.".pubkey");
}
} catch (\Exception $e) {
$this->warn("%s\n", $e->getMessage());
}
}
if ($this->args->bzip) {
try {
$bzip = (new Task\PharCompress($file, Phar::BZ2))->run();
$move = new Task\PharRename($bzip, $this->args->dest, $this->args->name ."-". $this->args->release);
$name = $move->run($this->verbosity());
$this->info("Created bzipped phar %s\n", $name);
if ($this->args->sign) {
$sign = new Task\PharSign($name, $this->args->sign, $pass);
$sign->run($this->verbosity())->exportPublicKey($name.".pubkey");
}
} catch (\Exception $e) {
$this->warn("%s\n", $e->getMessage());
}
}
try {
$move = new Task\PharRename($file, $this->args->dest, $this->args->name ."-". $this->args->release);
$name = $move->run($this->verbosity());
$this->info("Created executable phar %s\n", $name);
if (isset($pkey)) {
$pkey->exportPublicKey($name.".pubkey");
}
} catch (\Exception $e) {
$this->error("%s\n", $e->getMessage());
exit(self::EBUILD);
}
}
}
<?php
namespace pharext\SourceDir;
use pharext\Cli\Args;
use pharext\License;
use pharext\SourceDir;
use FilesystemIterator;
use IteratorAggregate;
use RecursiveCallbackFilterIterator;
use RecursiveDirectoryIterator;
use RecursiveIteratorIterator;
class Basic implements IteratorAggregate, SourceDir
{
use License;
private $path;
public function __construct($path) {
$this->path = $path;
}
public function getBaseDir() {
return $this->path;
}
public function getPackageInfo() {
return [];
}
public function getLicense() {
if (($file = $this->findLicense($this->getBaseDir()))) {
return $this->readLicense($file);
}
return "UNKNOWN";
}
public function getArgs() {
return [];
}
public function setArgs(Args $args) {
}
public function filter($current, $key, $iterator) {
$sub = $current->getSubPath();
if ($sub === ".git" || $sub === ".hg" || $sub === ".svn") {
return false;
}
return true;
}
public function getIterator() {
$rdi = new RecursiveDirectoryIterator($this->path,
FilesystemIterator::CURRENT_AS_SELF | // needed for 5.5
FilesystemIterator::KEY_AS_PATHNAME |
FilesystemIterator::SKIP_DOTS);
$rci = new RecursiveCallbackFilterIterator($rdi, [$this, "filter"]);
$rii = new RecursiveIteratorIterator($rci);
foreach ($rii as $path => $child) {
if (!$child->isDir()) {
yield realpath($path);
}
}
}
}
<?php
namespace pharext\SourceDir;
use pharext\Cli\Args;
use pharext\License;
use pharext\SourceDir;
/**
* Extension source directory which is a git repo
*/
class Git implements \IteratorAggregate, SourceDir
{
use License;
/**
* Base directory
* @var string
*/
private $path;
/**
* @inheritdoc
* @see \pharext\SourceDir::__construct()
*/
public function __construct($path) {
$this->path = $path;
}
/**
* @inheritdoc
* @see \pharext\SourceDir::getBaseDir()
*/
public function getBaseDir() {
return $this->path;
}
/**
* @inheritdoc
* @return array
*/
public function getPackageInfo() {
return [];
}
/**
* @inheritdoc
* @return string
*/
public function getLicense() {
if (($file = $this->findLicense($this->getBaseDir()))) {
return $this->readLicense($file);
}
return "UNKNOWN";
}
/**
* @inheritdoc
* @return array
*/
public function getArgs() {
return [];
}
/**
* @inheritdoc
*/
public function setArgs(Args $args) {
}
/**
* Generate a list of files by `git ls-files`
* @return Generator
*/
private function generateFiles() {
$pwd = getcwd();
chdir($this->path);
if (($pipe = popen("git ls-tree -r --name-only HEAD", "r"))) {
$path = realpath($this->path);
while (!feof($pipe)) {
if (strlen($file = trim(fgets($pipe)))) {
/* there may be symlinks, so no realpath here */
yield "$path/$file";
}
}
pclose($pipe);
}
chdir($pwd);
}
/**
* Implements IteratorAggregate
* @see IteratorAggregate::getIterator()
*/
public function getIterator() {
return $this->generateFiles();
}
}
<?php
namespace pharext\SourceDir;
use pharext\Cli\Args;
use pharext\Exception;
use pharext\SourceDir;
use pharext\License;
/**
* A PECL extension source directory containing a v2 package.xml
*/
class Pecl implements \IteratorAggregate, SourceDir
{
use License;
/**
* The package.xml
* @var SimpleXmlElement
*/
private $sxe;
/**
* The base directory
* @var string
*/
private $path;
/**
* The package.xml
* @var string
*/
private $file;
/**
* @inheritdoc
* @see \pharext\SourceDir::__construct()
*/
public function __construct($path) {
if (is_file("$path/package2.xml")) {
$sxe = simplexml_load_file($this->file = "$path/package2.xml");
} elseif (is_file("$path/package.xml")) {
$sxe = simplexml_load_file($this->file = "$path/package.xml");
} else {
throw new Exception("Missing package.xml in $path");
}
$sxe->registerXPathNamespace("pecl", $sxe->getDocNamespaces()[""]);
$this->sxe = $sxe;
$this->path = realpath($path);
}
/**
* @inheritdoc
* @see \pharext\SourceDir::getBaseDir()
*/
public function getBaseDir() {
return $this->path;
}
/**
* Retrieve gathered package info
* @return Generator
*/
public function getPackageInfo() {
if (($name = $this->sxe->xpath("/pecl:package/pecl:name"))) {
yield "name" => (string) $name[0];
}
if (($release = $this->sxe->xpath("/pecl:package/pecl:version/pecl:release"))) {
yield "release" => (string) $release[0];
}
if ($this->sxe->xpath("/pecl:package/pecl:zendextsrcrelease")) {
yield "zend" => true;
}
}
/**
* @inheritdoc
* @return string
*/
public function getLicense() {
if (($license = $this->sxe->xpath("/pecl:package/pecl:license"))) {
if (($file = $this->findLicense($this->getBaseDir(), $license[0]["filesource"]))) {
return $this->readLicense($file);
}
}
if (($file = $this->findLicense($this->getBaseDir()))) {
return $this->readLicense($file);
}
if ($license) {
return $license[0] ." ". $license[0]["uri"];
}
return "UNKNOWN";
}
/**
* @inheritdoc
* @see \pharext\SourceDir::getArgs()
*/
public function getArgs() {
$configure = $this->sxe->xpath("/pecl:package/pecl:extsrcrelease/pecl:configureoption");
foreach ($configure as $cfg) {
yield [null, $cfg["name"], ucfirst($cfg["prompt"]), Args::OPTARG,
strlen($cfg["default"]) ? $cfg["default"] : null];
}
$configure = $this->sxe->xpath("/pecl:package/pecl:zendextsrcrelease/pecl:configureoption");
foreach ($configure as $cfg) {
yield [null, $cfg["name"], ucfirst($cfg["prompt"]), Args::OPTARG,
strlen($cfg["default"]) ? $cfg["default"] : null];
}
}
/**
* @inheritdoc
* @see \pharext\SourceDir::setArgs()
*/
public function setArgs(Args $args) {
$configure = $this->sxe->xpath("/pecl:package/pecl:extsrcrelease/pecl:configureoption");
foreach ($configure as $cfg) {
if (isset($args[$cfg["name"]])) {
$args->configure = "--{$cfg["name"]}={$args[$cfg["name"]]}";
}
}
$configure = $this->sxe->xpath("/pecl:package/pecl:zendextsrcrelease/pecl:configureoption");
foreach ($configure as $cfg) {
if (isset($args[$cfg["name"]])) {
$args->configure = "--{$cfg["name"]}={$args[$cfg["name"]]}";
}
}
}
/**
* Compute the path of a file by parent dir nodes
* @param \SimpleXMLElement $ele
* @return string
*/
private function dirOf($ele) {
$path = "";
while (($ele = current($ele->xpath(".."))) && $ele->getName() == "dir") {
$path = trim($ele["name"], "/") ."/". $path ;
}
return trim($path, "/");
}
/**
* Generate a list of files from the package.xml
* @return Generator
*/
private function generateFiles() {
/* hook */
$temp = tmpfile();
fprintf($temp, "<?php\nreturn new %s(__DIR__);\n", get_class($this));
rewind($temp);
yield "pharext_package.php" => $temp;
/* deps */
$dependencies = $this->sxe->xpath("/pecl:package/pecl:dependencies/pecl:required/pecl:package");
foreach ($dependencies as $key => $dep) {
if (($glob = glob("{$this->path}/{$dep->name}-*.ext.phar*"))) {
usort($glob, function($a, $b) {
return version_compare(
substr($a, strpos(".ext.phar", $a)),
substr($b, strpos(".ext.phar", $b))
);
});
yield end($glob);
}
}
/* files */
yield realpath($this->file);
foreach ($this->sxe->xpath("//pecl:file") as $file) {
yield realpath($this->path ."/". $this->dirOf($file) ."/". $file["name"]);
}
}
/**
* Implements IteratorAggregate
* @see IteratorAggregate::getIterator()
*/
public function getIterator() {
return $this->generateFiles();
}
}
<?php
namespace pharext;
/**
* Source directory interface, which should yield file names to package on traversal
*/
interface SourceDir extends \Traversable
{
/**
* Retrieve the base directory
* @return string
*/
public function getBaseDir();
/**
* Retrieve gathered package info
* @return array|Traversable
*/
public function getPackageInfo();
/**
* Retrieve the full text license
* @return string
*/
public function getLicense();
/**
* Provide installer command line args
* @return array|Traversable
*/
public function getArgs();
/**
* Process installer command line args
* @param \pharext\Cli\Args $args
*/
public function setArgs(Cli\Args $args);
}
<?php
namespace pharext\Task;
use pharext\Exception;
use pharext\ExecCmd;
use pharext\Task;
use pharext\Tempfile;
/**
* PHP INI activation
*/
class Activate implements Task
{
/**
* @var string
*/
private $cwd;
/**
* @var array
*/
private $inis;
/**
* @var string
*/
private $type;
/**
* @var string
*/
private $php_config;
/**
* @var string
*/
private $sudo;
/**
* @param string $cwd working directory
* @param array $inis custom INI or list of loaded/scanned INI files
* @param string $type extension or zend_extension
* @param string $prefix install prefix, e.g. /usr/local
* @param string $common_name PHP programs common name, e.g. php5
* @param string $sudo sudo command
* @throws \pharext\Exception
*/
public function __construct($cwd, array $inis, $type = "extension", $prefix = null, $common_name = "php", $sudo = null) {
$this->cwd = $cwd;
$this->type = $type;
$this->sudo = $sudo;
if (!$this->inis = $inis) {
throw new Exception("No PHP INIs given");
}
$cmd = $common_name . "-config";
if (isset($prefix)) {
$cmd = $prefix . "/bin/" . $cmd;
}
$this->php_config = $cmd;
}
/**
* @param bool $verbose
* @return boolean false, if extension was already activated
*/
public function run($verbose = false) {
if ($verbose !== false) {
printf("Running INI activation ...\n");
}
$extension = basename(current(glob("{$this->cwd}/modules/*.so")));
if ($this->type === "zend_extension") {
$pattern = preg_quote((new ExecCmd($this->php_config))->run(["--extension-dir"])->getOutput() . "/$extension", "/");
} else {
$pattern = preg_quote($extension, "/");
}
foreach ($this->inis as $file) {
if ($verbose) {
printf("Checking %s ...\n", $file);
}
if (!file_exists($file)) {
throw new Exception(sprintf("INI file '%s' does not exist", $file));
}
$temp = new Tempfile("phpini");
foreach (file($file) as $line) {
if (preg_match("/^\s*{$this->type}\s*=\s*[\"']?{$pattern}[\"']?\s*(;.*)?\$/", $line)) {
return false;
}
fwrite($temp->getStream(), $line);
}
}
/* not found; append to last processed file, which is the main by default */
if ($verbose) {
printf("Activating in %s ...\n", $file);
}
fprintf($temp->getStream(), $this->type . "=%s\n", $extension);
$temp->closeStream();
$path = $temp->getPathname();
$stat = stat($file);
// owner transfer
$ugid = sprintf("%d:%d", $stat["uid"], $stat["gid"]);
$cmd = new ExecCmd("chown", $verbose);
if (isset($this->sudo)) {
$cmd->setSu($this->sudo);
}
$cmd->run([$ugid, $path]);
// permission transfer
$perm = decoct($stat["mode"] & 0777);
$cmd = new ExecCmd("chmod", $verbose);
if (isset($this->sudo)) {
$cmd->setSu($this->sudo);
}
$cmd->run([$perm, $path]);
// rename
$cmd = new ExecCmd("mv", $verbose);
if (isset($this->sudo)) {
$cmd->setSu($this->sudo);
}
$cmd->run([$path, $file]);
if ($verbose) {
printf("Replaced %s ...\n", $file);
}
return true;
}
}
<?php
namespace pharext\Task;
use pharext\Task;
/**
* Ask password on console
*/
class Askpass implements Task
{
/**
* @var string
*/
private $prompt;
/**
* @param string $prompt
*/
public function __construct($prompt = "Password:") {
$this->prompt = $prompt;
}
/**
* @param bool $verbose
* @return string
*/
public function run($verbose = false) {
system("stty -echo");
printf("%s ", $this->prompt);
$pass = fgets(STDIN, 1024);
printf("\n");
system("stty echo");
if (substr($pass, -1) == "\n") {
$pass = substr($pass, 0, -1);
}
return $pass;
}
}
<?php
namespace pharext\Task;
use pharext\Task;
use RecursiveDirectoryIterator;
use RecursiveIteratorIterator;
/**
* List all library files of pharext to bundle with a phar
*/
class BundleGenerator implements Task
{
/**
* @param bool $verbose
* @return Generator
*/
public function run($verbose = false) {
if ($verbose) {
printf("Packaging pharext ... \n");
}
$rdi = new RecursiveDirectoryIterator(dirname(dirname(__DIR__)));
$rii = new RecursiveIteratorIterator($rdi);
for ($rii->rewind(); $rii->valid(); $rii->next()) {
if (!$rii->isDot()) {
yield $rii->getSubPathname() => $rii->key();
}
}
}
}
<?php
namespace pharext\Task;
use pharext\Task;
use FilesystemIterator;
use RecursiveDirectoryIterator;
use RecursiveIteratorIterator;
/**
* Recursively cleanup FS entries
*/
class Cleanup implements Task
{
/**
* @var string
*/
private $rm;
public function __construct($rm) {
$this->rm = $rm;
}
/**
* @param bool $verbose
*/
public function run($verbose = false) {
if ($verbose) {
printf("Cleaning up %s ...\n", $this->rm);
}
if ($this->rm instanceof Tempfile) {
unset($this->rm);
} elseif (is_dir($this->rm)) {
$rdi = new RecursiveDirectoryIterator($this->rm,
FilesystemIterator::CURRENT_AS_SELF | // needed for 5.5
FilesystemIterator::KEY_AS_PATHNAME |
FilesystemIterator::SKIP_DOTS);
$rii = new RecursiveIteratorIterator($rdi,
RecursiveIteratorIterator::CHILD_FIRST);
foreach ($rii as $path => $child) {
if ($child->isDir()) {
@rmdir($path);
} else {
@unlink($path);
}
}
@rmdir($this->rm);
} elseif (file_exists($this->rm)) {
@unlink($this->rm);
}
}
}
<?php
namespace pharext\Task;
use pharext\Exception;
use pharext\ExecCmd;
use pharext\Task;
/**
* Runs extension's configure
*/
class Configure implements Task
{
/**
* @var array
*/
private $args;
/**
* @var string
*/
private $cwd;
/**
* @param string $cwd working directory
* @param array $args configure args
* @param string $prefix install prefix, e.g. /usr/local
* @param string $common_name PHP programs common name, e.g. php5
*/
public function __construct($cwd, array $args = null, $prefix = null, $common_name = "php") {
$this->cwd = $cwd;
$cmd = $common_name . "-config";
if (isset($prefix)) {
$cmd = $prefix . "/bin/" . $cmd;
}
$this->args = ["--with-php-config=$cmd"];
if ($args) {
$this->args = array_merge($this->args, $args);
}
}
public function run($verbose = false) {
if ($verbose !== false) {
printf("Running ./configure ...\n");
}
$pwd = getcwd();
if (!chdir($this->cwd)) {
throw new Exception;
}
try {
$cmd = new ExecCmd("./configure", $verbose);
$cmd->run($this->args);
} finally {
chdir($pwd);
}
}
}
<?php
namespace pharext\Task;
use pharext\Archive;
use pharext\Task;
use pharext\Tempdir;
use Phar;
use PharData;
/**
* Extract a package archive
*/
class Extract implements Task
{
/**
* @var Phar(Data)
*/
private $source;
/**
* @param mixed $source archive location
*/
public function __construct($source) {
if ($source instanceof Phar || $source instanceof PharData || $source instanceof Archive) {
$this->source = $source;
} else {
$this->source = new PharData($source);
}
}
/**
* @param bool $verbose
* @return \pharext\Tempdir
*/
public function run($verbose = false) {
if ($verbose) {
printf("Extracting %s ...\n", basename($this->source->getPath()));
}
if ($this->source instanceof Archive) {
return $this->source->extract();
}
$dest = new Tempdir("extract");
$this->source->extractTo($dest);
return $dest;
}
}
<?php
namespace pharext\Task;
use pharext\ExecCmd;
use pharext\Task;
use pharext\Tempdir;
/**
* Clone a git repo
*/
class GitClone implements Task
{
/**
* @var string
*/
private $source;
/**
* @var string
*/
private $branch;
/**
* @param string $source git repo location
*/
public function __construct($source, $branch = null) {
$this->source = $source;
$this->branch = $branch;
}
/**
* @param bool $verbose
* @return \pharext\Tempdir
*/
public function run($verbose = false) {
if ($verbose !== false) {
printf("Fetching %s ...\n", $this->source);
}
$local = new Tempdir("gitclone");
$cmd = new ExecCmd("git", $verbose);
if (strlen($this->branch)) {
$cmd->run(["clone", "--depth", 1, "--branch", $this->branch, $this->source, $local]);
} else {
$cmd->run(["clone", $this->source, $local]);
}
return $local;
}
}
<?php
namespace pharext\Task;
use pharext\ExecCmd;
use pharext\Exception;
use pharext\Task;
/**
* Run make in the source dir
*/
class Make implements Task
{
/**
* @var string
*/
private $cwd;
/**
* @var array
*/
private $args;
/**
* @var string
*/
private $sudo;
/**
*
* @param string $cwd working directory
* @param array $args make's arguments
* @param string $sudo sudo command
*/
public function __construct($cwd, array $args = null, $sudo = null) {
$this->cwd = $cwd;
$this->sudo = $sudo;
$this->args = $args;
}
/**
*
* @param bool $verbose
* @throws \pharext\Exception
*/
public function run($verbose = false) {
if ($verbose !== false) {
printf("Running make");
if ($this->args) {
foreach ($this->args as $arg) {
printf(" %s", $arg);
}
}
printf(" ...\n");
}
$pwd = getcwd();
if (!chdir($this->cwd)) {
throw new Exception;
}
try {
$cmd = new ExecCmd("make", $verbose);
if (isset($this->sudo)) {
$cmd->setSu($this->sudo);
}
$args = $this->args;
if (!$verbose) {
$args = array_merge((array) $args, ["-s"]);
}
$cmd->run($args);
} finally {
chdir($pwd);
}
}
}
<?php
namespace pharext\Task;
use pharext\Exception;
use pharext\Task;
use pharext\Tempfile;
class PaxFixup implements Task
{
private $source;
public function __construct($source) {
$this->source = $source;
}
private function openArchive($source) {
$hdr = file_get_contents($source, false, null, 0, 3);
if ($hdr === "\x1f\x8b\x08") {
$fd = fopen("compress.zlib://$source", "r");
} elseif ($hdr === "BZh") {
$fd = fopen("compress.bzip2://$source", "r");
} else {
$fd = fopen($source, "r");
}
if (!is_resource($fd)) {
throw new Exception;
}
return $fd;
}
public function run($verbose = false) {
if ($verbose !== false) {
printf("Fixing up a tarball with global pax header ...\n");
}
$temp = new Tempfile("paxfix");
stream_copy_to_stream($this->openArchive($this->source),
$temp->getStream(), -1, 1024);
$temp->closeStream();
return (new Extract((string) $temp))->run($verbose);
}
}<?php
namespace pharext\Task;
use pharext\Exception;
use pharext\Task;
/**
* Fixup package.xml files in an extracted PECL dir
*/
class PeclFixup implements Task
{
/**
* @var string
*/
private $source;
/**
* @param string $source source directory
*/
public function __construct($source) {
$this->source = $source;
}
/**
* @param bool $verbose
* @return string sanitized source location
* @throws \pahrext\Exception
*/
public function run($verbose = false) {
if ($verbose !== false) {
printf("Sanitizing PECL dir ...\n");
}
$dirs = glob("{$this->source}/*", GLOB_ONLYDIR);
$files = array_diff(glob("{$this->source}/*"), $dirs);
$check = array_reduce($files, function($r, $v) {
return $v && fnmatch("package*.xml", basename($v));
}, true);
if (count($dirs) !== 1 || !$check) {
throw new Exception("Does not look like an extracted PECL dir: {$this->source}");
}
$dest = current($dirs);
foreach ($files as $file) {
if ($verbose) {
printf("Moving %s into %s ...\n", basename($file), basename($dest));
}
if (!rename($file, "$dest/" . basename($file))) {
throw new Exception;
}
}
return $dest;
}
}
<?php
namespace pharext\Task;
use pharext\Exception;
use pharext\SourceDir;
use pharext\Task;
use pharext\Tempname;
use Phar;
/**
* Build phar
*/
class PharBuild implements Task
{
/**
* @var \pharext\SourceDir
*/
private $source;
/**
* @var string
*/
private $stub;
/**
* @var array
*/
private $meta;
/**
* @var bool
*/
private $readonly;
/**
* @param SourceDir $source extension source directory
* @param string $stub path to phar stub
* @param array $meta phar meta data
* @param bool $readonly whether the stub has -dphar.readonly=1 set
*/
public function __construct(SourceDir $source = null, $stub, array $meta = null, $readonly = true) {
$this->source = $source;
$this->stub = $stub;
$this->meta = $meta;
$this->readonly = $readonly;
}
/**
* @param bool $verbose
* @return \pharext\Tempname
* @throws \pharext\Exception
*/
public function run($verbose = false) {
/* Phar::compress() and ::convert*() use strtok("."), ugh!
* so, be sure to not use any other dots in the filename
* except for .phar
*/
$temp = new Tempname("", "-pharext.phar");
$phar = new Phar($temp);
$phar->startBuffering();
if ($this->meta) {
$phar->setMetadata($this->meta);
}
if ($this->stub) {
(new PharStub($phar, $this->stub))->run($verbose);
}
$phar->buildFromIterator((new Task\BundleGenerator)->run());
if ($this->source) {
if ($verbose) {
$bdir = $this->source->getBaseDir();
$blen = strlen($bdir);
foreach ($this->source as $index => $file) {
if (is_resource($file)) {
printf("Packaging %s ...\n", $index);
$phar[$index] = $file;
} else {
printf("Packaging %s ...\n", $index = trim(substr($file, $blen), "/"));
$phar->addFile($file, $index);
}
}
} else {
$phar->buildFromIterator($this->source, $this->source->getBaseDir());
}
}
$phar->stopBuffering();
if (!chmod($temp, fileperms($temp) | 0111)) {
throw new Exception;
}
return $temp;
}
}<?php
namespace pharext\Task;
use pharext\Task;
use Phar;
/**
* Clone a compressed copy of a phar
*/
class PharCompress implements Task
{
/**
* @var string
*/
private $file;
/**
* @var Phar
*/
private $package;
/**
* @var int
*/
private $encoding;
/**
* @var string
*/
private $extension;
/**
* @param string $file path to the original phar
* @param int $encoding Phar::GZ or Phar::BZ2
*/
public function __construct($file, $encoding) {
$this->file = $file;
$this->package = new Phar($file);
$this->encoding = $encoding;
switch ($encoding) {
case Phar::GZ:
$this->extension = ".gz";
break;
case Phar::BZ2:
$this->extension = ".bz2";
break;
}
}
/**
* @param bool $verbose
* @return string
*/
public function run($verbose = false) {
if ($verbose) {
printf("Compressing %s ...\n", basename($this->package->getPath()));
}
/* stop shebang */
$stub = $this->package->getStub();
$phar = $this->package->compress($this->encoding);
$phar->setStub(substr($stub, strpos($stub, "\n")+1));
return $this->file . $this->extension;
}
}
<?php
namespace pharext\Task;
use pharext\Exception;
use pharext\Task;
/**
* Rename the phar archive
*/
class PharRename implements Task
{
/**
* @var string
*/
private $phar;
/**
* @var string
*/
private $dest;
/**
* @var string
*/
private $name;
/**
* @param string $phar path to phar
* @param string $dest destination dir
* @param string $name package name
*/
public function __construct($phar, $dest, $name) {
$this->phar = $phar;
$this->dest = $dest;
$this->name = $name;
}
/**
* @param bool $verbose
* @return string path to renamed phar
* @throws \pharext\Exception
*/
public function run($verbose = false) {
$extension = substr(strstr($this->phar, "-pharext.phar"), 8);
$name = sprintf("%s/%s.ext%s", $this->dest, $this->name, $extension);
if ($verbose) {
printf("Renaming %s to %s ...\n", basename($this->phar), basename($name));
}
if (!rename($this->phar, $name)) {
throw new Exception;
}
return $name;
}
}
<?php
namespace pharext\Task;
use pharext\Openssl;
use pharext\Task;
use Phar;
/**
* Sign the phar with a private key
*/
class PharSign implements Task
{
/**
* @var Phar
*/
private $phar;
/**
* @var \pharext\Openssl\PrivateKey
*/
private $pkey;
/**
*
* @param mixed $phar phar instance or path to phar
* @param string $pkey path to private key
* @param string $pass password for the private key
*/
public function __construct($phar, $pkey, $pass) {
if ($phar instanceof Phar || $phar instanceof PharData) {
$this->phar = $phar;
} else {
$this->phar = new Phar($phar);
}
$this->pkey = new Openssl\PrivateKey($pkey, $pass);
}
/**
* @param bool $verbose
* @return \pharext\Openssl\PrivateKey
*/
public function run($verbose = false) {
if ($verbose) {
printf("Signing %s ...\n", basename($this->phar->getPath()));
}
$this->pkey->sign($this->phar);
return $this->pkey;
}
}
<?php
namespace pharext\Task;
use Phar;
use pharext\Exception;
use pharext\Task;
/**
* Set the phar's stub
*/
class PharStub implements Task
{
/**
* @var \Phar
*/
private $phar;
/**
* @var string
*/
private $stub;
/**
* @param \Phar $phar
* @param string $stub file path to the stub
* @throws \pharext\Exception
*/
function __construct(Phar $phar, $stub) {
$this->phar = $phar;
if (!file_exists($this->stub = $stub)) {
throw new Exception("File '$stub' does not exist");
}
}
/**
* @param bool $verbose
*/
function run($verbose = false) {
if ($verbose) {
printf("Using stub '%s'...\n", basename($this->stub));
}
$stub = preg_replace_callback('/^#include <([^>]+)>/m', function($includes) {
return file_get_contents($includes[1], true, null, 5);
}, file_get_contents($this->stub));
if ($this->phar->isCompressed() && substr($stub, 0, 2) === "#!") {
$stub = substr($stub, strpos($stub, "\n")+1);
}
$this->phar->setStub($stub);
}
}
<?php
namespace pharext\Task;
use pharext\Exception;
use pharext\ExecCmd;
use pharext\Task;
/**
* Run phpize in the extension source directory
*/
class Phpize implements Task
{
/**
* @var string
*/
private $phpize;
/**
*
* @var string
*/
private $cwd;
/**
* @param string $cwd working directory
* @param string $prefix install prefix, e.g. /usr/local
* @param string $common_name PHP program common name, e.g. php5
*/
public function __construct($cwd, $prefix = null, $common_name = "php") {
$this->cwd = $cwd;
$cmd = $common_name . "ize";
if (isset($prefix)) {
$cmd = $prefix . "/bin/" . $cmd;
}
$this->phpize = $cmd;
}
/**
* @param bool $verbose
* @throws \pharext\Exception
*/
public function run($verbose = false) {
if ($verbose !== false) {
printf("Running %s ...\n", $this->phpize);
}
$pwd = getcwd();
if (!chdir($this->cwd)) {
throw new Exception;
}
try {
$cmd = new ExecCmd($this->phpize, $verbose);
$cmd->run();
} finally {
chdir($pwd);
}
}
}
<?php
namespace pharext\Task;
use pharext\Exception;
use pharext\Task;
use pharext\Tempfile;
/**
* Fetch a remote archive
*/
class StreamFetch implements Task
{
/**
* @var string
*/
private $source;
/**
* @var callable
*/
private $progress;
/**
* @param string $source remote file location
* @param callable $progress progress callback
*/
public function __construct($source, callable $progress) {
$this->source = $source;
$this->progress = $progress;
}
private function createStreamContext() {
$progress = $this->progress;
/* avoid bytes_max bug of older PHP versions */
$maxbytes = 0;
return stream_context_create([],["notification" => function($notification, $severity, $message, $code, $bytes_cur, $bytes_max) use($progress, &$maxbytes) {
if ($bytes_max > $maxbytes) {
$maxbytes = $bytes_max;
}
switch ($notification) {
case STREAM_NOTIFY_CONNECT:
$progress(0);
break;
case STREAM_NOTIFY_PROGRESS:
$progress($maxbytes > 0 ? $bytes_cur/$maxbytes : .5);
break;
case STREAM_NOTIFY_COMPLETED:
/* this is sometimes not generated, why? */
$progress(1);
break;
}
}]);
}
/**
* @param bool $verbose
* @return \pharext\Task\Tempfile
* @throws \pharext\Exception
*/
public function run($verbose = false) {
if ($verbose !== false) {
printf("Fetching %s ...\n", $this->source);
}
$context = $this->createStreamContext();
if (!$remote = fopen($this->source, "r", false, $context)) {
throw new Exception;
}
$local = new Tempfile("remote");
if (!stream_copy_to_stream($remote, $local->getStream())) {
throw new Exception;
}
$local->closeStream();
/* STREAM_NOTIFY_COMPLETED is not generated, see above */
call_user_func($this->progress, 1);
return $local;
}
}
<?php
namespace pharext;
/**
* Simple task interface
*/
interface Task
{
public function run($verbose = false);
}
<?php
namespace pharext;
/**
* Create a temporary directory
*/
class Tempdir extends \SplFileInfo
{
/**
* @param string $prefix prefix to uniqid()
* @throws \pharext\Exception
*/
public function __construct($prefix) {
$temp = new Tempname($prefix);
if (!is_dir($temp) && !mkdir($temp, 0700, true)) {
throw new Exception("Could not create tempdir: ".error_get_last()["message"]);
}
parent::__construct($temp);
}
}
<?php
namespace pharext;
/**
* Create a new temporary file
*/
class Tempfile extends \SplFileInfo
{
/**
* @var resource
*/
private $handle;
/**
* @param string $prefix uniqid() prefix
* @param string $suffix e.g. file extension
* @throws \pharext\Exception
*/
public function __construct($prefix, $suffix = ".tmp") {
$tries = 0;
$omask = umask(077);
do {
$path = new Tempname($prefix, $suffix);
$this->handle = fopen($path, "x");
} while (!is_resource($this->handle) && $tries++ < 10);
umask($omask);
if (!is_resource($this->handle)) {
throw new Exception("Could not create temporary file");
}
parent::__construct($path);
}
/**
* Unlink the file
*/
public function __destruct() {
if (is_file($this->getPathname())) {
@unlink($this->getPathname());
}
}
/**
* Close the stream
*/
public function closeStream() {
fclose($this->handle);
}
/**
* Retrieve the stream resource
* @return resource
*/
public function getStream() {
return $this->handle;
}
}
<?php
namespace pharext;
use pharext\Exception;
/**
* A temporary file/directory name
*/
class Tempname
{
/**
* @var string
*/
private $name;
/**
* @param string $prefix uniqid() prefix
* @param string $suffix e.g. file extension
*/
public function __construct($prefix, $suffix = null) {
$temp = sys_get_temp_dir() . "/pharext-" . $this->getUser();
if (!is_dir($temp) && !mkdir($temp, 0700, true)) {
throw new Exception;
}
$this->name = $temp ."/". uniqid($prefix) . $suffix;
}
private function getUser() {
if (extension_loaded("posix") && function_exists("posix_getpwuid")) {
return posix_getpwuid(posix_getuid())["name"];
}
return trim(`whoami 2>/dev/null`)
?: trim(`id -nu 2>/dev/null`)
?: getenv("USER")
?: get_current_user();
}
/**
* @return string
*/
public function __toString() {
return (string) $this->name;
}
}
<?php
namespace pharext;
use Phar;
use PharFileInfo;
use SplFileInfo;
use pharext\Exception;
class Updater implements Command
{
use Cli\Command;
/**
* Create the command
*/
public function __construct() {
$this->args = new Cli\Args([
["h", "help", "Display this help",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
["v", "verbose", "More output",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
["q", "quiet", "Less output",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG],
[null, "signature", "Show pharext signature",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
[null, "license", "Show pharext license",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
[null, "version", "Show pharext version",
Cli\Args::OPTIONAL|Cli\Args::SINGLE|Cli\Args::NOARG|Cli\Args::HALT],
[0, "path", "Path to .ext.phar to update",
Cli\Args::REQUIRED|Cli\Args::MULTI],
]);
}
/**
* @inheritdoc
* @see \pharext\Command::run()
*/
public function run($argc, array $argv) {
$errs = [];
$prog = array_shift($argv);
foreach ($this->args->parse(--$argc, $argv) as $error) {
$errs[] = $error;
}
if ($this->args["help"]) {
$this->header();
$this->help($prog);
exit;
}
try {
foreach (["signature", "license", "version"] as $opt) {
if ($this->args[$opt]) {
printf("%s\n", $this->metadata($opt));
exit;
}
}
} catch (\Exception $e) {
$this->error("%s\n", $e->getMessage());
exit(self::EARGS);
}
foreach ($this->args->validate() as $error) {
$errs[] = $error;
}
if ($errs) {
if (!$this->args["quiet"]) {
$this->header();
}
foreach ($errs as $err) {
$this->error("%s\n", $err);
}
printf("\n");
if (!$this->args["quiet"]) {
$this->help($prog);
}
exit(self::EARGS);
}
foreach ($this->args[0] as $file) {
$info = new SplFileInfo($file);
while ($info->isLink()) {
$info = new SplFileInfo($info->getLinkTarget());
}
if ($info->isFile()) {
if (!$this->updatePackage($info)) {
$this->warn("Cannot upgrade pre-v3 packages\n");
}
} else {
$this->error("File '%s' does not exist\n", $file);
exit(self::EARGS);
}
}
}
/**
* Replace the pharext core in an .ext.phar package
* @param string $temp path to temp phar
* @return boolean FALSE if the package is too old (pre-v3) to upgrade
*/
private function replacePharext($temp) {
$phar = new Phar($temp, Phar::CURRENT_AS_SELF);
$phar->startBuffering();
if (!$meta = $phar->getMetadata()) {
// don't upgrade pre-v3 packages
return false;
}
// replace current pharext files
$core = (new Task\BundleGenerator)->run($this->verbosity());
$phar->buildFromIterator($core);
$stub = __DIR__."/../pharext_installer.php";
(new Task\PharStub($phar, $stub))->run($this->verbosity());
// check dependencies
foreach ($phar as $info) {
if (fnmatch("*.ext.phar*", $info->getBasename())) {
$this->updatePackage($info, $phar);
}
}
$phar->stopBuffering();
$phar->setMetadata([
"version" => Metadata::version(),
"header" => Metadata::header(),
] + $meta);
$this->info("Updated pharext version from '%s' to '%s'\n",
isset($meta["version"]) ? $meta["version"] : "(unknown)",
$phar->getMetadata()["version"]);
return true;
}
/**
* Update an .ext.phar package to the current pharext version
* @param SplFileInfo $file
* @param Phar $phar the parent phar containing $file as dependency
* @return boolean FALSE if the package is too old (pre-v3) to upgrade
* @throws Exception
*/
private function updatePackage(SplFileInfo $file, Phar $phar = null) {
$this->info("Updating pharext core in '%s'...\n", basename($file));
$temp = new Tempname("update", substr(strstr($file, ".ext.phar"), 4));
if (!copy($file->getPathname(), $temp)) {
throw new Exception;
}
if (!chmod($temp, $file->getPerms())) {
throw new Exception;
}
if (!$this->replacePharext($temp)) {
return false;
}
if ($phar) {
$phar->addFile($temp, $file);
} elseif (!rename($temp, $file->getPathname())) {
throw new Exception;
}
return true;
}
}
#!/usr/bin/env php
<?php
/**
* The installer sub-stub for extension phars
*/
namespace pharext;
define("PHAREXT_PHAR", __FILE__);
spl_autoload_register(function($c) {
return include strtr($c, "\\_", "//") . ".php";
});
#include <pharext/Exception.php>
#include <pharext/Tempname.php>
#include <pharext/Tempfile.php>
#include <pharext/Tempdir.php>
#include <pharext/Archive.php>
namespace pharext;
if (extension_loaded("Phar")) {
\Phar::interceptFileFuncs();
\Phar::mapPhar();
$phardir = "phar://".__FILE__;
} else {
$archive = new Archive(__FILE__);
$phardir = $archive->extract();
}
set_include_path("$phardir:". get_include_path());
$installer = new Installer();
$installer->run($argc, $argv);
__HALT_COMPILER();
#!/usr/bin/php -dphar.readonly=0
<?php
/**
* The packager sub-stub for bin/pharext
*/
namespace pharext;
spl_autoload_register(function($c) {
return include strtr($c, "\\_", "//") . ".php";
});
set_include_path('phar://' . __FILE__ .":". get_include_path());
if (!extension_loaded("Phar")) {
fprintf(STDERR, "ERROR: Phar extension not loaded\n\n");
fprintf(STDERR, "\tPlease load the phar extension in your php.ini\n".
"\tor rebuild PHP with the --enable-phar flag.\n\n");
exit(1);
}
if (ini_get("phar.readonly")) {
fprintf(STDERR, "ERROR: Phar is configured read-only\n\n");
fprintf(STDERR, "\tPlease specify phar.readonly=0 in your php.ini\n".
"\tor run this command with php -dphar.readonly=0\n\n");
exit(1);
}
\Phar::interceptFileFuncs();
\Phar::mapPhar();
$packager = new Packager();
$packager->run($argc, $argv);
__HALT_COMPILER();
#!/usr/bin/php -dphar.readonly=0
<?php
/**
* The installer updater stub for extension phars
*/
namespace pharext;
spl_autoload_register(function($c) {
return include strtr($c, "\\_", "//") . ".php";
});
set_include_path('phar://' . __FILE__ .":". get_include_path());
if (!extension_loaded("Phar")) {
fprintf(STDERR, "ERROR: Phar extension not loaded\n\n");
fprintf(STDERR, "\tPlease load the phar extension in your php.ini\n".
"\tor rebuild PHP with the --enable-phar flag.\n\n");
exit(1);
}
if (ini_get("phar.readonly")) {
fprintf(STDERR, "ERROR: Phar is configured read-only\n\n");
fprintf(STDERR, "\tPlease specify phar.readonly=0 in your php.ini\n".
"\tor run this command with php -dphar.readonly=0\n\n");
exit(1);
}
\Phar::interceptFileFuncs();
\Phar::mapPhar();
$updater = new Updater();
$updater->run($argc, $argv);
__HALT_COMPILER();
<?php
return new pharext\SourceDir\Pecl(__DIR__);
<?xml version="1.0" encoding="UTF-8"?>
<package packagerversion="1.10.1" 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&apos;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>2016-01-19</date>
<time>07:07:00</time>
<version>
<release>1.1.2</release>
<api>1.0.0</api>
</version>
<stability>
<release>stable</release>
<api>stable</api>
</stability>
<license>BSD, revised</license>
<notes>
* Fixed release stability to stable
</notes>
<contents>
<dir name="/">
<file md5sum="37a9ca6b65d6b99c9e9e4e073e0f80ff" name="src/php_raphf_api.h" role="src" />
<file md5sum="a253b8964470973a9fdfb3527160a56b" name="src/php_raphf_api.c" role="src" />
<file md5sum="5af3c5a1c48c86df8bae7bf4ea1502b0" name="scripts/gen_travis_yml.php" role="src" />
<file md5sum="406087b2f4d3b29a266b50cb585067dd" name="tests/http001.phpt" role="test" />
<file md5sum="41fdb28308a85e336c86d37a85254f4d" name="tests/http002.phpt" role="test" />
<file md5sum="61acb4187c31243f5fab8396839713eb" name="tests/http003.phpt" role="test" />
<file md5sum="b8f16441c1de313daa127d76e927c179" name="tests/http004.phpt" role="test" />
<file md5sum="f00d3c40b7d279e4f72b8464c2ac08b5" name="AUTHORS" role="doc" />
<file md5sum="4e80a777613575ef042d64749d01573b" name="BUGS" role="doc" />
<file md5sum="e08900397d959898138ad2128935d922" name="CONTRIBUTING.md" role="doc" />
<file md5sum="3f3a0065594119c8480bdeb8389af171" name="CREDITS" role="doc" />
<file md5sum="a3b4fd992df13edab98ba5c58c0a0b0a" name="LICENSE" role="doc" />
<file md5sum="e8f740975a8aa0e741f7e88d572474b8" name="README.md" role="doc" />
<file md5sum="cd0b941fc7688653edbdb0e7b15e074b" name="THANKS" role="doc" />
<file md5sum="0740ef89d5dd0d273e2e8f994a30ea9e" name="TODO" role="doc" />
<file md5sum="34cb8a3fc141a1f050bf02acf26df27b" name="Doxyfile" role="doc" />
<file md5sum="bbc7d260c89a883d29f35f4b42a2ba51" name="config.m4" role="src" />
<file md5sum="069a81e1f666ffc8def7201dab123d44" name="config0.m4" role="src" />
<file md5sum="ebf8bff059e4a5987e06c510554106c0" name="config.w32" role="src" />
<file md5sum="5723e39cd24b82066f7758c75d6126e9" name="Makefile.frag" role="src" />
<file md5sum="50b0094d8d3a85246c64845725234d3a" name="php_raphf.h" role="src" />
</dir>
</contents>
<dependencies>
<required>
<php>
<min>5.3.0</min>
<max>7.0.0</max>
<exclude>7.0.0</exclude>
</php>
<pearinstaller>
<min>1.4.0</min>
</pearinstaller>
</required>
</dependencies>
<providesextension>raphf</providesextension>
<extsrcrelease />
</package>
/*
+--------------------------------------------------------------------+
| PECL :: raphf |
+--------------------------------------------------------------------+
| Redistribution and use in source and binary forms, with or without |
| modification, are permitted provided that the conditions mentioned |
| in the accompanying LICENSE file are met. |
+--------------------------------------------------------------------+
| Copyright (c) 2013, Michael Wallner <mike@php.net> |
+--------------------------------------------------------------------+
*/
#ifndef PHP_RAPHF_API_H
#define PHP_RAPHF_API_H
/**
* A resource constructor.
*
* @param opaque is the \a data from php_persistent_handle_provide()
* @param init_arg is the \a init_arg from php_resource_factory_init()
* @return the created (persistent) handle
*/
typedef void *(*php_resource_factory_handle_ctor_t)(void *opaque,
void *init_arg TSRMLS_DC);
/**
* The copy constructor of a resource.
*
* @param opaque the factory's data
* @param handle the (persistent) handle to copy
*/
typedef void *(*php_resource_factory_handle_copy_t)(void *opaque,
void *handle TSRMLS_DC);
/**
* The destructor of a resource.
*
* @param opaque the factory's data
* @param handle the handle to destroy
*/
typedef void (*php_resource_factory_handle_dtor_t)(void *opaque,
void *handle TSRMLS_DC);
/**
* The resource ops consisting of a ctor, a copy ctor and a dtor.
*
* Define this ops and register them with php_persistent_handle_provide()
* in MINIT.
*/
typedef struct php_resource_factory_ops {
/** The resource constructor */
php_resource_factory_handle_ctor_t ctor;
/** The resource's copy constructor */
php_resource_factory_handle_copy_t copy;
/** The resource's destructor */
php_resource_factory_handle_dtor_t dtor;
} php_resource_factory_ops_t;
/**
* The resource factory.
*/
typedef struct php_resource_factory {
/** The resource ops */
php_resource_factory_ops_t fops;
/** Opaque user data */
void *data;
/** User data destructor */
void (*dtor)(void *data);
/** How often this factory is referenced */
unsigned refcount;
} php_resource_factory_t;
/**
* Initialize a resource factory.
*
* If you register a \a dtor for a resource factory used with a persistent
* handle provider, be sure to call php_persistent_handle_cleanup() for your
* registered provider in MSHUTDOWN, else the dtor will point to no longer
* available memory if the extension has already been unloaded.
*
* @param f the factory to initialize; if NULL allocated on the heap
* @param fops the resource ops to assign to the factory
* @param data opaque user data; may be NULL
* @param dtor a destructor for the data; may be NULL
* @return \a f or an allocated resource factory
*/
PHP_RAPHF_API php_resource_factory_t *php_resource_factory_init(
php_resource_factory_t *f, php_resource_factory_ops_t *fops, void *data,
void (*dtor)(void *data));
/**
* Increase the refcount of the resource factory.
*
* @param rf the resource factory
* @return the new refcount
*/
PHP_RAPHF_API unsigned php_resource_factory_addref(php_resource_factory_t *rf);
/**
* Destroy the resource factory.
*
* If the factory's refcount reaches 0, the \a dtor for \a data is called.
*
* @param f the resource factory
*/
PHP_RAPHF_API void php_resource_factory_dtor(php_resource_factory_t *f);
/**
* Destroy and free the resource factory.
*
* Calls php_resource_factory_dtor() and frees \æ f if the factory's refcount
* reached 0.
*
* @param f the resource factory
*/
PHP_RAPHF_API void php_resource_factory_free(php_resource_factory_t **f);
/**
* Construct a resource by the resource factory \a f
*
* @param f the resource factory
* @param init_arg for the resource constructor
* @return the new resource
*/
PHP_RAPHF_API void *php_resource_factory_handle_ctor(php_resource_factory_t *f,
void *init_arg TSRMLS_DC);
/**
* Create a copy of the resource \a handle
*
* @param f the resource factory
* @param handle the resource to copy
* @return the copy
*/
PHP_RAPHF_API void *php_resource_factory_handle_copy(php_resource_factory_t *f,
void *handle TSRMLS_DC);
/**
* Destroy (and free) the resource
*
* @param f the resource factory
* @param handle the resource to destroy
*/
PHP_RAPHF_API void php_resource_factory_handle_dtor(php_resource_factory_t *f,
void *handle TSRMLS_DC);
/**
* Persistent handles storage
*/
typedef struct php_persistent_handle_list {
/** Storage of free resources */
HashTable free;
/** Count of acquired resources */
ulong used;
} php_persistent_handle_list_t;
/**
* Definition of a persistent handle provider.
* Holds a resource factory an a persistent handle list.
*/
typedef struct php_persistent_handle_provider {
/**
* The list of free handles.
* Hash of "ident" => array(handles) entries. Persistent handles are
* acquired out of this list.
*/
php_persistent_handle_list_t list;
/**
* The resource factory.
* New handles are created by this factory.
*/
php_resource_factory_t rf;
} php_persistent_handle_provider_t;
typedef struct php_persistent_handle_factory php_persistent_handle_factory_t;
/**
* Wakeup the persistent handle on re-acquisition.
*/
typedef void (*php_persistent_handle_wakeup_t)(
php_persistent_handle_factory_t *f, void **handle TSRMLS_DC);
/**
* Retire the persistent handle on release.
*/
typedef void (*php_persistent_handle_retire_t)(
php_persistent_handle_factory_t *f, void **handle TSRMLS_DC);
/**
* Definition of a persistent handle factory.
*
* php_persistent_handle_concede() will return a pointer to a
* php_persistent_handle_factory if a provider for the \a name_str has
* been registered with php_persistent_handle_provide().
*/
struct php_persistent_handle_factory {
/** The persistent handle provider */
php_persistent_handle_provider_t *provider;
/** The persistent handle wakeup routine; may be NULL */
php_persistent_handle_wakeup_t wakeup;
/** The persistent handle retire routine; may be NULL */
php_persistent_handle_retire_t retire;
/** The ident for which this factory manages resources */
struct {
/** ident string */
char *str;
/** ident length */
size_t len;
} ident;
/** Whether it has to be free'd on php_persistent_handle_abandon() */
unsigned free_on_abandon:1;
};
/**
* Register a persistent handle provider in MINIT.
*
* Registers a factory provider for \a name_str with \a fops resource factory
* ops. Call this in your MINIT.
*
* A php_resource_factory will be created with \a fops, \a data and \a dtor
* and will be stored together with a php_persistent_handle_list in the global
* raphf hash.
*
* A php_persistent_handle_factory can then be retrieved by
* php_persistent_handle_concede() at runtime.
*
* @param name_str the provider name, e.g. "http\Client\Curl"
* @param name_len the provider name length, e.g. strlen("http\Client\Curl")
* @param fops the resource factory ops
* @param data opaque user data
* @param dtor \a data destructor
* @return SUCCESS/FAILURE
*/
PHP_RAPHF_API int /* SUCCESS|FAILURE */ php_persistent_handle_provide(
const char *name_str, size_t name_len, php_resource_factory_ops_t *fops,
void *data, void (*dtor)(void *) TSRMLS_DC);
/**
* Retrieve a persistent handle factory at runtime.
*
* If a persistent handle provider has been registered for \a name_str, a new
* php_persistent_handle_factory creating resources in the \a ident_str
* namespace will be constructed.
*
* The wakeup routine \a wakeup and the retire routine \a retire will be
* assigned to the new php_persistent_handle_factory.
*
* @param a pointer to a factory; allocated on the heap if NULL
* @param name_str the provider name, e.g. "http\Client\Curl"
* @param name_len the provider name length, e.g. strlen("http\Client\Curl")
* @param ident_str the subsidiary namespace, e.g. "php.net:80"
* @param ident_len the subsidiary namespace lenght, e.g. strlen("php.net:80")
* @param wakeup any persistent handle wakeup routine
* @param retire any persistent handle retire routine
* @return \a a or an allocated persistent handle factory
*/
PHP_RAPHF_API php_persistent_handle_factory_t *php_persistent_handle_concede(
php_persistent_handle_factory_t *a, const char *name_str,
size_t name_len, const char *ident_str, size_t ident_len,
php_persistent_handle_wakeup_t wakeup,
php_persistent_handle_retire_t retire TSRMLS_DC);
/**
* Abandon the persistent handle factory.
*
* Destroy a php_persistent_handle_factory created by
* php_persistent_handle_concede(). If the memory for the factory was allocated,
* it will automatically be free'd.
*
* @param a the persistent handle factory to destroy
*/
PHP_RAPHF_API void php_persistent_handle_abandon(
php_persistent_handle_factory_t *a);
/**
* Acquire a persistent handle.
*
* That is, either re-use a resource from the free list or create a new handle.
*
* If a handle is acquired from the free list, the
* php_persistent_handle_factory::wakeup callback will be executed for that
* handle.
*
* @param a the persistent handle factory
* @param init_arg the \a init_arg for php_resource_factory_handle_ctor()
* @return the acquired resource
*/
PHP_RAPHF_API void *php_persistent_handle_acquire(
php_persistent_handle_factory_t *a, void *init_arg TSRMLS_DC);
/**
* Release a persistent handle.
*
* That is, either put it back into the free list for later re-use or clean it
* up with php_resource_factory_handle_dtor().
*
* If a handle is put back into the free list, the
* php_persistent_handle_factory::retire callback will be executed for that
* handle.
*
* @param a the persistent handle factory
* @param handle the handle to release
*/
PHP_RAPHF_API void php_persistent_handle_release(
php_persistent_handle_factory_t *a, void *handle TSRMLS_DC);
/**
* Copy a persistent handle.
*
* Let the underlying resource factory copy the \a handle.
*
* @param a the persistent handle factory
* @param handle the resource to accrete
*/
PHP_RAPHF_API void *php_persistent_handle_accrete(
php_persistent_handle_factory_t *a, void *handle TSRMLS_DC);
/**
* Retrieve persistent handle resource factory ops.
*
* These ops can be used to mask a persistent handle factory as
* resource factory itself, so you can transparently use the
* resource factory API, both for persistent and non-persistent
* ressources.
*
* Example:
* \code{.c}
* php_resource_factory_t *create_my_rf(const char *persistent_id_str,
* size_t persistent_id_len TSRMLS_DC)
* {
* php_resource_factory_t *rf;
*
* if (persistent_id_str) {
* php_persistent_handle_factory_t *pf;
* php_resource_factory_ops_t *ops;
*
* ops = php_persistent_handle_get_resource_factory_ops();
*
* pf = php_persistent_handle_concede(NULL, "my", 2,
* persistent_id_str, persistent_id_len, NULL, NULL TSRMLS_CC);
*
* rf = php_persistent_handle_resource_factory_init(NULL, pf);
* } else {
* rf = php_resource_factory_init(NULL, &myops, NULL, NULL);
* }
* return rf;
* }
* \endcode
*/
PHP_RAPHF_API php_resource_factory_ops_t *
php_persistent_handle_get_resource_factory_ops(void);
/**
* Create a resource factory for persistent handles.
*
* This will create a resource factory with persistent handle ops, which wraps
* the provided reource factory \a pf.
*
* @param a the persistent handle resource factory to initialize
* @param pf the resource factory to wrap
*/
PHP_RAPHF_API php_resource_factory_t *
php_persistent_handle_resource_factory_init(php_resource_factory_t *a,
php_persistent_handle_factory_t *pf);
/**
* Check whether a resource factory is a persistent handle resource factory.
*
* @param a the resource factory to check
*/
PHP_RAPHF_API zend_bool php_resource_factory_is_persistent(
php_resource_factory_t *a);
/**
* Clean persistent handles up.
*
* Destroy persistent handles of provider \a name_str and in subsidiary
* namespace \a ident_str.
*
* If \a name_str is NULL, all persistent handles of all providers with a
* matching \a ident_str will be cleaned up.
*
* If \a ident_str is NULL all persistent handles of the provider will be
* cleaned up.
*
* Ergo, if both, \a name_str and \a ident_str are NULL, then all
* persistent handles will be cleaned up.
*
* You must call this in MSHUTDOWN, if your resource factory ops hold a
* registered php_resource_factory::dtor, else the dtor will point to
* memory not any more available if the extension has already been unloaded.
*
* @param name_str the provider name; may be NULL
* @param name_len the provider name length
* @param ident_str the subsidiary namespace name; may be NULL
* @param ident_len the subsidiary namespace name length
*/
PHP_RAPHF_API void php_persistent_handle_cleanup(const char *name_str,
size_t name_len, const char *ident_str, size_t ident_len TSRMLS_DC);
/**
* Retrieve statistics about the current process/thread's persistent handles.
*
* @return a HashTable like:
* \code
* [
* "name" => [
* "ident" => [
* "used" => 1,
* "free" => 0,
* ]
* ]
* ]
* \endcode
*/
PHP_RAPHF_API HashTable *php_persistent_handle_statall(HashTable *ht TSRMLS_DC);
#endif /* PHP_RAPHF_API_H */
/*
* Local variables:
* tab-width: 4
* c-basic-offset: 4
* End:
* vim600: noet sw=4 ts=4 fdm=marker
* vim<600: noet sw=4 ts=4
*/
/*
+--------------------------------------------------------------------+
| PECL :: raphf |
+--------------------------------------------------------------------+
| Redistribution and use in source and binary forms, with or without |
| modification, are permitted provided that the conditions mentioned |
| in the accompanying LICENSE file are met. |
+--------------------------------------------------------------------+
| Copyright (c) 2013, Michael Wallner <mike@php.net> |
+--------------------------------------------------------------------+
*/
#ifdef HAVE_CONFIG_H
# include "config.h"
#endif
#include "php.h"
#include "php_ini.h"
#include "ext/standard/info.h"
#include "php_raphf.h"
struct php_persistent_handle_globals {
ulong limit;
HashTable hash;
};
ZEND_BEGIN_MODULE_GLOBALS(raphf)
struct php_persistent_handle_globals persistent_handle;
ZEND_END_MODULE_GLOBALS(raphf)
#ifdef ZTS
# define PHP_RAPHF_G ((zend_raphf_globals *) \
(*((void ***) tsrm_ls))[TSRM_UNSHUFFLE_RSRC_ID(raphf_globals_id)])
#else
# define PHP_RAPHF_G (&raphf_globals)
#endif
ZEND_DECLARE_MODULE_GLOBALS(raphf)
#if PHP_VERSION_ID < 50500
#undef SUCCESS
#undef FAILURE
typedef enum {
SUCCESS = 0,
FAILURE = -1
} ZEND_RESULT_CODE;
#endif
#ifndef PHP_RAPHF_DEBUG_PHANDLES
# define PHP_RAPHF_DEBUG_PHANDLES 0
#endif
#if PHP_RAPHF_DEBUG_PHANDLES
# undef inline
# define inline
#endif
php_resource_factory_t *php_resource_factory_init(php_resource_factory_t *f,
php_resource_factory_ops_t *fops, void *data, void (*dtor)(void *data))
{
if (!f) {
f = emalloc(sizeof(*f));
}
memset(f, 0, sizeof(*f));
memcpy(&f->fops, fops, sizeof(*fops));
f->data = data;
f->dtor = dtor;
f->refcount = 1;
return f;
}
unsigned php_resource_factory_addref(php_resource_factory_t *rf)
{
return ++rf->refcount;
}
void php_resource_factory_dtor(php_resource_factory_t *f)
{
--f->refcount;
if (!f->refcount) {
if (f->dtor) {
f->dtor(f->data);
}
}
}
void php_resource_factory_free(php_resource_factory_t **f)
{
if (*f) {
php_resource_factory_dtor(*f);
if (!(*f)->refcount) {
efree(*f);
*f = NULL;
}
}
}
void *php_resource_factory_handle_ctor(php_resource_factory_t *f,
void *init_arg TSRMLS_DC)
{
if (f->fops.ctor) {
return f->fops.ctor(f->data, init_arg TSRMLS_CC);
}
return NULL;
}
void *php_resource_factory_handle_copy(php_resource_factory_t *f,
void *handle TSRMLS_DC)
{
if (f->fops.copy) {
return f->fops.copy(f->data, handle TSRMLS_CC);
}
return NULL;
}
void php_resource_factory_handle_dtor(php_resource_factory_t *f,
void *handle TSRMLS_DC)
{
if (f->fops.dtor) {
f->fops.dtor(f->data, handle TSRMLS_CC);
}
}
php_resource_factory_t *php_persistent_handle_resource_factory_init(
php_resource_factory_t *a, php_persistent_handle_factory_t *pf)
{
return php_resource_factory_init(a,
php_persistent_handle_get_resource_factory_ops(), pf,
(void(*)(void*)) php_persistent_handle_abandon);
}
zend_bool php_resource_factory_is_persistent(php_resource_factory_t *a)
{
return a->dtor == (void(*)(void *)) php_persistent_handle_abandon;
}
static inline php_persistent_handle_list_t *php_persistent_handle_list_init(
php_persistent_handle_list_t *list)
{
int free_list;
if ((free_list = !list)) {
list = pemalloc(sizeof(php_persistent_handle_list_t), 1);
}
list->used = 0;
if (SUCCESS != zend_hash_init(&list->free, 0, NULL, NULL, 1)) {
if (free_list) {
pefree(list, 1);
}
list = NULL;
}
return list;
}
static int php_persistent_handle_apply_stat(void *p TSRMLS_DC, int argc,
va_list argv, zend_hash_key *key)
{
php_persistent_handle_list_t **list = p;
zval *zsubentry, *zentry = va_arg(argv, zval *);
MAKE_STD_ZVAL(zsubentry);
array_init(zsubentry);
add_assoc_long_ex(zsubentry, ZEND_STRS("used"), (*list)->used);
add_assoc_long_ex(zsubentry, ZEND_STRS("free"),
zend_hash_num_elements(&(*list)->free));
add_assoc_zval_ex(zentry, key->arKey, key->nKeyLength, zsubentry);
return ZEND_HASH_APPLY_KEEP;
}
static int php_persistent_handle_apply_statall(void *p TSRMLS_DC, int argc,
va_list argv, zend_hash_key *key)
{
php_persistent_handle_provider_t *provider = p;
HashTable *ht = va_arg(argv, HashTable *);
zval *zentry;
MAKE_STD_ZVAL(zentry);
array_init(zentry);
zend_hash_apply_with_arguments(&provider->list.free TSRMLS_CC,
php_persistent_handle_apply_stat, 1, zentry);
zend_symtable_update(ht, key->arKey, key->nKeyLength, &zentry,
sizeof(zval *), NULL);
return ZEND_HASH_APPLY_KEEP;
}
static int php_persistent_handle_apply_cleanup_ex(void *pp, void *arg TSRMLS_DC)
{
php_resource_factory_t *rf = arg;
void **handle = pp;
#if PHP_RAPHF_DEBUG_PHANDLES
fprintf(stderr, "DESTROY: %p\n", *handle);
#endif
php_resource_factory_handle_dtor(rf, *handle TSRMLS_CC);
return ZEND_HASH_APPLY_REMOVE;
}
static int php_persistent_handle_apply_cleanup(void *pp, void *arg TSRMLS_DC)
{
php_resource_factory_t *rf = arg;
php_persistent_handle_list_t **listp = pp;
zend_hash_apply_with_argument(&(*listp)->free,
php_persistent_handle_apply_cleanup_ex, rf TSRMLS_CC);
if ((*listp)->used) {
return ZEND_HASH_APPLY_KEEP;
}
zend_hash_destroy(&(*listp)->free);
#if PHP_RAPHF_DEBUG_PHANDLES
fprintf(stderr, "LSTFREE: %p\n", *listp);
#endif
pefree(*listp, 1);
*listp = NULL;
return ZEND_HASH_APPLY_REMOVE;
}
static inline void php_persistent_handle_list_dtor(
php_persistent_handle_list_t *list,
php_persistent_handle_provider_t *provider TSRMLS_DC)
{
#if PHP_RAPHF_DEBUG_PHANDLES
fprintf(stderr, "LSTDTOR: %p\n", list);
#endif
zend_hash_apply_with_argument(&list->free,
php_persistent_handle_apply_cleanup_ex, &provider->rf TSRMLS_CC);
zend_hash_destroy(&list->free);
}
static inline void php_persistent_handle_list_free(
php_persistent_handle_list_t **list,
php_persistent_handle_provider_t *provider TSRMLS_DC)
{
php_persistent_handle_list_dtor(*list, provider TSRMLS_CC);
#if PHP_RAPHF_DEBUG_PHANDLES
fprintf(stderr, "LSTFREE: %p\n", *list);
#endif
pefree(*list, 1);
*list = NULL;
}
static int php_persistent_handle_list_apply_dtor(void *listp,
void *provider TSRMLS_DC)
{
php_persistent_handle_list_free(listp, provider TSRMLS_CC);
return ZEND_HASH_APPLY_REMOVE;
}
static inline php_persistent_handle_list_t *php_persistent_handle_list_find(
php_persistent_handle_provider_t *provider, const char *ident_str,
size_t ident_len TSRMLS_DC)
{
php_persistent_handle_list_t **list, *new_list;
ZEND_RESULT_CODE rv = zend_symtable_find(&provider->list.free, ident_str,
ident_len + 1, (void *) &list);
if (SUCCESS == rv) {
#if PHP_RAPHF_DEBUG_PHANDLES
fprintf(stderr, "LSTFIND: %p\n", *list);
#endif
return *list;
}
if ((new_list = php_persistent_handle_list_init(NULL))) {
rv = zend_symtable_update(&provider->list.free, ident_str, ident_len+1,
(void *) &new_list, sizeof(php_persistent_handle_list_t *),
(void *) &list);
if (SUCCESS == rv) {
#if PHP_RAPHF_DEBUG_PHANDLES
fprintf(stderr, "LSTFIND: %p (new)\n", *list);
#endif
return *list;
}
php_persistent_handle_list_free(&new_list, provider TSRMLS_CC);
}
return NULL;
}
static int php_persistent_handle_apply_cleanup_all(void *p TSRMLS_DC, int argc,
va_list argv, zend_hash_key *key)
{
php_persistent_handle_provider_t *provider = p;
const char *ident_str = va_arg(argv, const char *);
size_t ident_len = va_arg(argv, size_t);
php_persistent_handle_list_t *list;
if (ident_str && ident_len) {
if ((list = php_persistent_handle_list_find(provider, ident_str,
ident_len TSRMLS_CC))) {
zend_hash_apply_with_argument(&list->free,
php_persistent_handle_apply_cleanup_ex,
&provider->rf TSRMLS_CC);
}
} else {
zend_hash_apply_with_argument(&provider->list.free,
php_persistent_handle_apply_cleanup, &provider->rf TSRMLS_CC);
}
return ZEND_HASH_APPLY_KEEP;
}
static void php_persistent_handle_hash_dtor(void *p)
{
php_persistent_handle_provider_t *provider;
TSRMLS_FETCH();
provider = (php_persistent_handle_provider_t *) p;
zend_hash_apply_with_argument(&provider->list.free,
php_persistent_handle_list_apply_dtor, provider TSRMLS_CC);
zend_hash_destroy(&provider->list.free);
php_resource_factory_dtor(&provider->rf);
}
PHP_RAPHF_API ZEND_RESULT_CODE php_persistent_handle_provide(const char *name_str,
size_t name_len, php_resource_factory_ops_t *fops, void *data,
void (*dtor)(void *) TSRMLS_DC)
{
ZEND_RESULT_CODE status = FAILURE;
php_persistent_handle_provider_t provider;
if (php_persistent_handle_list_init(&provider.list)) {
if (php_resource_factory_init(&provider.rf, fops, data, dtor)) {
#if PHP_RAPHF_DEBUG_PHANDLES
fprintf(stderr, "PROVIDE: %p %s\n", PHP_RAPHF_G, name_str);
#endif
status = zend_symtable_update(&PHP_RAPHF_G->persistent_handle.hash,
name_str, name_len+1, (void *) &provider,
sizeof(php_persistent_handle_provider_t), NULL);
if (SUCCESS != status) {
php_resource_factory_dtor(&provider.rf);
}
}
}
return status;
}
php_persistent_handle_factory_t *php_persistent_handle_concede(
php_persistent_handle_factory_t *a, const char *name_str,
size_t name_len, const char *ident_str, size_t ident_len,
php_persistent_handle_wakeup_t wakeup,
php_persistent_handle_retire_t retire TSRMLS_DC)
{
ZEND_RESULT_CODE status = FAILURE;
php_persistent_handle_factory_t *free_a = NULL;
if (!a) {
free_a = a = emalloc(sizeof(*a));
}
memset(a, 0, sizeof(*a));
status = zend_symtable_find(&PHP_RAPHF_G->persistent_handle.hash, name_str,
name_len+1, (void *) &a->provider);
if (SUCCESS == status) {
a->ident.str = estrndup(ident_str, ident_len);
a->ident.len = ident_len;
a->wakeup = wakeup;
a->retire = retire;
if (free_a) {
a->free_on_abandon = 1;
}
} else {
if (free_a) {
efree(free_a);
}
a = NULL;
}
#if PHP_RAPHF_DEBUG_PHANDLES
fprintf(stderr, "CONCEDE: %p %p (%s) (%s)\n", PHP_RAPHF_G,
a ? a->provider : NULL, name_str, ident_str);
#endif
return a;
}
PHP_RAPHF_API void php_persistent_handle_abandon(
php_persistent_handle_factory_t *a)
{
zend_bool f = a->free_on_abandon;
#if PHP_RAPHF_DEBUG_PHANDLES
fprintf(stderr, "ABANDON: %p\n", a->provider);
#endif
STR_FREE(a->ident.str);
memset(a, 0, sizeof(*a));
if (f) {
efree(a);
}
}
void *php_persistent_handle_acquire(
php_persistent_handle_factory_t *a, void *init_arg TSRMLS_DC)
{
int key;
ZEND_RESULT_CODE rv;
ulong index;
void **handle_ptr, *handle = NULL;
php_persistent_handle_list_t *list;
list = php_persistent_handle_list_find(a->provider, a->ident.str,
a->ident.len TSRMLS_CC);
if (list) {
zend_hash_internal_pointer_end(&list->free);
key = zend_hash_get_current_key(&list->free, NULL, &index, 0);
rv = zend_hash_get_current_data(&list->free, (void *) &handle_ptr);
if (HASH_KEY_NON_EXISTANT != key && SUCCESS == rv) {
handle = *handle_ptr;
if (a->wakeup) {
a->wakeup(a, &handle TSRMLS_CC);
}
zend_hash_index_del(&list->free, index);
} else {
handle = php_resource_factory_handle_ctor(&a->provider->rf,
init_arg TSRMLS_CC);
}
#if PHP_RAPHF_DEBUG_PHANDLES
fprintf(stderr, "CREATED: %p\n", *handle);
#endif
if (handle) {
++a->provider->list.used;
++list->used;
}
}
return handle;
}
void *php_persistent_handle_accrete(
php_persistent_handle_factory_t *a, void *handle TSRMLS_DC)
{
void *new_handle = NULL;
php_persistent_handle_list_t *list;
new_handle = php_resource_factory_handle_copy(&a->provider->rf,
handle TSRMLS_CC);
if (handle) {
list = php_persistent_handle_list_find(a->provider, a->ident.str,
a->ident.len TSRMLS_CC);
if (list) {
++list->used;
}
++a->provider->list.used;
}
return new_handle;
}
void php_persistent_handle_release(
php_persistent_handle_factory_t *a, void *handle TSRMLS_DC)
{
php_persistent_handle_list_t *list;
list = php_persistent_handle_list_find(a->provider, a->ident.str,
a->ident.len TSRMLS_CC);
if (list) {
if (a->provider->list.used >= PHP_RAPHF_G->persistent_handle.limit) {
#if PHP_RAPHF_DEBUG_PHANDLES
fprintf(stderr, "DESTROY: %p\n", *handle);
#endif
php_resource_factory_handle_dtor(&a->provider->rf,
handle TSRMLS_CC);
} else {
if (a->retire) {
a->retire(a, &handle TSRMLS_CC);
}
zend_hash_next_index_insert(&list->free, (void *) &handle,
sizeof(void *), NULL);
}
--a->provider->list.used;
--list->used;
}
}
void php_persistent_handle_cleanup(const char *name_str, size_t name_len,
const char *ident_str, size_t ident_len TSRMLS_DC)
{
php_persistent_handle_provider_t *provider;
php_persistent_handle_list_t *list;
ZEND_RESULT_CODE rv;
if (name_str && name_len) {
rv = zend_symtable_find(&PHP_RAPHF_G->persistent_handle.hash, name_str,
name_len+1, (void *) &provider);
if (SUCCESS == rv) {
if (ident_str && ident_len) {
list = php_persistent_handle_list_find(provider, ident_str,
ident_len TSRMLS_CC);
if (list) {
zend_hash_apply_with_argument(&list->free,
php_persistent_handle_apply_cleanup_ex,
&provider->rf TSRMLS_CC);
}
} else {
zend_hash_apply_with_argument(&provider->list.free,
php_persistent_handle_apply_cleanup,
&provider->rf TSRMLS_CC);
}
}
} else {
zend_hash_apply_with_arguments(
&PHP_RAPHF_G->persistent_handle.hash TSRMLS_CC,
php_persistent_handle_apply_cleanup_all, 2, ident_str,
ident_len);
}
}
HashTable *php_persistent_handle_statall(HashTable *ht TSRMLS_DC)
{
if (zend_hash_num_elements(&PHP_RAPHF_G->persistent_handle.hash)) {
if (!ht) {
ALLOC_HASHTABLE(ht);
zend_hash_init(ht, 0, NULL, ZVAL_PTR_DTOR, 0);
}
zend_hash_apply_with_arguments(
&PHP_RAPHF_G->persistent_handle.hash TSRMLS_CC,
php_persistent_handle_apply_statall, 1, ht);
} else if (ht) {
ht = NULL;
}
return ht;
}
static php_resource_factory_ops_t php_persistent_handle_resource_factory_ops = {
(php_resource_factory_handle_ctor_t) php_persistent_handle_acquire,
(php_resource_factory_handle_copy_t) php_persistent_handle_accrete,
(php_resource_factory_handle_dtor_t) php_persistent_handle_release
};
php_resource_factory_ops_t *php_persistent_handle_get_resource_factory_ops(void)
{
return &php_persistent_handle_resource_factory_ops;
}
ZEND_BEGIN_ARG_INFO_EX(ai_raphf_stat_persistent_handles, 0, 0, 0)
ZEND_END_ARG_INFO();
static PHP_FUNCTION(raphf_stat_persistent_handles)
{
if (SUCCESS == zend_parse_parameters_none()) {
object_init(return_value);
if (php_persistent_handle_statall(HASH_OF(return_value) TSRMLS_CC)) {
return;
}
zval_dtor(return_value);
}
RETURN_FALSE;
}
ZEND_BEGIN_ARG_INFO_EX(ai_raphf_clean_persistent_handles, 0, 0, 0)
ZEND_ARG_INFO(0, name)
ZEND_ARG_INFO(0, ident)
ZEND_END_ARG_INFO();
static PHP_FUNCTION(raphf_clean_persistent_handles)
{
char *name_str = NULL, *ident_str = NULL;
int name_len = 0, ident_len = 0;
if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s!s!",
&name_str, &name_len, &ident_str, &ident_len)) {
php_persistent_handle_cleanup(name_str, name_len, ident_str,
ident_len TSRMLS_CC);
}
}
static const zend_function_entry raphf_functions[] = {
ZEND_NS_FENTRY("raphf", stat_persistent_handles,
ZEND_FN(raphf_stat_persistent_handles),
ai_raphf_stat_persistent_handles, 0)
ZEND_NS_FENTRY("raphf", clean_persistent_handles,
ZEND_FN(raphf_clean_persistent_handles),
ai_raphf_clean_persistent_handles, 0)
{0}
};
PHP_INI_BEGIN()
STD_PHP_INI_ENTRY("raphf.persistent_handle.limit", "-1", PHP_INI_SYSTEM,
OnUpdateLong, persistent_handle.limit, zend_raphf_globals,
raphf_globals)
PHP_INI_END()
static HashTable *php_persistent_handles_global_hash;
static PHP_GINIT_FUNCTION(raphf)
{
raphf_globals->persistent_handle.limit = -1;
zend_hash_init(&raphf_globals->persistent_handle.hash, 0, NULL,
php_persistent_handle_hash_dtor, 1);
if (php_persistent_handles_global_hash) {
zend_hash_copy(&raphf_globals->persistent_handle.hash,
php_persistent_handles_global_hash, NULL, NULL,
sizeof(php_persistent_handle_provider_t));
}
}
static PHP_GSHUTDOWN_FUNCTION(raphf)
{
zend_hash_destroy(&raphf_globals->persistent_handle.hash);
}
PHP_MINIT_FUNCTION(raphf)
{
php_persistent_handles_global_hash = &PHP_RAPHF_G->persistent_handle.hash;
REGISTER_INI_ENTRIES();
return SUCCESS;
}
PHP_MSHUTDOWN_FUNCTION(raphf)
{
UNREGISTER_INI_ENTRIES();
php_persistent_handles_global_hash = NULL;
return SUCCESS;
}
static int php_persistent_handle_apply_info_ex(void *p TSRMLS_DC, int argc,
va_list argv, zend_hash_key *key)
{
php_persistent_handle_list_t **list = p;
zend_hash_key *super_key = va_arg(argv, zend_hash_key *);
char used[21], free[21];
slprintf(used, sizeof(used), "%u", (*list)->used);
slprintf(free, sizeof(free), "%d", zend_hash_num_elements(&(*list)->free));
php_info_print_table_row(4, super_key->arKey, key->arKey, used, free);
return ZEND_HASH_APPLY_KEEP;
}
static int php_persistent_handle_apply_info(void *p TSRMLS_DC, int argc,
va_list argv, zend_hash_key *key)
{
php_persistent_handle_provider_t *provider = p;
zend_hash_apply_with_arguments(&provider->list.free TSRMLS_CC,
php_persistent_handle_apply_info_ex, 1, key);
return ZEND_HASH_APPLY_KEEP;
}
PHP_MINFO_FUNCTION(raphf)
{
php_info_print_table_start();
php_info_print_table_header(2,
"Resource and persistent handle factory support", "enabled");
php_info_print_table_row(2, "Extension version", PHP_RAPHF_VERSION);
php_info_print_table_end();
php_info_print_table_start();
php_info_print_table_colspan_header(4, "Persistent handles in this "
#ifdef ZTS
"thread"
#else
"process"
#endif
);
php_info_print_table_header(4, "Provider", "Ident", "Used", "Free");
zend_hash_apply_with_arguments(
&PHP_RAPHF_G->persistent_handle.hash TSRMLS_CC,
php_persistent_handle_apply_info, 0);
php_info_print_table_end();
DISPLAY_INI_ENTRIES();
}
zend_module_entry raphf_module_entry = {
STANDARD_MODULE_HEADER,
"raphf",
raphf_functions,
PHP_MINIT(raphf),
PHP_MSHUTDOWN(raphf),
NULL,
NULL,
PHP_MINFO(raphf),
PHP_RAPHF_VERSION,
ZEND_MODULE_GLOBALS(raphf),
PHP_GINIT(raphf),
PHP_GSHUTDOWN(raphf),
NULL,
STANDARD_MODULE_PROPERTIES_EX
};
/* }}} */
#ifdef COMPILE_DL_RAPHF
ZEND_GET_MODULE(raphf)
#endif
/*
* Local variables:
* tab-width: 4
* c-basic-offset: 4
* End:
* vim600: noet sw=4 ts=4 fdm=marker
* vim<600: noet sw=4 ts=4
*/
#!/usr/bin/env php
# autogenerated file; do not edit
sudo: false
language: c
addons:
apt:
packages:
- php5-cli
- php-pear
env:
matrix:
<?php
$gen = include "./travis/pecl/gen-matrix.php";
$env = $gen([
"PHP" => ["5.4", "5.5", "5.6"],
"enable_debug",
"enable_maintainer_zts",
]);
foreach ($env as $e) {
printf(" - %s\n", $e);
}
?>
before_script:
- make -f travis/pecl/Makefile php
- make -f travis/pecl/Makefile ext PECL=raphf
script:
- make -f travis/pecl/Makefile test
--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
Michael Wallner <mike@php.net>
Yay, now known and unresolved issues yet!
# Contributor Code of Conduct
As contributors and maintainers of this project, and in the interest of
fostering an open and welcoming community, we pledge to respect all people who
contribute through reporting issues, posting feature requests, updating
documentation, submitting pull requests or patches, and other activities.
We are committed to making participation in this project a harassment-free
experience for everyone, regardless of level of experience, gender, gender
identity and expression, sexual orientation, disability, personal appearance,
body size, race, ethnicity, age, religion, or nationality.
Examples of unacceptable behavior by participants include:
* The use of sexualized language or imagery
* Personal attacks
* Trolling or insulting/derogatory comments
* Public or private harassment
* Publishing other's private information, such as physical or electronic
addresses, without explicit permission
* Other unethical or unprofessional conduct.
Project maintainers have the right and responsibility to remove, edit, or reject
comments, commits, code, wiki edits, issues, and other contributions that are
not aligned to this Code of Conduct. By adopting this Code of Conduct, project
maintainers commit themselves to fairly and consistently applying these
principles to every aspect of managing this project. Project maintainers who do
not follow or enforce the Code of Conduct may be permanently removed from the
project team.
This code of conduct applies both within project spaces and in public spaces
when an individual is representing the project or its community.
Instances of abusive, harassing, or otherwise unacceptable behavior may be
reported by opening an issue or contacting one or more of the project maintainers.
This Code of Conduct is adapted from the
[Contributor Covenant](http://contributor-covenant.org), version 1.2.0,
available at http://contributor-covenant.org/version/1/2/0/.
raphf
Michael Wallner
Copyright (c) 2013, Michael Wallner <mike@php.net>.
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
# ext-raphf
[![Build Status](https://travis-ci.org/m6w6/ext-raphf.svg?branch=v1.1.x)](https://travis-ci.org/m6w6/ext-raphf)
The "Resource and Persistent Handle Factory" extension provides facilities to manage those in a convenient manner.
## Documentation
See the [online markdown reference](https://mdref.m6w6.name/raphf).
Known issues are listed in [BUGS](./BUGS) and future ideas can be found in [TODO](./TODO).
## Installing
### PECL
pecl install raphf
### PHARext
Watch out for [PECL replicates](https://replicator.pharext.org?raphf)
and pharext packages attached to [releases](./releases).
### Checkout
git clone github.com:m6w6/ext-raphf
cd ext-raphf
/path/to/phpize
./configure --with-php-config=/path/to/php-config
make
sudo make install
## ChangeLog
A comprehensive list of changes can be obtained from the
[PECL website](https://pecl.php.net/package-changelog.php?package=raphf).
## License
ext-raphf is licensed under the 2-Clause-BSD license, which can be found in
the accompanying [LICENSE](./LICENSE) file.
## Contributing
All forms of contribution are welcome! Please see the bundled
[CONTRIBUTING](./CONTRIBUTING.md) note for the general principles followed.
The list of past and current contributors is maintained in [THANKS](./THANKS).
Thanks go to the following people, who have contributed to this project:
Anatol Belski
Remi Collet
* TTL
# Doxyfile 1.8.10
#---------------------------------------------------------------------------
# Project related configuration options
#---------------------------------------------------------------------------
DOXYFILE_ENCODING = UTF-8
PROJECT_NAME = "Resource and persistent handle factory API"
PROJECT_NUMBER =
PROJECT_BRIEF = "A facility to manage possibly persistent resources with a comprehensible API. Provides simliar functionality like the zend_list API, but with more flexiblity and freedom."
PROJECT_LOGO = raphf.png
OUTPUT_DIRECTORY =
CREATE_SUBDIRS = NO
ALLOW_UNICODE_NAMES = NO
OUTPUT_LANGUAGE = English
BRIEF_MEMBER_DESC = YES
REPEAT_BRIEF = YES
ABBREVIATE_BRIEF =
ALWAYS_DETAILED_SEC = NO
INLINE_INHERITED_MEMB = NO
FULL_PATH_NAMES = YES
STRIP_FROM_PATH =
STRIP_FROM_INC_PATH =
SHORT_NAMES = NO
JAVADOC_AUTOBRIEF = YES
QT_AUTOBRIEF = NO
MULTILINE_CPP_IS_BRIEF = NO
INHERIT_DOCS = YES
SEPARATE_MEMBER_PAGES = NO
TAB_SIZE = 4
ALIASES =
TCL_SUBST =
OPTIMIZE_OUTPUT_FOR_C = YES
OPTIMIZE_OUTPUT_JAVA = NO
OPTIMIZE_FOR_FORTRAN = NO
OPTIMIZE_OUTPUT_VHDL = NO
EXTENSION_MAPPING = no_extension=md
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
GROUP_NESTED_COMPOUNDS = NO
SUBGROUPING = YES
INLINE_GROUPED_CLASSES = NO
INLINE_SIMPLE_STRUCTS = YES
TYPEDEF_HIDES_STRUCT = NO
LOOKUP_CACHE_SIZE = 0
#---------------------------------------------------------------------------
# Build related configuration options
#---------------------------------------------------------------------------
EXTRACT_ALL = YES
EXTRACT_PRIVATE = NO
EXTRACT_PACKAGE = NO
EXTRACT_STATIC = NO
EXTRACT_LOCAL_CLASSES = NO
EXTRACT_LOCAL_METHODS = NO
EXTRACT_ANON_NSPACES = NO
HIDE_UNDOC_MEMBERS = NO
HIDE_UNDOC_CLASSES = NO
HIDE_FRIEND_COMPOUNDS = NO
HIDE_IN_BODY_DOCS = NO
INTERNAL_DOCS = NO
CASE_SENSE_NAMES = YES
HIDE_SCOPE_NAMES = NO
HIDE_COMPOUND_REFERENCE= NO
SHOW_INCLUDE_FILES = YES
SHOW_GROUPED_MEMB_INC = NO
FORCE_LOCAL_INCLUDES = NO
INLINE_INFO = YES
SORT_MEMBER_DOCS = YES
SORT_BRIEF_DOCS = NO
SORT_MEMBERS_CTORS_1ST = NO
SORT_GROUP_NAMES = NO
SORT_BY_SCOPE_NAME = NO
STRICT_PROTO_MATCHING = NO
GENERATE_TODOLIST = YES
GENERATE_TESTLIST = YES
GENERATE_BUGLIST = YES
GENERATE_DEPRECATEDLIST= YES
ENABLED_SECTIONS =
MAX_INITIALIZER_LINES = 30
SHOW_USED_FILES = YES
SHOW_FILES = YES
SHOW_NAMESPACES = YES
FILE_VERSION_FILTER =
LAYOUT_FILE =
CITE_BIB_FILES =
#---------------------------------------------------------------------------
# Configuration options related to warning and progress messages
#---------------------------------------------------------------------------
QUIET = NO
WARNINGS = YES
WARN_IF_UNDOCUMENTED = YES
WARN_IF_DOC_ERROR = YES
WARN_NO_PARAMDOC = NO
WARN_FORMAT = "$file:$line: $text"
WARN_LOGFILE =
#---------------------------------------------------------------------------
# Configuration options related to the input files
#---------------------------------------------------------------------------
INPUT = README.md CONTRIBUTING.md php_raphf.h src
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 = README.md
#---------------------------------------------------------------------------
# Configuration options related to source browsing
#---------------------------------------------------------------------------
SOURCE_BROWSER = NO
INLINE_SOURCES = NO
STRIP_CODE_COMMENTS = YES
REFERENCED_BY_RELATION = YES
REFERENCES_RELATION = NO
REFERENCES_LINK_SOURCE = YES
SOURCE_TOOLTIPS = YES
USE_HTAGS = NO
VERBATIM_HEADERS = YES
#---------------------------------------------------------------------------
# Configuration options related to the alphabetical class index
#---------------------------------------------------------------------------
ALPHABETICAL_INDEX = YES
COLS_IN_ALPHA_INDEX = 5
IGNORE_PREFIX =
#---------------------------------------------------------------------------
# Configuration options related to the HTML output
#---------------------------------------------------------------------------
GENERATE_HTML = YES
HTML_OUTPUT = .
HTML_FILE_EXTENSION = .html
HTML_HEADER =
HTML_FOOTER =
HTML_STYLESHEET =
HTML_EXTRA_STYLESHEET =
HTML_EXTRA_FILES = BUGS CONTRIBUTING.md LICENSE THANKS TODO
HTML_COLORSTYLE_HUE = 220
HTML_COLORSTYLE_SAT = 100
HTML_COLORSTYLE_GAMMA = 80
HTML_TIMESTAMP = NO
HTML_DYNAMIC_SECTIONS = NO
HTML_INDEX_NUM_ENTRIES = 100
GENERATE_DOCSET = NO
DOCSET_FEEDNAME = "Doxygen generated docs"
DOCSET_BUNDLE_ID = org.doxygen.Project
DOCSET_PUBLISHER_ID = org.doxygen.Publisher
DOCSET_PUBLISHER_NAME = Publisher
GENERATE_HTMLHELP = NO
CHM_FILE =
HHC_LOCATION =
GENERATE_CHI = NO
CHM_INDEX_ENCODING =
BINARY_TOC = NO
TOC_EXPAND = NO
GENERATE_QHP = NO
QCH_FILE =
QHP_NAMESPACE = org.doxygen.Project
QHP_VIRTUAL_FOLDER = doc
QHP_CUST_FILTER_NAME =
QHP_CUST_FILTER_ATTRS =
QHP_SECT_FILTER_ATTRS =
QHG_LOCATION =
GENERATE_ECLIPSEHELP = NO
ECLIPSE_DOC_ID = org.doxygen.Project
DISABLE_INDEX = NO
GENERATE_TREEVIEW = YES
ENUM_VALUES_PER_LINE = 4
TREEVIEW_WIDTH = 250
EXT_LINKS_IN_WINDOW = NO
FORMULA_FONTSIZE = 10
FORMULA_TRANSPARENT = YES
USE_MATHJAX = NO
MATHJAX_FORMAT = HTML-CSS
MATHJAX_RELPATH = http://cdn.mathjax.org/mathjax/latest
MATHJAX_EXTENSIONS =
MATHJAX_CODEFILE =
SEARCHENGINE = YES
SERVER_BASED_SEARCH = NO
EXTERNAL_SEARCH = NO
SEARCHENGINE_URL =
SEARCHDATA_FILE = searchdata.xml
EXTERNAL_SEARCH_ID =
EXTRA_SEARCH_MAPPINGS =
#---------------------------------------------------------------------------
# Configuration options related to the LaTeX output
#---------------------------------------------------------------------------
GENERATE_LATEX = NO
LATEX_OUTPUT = latex
LATEX_CMD_NAME = latex
MAKEINDEX_CMD_NAME = makeindex
COMPACT_LATEX = NO
PAPER_TYPE = a4
EXTRA_PACKAGES =
LATEX_HEADER =
LATEX_FOOTER =
LATEX_EXTRA_STYLESHEET =
LATEX_EXTRA_FILES =
PDF_HYPERLINKS = YES
USE_PDFLATEX = YES
LATEX_BATCHMODE = NO
LATEX_HIDE_INDICES = NO
LATEX_SOURCE_CODE = NO
LATEX_BIB_STYLE = plain
#---------------------------------------------------------------------------
# Configuration options related to the RTF output
#---------------------------------------------------------------------------
GENERATE_RTF = NO
RTF_OUTPUT = rtf
COMPACT_RTF = NO
RTF_HYPERLINKS = NO
RTF_STYLESHEET_FILE =
RTF_EXTENSIONS_FILE =
RTF_SOURCE_CODE = NO
#---------------------------------------------------------------------------
# Configuration options related to the man page output
#---------------------------------------------------------------------------
GENERATE_MAN = NO
MAN_OUTPUT = man
MAN_EXTENSION = .3
MAN_SUBDIR =
MAN_LINKS = NO
#---------------------------------------------------------------------------
# Configuration options related to the XML output
#---------------------------------------------------------------------------
GENERATE_XML = NO
XML_OUTPUT = xml
XML_PROGRAMLISTING = YES
#---------------------------------------------------------------------------
# Configuration options related to the DOCBOOK output
#---------------------------------------------------------------------------
GENERATE_DOCBOOK = NO
DOCBOOK_OUTPUT = docbook
DOCBOOK_PROGRAMLISTING = NO
#---------------------------------------------------------------------------
# Configuration options for the AutoGen Definitions output
#---------------------------------------------------------------------------
GENERATE_AUTOGEN_DEF = NO
#---------------------------------------------------------------------------
# Configuration options related to the Perl module output
#---------------------------------------------------------------------------
GENERATE_PERLMOD = NO
PERLMOD_LATEX = NO
PERLMOD_PRETTY = YES
PERLMOD_MAKEVAR_PREFIX =
#---------------------------------------------------------------------------
# Configuration options related to the preprocessor
#---------------------------------------------------------------------------
ENABLE_PREPROCESSING = YES
MACRO_EXPANSION = YES
EXPAND_ONLY_PREDEF = NO
SEARCH_INCLUDES = YES
INCLUDE_PATH =
INCLUDE_FILE_PATTERNS =
PREDEFINED = DOXYGEN \
TSRMLS_C= \
TSRMLS_D= \
TSRMLS_CC= \
TSRMLS_DC= \
PHP_RAPHF_API=
EXPAND_AS_DEFINED =
SKIP_FUNCTION_MACROS = YES
#---------------------------------------------------------------------------
# Configuration options related to external references
#---------------------------------------------------------------------------
TAGFILES =
GENERATE_TAGFILE =
ALLEXTERNALS = NO
EXTERNAL_GROUPS = YES
EXTERNAL_PAGES = YES
PERL_PATH = /usr/bin/perl
#---------------------------------------------------------------------------
# Configuration options related to the dot tool
#---------------------------------------------------------------------------
CLASS_DIAGRAMS = YES
MSCGEN_PATH =
DIA_PATH =
HIDE_UNDOC_RELATIONS = YES
HAVE_DOT = YES
DOT_NUM_THREADS = 0
DOT_FONTNAME = Helvetica
DOT_FONTSIZE = 10
DOT_FONTPATH =
CLASS_GRAPH = NO
COLLABORATION_GRAPH = YES
GROUP_GRAPHS = YES
UML_LOOK = NO
UML_LIMIT_NUM_FIELDS = 10
TEMPLATE_RELATIONS = NO
INCLUDE_GRAPH = YES
INCLUDED_BY_GRAPH = YES
CALL_GRAPH = YES
CALLER_GRAPH = YES
GRAPHICAL_HIERARCHY = YES
DIRECTORY_GRAPH = YES
DOT_IMAGE_FORMAT = png
INTERACTIVE_SVG = NO
DOT_PATH =
DOTFILE_DIRS =
MSCFILE_DIRS =
DIAFILE_DIRS =
PLANTUML_JAR_PATH =
PLANTUML_INCLUDE_PATH =
DOT_GRAPH_MAX_NODES = 50
MAX_DOT_GRAPH_DEPTH = 0
DOT_TRANSPARENT = NO
DOT_MULTI_TARGETS = NO
GENERATE_LEGEND = YES
DOT_CLEANUP = YES
sinclude(config0.m4)
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_RAPHF_SRCDIR=PHP_EXT_SRCDIR(raphf)
PHP_RAPHF_BUILDDIR=PHP_EXT_BUILDDIR(raphf)
PHP_ADD_INCLUDE($PHP_RAPHF_SRCDIR/src)
PHP_ADD_BUILD_DIR($PHP_RAPHF_BUILDDIR/src)
PHP_RAPHF_HEADERS=`(cd $PHP_RAPHF_SRCDIR/src && echo *.h)`
PHP_RAPHF_SOURCES=`(cd $PHP_RAPHF_SRCDIR && echo src/*.c)`
PHP_NEW_EXTENSION(raphf, $PHP_RAPHF_SOURCES, $ext_shared)
PHP_INSTALL_HEADERS(ext/raphf, php_raphf.h $PHP_RAPHF_HEADERS)
PHP_SUBST(PHP_RAPHF_HEADERS)
PHP_SUBST(PHP_RAPHF_SOURCES)
PHP_SUBST(PHP_RAPHF_SRCDIR)
PHP_SUBST(PHP_RAPHF_BUILDDIR)
PHP_ADD_MAKEFILE_FRAGMENT
fi
ARG_ENABLE("raphf", "for raphf support", "no");
if (PHP_RAPHF == "yes") {
var PHP_RAPHF_HEADERS=glob("src/*.h"), PHP_RAPHF_SOURCES=glob("src/*.c");
EXTENSION("raphf", PHP_RAPHF_SOURCES);
PHP_INSTALL_HEADERS("ext/raphf", "php_propro.h");
for (var i=0; i<PHP_RAPHF_HEADERS.length; ++i) {
var basename = FSO.GetFileName(PHP_RAPHF_HEADERS[i]);
copy_and_subst(PHP_RAPHF_HEADERS[i], basename, []);
PHP_INSTALL_HEADERS("ext/raphf", basename);
}
AC_DEFINE("HAVE_RAPHF", 1);
}
# provide headers in builddir, so they do not end up in /usr/include/ext/raphf/src
PHP_RAPHF_HEADERS := $(addprefix $(PHP_RAPHF_BUILDDIR)/,$(PHP_RAPHF_HEADERS))
$(PHP_RAPHF_BUILDDIR)/%.h: $(PHP_RAPHF_SRCDIR)/src/%.h
@cat >$@ <$<
$(all_targets): raphf-build-headers
clean: raphf-clean-headers
.PHONY: raphf-build-headers
raphf-build-headers: $(PHP_RAPHF_HEADERS)
.PHONY: raphf-clean-headers
raphf-clean-headers:
-rm -f $(PHP_RAPHF_HEADERS)
/*
+--------------------------------------------------------------------+
| PECL :: raphf |
+--------------------------------------------------------------------+
| Redistribution and use in source and binary forms, with or without |
| modification, are permitted provided that the conditions mentioned |
| in the accompanying LICENSE file are met. |
+--------------------------------------------------------------------+
| Copyright (c) 2013, Michael Wallner <mike@php.net> |
+--------------------------------------------------------------------+
*/
#ifndef PHP_RAPHF_H
#define PHP_RAPHF_H
extern zend_module_entry raphf_module_entry;
#define phpext_raphf_ptr &raphf_module_entry
#define PHP_RAPHF_VERSION "1.1.2"
#ifdef PHP_WIN32
# define PHP_RAPHF_API __declspec(dllexport)
#elif defined(__GNUC__) && __GNUC__ >= 4
# define PHP_RAPHF_API extern __attribute__ ((visibility("default")))
#else
# define PHP_RAPHF_API extern
#endif
#ifdef ZTS
# include "TSRM.h"
#endif
#include "php_raphf_api.h"
#endif /* PHP_RAPHF_H */
/*
* Local variables:
* tab-width: 4
* c-basic-offset: 4
* End:
* vim600: noet sw=4 ts=4 fdm=marker
* vim<600: noet sw=4 ts=4
*/
<EFBFBD><EFBFBD><EFBFBD>X<EFBFBD>8.<2E><><EFBFBD>vU<76><55><14>Z<EFBFBD><5A>GBMB
Reference in New Issue Copy Permalink