array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.uniqid.php', 1 => 'uniqid', 2 => 'Genera un identificador basado en el tiempo', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Funciones Varias', ), 'prev' => array ( 0 => 'function.time-sleep-until.php', 1 => 'time_sleep_until', ), 'next' => array ( 0 => 'function.unpack.php', 1 => 'unpack', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/misc/functions/uniqid.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

uniqid

(PHP 4, PHP 5, PHP 7, PHP 8)

uniqid — Genera un identificador basado en el tiempo

Descripción

uniqid(string $prefix = "", bool $more_entropy = false): string

Genera un identificador basado en la hora actual con una precisión a la microsegundo, prefijado por el prefix dado y añadiendo eventualmente un valor generado aleatoriamente.

Precaución

Esta función no genera valores criptográficamente seguros, y no debe ser utilizada con fines criptográficos, o con fines que requieran que los valores devueltos sean indescifrables.

Si se requiere aleatoriedad criptográficamente segura, el Random\Randomizer puede ser utilizado con el motor Random\Engine\Secure. Para casos de uso simples, las funciones random_int() y random_bytes() proporcionan una API práctica y segura que es soportada por el CSPRNG del sistema operativo.

Advertencia

Esta función no garantiza la unicidad del valor devuelto ya que este se basa en la hora actual en microsegundos o en la hora actual con una pequeña cantidad de datos aleatorios añadidos si more_entropy es true.

Parámetros

prefix

Puede ser útil, por ejemplo, para identificar fácilmente diferentes hosts, si se genera simultáneamente en varios hosts que pueden generar el mismo identificador en la misma microsegundo. (Esto puede ocurrir incluso en un solo host si el reloj del sistema se mueve hacia atrás, por ejemplo por un ajuste NTP.)

Sin prefix (prefijo vacío), la cadena devuelta tendrá 13 caracteres. Si more_entropy es true, tendrá 23 caracteres.

more_entropy

Si el parámetro opcional more_entropy es true, uniqid() añadirá una entropía "combined LCG" al final del valor devuelto, lo que aumenta la probabilidad de la unicidad del resultado.

Valores devueltos

Devuelve un identificador basado en el timestamp, en forma de string.

Advertencia

Esta función no garantiza la unicidad del valor devuelto.

Ejemplos

Ejemplo #1 Ejemplo con uniqid()

<?php
/* Un identificador único, como: 4b3403665fea6 */
printf("uniqid(): %s\r\n", uniqid());

/* También podemos prefijar el identificador único,
* lo que equivale a:
*
* $uniqid = $prefix . uniqid();
* $uniqid = uniqid($prefix);
*/
printf("uniqid('php_'): %s\r\n", uniqid('php_'));

/* También podemos activar el parámetro more_entropy,
* requerido por algunos sistemas, como Cygwin. Esto hará que
* uniqid() produzca un valor como: 4b340550242239.64159797
*/
printf("uniqid('', true): %s\r\n", uniqid('', true));
?>

Notas

Nota:

En Cygwin, el parámetro more_entropy debe ser pasado a true para que esta función funcione.

Ver también