(PHP 4, PHP 5, PHP 7, PHP 8)
uniqid — Сгенерировать уникальный ID
$prefix
= "", bool $more_entropy
= false
): stringПолучает уникальный идентификатор с префиксом, основанный на текущем времени в микросекундах.
Функция не создаёт криптографически защищённые значения и не должна использоваться для криптографических целей или целей, требующих, чтобы возвращаемые значения были недоступны для разгадывания.
Если требуется криптографически безопасная случайная последовательность, Random\Randomizer может использоваться с движком Random\Engine\Secure. Для простых случаев использования функции random_int() и random_bytes() предоставляют удобный и безопасный API, поддерживаемый CSPRNG операционной системы.
Эта функция не гарантирует получения уникального значения. Большинство
операционных систем синхронизирует время с NTP, либо его аналогами,
так что системное время постоянно меняется. Следовательно возможна
ситуация, когда эта функция вернёт неуникальный идентификатор для
процесса/потока. Для увеличения вероятности получения уникального
значения используйте параметр more_entropy
.
prefix
Может быть полезно, к примеру, если идентификаторы генерируются одновременно на нескольких хостах и генерация идентификаторов производится в одну и ту же микросекунду.
С пустым параметром prefix
, возвращаемая строка
будет длиной в 13 символов. Если параметр more_entropy
равен true
, то строка будет длиной в 23 символа.
more_entropy
Если равен true
, то функция uniqid() добавит
дополнительную энтропию (используя комбинированный линейный конгруэнтный
генератор) в конце возвращаемого значения, что увеличивает вероятность
уникальности результата.
Возвращает уникальный идентификатор в виде строки.
Эта функция пытается создать уникальный идентификатор, но не даёт 100% гарантии уникальности.
Пример #1 Пример использования uniqid()
<?php
/* Уникальный id, например: 4b3403665fea6 */
printf("uniqid(): %s\r\n", uniqid());
/* Префикс к уникальному id можно добавить одним
* из следующих способов:
*
* $uniqid = $prefix . uniqid();
* $uniqid = uniqid($prefix);
*/
printf("uniqid('php_'): %s\r\n", uniqid('php_'));
/* Также можно активировать параметр большей энтропии, который
* требуется на некоторых системах, таких как Cygwin. Таким образом
* функция uniqid() сгенерирует значение: 4b340550242239.64159797
*/
printf("uniqid('', true): %s\r\n", uniqid('', true));
?>
Замечание:
В Cygwin параметр
more_entropy
должен быть задан какtrue
для работы этой функции.