mcrypt_create_iv

(PHP 4, PHP 5)

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

Descripción

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

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.

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_256, MCRYPT_MODE_CFB);
    $iv = mcrypt_create_iv($size, MCRYPT_DEV_RANDOM);
?>

Ver también