| name file | size | edit | permission | action |
|---|---|---|---|---|
| .editorconfig | 276 KB | March 05 2024 07:12:34 | 0666 | |
| .env | 1385 KB | May 24 2024 16:43:55 | 0666 | |
| .env.example | 1088 KB | March 05 2024 07:12:34 | 0666 | |
| .gitattributes | 190 KB | March 05 2024 07:12:34 | 0666 | |
| .gitignore | 245 KB | March 05 2024 07:12:34 | 0666 | |
| .htaccess | 947 KB | July 04 2023 21:25:08 | 0664 | |
| .rnd | 1024 KB | March 13 2024 04:51:14 | 0666 | |
| README.md | 472 KB | March 22 2024 10:35:00 | 0666 | |
| app | - | March 05 2024 07:12:34 | 0777 | |
| artisan | 1739 KB | March 05 2024 07:12:34 | 0666 | |
| bootstrap | - | March 05 2024 07:12:34 | 0777 | |
| composer.json | 2829 KB | May 13 2024 12:10:04 | 0666 | |
| composer.lock | 417205 KB | March 19 2024 12:13:14 | 0666 | |
| config | - | July 03 2025 02:53:36 | 0777 | |
| database | - | March 05 2024 07:12:34 | 0777 | |
| index.php | 1816 KB | May 13 2024 10:32:36 | 0666 | |
| lang | - | May 13 2024 14:53:26 | 0777 | |
| manifest.json | 913 KB | May 14 2024 03:57:26 | 0664 | |
| package.json | 398 KB | March 05 2024 07:12:34 | 0666 | |
| phpunit.xml | 1206 KB | March 05 2024 07:12:34 | 0666 | |
| public | - | July 03 2025 02:37:20 | 0777 | |
| resources | - | May 13 2024 12:09:36 | 0777 | |
| routes | - | March 05 2024 07:12:34 | 0777 | |
| service-worker.js | 924 KB | March 05 2024 07:12:34 | 0666 | |
| storage | - | March 05 2024 10:03:52 | 0777 | |
| symlink.php | 218 KB | March 05 2024 07:12:34 | 0666 | |
| tests | - | March 05 2024 07:12:34 | 0777 | |
| vendor | - | March 19 2024 12:13:14 | 0777 | |
| vite.config.js | 326 KB | March 05 2024 07:12:34 | 0666 |
*/ abstract class AbstractUid implements \JsonSerializable { /** * The identifier in its canonic representation. */ protected $uid; /** * Whether the passed value is valid for the constructor of the current class. */ abstract public static function isValid(string $uid): bool; /** * Creates an AbstractUid from an identifier represented in any of the supported formats. * * @throws \InvalidArgumentException When the passed value is not valid */ abstract public static function fromString(string $uid): static; /** * @throws \InvalidArgumentException When the passed value is not valid */ public static function fromBinary(string $uid): static { if (16 !== \strlen($uid)) { throw new \InvalidArgumentException('Invalid binary uid provided.'); } return static::fromString($uid); } /** * @throws \InvalidArgumentException When the passed value is not valid */ public static function fromBase58(string $uid): static { if (22 !== \strlen($uid)) { throw new \InvalidArgumentException('Invalid base-58 uid provided.'); } return static::fromString($uid); } /** * @throws \InvalidArgumentException When the passed value is not valid */ public static function fromBase32(string $uid): static { if (26 !== \strlen($uid)) { throw new \InvalidArgumentException('Invalid base-32 uid provided.'); } return static::fromString($uid); } /** * @throws \InvalidArgumentException When the passed value is not valid */ public static function fromRfc4122(string $uid): static { if (36 !== \strlen($uid)) { throw new \InvalidArgumentException('Invalid RFC4122 uid provided.'); } return static::fromString($uid); } /** * Returns the identifier as a raw binary string. */ abstract public function toBinary(): string; /** * Returns the identifier as a base58 case sensitive string. */ public function toBase58(): string { return strtr(sprintf('%022s', BinaryUtil::toBase($this->toBinary(), BinaryUtil::BASE58)), '0', '1'); } /** * Returns the identifier as a base32 case insensitive string. */ public function toBase32(): string { $uid = bin2hex($this->toBinary()); $uid = sprintf('%02s%04s%04s%04s%04s%04s%04s', base_convert(substr($uid, 0, 2), 16, 32), base_convert(substr($uid, 2, 5), 16, 32), base_convert(substr($uid, 7, 5), 16, 32), base_convert(substr($uid, 12, 5), 16, 32), base_convert(substr($uid, 17, 5), 16, 32), base_convert(substr($uid, 22, 5), 16, 32), base_convert(substr($uid, 27, 5), 16, 32) ); return strtr($uid, 'abcdefghijklmnopqrstuv', 'ABCDEFGHJKMNPQRSTVWXYZ'); } /** * Returns the identifier as a RFC4122 case insensitive string. */ public function toRfc4122(): string { // don't use uuid_unparse(), it's slower $uuid = bin2hex($this->toBinary()); $uuid = substr_replace($uuid, '-', 8, 0); $uuid = substr_replace($uuid, '-', 13, 0); $uuid = substr_replace($uuid, '-', 18, 0); return substr_replace($uuid, '-', 23, 0); } /** * Returns whether the argument is an AbstractUid and contains the same value as the current instance. */ public function equals(mixed $other): bool { if (!$other instanceof self) { return false; } return $this->uid === $other->uid; } public function compare(self $other): int { return (\strlen($this->uid) - \strlen($other->uid)) ?: ($this->uid <=> $other->uid); } public function __toString(): string { return $this->uid; } public function jsonSerialize(): string { return $this->uid; } }