hash_file

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

hash_fileGenera un valor de hash utilizando el contenido de un fichero dado

Descripción

hash_file(
    string $algo,
    string $filename,
    bool $binary = false,
    array $options = []
): string|false

Parámetros

algo

Nombre del algoritmo de hash seleccionado (por ejemplo: "sha256"). Para una lista de los algoritmos disponibles ver hash_algos().

filename

URL que indica la ubicación del fichero que será hasheado; Soporta los envolventes fopen().

binary

Cuando vale true, la salida será datos binarios sin tratar. Cuando vale false, la salida será dígitos hexadecimales en minúscula.

options

Un array de opciones para los diversos algoritmos de hash. Actualmente, solo el parámetro "seed" es soportado para las variantes MurmurHash.

Valores devueltos

Devuelve un string que contiene la huella digital calculada en dígitos hexadecimales minúsculos a menos que binary esté fijado a true. En este caso, la representación binaria sin tratar de la huella digital es devuelta, o false en caso de error.

Historial de cambios

Versión Descripción
8.1.0 El parámetro options ha sido añadido.

Ejemplos

Ejemplo #1 Ejemplo con hash_file()

<?php
/* Crea un fichero para calcular su huella digital */
file_put_contents('example.txt', 'The quick brown fox jumped over the lazy dog.');

echo
hash_file('sha256', 'example.txt');
?>

El resultado del ejemplo sería:

68b1282b91de2c054c36629cb8dd447f12f096d3e3c587978dc2248444633483

Ver también

  • hash_init() - Inicializa un contexto de hachado incremental
  • hash_hmac_file() - Genera un valor de clave de hash utilizando el método HMAC y el contenido de un fichero dado