995 lines
32 KiB
PHP
995 lines
32 KiB
PHP
<?php
|
|
|
|
/**
|
|
* Tools module.
|
|
*
|
|
* This file is part of MadelineProto.
|
|
* MadelineProto is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
|
|
* MadelineProto is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
* See the GNU Affero General Public License for more details.
|
|
* You should have received a copy of the GNU General Public License along with MadelineProto.
|
|
* If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* @author Daniil Gentili <daniil@daniil.it>
|
|
* @copyright 2016-2020 Daniil Gentili <daniil@daniil.it>
|
|
* @license https://opensource.org/licenses/AGPL-3.0 AGPLv3
|
|
*
|
|
* @link https://docs.madelineproto.xyz MadelineProto documentation
|
|
*/
|
|
|
|
namespace danog\MadelineProto;
|
|
|
|
use Amp\Deferred;
|
|
use Amp\Failure;
|
|
use Amp\File\StatCache;
|
|
use Amp\Loop;
|
|
use Amp\Promise;
|
|
use Amp\Success;
|
|
use Amp\TimeoutException;
|
|
use danog\MadelineProto\MTProtoTools\GarbageCollector;
|
|
use tgseclib\Math\BigInteger;
|
|
use function Amp\ByteStream\getOutputBufferStream;
|
|
use function Amp\ByteStream\getStdin;
|
|
use function Amp\ByteStream\getStdout;
|
|
use function Amp\delay;
|
|
use function Amp\File\exists;
|
|
use function Amp\File\get;
|
|
use function Amp\Promise\all;
|
|
use function Amp\Promise\any;
|
|
use function Amp\Promise\first;
|
|
use function Amp\Promise\some;
|
|
use function Amp\Promise\timeout;
|
|
use function Amp\Promise\timeoutWithDefault;
|
|
use function Amp\Promise\wait;
|
|
|
|
/**
|
|
* Some tools.
|
|
*/
|
|
abstract class Tools extends StrTools
|
|
{
|
|
/**
|
|
* Boolean to avoid problems with exceptions thrown by forked strands, see tools.
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public bool $destructing = false;
|
|
/**
|
|
* Sanify TL obtained from JSON for TL serialization.
|
|
*
|
|
* @param array $input Data to sanitize
|
|
*
|
|
* @internal
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function convertJsonTL(array $input): array
|
|
{
|
|
$cb = static function (&$val) use (&$cb) {
|
|
if (isset($val['@type'])) {
|
|
$val['_'] = $val['@type'];
|
|
} elseif (\is_array($val)) {
|
|
\array_walk($val, $cb);
|
|
}
|
|
};
|
|
\array_walk($input, $cb);
|
|
return $input;
|
|
}
|
|
/**
|
|
* Generate MTProto vector hash.
|
|
*
|
|
* @param array $ints IDs
|
|
*
|
|
* @return int Vector hash
|
|
*/
|
|
public static function genVectorHash(array $ints): int
|
|
{
|
|
//sort($ints, SORT_NUMERIC);
|
|
if (\danog\MadelineProto\Magic::$bigint) {
|
|
$hash = new \tgseclib\Math\BigInteger(0);
|
|
foreach ($ints as $int) {
|
|
$hash = $hash->multiply(\danog\MadelineProto\Magic::$twozerotwosixone)->add(\danog\MadelineProto\Magic::$zeroeight)->add(new \tgseclib\Math\BigInteger($int))->divide(\danog\MadelineProto\Magic::$zeroeight)[1];
|
|
}
|
|
$hash = self::unpackSignedInt(\strrev(\str_pad($hash->toBytes(), 4, "\0", STR_PAD_LEFT)));
|
|
} else {
|
|
$hash = 0;
|
|
foreach ($ints as $int) {
|
|
$hash = ($hash * 20261 & 0x7fffffff) + $int & 0x7fffffff;
|
|
}
|
|
}
|
|
return $hash;
|
|
}
|
|
/**
|
|
* Get random integer.
|
|
*
|
|
* @param integer $modulus Modulus
|
|
*
|
|
* @return int
|
|
*/
|
|
public static function randomInt(int $modulus = 0): int
|
|
{
|
|
if ($modulus === 0) {
|
|
$modulus = PHP_INT_MAX;
|
|
}
|
|
try {
|
|
return \random_int(0, PHP_INT_MAX) % $modulus;
|
|
} catch (\Exception $e) {
|
|
// random_compat will throw an Exception, which in PHP 5 does not implement Throwable
|
|
} catch (\Throwable $e) {
|
|
// If a sufficient source of randomness is unavailable, random_bytes() will throw an
|
|
// object that implements the Throwable interface (Exception, TypeError, Error).
|
|
// We don't actually need to do anything here. The string() method should just continue
|
|
// as normal. Note, however, that if we don't have a sufficient source of randomness for
|
|
// random_bytes(), most of the other calls here will fail too, so we'll end up using
|
|
// the PHP implementation.
|
|
}
|
|
if (Magic::$bigint) {
|
|
$number = self::unpackSignedInt(self::random(4));
|
|
} else {
|
|
$number = self::unpackSignedLong(self::random(8));
|
|
}
|
|
return ($number & PHP_INT_MAX) % $modulus;
|
|
}
|
|
/**
|
|
* Get random string of specified length.
|
|
*
|
|
* @param integer $length Length
|
|
*
|
|
* @return string Random string
|
|
*/
|
|
public static function random(int $length): string
|
|
{
|
|
return $length === 0 ? '' : \tgseclib\Crypt\Random::string($length);
|
|
}
|
|
/**
|
|
* Positive modulo
|
|
* Works just like the % (modulus) operator, only returns always a postive number.
|
|
*
|
|
* @param int $a A
|
|
* @param int $b B
|
|
*
|
|
* @return int Modulo
|
|
*/
|
|
public static function posmod(int $a, int $b): int
|
|
{
|
|
$resto = $a % $b;
|
|
return $resto < 0 ? $resto + \abs($b) : $resto;
|
|
}
|
|
/**
|
|
* Unpack base256 signed int.
|
|
*
|
|
* @param string $value base256 int
|
|
*
|
|
* @return integer
|
|
*/
|
|
public static function unpackSignedInt(string $value): int
|
|
{
|
|
if (\strlen($value) !== 4) {
|
|
throw new TL\Exception(\danog\MadelineProto\Lang::$current_lang['length_not_4']);
|
|
}
|
|
return \unpack('l', \danog\MadelineProto\Magic::$BIG_ENDIAN ? \strrev($value) : $value)[1];
|
|
}
|
|
/**
|
|
* Unpack base256 signed long.
|
|
*
|
|
* @param string $value base256 long
|
|
*
|
|
* @return integer
|
|
*/
|
|
public static function unpackSignedLong(string $value): int
|
|
{
|
|
if (\strlen($value) !== 8) {
|
|
throw new TL\Exception(\danog\MadelineProto\Lang::$current_lang['length_not_8']);
|
|
}
|
|
return \unpack('q', \danog\MadelineProto\Magic::$BIG_ENDIAN ? \strrev($value) : $value)[1];
|
|
}
|
|
/**
|
|
* Unpack base256 signed long to string.
|
|
*
|
|
* @param string $value base256 long
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function unpackSignedLongString($value): string
|
|
{
|
|
if (\is_int($value)) {
|
|
return (string) $value;
|
|
}
|
|
if (\is_array($value) && \count($value) === 2) {
|
|
$value = \pack('l2', $value);
|
|
}
|
|
if (\strlen($value) !== 8) {
|
|
throw new TL\Exception(\danog\MadelineProto\Lang::$current_lang['length_not_8']);
|
|
}
|
|
$big = new BigInteger((string) $value, -256);
|
|
return (string) $big;
|
|
}
|
|
/**
|
|
* Convert integer to base256 signed int.
|
|
*
|
|
* @param integer $value Value to convert
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function packSignedInt(int $value): string
|
|
{
|
|
if ($value > 2147483647) {
|
|
throw new TL\Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['value_bigger_than_2147483647'], $value));
|
|
}
|
|
if ($value < -2147483648) {
|
|
throw new TL\Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['value_smaller_than_2147483648'], $value));
|
|
}
|
|
$res = \pack('l', $value);
|
|
return \danog\MadelineProto\Magic::$BIG_ENDIAN ? \strrev($res) : $res;
|
|
}
|
|
/**
|
|
* Convert integer to base256 long.
|
|
*
|
|
* @param int $value Value to convert
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function packSignedLong(int $value): string
|
|
{
|
|
if ($value > 9223372036854775807) {
|
|
throw new TL\Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['value_bigger_than_9223372036854775807'], $value));
|
|
}
|
|
if ($value < -9.223372036854776E+18) {
|
|
throw new TL\Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['value_smaller_than_9223372036854775808'], $value));
|
|
}
|
|
$res = \danog\MadelineProto\Magic::$bigint ? self::packSignedInt($value)."\0\0\0\0" : (\danog\MadelineProto\Magic::$BIG_ENDIAN ? \strrev(\pack('q', $value)) : \pack('q', $value));
|
|
return $res;
|
|
}
|
|
/**
|
|
* Convert value to unsigned base256 int.
|
|
*
|
|
* @param int $value Value
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function packUnsignedInt(int $value): string
|
|
{
|
|
if ($value > 4294967295) {
|
|
throw new TL\Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['value_bigger_than_4294967296'], $value));
|
|
}
|
|
if ($value < 0) {
|
|
throw new TL\Exception(\sprintf(\danog\MadelineProto\Lang::$current_lang['value_smaller_than_0'], $value));
|
|
}
|
|
return \pack('V', $value);
|
|
}
|
|
/**
|
|
* Convert double to binary version.
|
|
*
|
|
* @param float $value Value to convert
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function packDouble(float $value): string
|
|
{
|
|
$res = \pack('d', $value);
|
|
if (\strlen($res) !== 8) {
|
|
throw new TL\Exception(\danog\MadelineProto\Lang::$current_lang['encode_double_error']);
|
|
}
|
|
return \danog\MadelineProto\Magic::$BIG_ENDIAN ? \strrev($res) : $res;
|
|
}
|
|
/**
|
|
* Unpack binary double.
|
|
*
|
|
* @param string $value Value to unpack
|
|
*
|
|
* @return float
|
|
*/
|
|
public static function unpackDouble(string $value): float
|
|
{
|
|
if (\strlen($value) !== 8) {
|
|
throw new TL\Exception(\danog\MadelineProto\Lang::$current_lang['length_not_8']);
|
|
}
|
|
return \unpack('d', \danog\MadelineProto\Magic::$BIG_ENDIAN ? \strrev($value) : $value)[1];
|
|
}
|
|
/**
|
|
* Synchronously wait for a promise|generator.
|
|
*
|
|
* @param \Generator|Promise $promise The promise to wait for
|
|
* @param boolean $ignoreSignal Whether to ignore shutdown signals
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public static function wait($promise, $ignoreSignal = false)
|
|
{
|
|
if ($promise instanceof \Generator) {
|
|
$promise = new Coroutine($promise);
|
|
} elseif (!$promise instanceof Promise) {
|
|
return $promise;
|
|
}
|
|
$exception = null;
|
|
$value = null;
|
|
$resolved = false;
|
|
do {
|
|
try {
|
|
Loop::run(function () use (&$resolved, &$value, &$exception, $promise) {
|
|
$promise->onResolve(function ($e, $v) use (&$resolved, &$value, &$exception) {
|
|
Loop::stop();
|
|
$resolved = true;
|
|
$exception = $e;
|
|
$value = $v;
|
|
});
|
|
});
|
|
} catch (\Throwable $throwable) {
|
|
Logger::log('Loop exceptionally stopped without resolving the promise', Logger::FATAL_ERROR);
|
|
Logger::log((string) $throwable, Logger::FATAL_ERROR);
|
|
throw $throwable;
|
|
}
|
|
} while (!$resolved && !(Magic::$signaled && !$ignoreSignal));
|
|
if ($exception) {
|
|
throw $exception;
|
|
}
|
|
return $value;
|
|
}
|
|
/**
|
|
* Returns a promise that succeeds when all promises succeed, and fails if any promise fails.
|
|
* Returned promise succeeds with an array of values used to succeed each contained promise, with keys corresponding to the array of promises.
|
|
*
|
|
* @param array<\Generator|Promise> $promises Promises
|
|
*
|
|
* @return Promise
|
|
*/
|
|
public static function all(array $promises): Promise
|
|
{
|
|
foreach ($promises as &$promise) {
|
|
$promise = self::call($promise);
|
|
}
|
|
/** @var Promise[] $promises */
|
|
return all($promises);
|
|
}
|
|
/**
|
|
* Returns a promise that is resolved when all promises are resolved. The returned promise will not fail.
|
|
*
|
|
* @param array<Promise|\Generator> $promises Promises
|
|
*
|
|
* @return Promise
|
|
*/
|
|
public static function any(array $promises): Promise
|
|
{
|
|
foreach ($promises as &$promise) {
|
|
$promise = self::call($promise);
|
|
}
|
|
/** @var Promise[] $promises */
|
|
return any($promises);
|
|
}
|
|
/**
|
|
* Resolves with a two-item array delineating successful and failed Promise results.
|
|
* The returned promise will only fail if the given number of required promises fail.
|
|
*
|
|
* @param array<Promise|\Generator> $promises Promises
|
|
*
|
|
* @return Promise
|
|
*/
|
|
public static function some(array $promises): Promise
|
|
{
|
|
foreach ($promises as &$promise) {
|
|
$promise = self::call($promise);
|
|
}
|
|
/** @var Promise[] $promises */
|
|
return some($promises);
|
|
}
|
|
/**
|
|
* Returns a promise that succeeds when the first promise succeeds, and fails only if all promises fail.
|
|
*
|
|
* @param array<Promise|\Generator> $promises Promises
|
|
*
|
|
* @return Promise
|
|
*/
|
|
public static function first(array $promises): Promise
|
|
{
|
|
foreach ($promises as &$promise) {
|
|
$promise = self::call($promise);
|
|
}
|
|
/** @var Promise[] $promises */
|
|
return first($promises);
|
|
}
|
|
/**
|
|
* Create an artificial timeout for any \Generator or Promise.
|
|
*
|
|
* @param \Generator|Promise $promise
|
|
* @param integer $timeout
|
|
*
|
|
* @return Promise
|
|
*/
|
|
public static function timeout($promise, int $timeout): Promise
|
|
{
|
|
$promise = self::call($promise);
|
|
|
|
$deferred = new Deferred;
|
|
|
|
$watcher = Loop::delay($timeout, static function () use (&$deferred) {
|
|
$temp = $deferred; // prevent double resolve
|
|
$deferred = null;
|
|
$temp->fail(new TimeoutException);
|
|
});
|
|
Loop::unreference($watcher);
|
|
|
|
$promise->onResolve(function () use (&$deferred, $promise, $watcher) {
|
|
if ($deferred !== null) {
|
|
Loop::cancel($watcher);
|
|
$deferred->resolve($promise);
|
|
}
|
|
});
|
|
|
|
return $deferred->promise();
|
|
}
|
|
/**
|
|
* Creates an artificial timeout for any `Promise`.
|
|
*
|
|
* If the promise is resolved before the timeout expires, the result is returned
|
|
*
|
|
* If the timeout expires before the promise is resolved, a default value is returned
|
|
*
|
|
* @template TReturnAlt
|
|
* @template TReturn
|
|
* @template TGenerator as \Generator<mixed, mixed, mixed, TReturn>
|
|
*
|
|
* @param Promise|Generator $promise Promise to which the timeout is applied.
|
|
* @param int $timeout Timeout in milliseconds.
|
|
* @param mixed $default
|
|
*
|
|
* @psalm-param Promise<TReturn>|TGenerator $promise Promise to which the timeout is applied.
|
|
* @psalm-param TReturnAlt $default
|
|
*
|
|
* @return Promise<TReturn>|Promise<TReturnAlt>
|
|
*
|
|
* @throws \TypeError If $promise is not an instance of \Amp\Promise, \Generator or \React\Promise\PromiseInterface.
|
|
*/
|
|
public static function timeoutWithDefault($promise, int $timeout, $default = null): Promise
|
|
{
|
|
$promise = self::call($promise);
|
|
|
|
$deferred = new Deferred;
|
|
|
|
$watcher = Loop::delay($timeout, static function () use (&$deferred, $default) {
|
|
$temp = $deferred; // prevent double resolve
|
|
$deferred = null;
|
|
$temp->resolve($default);
|
|
});
|
|
Loop::unreference($watcher);
|
|
|
|
$promise->onResolve(function () use (&$deferred, $promise, $watcher) {
|
|
if ($deferred !== null) {
|
|
Loop::cancel($watcher);
|
|
$deferred->resolve($promise);
|
|
}
|
|
});
|
|
|
|
return $deferred->promise();
|
|
}
|
|
/**
|
|
* Convert generator, promise or any other value to a promise.
|
|
*
|
|
* @param \Generator|Promise|mixed $promise
|
|
*
|
|
* @template TReturn
|
|
* @psalm-param \Generator<mixed, mixed, mixed, TReturn>|Promise<TReturn>|TReturn $promise
|
|
*
|
|
* @return Promise
|
|
* @psalm-return Promise<TReturn>
|
|
*/
|
|
public static function call($promise): Promise
|
|
{
|
|
if ($promise instanceof \Generator) {
|
|
$promise = new Coroutine($promise);
|
|
} elseif (!$promise instanceof Promise) {
|
|
return new Success($promise);
|
|
}
|
|
return $promise;
|
|
}
|
|
/**
|
|
* Call promise in background.
|
|
*
|
|
* @param \Generator|Promise $promise Promise to resolve
|
|
* @param ?\Generator|Promise $actual Promise to resolve instead of $promise
|
|
* @param string $file File
|
|
*
|
|
* @psalm-suppress InvalidScope
|
|
*
|
|
* @return Promise|mixed
|
|
*/
|
|
public static function callFork($promise, $actual = null, $file = '')
|
|
{
|
|
if ($actual) {
|
|
$promise = $actual;
|
|
}
|
|
if ($promise instanceof \Generator) {
|
|
$promise = new Coroutine($promise);
|
|
}
|
|
if ($promise instanceof Promise) {
|
|
$promise->onResolve(function ($e, $res) use ($file) {
|
|
if ($e) {
|
|
if (isset($this)) {
|
|
$this->rethrow($e, $file);
|
|
} else {
|
|
self::rethrow($e, $file);
|
|
}
|
|
}
|
|
});
|
|
}
|
|
return $promise;
|
|
}
|
|
/**
|
|
* Call promise in background, deferring execution.
|
|
*
|
|
* @param \Generator|Promise $promise Promise to resolve
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function callForkDefer($promise): void
|
|
{
|
|
Loop::defer(fn () => self::callFork($promise));
|
|
}
|
|
/**
|
|
* Rethrow error catched in strand.
|
|
*
|
|
* @param \Throwable $e Exception
|
|
* @param string $file File where the strand started
|
|
*
|
|
* @psalm-suppress InvalidScope
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function rethrow(\Throwable $e, $file = ''): void
|
|
{
|
|
$zis = isset($this) ? $this : null;
|
|
$logger = isset($zis->logger) ? $zis->logger : Logger::$default;
|
|
if ($file) {
|
|
$file = " started @ {$file}";
|
|
}
|
|
if ($logger) {
|
|
$logger->logger("Got the following exception within a forked strand{$file}, trying to rethrow");
|
|
}
|
|
if ($e->getMessage() === "Cannot get return value of a generator that hasn't returned") {
|
|
$logger->logger("Well you know, this might actually not be the actual exception, scroll up in the logs to see the actual exception");
|
|
if (!$zis || !$zis->destructing) {
|
|
Promise\rethrow(new Failure($e));
|
|
}
|
|
} else {
|
|
if ($logger) {
|
|
$logger->logger($e);
|
|
}
|
|
Promise\rethrow(new Failure($e));
|
|
}
|
|
}
|
|
/**
|
|
* Call promise $b after promise $a.
|
|
*
|
|
* @param \Generator|Promise $a Promise A
|
|
* @param \Generator|Promise $b Promise B
|
|
*
|
|
* @psalm-suppress InvalidScope
|
|
*
|
|
* @return Promise
|
|
*/
|
|
public static function after($a, $b): Promise
|
|
{
|
|
$a = self::call($a);
|
|
$deferred = new Deferred();
|
|
$a->onResolve(static function ($e, $res) use ($b, $deferred) {
|
|
if ($e) {
|
|
if (isset($this)) {
|
|
$this->rethrow($e);
|
|
} else {
|
|
self::rethrow($e);
|
|
}
|
|
return;
|
|
}
|
|
$b = self::call($b);
|
|
$b->onResolve(function ($e, $res) use ($deferred) {
|
|
if ($e) {
|
|
if (isset($this)) {
|
|
$this->rethrow($e);
|
|
} else {
|
|
self::rethrow($e);
|
|
}
|
|
return;
|
|
}
|
|
$deferred->resolve($res);
|
|
});
|
|
});
|
|
return $deferred->promise();
|
|
}
|
|
/**
|
|
* Asynchronously lock a file
|
|
* Resolves with a callbable that MUST eventually be called in order to release the lock.
|
|
*
|
|
* @param string $file File to lock
|
|
* @param integer $operation Locking mode
|
|
* @param float $polling Polling interval
|
|
* @param ?Promise $token Cancellation token
|
|
* @param ?callable $failureCb Failure callback, called only once if the first locking attempt fails.
|
|
*
|
|
* @return Promise<?callable>
|
|
*/
|
|
public static function flock(string $file, int $operation, float $polling = 0.1, ?Promise $token = null, $failureCb = null): Promise
|
|
{
|
|
return self::call(Tools::flockGenerator($file, $operation, $polling, $token, $failureCb));
|
|
}
|
|
/**
|
|
* Asynchronously lock a file (internal generator function).
|
|
*
|
|
* @param string $file File to lock
|
|
* @param integer $operation Locking mode
|
|
* @param float $polling Polling interval
|
|
* @param ?Promise $token Cancellation token
|
|
* @param ?callable $failureCb Failure callback, called only once if the first locking attempt fails.
|
|
*
|
|
* @internal Generator function
|
|
*
|
|
* @return \Generator
|
|
* @psalm-return \Generator<mixed, mixed, mixed, ?callable>
|
|
*/
|
|
public static function flockGenerator(string $file, int $operation, float $polling, ?Promise $token = null, $failureCb = null): \Generator
|
|
{
|
|
$polling *= 1000;
|
|
$polling = (int) $polling;
|
|
if (!yield exists($file)) {
|
|
yield \touch($file);
|
|
StatCache::clear($file);
|
|
}
|
|
$operation |= LOCK_NB;
|
|
$res = \fopen($file, 'c');
|
|
do {
|
|
$result = \flock($res, $operation);
|
|
if (!$result) {
|
|
if ($failureCb) {
|
|
$failureCb();
|
|
$failureCb = null;
|
|
}
|
|
if ($token) {
|
|
if (yield Tools::timeoutWithDefault($token, $polling, false)) {
|
|
return;
|
|
}
|
|
} else {
|
|
yield delay($polling);
|
|
}
|
|
}
|
|
} while (!$result);
|
|
return static function () use (&$res) {
|
|
if ($res) {
|
|
\flock($res, LOCK_UN);
|
|
\fclose($res);
|
|
$res = null;
|
|
}
|
|
};
|
|
}
|
|
/**
|
|
* Asynchronously sleep.
|
|
*
|
|
* @param int|float $time Number of seconds to sleep for
|
|
*
|
|
* @return Promise
|
|
*/
|
|
public static function sleep($time): Promise
|
|
{
|
|
return new \Amp\Delayed((int) ($time * 1000));
|
|
}
|
|
/**
|
|
* Asynchronously read line.
|
|
*
|
|
* @param string $prompt Prompt
|
|
*
|
|
* @return Promise<string>
|
|
*/
|
|
public static function readLine(string $prompt = ''): Promise
|
|
{
|
|
return self::call(Tools::readLineGenerator($prompt));
|
|
}
|
|
/**
|
|
* Asynchronously read line (generator function).
|
|
*
|
|
* @param string $prompt Prompt
|
|
*
|
|
* @internal Generator function
|
|
*
|
|
* @return \Generator
|
|
*
|
|
* @psalm-return \Generator<int, Promise|Promise<null|string>, mixed, mixed|null>
|
|
*/
|
|
public static function readLineGenerator(string $prompt = ''): \Generator
|
|
{
|
|
try {
|
|
GarbageCollector::$log = false;
|
|
$stdin = getStdin();
|
|
$stdout = getStdout();
|
|
if ($prompt) {
|
|
yield $stdout->write($prompt);
|
|
}
|
|
static $lines = [''];
|
|
while (\count($lines) < 2 && ($chunk = yield $stdin->read()) !== null) {
|
|
$chunk = \explode("\n", \str_replace(["\r", "\n\n"], "\n", $chunk));
|
|
$lines[\count($lines) - 1] .= \array_shift($chunk);
|
|
$lines = \array_merge($lines, $chunk);
|
|
}
|
|
} finally {
|
|
GarbageCollector::$log = true;
|
|
}
|
|
return \array_shift($lines);
|
|
}
|
|
/**
|
|
* Asynchronously write to stdout/browser.
|
|
*
|
|
* @param string $string Message to echo
|
|
*
|
|
* @return Promise
|
|
*/
|
|
public static function echo(string $string): Promise
|
|
{
|
|
return getOutputBufferStream()->write($string);
|
|
}
|
|
/**
|
|
* Check if is array or similar (traversable && countable && arrayAccess).
|
|
*
|
|
* @param mixed $var Value to check
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function isArrayOrAlike($var): bool
|
|
{
|
|
return \is_array($var) || $var instanceof \ArrayAccess && $var instanceof \Traversable && $var instanceof \Countable;
|
|
}
|
|
/**
|
|
* Create array.
|
|
*
|
|
* @param mixed ...$params Params
|
|
*
|
|
* @return array
|
|
*/
|
|
public static function arr(...$params): array
|
|
{
|
|
return $params;
|
|
}
|
|
/**
|
|
* base64URL decode.
|
|
*
|
|
* @param string $data Data to decode
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function base64urlDecode(string $data): string
|
|
{
|
|
return \base64_decode(\str_pad(\strtr($data, '-_', '+/'), \strlen($data) % 4, '=', STR_PAD_RIGHT));
|
|
}
|
|
/**
|
|
* Base64URL encode.
|
|
*
|
|
* @param string $data Data to encode
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function base64urlEncode(string $data): string
|
|
{
|
|
return \rtrim(\strtr(\base64_encode($data), '+/', '-_'), '=');
|
|
}
|
|
/**
|
|
* null-byte RLE decode.
|
|
*
|
|
* @param string $string Data to decode
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function rleDecode(string $string): string
|
|
{
|
|
$new = '';
|
|
$last = '';
|
|
$null = \chr(0);
|
|
foreach (\str_split($string) as $cur) {
|
|
if ($last === $null) {
|
|
$new .= \str_repeat($last, \ord($cur));
|
|
$last = '';
|
|
} else {
|
|
$new .= $last;
|
|
$last = $cur;
|
|
}
|
|
}
|
|
$string = $new.$last;
|
|
return $string;
|
|
}
|
|
/**
|
|
* null-byte RLE encode.
|
|
*
|
|
* @param string $string Data to encode
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function rleEncode(string $string): string
|
|
{
|
|
$new = '';
|
|
$count = 0;
|
|
$null = \chr(0);
|
|
foreach (\str_split($string) as $cur) {
|
|
if ($cur === $null) {
|
|
$count++;
|
|
} else {
|
|
if ($count > 0) {
|
|
$new .= $null.\chr($count);
|
|
$count = 0;
|
|
}
|
|
$new .= $cur;
|
|
}
|
|
}
|
|
return $new;
|
|
}
|
|
/**
|
|
* Inflate stripped photosize to full JPG payload.
|
|
*
|
|
* @param string $stripped Stripped photosize
|
|
*
|
|
* @return string JPG payload
|
|
*/
|
|
public static function inflateStripped(string $stripped): string
|
|
{
|
|
if (\strlen($stripped) < 3 || \ord($stripped[0]) !== 1) {
|
|
return $stripped;
|
|
}
|
|
$header = "\xff\xd8\xff\xe0\x00\x10\x4a\x46\x49".
|
|
"\x46\x00\x01\x01\x00\x00\x01\x00\x01\x00\x00\xff\xdb\x00\x43\x00\x28\x1c".
|
|
"\x1e\x23\x1e\x19\x28\x23\x21\x23\x2d\x2b\x28\x30\x3c\x64\x41\x3c\x37\x37".
|
|
"\x3c\x7b\x58\x5d\x49\x64\x91\x80\x99\x96\x8f\x80\x8c\x8a\xa0\xb4\xe6\xc3".
|
|
"\xa0\xaa\xda\xad\x8a\x8c\xc8\xff\xcb\xda\xee\xf5\xff\xff\xff\x9b\xc1\xff".
|
|
"\xff\xff\xfa\xff\xe6\xfd\xff\xf8\xff\xdb\x00\x43\x01\x2b\x2d\x2d\x3c\x35".
|
|
"\x3c\x76\x41\x41\x76\xf8\xa5\x8c\xa5\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8".
|
|
"\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8".
|
|
"\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8\xf8".
|
|
"\xf8\xf8\xf8\xf8\xf8\xff\xc0\x00\x11\x08\x00\x00\x00\x00\x03\x01\x22\x00".
|
|
"\x02\x11\x01\x03\x11\x01\xff\xc4\x00\x1f\x00\x00\x01\x05\x01\x01\x01\x01".
|
|
"\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08".
|
|
"\x09\x0a\x0b\xff\xc4\x00\xb5\x10\x00\x02\x01\x03\x03\x02\x04\x03\x05\x05".
|
|
"\x04\x04\x00\x00\x01\x7d\x01\x02\x03\x00\x04\x11\x05\x12\x21\x31\x41\x06".
|
|
"\x13\x51\x61\x07\x22\x71\x14\x32\x81\x91\xa1\x08\x23\x42\xb1\xc1\x15\x52".
|
|
"\xd1\xf0\x24\x33\x62\x72\x82\x09\x0a\x16\x17\x18\x19\x1a\x25\x26\x27\x28".
|
|
"\x29\x2a\x34\x35\x36\x37\x38\x39\x3a\x43\x44\x45\x46\x47\x48\x49\x4a\x53".
|
|
"\x54\x55\x56\x57\x58\x59\x5a\x63\x64\x65\x66\x67\x68\x69\x6a\x73\x74\x75".
|
|
"\x76\x77\x78\x79\x7a\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94\x95\x96".
|
|
"\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4\xb5\xb6".
|
|
"\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4\xd5\xd6".
|
|
"\xd7\xd8\xd9\xda\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf1\xf2\xf3\xf4".
|
|
"\xf5\xf6\xf7\xf8\xf9\xfa\xff\xc4\x00\x1f\x01\x00\x03\x01\x01\x01\x01\x01".
|
|
"\x01\x01\x01\x01\x00\x00\x00\x00\x00\x00\x01\x02\x03\x04\x05\x06\x07\x08".
|
|
"\x09\x0a\x0b\xff\xc4\x00\xb5\x11\x00\x02\x01\x02\x04\x04\x03\x04\x07\x05".
|
|
"\x04\x04\x00\x01\x02\x77\x00\x01\x02\x03\x11\x04\x05\x21\x31\x06\x12\x41".
|
|
"\x51\x07\x61\x71\x13\x22\x32\x81\x08\x14\x42\x91\xa1\xb1\xc1\x09\x23\x33".
|
|
"\x52\xf0\x15\x62\x72\xd1\x0a\x16\x24\x34\xe1\x25\xf1\x17\x18\x19\x1a\x26".
|
|
"\x27\x28\x29\x2a\x35\x36\x37\x38\x39\x3a\x43\x44\x45\x46\x47\x48\x49\x4a".
|
|
"\x53\x54\x55\x56\x57\x58\x59\x5a\x63\x64\x65\x66\x67\x68\x69\x6a\x73\x74".
|
|
"\x75\x76\x77\x78\x79\x7a\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x92\x93\x94".
|
|
"\x95\x96\x97\x98\x99\x9a\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xb2\xb3\xb4".
|
|
"\xb5\xb6\xb7\xb8\xb9\xba\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xd2\xd3\xd4".
|
|
"\xd5\xd6\xd7\xd8\xd9\xda\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xf2\xf3\xf4".
|
|
"\xf5\xf6\xf7\xf8\xf9\xfa\xff\xda\x00\x0c\x03\x01\x00\x02\x11\x03\x11\x00".
|
|
"\x3f\x00";
|
|
static $footer = "\xff\xd9";
|
|
$header[164] = $stripped[1];
|
|
$header[165] = $stripped[2];
|
|
return $header.\substr($stripped, 3).$footer;
|
|
}
|
|
/**
|
|
* Get maximum photo size.
|
|
*
|
|
* @internal
|
|
*
|
|
* @param array $sizes
|
|
* @return array
|
|
*/
|
|
public static function maxSize(array $sizes): array
|
|
{
|
|
$maxPixels = 0;
|
|
$max = null;
|
|
foreach ($sizes as $size) {
|
|
if (isset($size['w'], $size['h'])) {
|
|
$curPixels = $size['w'] * $size['h'];
|
|
if ($curPixels > $maxPixels) {
|
|
$maxPixels = $curPixels;
|
|
$max = $size;
|
|
}
|
|
}
|
|
}
|
|
return $max;
|
|
}
|
|
/**
|
|
* Get final element of array.
|
|
*
|
|
* @param array $what Array
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public static function end(array $what)
|
|
{
|
|
return \end($what);
|
|
}
|
|
/**
|
|
* Whether this is altervista.
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function isAltervista(): bool
|
|
{
|
|
return Magic::$altervista;
|
|
}
|
|
/**
|
|
* Checks private property exists in an object.
|
|
*
|
|
* @param object $obj Object
|
|
* @param string $var Attribute name
|
|
*
|
|
* @psalm-suppress InvalidScope
|
|
*
|
|
* @return bool
|
|
* @access public
|
|
*/
|
|
public static function hasVar($obj, string $var): bool
|
|
{
|
|
return \Closure::bind(
|
|
function () use ($var) {
|
|
return isset($this->{$var});
|
|
},
|
|
$obj,
|
|
\get_class($obj)
|
|
)->__invoke();
|
|
}
|
|
/**
|
|
* Accesses a private variable from an object.
|
|
*
|
|
* @param object $obj Object
|
|
* @param string $var Attribute name
|
|
*
|
|
* @psalm-suppress InvalidScope
|
|
*
|
|
* @return mixed
|
|
* @access public
|
|
*/
|
|
public static function &getVar($obj, string $var)
|
|
{
|
|
return \Closure::bind(
|
|
function & () use ($var) {
|
|
return $this->{$var};
|
|
},
|
|
$obj,
|
|
\get_class($obj)
|
|
)->__invoke();
|
|
}
|
|
/**
|
|
* Sets a private variable in an object.
|
|
*
|
|
* @param object $obj Object
|
|
* @param string $var Attribute name
|
|
* @param mixed $val Attribute value
|
|
*
|
|
* @psalm-suppress InvalidScope
|
|
*
|
|
* @return void
|
|
*
|
|
* @access public
|
|
*/
|
|
public static function setVar($obj, string $var, &$val): void
|
|
{
|
|
\Closure::bind(
|
|
function () use ($var, &$val) {
|
|
$this->{$var} =& $val;
|
|
},
|
|
$obj,
|
|
\get_class($obj)
|
|
)->__invoke();
|
|
}
|
|
/**
|
|
* Get absolute path to file, related to session path.
|
|
*
|
|
* @param string $file File
|
|
*
|
|
* @internal
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function absolute(string $file): string
|
|
{
|
|
if (($file[0] ?? '') !== '/' && ($file[1] ?? '') !== ':' && !\in_array(\substr($file, 0, 4), ['phar', 'http'])) {
|
|
$file = Magic::getcwd().DIRECTORY_SEPARATOR.$file;
|
|
}
|
|
return $file;
|
|
}
|
|
}
|