Zabbix

<?php declare(strict_types = 0);

/*

** Copyright (C) 2001-2025 Zabbix SIA

**

** This program 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, version 3.

**

** This program 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 Affero General Public License along with this program.

** If not, see <https://www.gnu.org/licenses/>.

**/

​

​

/**

 * Class to work with CUID hash. Based on server CUID implementation.

 */

class CCuid {

    private const BASE36 = 36;

    private const BLOCK_SIZE = 4;

    private const DECIMAL = 10;

    private const PREFIX = 'c';

    private const DISCRETE_VALUES = 1679616;

​

    public const LENGTH = 25;

​

    private static $counter = -1;

​

    public static function generate(): string {

        return sprintf('%s%s%s%s%s%s', self::PREFIX, self::getTimestampBlock(), self::getCounterBlock(),

            self::getFingerprintBlock(), self::getRandomBlock(), self::getRandomBlock()

        );

    }

​

    public static function isCuid(string $hash): bool {

        return $hash[0] === self::PREFIX;

    }

​

    public static function checkLength(string $hash): bool {

        return strlen($hash) === self::LENGTH;

    }

​

    private static function pad(string $value, int $size): string {

        return substr(str_pad(base_convert($value, self::DECIMAL, self::BASE36), $size, '0', STR_PAD_LEFT), -$size);

    }

​

    private static function next(): int {

        self::$counter++;

​

        if (self::$counter >= self::DISCRETE_VALUES) {

            self::$counter = 0;

        }

​

        return self::$counter;

    }

​

    private static function getRandomBlock(): string {

        $rand = floor(mt_rand() / mt_getrandmax() * self::DISCRETE_VALUES);

​

        return self::pad((string) $rand, self::BLOCK_SIZE);

    }