1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 <?php
/**
* BEdita, API-first content management framework
* Copyright 2017 ChannelWeb Srl, Chialab Srl
*
* This file is part of BEdita: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published
* by the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* See LICENSE.LGPL or <http://gnu.org/licenses/lgpl-3.0.html> for more details.
*/
namespace BEdita\Core\Utility;
use Cake\Utility\Text as CakeText;
/**
* Text handling utilities.
*/
class Text extends CakeText
{
/**
* Null UUID.
*
* @var string
* @see https://www.ietf.org/rfc/rfc4122.txt
*/
public const UUID_NIL = '00000000-0000-0000-0000-000000000000';
/**
* Namespace for names that are fully-qualified domain names.
*
* @var string
* @see https://www.ietf.org/rfc/rfc4122.txt
*/
public const NAMESPACE_DNS = '6ba7b810-9dad-11d1-80b4-00c04fd430c8';
/**
* Namespace for names that are URLs.
*
* @var string
* @see https://www.ietf.org/rfc/rfc4122.txt
*/
public const NAMESPACE_URL = '6ba7b811-9dad-11d1-80b4-00c04fd430c8';
/**
* Namespace for names that are ISO OIDs.
*
* @var string
* @see https://www.ietf.org/rfc/rfc4122.txt
*/
public const NAMESPACE_OID = '6ba7b812-9dad-11d1-80b4-00c04fd430c8';
/**
* Namespace for names that are X.500 DNs (in DER or a text output format).
*
* @var string
* @see https://www.ietf.org/rfc/rfc4122.txt
*/
public const NAMESPACE_X500 = '6ba7b814-9dad-11d1-80b4-00c04fd430c8';
/**
* Utility function to convert hex into bin for a UUID.
*
* @param string $uuid A UUID to convert into binary format.
* @return string
* @copyright Matt Farina MIT License https://github.com/lootils/uuid/blob/master/LICENSE
*/
protected static function uuidToBin($uuid)
{
static $pattern = '/^\{?[0-9a-f]{8}\-?[0-9a-f]{4}\-?[0-9a-f]{4}\-?[0-9a-f]{4}\-?[0-9a-f]{12}\}?$/i';
if (preg_match($pattern, $uuid) !== 1) {
throw new \LogicException(__d('bedita', 'The UUID provided for the namespace is not valid.'));
}
// Get hexadecimal components of namespace
$hex = str_replace('-', '', $uuid);
$length = strlen($hex);
// Convert to bits
$bin = '';
for ($i = 0; $i < $length; $i += 2) {
$bin .= chr(hexdec($hex[$i] . $hex[$i + 1]));
}
return $bin;
}
/**
* Generate a UUID version 5.
*
* @param string $name Name to generate UUID v5 for.
* @param string $namespace A valid UUID to be used as namespace.
* @return string
* @see https://www.ietf.org/rfc/rfc4122.txt
* @copyright Matt Farina MIT License https://github.com/lootils/uuid/blob/master/LICENSE
*/
public static function uuid5($name, $namespace = self::UUID_NIL)
{
$bin = static::uuidToBin($namespace);
$hash = sha1($bin . $name);
return sprintf(
'%08s-%04s-%04x-%04x-%12s',
// 32 bits for "time_low"
substr($hash, 0, 8),
// 16 bits for "time_mid"
substr($hash, 8, 4),
// 16 bits for "time_hi_and_version",
// four most significant bits holds version number 5
(hexdec(substr($hash, 12, 4)) & 0x0fff) | 0x5000,
// 16 bits, 8 bits for "clk_seq_hi_res",
// 8 bits for "clk_seq_low",
// two most significant bits holds zero and one for variant DCE1.1
(hexdec(substr($hash, 16, 4)) & 0x3fff) | 0x8000,
// 48 bits for "node"
substr($hash, 20, 12)
);
}
}