hash

(PHP 5 >= 5.1.2, PHP 7, PHP 8, PECL hash >= 1.1)

hashGera um valor hash (resumo da mensagem)

Descrição

hash(
    string $algo,
    string $data,
    bool $binary = false,
    array $options = []
): string

Parâmetros

algo

Nome do algoritmo de hash selecionado (por exemplo, "sha256"). Para uma lista de algoritmos suportados, veja hash_algos().

data

Mensagem a ter o hash gerado.

binary

Quando definido como true, gera dados binários brutos. false gera caracteres hexadecimais minúsculos.

options

Um array de opções para os vários algoritmos de hash. Atualmente, apenas o parâmetro "seed" é suportado pelas variantes MurmurHash.

Valor Retornado

Retorna uma string contendo o resumo da mensagem calculado como caracteres hexadecimais minúsculos a menos que binary seja definido como true, caso em que a representação binária bruta do resumo da mensagem é retornada.

Registro de Alterações

Versão Descrição
8.1.0 O parâmetro options foi adicionado.
8.0.0 hash() agora lança uma exceção ValueError se algo for desconhecido; anteriormente, false era retornado.

Exemplos

Exemplo #1 Um exemplo de hash()

<?php
echo hash('sha256', 'The quick brown fox jumped over the lazy dog.');
?>

O exemplo acima produzirá:

68b1282b91de2c054c36629cb8dd447f12f096d3e3c587978dc2248444633483

Veja Também

  • hash_init() - Inicializa um contexto de hash incremental
  • hash_file() - Gera um valor hash usando o conteúdo de um arquivo fornecido
  • hash_hmac() - Gera um valor de hash com chave usando o método HMAC