mhash_keygen_s2k

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

mhash_keygen_s2k — Gera uma chave

Warning

Esta função tornou-se DEFASADA a partir do PHP 8.1.0. O uso desta função é fortemente desencorajado.

Descrição

mhash_keygen_s2k(
    int $algo,
    string $password,
    string $salt,
    int $length
): string|false

Gera um chave de acordo com o parâmetro algo a partir de uma senha de usuário informada em password.

Este é o algoritmo Salted S2K como especificado no documento OpenPGP (» RFC 2440).

Tenha em mente que senhas fornecidas pelos usuários não são adequadas para uso como chaves em algoritmos criptográficos, pois os usuários normalmente escolhem chaves que podem ser escritas no teclado. Estas senhas usam somente 6 a 7 bits por caractere (ou menos). É altamente recomendado usar algum tipo de transformação (como esta função) na chave informada pelo usuário.

Parâmetros

algo: O ID da hash usada para criar a chave. Um das constantes MHASH_hashname.
password: Uma senha fornecida pelo usuário.
salt: Deve ser diferente e aleatório o suficiente para cada chave gerada de forma que sejam criadas chaves diferentes. Como salt precisa ser conhecido quando se verifica as chaves, é uma boa prática concatenar a chave a ele. Salt tem um comprimento fixo de 8 bytes e será completado com zeros forem fornecidos menos bytes.
length: O tamanho da chave, em bytes.

Valor Retornado

Retorna a chave gerada como uma string, ou false em caso de erro.

Registro de Alterações

Versão	Descrição
8.1.0	Esta função está defasada. Use as funções `hash_*()` em seu lugar.