mcrypt_create_iv

(PHP 4, PHP 5, PHP 7 < 7.2.0, PECL mcrypt >= 1.0.0)

mcrypt_create_ivCrea un vector de inicialización (IV) desde una fuente aleatoria

Advertencia

Esta función está OBSOLETA en PHP 7.1.0. y ELIMINADA en PHP 7.2.0.

Las alternativas a esta función son:

Descripción

mcrypt_create_iv ( int $size [, int $source = MCRYPT_DEV_URANDOM ] ) : string

Crea un vector de inicialización (IV) desde una fuente aleatoria.

El IV está destinado sólo a proveer una semilla alternativa a las rutinas de cifrado. Este IV no necesita ser secreto en absoluto, aunque ello puede ser deseable. Aún asi se lo puede enviar junto con su texto cifrado sin perder seguridad.

Parámetros

size

El tamaño del IV.

source

La fuente del IV. El parámetro source puede ser MCRYPT_RAND (generador de números aleatorios del sistema), MCRYPT_DEV_RANDOM (lee datos de /dev/random) y MCRYPT_DEV_URANDOM (lee datos de /dev/urandom). Antes de 5.3.0, MCRYPT_RAND era la única soportada en Windows.

Obsérvese que el valor predeterminado de este parámetro era MCRYPT_DEV_RANDOM antes de PHP 5.6.0.

Nota: Observe que MCRYPT_DEV_RANDOM podría hacer que la función quede en espera hasta que haya más entropía disponible.

Valores devueltos

Devuelve el vector de inicialización, o FALSE en caso de error.

Historial de cambios

Versión Descripción
5.6.0 MCRYPT_DEV_URANDOM ahora es el valor predetermniado de source.
5.3.0 MCRYPT_DEV_RANDOM y MCRYPT_DEV_URANDOM se volvieron disponibles en plataformas Windows.
5.3.0 Ya no se requiere invocar primero a srand(). Esto ahora se realiza de forma automática.

Ejemplos

Ejemplo #1 Ejemplo de mcrypt_create_iv()

<?php
    $size 
mcrypt_get_iv_size(MCRYPT_CAST_256MCRYPT_MODE_CFB);
    
$iv mcrypt_create_iv($sizeMCRYPT_DEV_RANDOM);
?>

Ver también