PHP crypt()Función
Manual de referencia de cadenas PHP
Definición y uso
La función crypt() devuelve una cadena cifrada utilizando los algoritmos DES, Blowfish o MD5.
El comportamiento de esta función varía según el sistema operativo; algunos sistemas admiten más de un tipo de algoritmo. Durante la instalación, PHP comprueba qué algoritmos están disponibles y cuál utilizar.
El algoritmo exacto depende del formato y la longitud del parámetro salt. El salt puede hacer que el cifrado sea más seguro al aumentar la cantidad de cadenas generadas combinando una cadena específica con un método de cifrado específico.
Aquí hay algunas constantes que se utilizan junto con la función crypt(). Estos valores de constantes están establecidos por PHP durante la instalación.
Constantes:
- [CRYPT_SALT_LENGTH] - Longitud de cifrado predeterminada. Con el cifrado DES estándar, la longitud es 2.
- [CRYPT_STD_DES] - El cifrado estándar basado en DES tiene un salt de 2 caracteres del alfabeto "./0-9A-Za-z". El uso de caracteres no válidos en el salt provocará un fallo de la función.
- [CRYPT_EXT_DES] - El cifrado extendido basado en DES tiene un salt de 9 caracteres, compuesto por un guion bajo, seguido de 4 bytes de iteraciones y 4 bytes de salt. Estos se codifican como caracteres imprimibles, cada carácter de 6 bits, con el carácter menos significativo primero. Los valores del 0 al 63 se codifican como "./0-9A-Za-z". El uso de caracteres no válidos en el salt provocará un fallo de la función.
- [CRYPT_MD5] - El cifrado MD5 tiene un salt de 12 caracteres que comienza con $1$.
- [CRYPT_BLOWFISH] - El cifrado Blowfish tiene un salt que comienza con $2a$, $2x$ o $2y$, un parámetro de costo "$" de dos dígitos, y 22 caracteres del alfabeto "./0-9A-Za-z". El uso de caracteres fuera del alfabeto hará que la función devuelva una cadena de longitud 0. El parámetro "$" es el logaritmo en base 2 del número de iteraciones del algoritmo hash basado en Blowfish, y debe estar en el rango de 04-31. Los valores fuera de ese rango provocarán un fallo de la función.
- [CRYPT_SHA_256] - El cifrado SHA-256 tiene un salt de 16 caracteres que comienza con $5$.Si la cadena salt comienza con "rounds=<N>$", el valor numérico de N se utiliza para indicar el número de veces que se ejecuta el bucle hash, similar al parámetro de costo en Blowfish. El número predeterminado de iteraciones es 5000, el mínimo es 1000 y el máximo es 999,999,999. Cualquier valor de N fuera de este rango se convertirá al valor límite más cercano.
- [CRYPT_SHA_512] - El cifrado SHA-512 tiene un salt de 16 caracteres que comienza con $6$.Si la cadena salt comienza con "rounds=<N>$", el valor numérico de N se utiliza para indicar el número de veces que se ejecuta el bucle hash, similar al parámetro de costo en Blowfish. El número predeterminado de iteraciones es 5000, el mínimo es 1000 y el máximo es 999,999,999. Cualquier valor de N fuera de este rango se convertirá al valor límite más cercano.
En los sistemas donde esta función admite múltiples algoritmos, las constantes anteriores se establecen en "1" si son compatibles; de lo contrario, se establecen en "0".
Notas:No existe una función de descifrado correspondiente. La función crypt() utiliza un algoritmo unidireccional.
Sintaxis
| Parámetros | Descripción |
|---|---|
| str | Obligatorio. Especifica la cadena que se va a codificar. |
| salt | Opcional. Una cadena utilizada para aumentar la cantidad de caracteres codificados, lo que hace que la codificación sea más segura. Si no se proporciona el parámetro salt, se generará uno aleatoriamente en cada llamada a la función. |
Detalles técnicos
| Valor de retorno: | Devuelve la cadena cifrada; si falla, devuelve una cadena de menos de 13 caracteres que se garantiza que sea diferente del salt. |
|---|---|
| Versión de PHP: | 4+ |
| Registro de cambios: | En PHP 5.3.7, se agregaron los modos Blowfish $2x$ y $2y$ para manejar posibles ataques de bit alto. En PHP 5.3.2, se agregaron las constantes SHA-256 y SHA-512. Desde PHP 5.3.2, Blowfish devuelve la cadena "failure" ("*0" o "*1") en caso de iteraciones no válidas, en lugar de recurrir a DES. Desde PHP 5.3.0, PHP incluye su propia implementación del cifrado MD5, la implementación DES estándar, la implementación DES extendida y el algoritmo Blowfish. Si el sistema no admite los algoritmos mencionados, se utilizarán las implementaciones integradas de PHP. |
Ejemplos
Ejemplo 1
Ejemplo 2
Cifrado con crypt() utilizando htpasswd:
Ejemplo 1
En este ejemplo, utilizamos diferentes tipos de hash:
El código anterior produce el siguiente resultado (depende del sistema operativo):
Standard DES: rl.3StKT.4T8M Extended DES: _J9..rasmBYk8r9AiWNc MD5: $1$rasmusle$rISCgZzpwk3UhDidwXvin0 Blowfish: $2a$07$usesomesillystringfore2uDLvp1Ii2e./U9C8sBjqp8I90dH6hi SHA-256: $5$rounds=5000$usesomesillystri$KqJWpanXZHKq2BOB43TSaYhEWsQ1Lr5QNyPCDH/Tp.6 SHA-512: $6$rounds=5000$usesomesillystri$D4IrlXatmP7rx3P3InaxBeoomnAihCKRVQP22JZ6EY47Wc6BkroIuUUBOov1i.S5KPgErtP/EN5mcO.ChWQW21
Manual de referencia de cadenas PHP Otras extensiones