/home/mip/public_html/vendor/laravel-filemanager/files/folder-1/821668/hashids.tar
hashids/LICENSE 0000644 00000002074 15243417771 0007212 0 ustar 00 MIT License
Copyright (c) Ivan Akimov <ivan@barreleye.com>
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
hashids/src/Math/BCMath.php 0000644 00000001571 15243417771 0011475 0 ustar 00 <?php
/**
* Copyright (c) Ivan Akimov.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @see https://github.com/vinkla/hashids
*/
namespace Hashids\Math;
class BCMath implements MathInterface
{
public function add($a, $b)
{
return bcadd($a, $b, 0);
}
public function multiply($a, $b)
{
return bcmul($a, $b, 0);
}
public function divide($a, $b)
{
return bcdiv($a, $b, 0);
}
public function mod($n, $d)
{
return bcmod($n, $d);
}
public function greaterThan($a, $b)
{
return bccomp($a, $b, 0) > 0;
}
public function intval($a)
{
return intval($a);
}
public function strval($a)
{
return $a;
}
public function get($a)
{
return $a;
}
}
hashids/src/Math/MathInterface.php 0000644 00000003032 15243417771 0013103 0 ustar 00 <?php
/**
* Copyright (c) Ivan Akimov.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @see https://github.com/vinkla/hashids
*/
namespace Hashids\Math;
interface MathInterface
{
/**
* Add two arbitrary-length integers.
* @param string $a
* @param string $b
* @return string
*/
public function add($a, $b);
/**
* Multiply two arbitrary-length integers.
* @param string $a
* @param string $b
* @return string
*/
public function multiply($a, $b);
/**
* Divide two arbitrary-length integers.
* @param string $a
* @param string $b
* @return string
*/
public function divide($a, $b);
/**
* Compute arbitrary-length integer modulo.
* @param string $n
* @param string $d
* @return string
*/
public function mod($n, $d);
/**
* Compares two arbitrary-length integers.
* @param string $a
* @param string $b
* @return bool
*/
public function greaterThan($a, $b);
/**
* Converts arbitrary-length integer to PHP integer.
* @param string $a
* @return int
*/
public function intval($a);
/**
* Converts arbitrary-length integer to PHP string.
* @param string $a
* @return string
*/
public function strval($a);
/**
* Converts PHP integer to arbitrary-length integer.
* @param int $a
* @return string
*/
public function get($a);
}
hashids/src/Math/Gmp.php 0000644 00000001617 15243417771 0011123 0 ustar 00 <?php
/**
* Copyright (c) Ivan Akimov.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @see https://github.com/vinkla/hashids
*/
namespace Hashids\Math;
class Gmp implements MathInterface
{
public function add($a, $b)
{
return gmp_add($a, $b);
}
public function multiply($a, $b)
{
return gmp_mul($a, $b);
}
public function divide($a, $b)
{
return gmp_div_q($a, $b);
}
public function mod($n, $d)
{
return gmp_mod($n, $d);
}
public function greaterThan($a, $b)
{
return gmp_cmp($a, $b) > 0;
}
public function intval($a)
{
return gmp_intval($a);
}
public function strval($a)
{
return gmp_strval($a);
}
public function get($a)
{
return gmp_init($a);
}
}
hashids/src/HashidsInterface.php 0000644 00000001454 15243417771 0012712 0 ustar 00 <?php
/**
* Copyright (c) Ivan Akimov.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @see https://github.com/vinkla/hashids
*/
namespace Hashids;
interface HashidsInterface
{
/**
* Encode parameters to generate a hash.
* @param int|string|array<int, int|string> ...$numbers
*/
public function encode(...$numbers): string;
/**
* Decode a hash to the original parameter values.
* @return array<int, int>|array{}
*/
public function decode(string $hash): array;
/** Encode hexadecimal values and generate a hash string. */
public function encodeHex(string $str): string;
/** Decode a hexadecimal hash. */
public function decodeHex(string $hash): string;
}
hashids/src/Hashids.php 0000644 00000023556 15243417771 0011100 0 ustar 00 <?php
/**
* Copyright (c) Ivan Akimov.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @see https://github.com/vinkla/hashids
*/
namespace Hashids;
use Hashids\Math\BCMath;
use Hashids\Math\Gmp;
use Hashids\Math\MathInterface;
use InvalidArgumentException;
use RuntimeException;
class Hashids implements HashidsInterface
{
public const GUARD_DIV = 12;
public const SEP_DIV = 3.5;
protected MathInterface $math;
protected array $shuffledAlphabets;
protected int $minHashLength;
protected string $alphabet;
protected string $guards;
protected string $salt;
protected string $seps = 'cfhistuCFHISTU';
/** @throws \InvalidArgumentException */
public function __construct(
string $salt = '',
int $minHashLength = 0,
string $alphabet = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890',
) {
$this->salt = mb_convert_encoding($salt, 'UTF-8', mb_detect_encoding($salt));
$this->minHashLength = $minHashLength;
$alphabet = mb_convert_encoding($alphabet, 'UTF-8', mb_detect_encoding($alphabet));
$this->alphabet = implode('', array_unique($this->multiByteSplit($alphabet)));
$this->math = $this->getMathExtension();
if (mb_strlen($this->alphabet) < 16) {
throw new InvalidArgumentException('The Hashids alphabet must contain at least 16 unique characters.');
}
if (false !== mb_strpos($this->alphabet, ' ')) {
throw new InvalidArgumentException('The Hashids alphabet can\'t contain spaces.');
}
$alphabetArray = $this->multiByteSplit($this->alphabet);
$sepsArray = $this->multiByteSplit($this->seps);
$this->seps = implode('', array_intersect($sepsArray, $alphabetArray));
$this->alphabet = implode('', array_diff($alphabetArray, $sepsArray));
$this->seps = $this->shuffle($this->seps, $this->salt);
if (!$this->seps || (mb_strlen($this->alphabet) / mb_strlen($this->seps)) > self::SEP_DIV) {
$sepsLength = (int) ceil(mb_strlen($this->alphabet) / self::SEP_DIV);
if ($sepsLength > mb_strlen($this->seps)) {
$diff = $sepsLength - mb_strlen($this->seps);
$this->seps .= mb_substr($this->alphabet, 0, $diff);
$this->alphabet = mb_substr($this->alphabet, $diff);
}
}
$this->alphabet = $this->shuffle($this->alphabet, $this->salt);
$guardCount = (int) ceil(mb_strlen($this->alphabet) / self::GUARD_DIV);
if (mb_strlen($this->alphabet) < 3) {
$this->guards = mb_substr($this->seps, 0, $guardCount);
$this->seps = mb_substr($this->seps, $guardCount);
} else {
$this->guards = mb_substr($this->alphabet, 0, $guardCount);
$this->alphabet = mb_substr($this->alphabet, $guardCount);
}
}
public function encode(...$numbers): string
{
$ret = '';
if (1 === count($numbers) && is_array($numbers[0])) {
$numbers = $numbers[0];
}
if (!$numbers) {
return $ret;
}
foreach ($numbers as $number) {
$isNumber = ctype_digit((string) $number);
if (!$isNumber) {
return $ret;
}
}
$alphabet = $this->alphabet;
$numbersSize = count($numbers);
$numbersHashInt = 0;
foreach ($numbers as $i => $number) {
$numbersHashInt += $this->math->intval($this->math->mod($number, $i + 100));
}
$lottery = $ret = mb_substr($alphabet, $numbersHashInt % mb_strlen($alphabet), 1);
foreach ($numbers as $i => $number) {
$alphabet = $this->shuffle($alphabet, mb_substr($lottery . $this->salt . $alphabet, 0, mb_strlen($alphabet)));
$ret .= $last = $this->hash($number, $alphabet);
if ($i + 1 < $numbersSize) {
$number %= (mb_ord($last, 'UTF-8') + $i);
$sepsIndex = $this->math->intval($this->math->mod($number, mb_strlen($this->seps)));
$ret .= mb_substr($this->seps, $sepsIndex, 1);
}
}
if (mb_strlen($ret) < $this->minHashLength) {
$guardIndex = ($numbersHashInt + mb_ord(mb_substr($ret, 0, 1), 'UTF-8')) % mb_strlen($this->guards);
$guard = mb_substr($this->guards, $guardIndex, 1);
$ret = $guard . $ret;
if (mb_strlen($ret) < $this->minHashLength) {
$guardIndex = ($numbersHashInt + mb_ord(mb_substr($ret, 2, 1), 'UTF-8')) % mb_strlen($this->guards);
$guard = mb_substr($this->guards, $guardIndex, 1);
$ret .= $guard;
}
}
$halfLength = (int) (mb_strlen($alphabet) / 2);
while (mb_strlen($ret) < $this->minHashLength) {
$alphabet = $this->shuffle($alphabet, $alphabet);
$ret = mb_substr($alphabet, $halfLength) . $ret . mb_substr($alphabet, 0, $halfLength);
$excess = mb_strlen($ret) - $this->minHashLength;
if ($excess > 0) {
$ret = mb_substr($ret, (int) ($excess / 2), $this->minHashLength);
}
}
return $ret;
}
public function decode(string $hash): array
{
$ret = [];
if (!($hash = trim($hash))) {
return $ret;
}
$alphabet = $this->alphabet;
$hashBreakdown = str_replace($this->multiByteSplit($this->guards), ' ', $hash);
$hashArray = explode(' ', $hashBreakdown);
$i = 3 === count($hashArray) || 2 === count($hashArray) ? 1 : 0;
$hashBreakdown = $hashArray[$i];
if ('' !== $hashBreakdown) {
$lottery = mb_substr($hashBreakdown, 0, 1);
$hashBreakdown = mb_substr($hashBreakdown, 1);
$hashBreakdown = str_replace($this->multiByteSplit($this->seps), ' ', $hashBreakdown);
$hashArray = explode(' ', $hashBreakdown);
foreach ($hashArray as $subHash) {
$alphabet = $this->shuffle($alphabet, mb_substr($lottery . $this->salt . $alphabet, 0, mb_strlen($alphabet)));
$result = $this->unhash($subHash, $alphabet);
if ($this->math->greaterThan($result, PHP_INT_MAX)) {
$ret[] = $this->math->strval($result);
} else {
$ret[] = $this->math->intval($result);
}
}
if ($this->encode($ret) !== $hash) {
$ret = [];
}
}
return $ret;
}
public function encodeHex(string $str): string
{
if (!ctype_xdigit($str)) {
return '';
}
$numbers = trim(chunk_split($str, 12, ' '));
$numbers = explode(' ', $numbers);
foreach ($numbers as $i => $number) {
$numbers[$i] = hexdec('1' . $number);
}
return $this->encode(...$numbers);
}
public function decodeHex(string $hash): string
{
$ret = '';
$numbers = $this->decode($hash);
foreach ($numbers as $number) {
$ret .= mb_substr(dechex($number), 1);
}
return $ret;
}
/** Shuffle alphabet by given salt. */
protected function shuffle(string $alphabet, string $salt): string
{
$key = $alphabet . ' ' . $salt;
if (isset($this->shuffledAlphabets[$key])) {
return $this->shuffledAlphabets[$key];
}
$saltLength = mb_strlen($salt);
$saltArray = $this->multiByteSplit($salt);
if (!$saltLength) {
return $alphabet;
}
$alphabetArray = $this->multiByteSplit($alphabet);
for ($i = mb_strlen($alphabet) - 1, $v = 0, $p = 0; $i > 0; $i--, $v++) {
$v %= $saltLength;
$p += $int = mb_ord($saltArray[$v], 'UTF-8');
$j = ($int + $v + $p) % $i;
$temp = $alphabetArray[$j];
$alphabetArray[$j] = $alphabetArray[$i];
$alphabetArray[$i] = $temp;
}
$alphabet = implode('', $alphabetArray);
$this->shuffledAlphabets[$key] = $alphabet;
return $alphabet;
}
/** Hash given input value. */
protected function hash(string $input, string $alphabet): string
{
$hash = '';
$alphabetLength = mb_strlen($alphabet);
do {
$hash = mb_substr($alphabet, $this->math->intval($this->math->mod($input, $alphabetLength)), 1) . $hash;
$input = $this->math->divide($input, $alphabetLength);
} while ($this->math->greaterThan($input, 0));
return $hash;
}
/** Unhash given input value. */
protected function unhash(string $input, string $alphabet): int|string
{
$number = 0;
$inputLength = mb_strlen($input);
if ($inputLength && $alphabet) {
$alphabetLength = mb_strlen($alphabet);
$inputChars = $this->multiByteSplit($input);
foreach ($inputChars as $char) {
$position = mb_strpos($alphabet, $char);
$number = $this->math->multiply($number, $alphabetLength);
$number = $this->math->add($number, $position);
}
}
return $number;
}
/**
* Get BC Math or GMP extension.
* @throws \RuntimeException
*/
protected function getMathExtension(): MathInterface
{
if (extension_loaded('gmp')) {
return new Gmp();
}
if (extension_loaded('bcmath')) {
return new BCMath();
}
throw new RuntimeException('Missing math extension for Hashids, install either bcmath or gmp.');
}
/**
* Replace simple use of $this->multiByteSplit with multi byte string.
* @return array<int, string>
*/
protected function multiByteSplit(string $string): array
{
return preg_split('/(?!^)(?=.)/u', $string) ?: [];
}
}
hashids/composer.json 0000644 00000002464 15243417771 0010732 0 ustar 00 {
"name": "hashids/hashids",
"description": "Generate short, unique, non-sequential ids (like YouTube and Bitly) from numbers",
"license": "MIT",
"keywords": [
"bitly",
"decode",
"encode",
"hash",
"hashid",
"hashids",
"ids",
"obfuscate",
"youtube"
],
"authors": [
{
"name": "Ivan Akimov",
"email": "ivan@barreleye.com"
},
{
"name": "Vincent Klaiber",
"email": "hello@doubledip.se"
}
],
"homepage": "https://hashids.org/php",
"require": {
"php": "^8.1",
"ext-mbstring": "*"
},
"require-dev": {
"phpunit/phpunit": "^10.0"
},
"suggest": {
"ext-bcmath": "Required to use BC Math arbitrary precision mathematics (*).",
"ext-gmp": "Required to use GNU multiple precision mathematics (*)."
},
"minimum-stability": "dev",
"prefer-stable": true,
"autoload": {
"psr-4": {
"Hashids\\": "src/"
}
},
"autoload-dev": {
"psr-4": {
"Hashids\\Tests\\": "tests/"
}
},
"config": {
"preferred-install": "dist"
},
"extra": {
"branch-alias": {
"dev-master": "5.0-dev"
}
}
}
LICENSE 0000644 00000002100 15243426702 0005547 0 ustar 00 MIT License
Copyright (c) Vincent Klaiber <hello@doubledip.se>
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
src/HashidsServiceProvider.php 0000644 00000004414 15243426702 0012473 0 ustar 00 <?php
/**
* Copyright (c) Vincent Klaiber.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @see https://github.com/vinkla/laravel-hashids
*/
declare(strict_types=1);
namespace Vinkla\Hashids;
use Hashids\Hashids;
use Illuminate\Contracts\Container\Container;
use Illuminate\Foundation\Application as LaravelApplication;
use Illuminate\Support\ServiceProvider;
use Laravel\Lumen\Application as LumenApplication;
class HashidsServiceProvider extends ServiceProvider
{
public function boot(): void
{
$this->setupConfig();
}
protected function setupConfig(): void
{
$source = realpath($raw = __DIR__ . '/../config/hashids.php') ?: $raw;
if ($this->app instanceof LaravelApplication && $this->app->runningInConsole()) {
$this->publishes([$source => config_path('hashids.php')]);
} elseif ($this->app instanceof LumenApplication) {
$this->app->configure('hashids');
}
$this->mergeConfigFrom($source, 'hashids');
}
public function register(): void
{
$this->registerFactory();
$this->registerManager();
$this->registerBindings();
}
protected function registerFactory(): void
{
$this->app->singleton('hashids.factory', function () {
return new HashidsFactory();
});
$this->app->alias('hashids.factory', HashidsFactory::class);
}
protected function registerManager(): void
{
$this->app->singleton('hashids', function (Container $app) {
$config = $app['config'];
$factory = $app['hashids.factory'];
return new HashidsManager($config, $factory);
});
$this->app->alias('hashids', HashidsManager::class);
}
protected function registerBindings(): void
{
$this->app->bind('hashids.connection', function (Container $app) {
$manager = $app['hashids'];
return $manager->connection();
});
$this->app->alias('hashids.connection', Hashids::class);
}
public function provides(): array
{
return [
'hashids',
'hashids.factory',
'hashids.connection',
];
}
}
src/Facades/Hashids.php 0000644 00000001340 15243426702 0010760 0 ustar 00 <?php
/**
* Copyright (c) Vincent Klaiber.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @see https://github.com/vinkla/laravel-hashids
*/
declare(strict_types=1);
namespace Vinkla\Hashids\Facades;
use Illuminate\Support\Facades\Facade;
/**
* @method static string encode(mixed ...$numbers)
* @method static array decode(string $hash)
* @method static string encodeHex(string $str)
* @method static string decodeHex(string $hash)
* @method static \Hashids\Hashids connection(string|null $name = null)
*/
class Hashids extends Facade
{
protected static function getFacadeAccessor(): string
{
return 'hashids';
}
}
src/HashidsManager.php 0000644 00000002143 15243426702 0010727 0 ustar 00 <?php
/**
* Copyright (c) Vincent Klaiber.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @see https://github.com/vinkla/laravel-hashids
*/
declare(strict_types=1);
namespace Vinkla\Hashids;
use GrahamCampbell\Manager\AbstractManager;
use Hashids\Hashids;
use Illuminate\Contracts\Config\Repository;
/**
* @method string encode(mixed ...$numbers)
* @method array decode(string $hash)
* @method string encodeHex(string $str)
* @method string decodeHex(string $hash)
*/
class HashidsManager extends AbstractManager
{
protected HashidsFactory $factory;
public function __construct(Repository $config, HashidsFactory $factory)
{
parent::__construct($config);
$this->factory = $factory;
}
protected function createConnection(array $config): Hashids
{
return $this->factory->make($config);
}
protected function getConfigName(): string
{
return 'hashids';
}
public function getFactory(): HashidsFactory
{
return $this->factory;
}
}
src/HashidsFactory.php 0000644 00000001741 15243426702 0010767 0 ustar 00 <?php
/**
* Copyright (c) Vincent Klaiber.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @see https://github.com/vinkla/laravel-hashids
*/
declare(strict_types=1);
namespace Vinkla\Hashids;
use Hashids\Hashids;
use Illuminate\Support\Arr;
class HashidsFactory
{
public function make(array $config): Hashids
{
$config = $this->getConfig($config);
return $this->getClient($config);
}
protected function getConfig(array $config): array
{
return [
'salt' => Arr::get($config, 'salt', ''),
'length' => Arr::get($config, 'length', 0),
'alphabet' => Arr::get($config, 'alphabet', 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890'),
];
}
protected function getClient(array $config): Hashids
{
return new Hashids($config['salt'], $config['length'], $config['alphabet']);
}
}
composer.json 0000644 00000002464 15243426702 0007301 0 ustar 00 {
"name": "vinkla/hashids",
"description": "A Hashids bridge for Laravel",
"license": "MIT",
"keywords": [
"hashids",
"laravel"
],
"authors": [
{
"name": "Vincent Klaiber",
"email": "hello@doubledip.se"
}
],
"require": {
"php": "^8.1",
"graham-campbell/manager": "^5.0",
"hashids/hashids": "^5.0",
"illuminate/contracts": "^10.0",
"illuminate/support": "^10.0"
},
"require-dev": {
"graham-campbell/analyzer": "^4.0",
"graham-campbell/testbench": "^6.0",
"mockery/mockery": "^1.5",
"phpunit/phpunit": "^10.0"
},
"minimum-stability": "dev",
"prefer-stable": true,
"autoload": {
"psr-4": {
"Vinkla\\Hashids\\": "src/"
}
},
"autoload-dev": {
"psr-4": {
"Vinkla\\Tests\\Hashids\\": "tests/"
}
},
"config": {
"preferred-install": "dist"
},
"extra": {
"branch-alias": {
"dev-master": "11.0-dev"
},
"laravel": {
"aliases": {
"Hashids": "Vinkla\\Hashids\\Facades\\Hashids"
},
"providers": [
"Vinkla\\Hashids\\HashidsServiceProvider"
]
}
}
}
config/hashids.php 0000644 00000002404 15243426702 0010152 0 ustar 00 <?php
return [
/*
|--------------------------------------------------------------------------
| Default Connection Name
|--------------------------------------------------------------------------
|
| Here you may specify which of the connections below you wish to use as
| your default connection for all work. Of course, you may use many
| connections at once using the manager class.
|
*/
'default' => 'main',
/*
|--------------------------------------------------------------------------
| Hashids Connections
|--------------------------------------------------------------------------
|
| Here are each of the connections setup for your application. Example
| configuration has been included, but you may add as many connections as
| you would like.
|
*/
'connections' => [
'main' => [
'salt' => '',
'length' => 0,
// 'alphabet' => 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890'
],
'alternative' => [
'salt' => 'your-salt-string',
'length' => 'your-length-integer',
// 'alphabet' => 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890'
],
],
];
