PHP sha1_file() funktion

Eksempel

Beregn SHA-1 hash for tekstfilen "test.txt":

<?php
$filename = "test.txt";
$sha1file = sha1_file($filename);
echo $sha1file;
?>

Output af ovenstående kode:

aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d

Definition og brug

sha1_file() funktionen beregner filens SHA-1 hash.

sha1_file() funktionen bruger den amerikanske Secure Hash-algoritme 1.

Forklaring fra RFC 3174 - Den amerikanske Secure Hash-algoritme 1: SHA-1 genererer en 160-bit output kaldet meddelelsesresumé. Meddelelsesresumé kan inputtes til en algoritme, der kan generere eller verificere meddelelsessignaturer. At signere meddelelsesresumé i stedet for meddelelsen kan forbedre proceseffektiviteten, da meddelelsesresuméets størrelse typisk er meget mindre end meddelelsen. Verificereren af den digitale signatur skal bruge den samme hash-algoritme som skabereren af den digitale signatur.

Returnerer den beregnede SHA-1 hash, hvis succesfuld, ellers returnerer FALSE.

Syntaks

sha1_file(fil,raw)
Parameter Beskrivelse
fil Obligatorisk. Bestemmer filen, der skal beregnes.
raw

Valgfri. Boolsk værdi, der bestemmer seksservertal eller binær outputformat:

  • TRUE - Original 20-seksservertal binær format
  • FALSE - Standard. 40-seksservertal

Tekniske detaljer

Returværdi: Returnerer den beregnede SHA-1 hash, hvis succesfuld, ellers returnerer FALSE.
PHP version: 4.3.0+
Opdateringslog

I PHP 5.0:raw Parameter er valgfri.

Fra PHP 5.1 kan sha1_file() bruges ved at indpakke. For eksempel: sha1_file("http://codew3c.com/..")

Flere eksempler

Eksempel 1

Lagre SHA-1 hash for "test.txt" i filen:

<?php
$sha1file = sha1_file("test.txt");
file_put_contents("sha1file.txt",$sha1file);
?>

Test om "test.txt" er blevet ændret (dvs. SHA-1 er blevet ændret):

<?php
$sha1file = file_get_contents("sha1file.txt");
if (sha1_file("test.txt") == $sha1file)
  {
  echo "Filen er okay.";
  }
else
  {
  echo "Filen er blevet ændret.";
  }
?>

Output af ovenstående kode:

Filen er okay.