Przykład
Obliczyć SHA-1 hash pliku tekstowego "test.txt" :
<?php
$filename = "test.txt";
$sha1file = sha1_file($filename);
echo $sha1file;
?>Wyjście z kodem powyżej będą:
aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d
Definicja i Wykorzystanie
sha1_file() oblicza SHA-1 pliku.
sha1_file() funkcja używa US Secure Hash Algorithm 1.
Z RFC 3174 - USA Secure Hash Algorithm 1: "SHA-1 produces a 160-bit output called a message digest. The message digest can then, for example, be input to a signature algorithm which generates or verifies the signature for the message. Signing the message digest rather than the message often improves the efficiency of the process because the message digest is usually much smaller in size than the message. The same hash algorithm must be used by the verifier of a digital signature as was used by the creator of the digital signature."
Funkcja ta zwraca obliczoną skrótu SHA-1 w przypadku sukcesu lub FALSE w przypadku błędu.
Składnia
sha1_file( file,raw )
| Parametr | Opis |
|---|---|
| file | Wymagany. Plik należy obliczyć |
| raw | Opcjonalny. Wartość logiczna, która określa szesnastkowy lub binarny format wyjściowy:
|
Szczegóły techniczne
| Zwracana wartość: | Zwraca obliczone skrótu SHA-1 w przypadku powodzenia, FALSE w przypadku porażki |
|---|---|
| Wersja PHP: | 4.3.0+ |
| Lista zmian: | Parametr surowy stały się opcjonalne w PHP 5.0 Od PHP 5.1, możliwe jest użycie sha1_file() z opakowania, na przykład sha1_file("http://w3ii.com/..") |
Więcej przykładów
Przykład 1
Przechowywać SHA-1 hash "test.txt" w pliku:
<?php
$sha1file = sha1_file("test.txt");
file_put_contents("sha1file.txt",$sha1file);
?>Sprawdza czy "test.txt" została zmieniona (czyli jeśli hash SHA-1 został zmieniony):
<?php
$sha1file = file_get_contents("sha1file.txt");
if (sha1_file("test.txt") == $sha1file)
{
echo "The file is ok.";
}
else
{
echo "The file has been changed.";
}
?>Wyjście z kodem powyżej mogą być:
The file is ok.
<String referencyjny PHP