PHP sha1_file() 函數

實例

計算文字檔"test.txt" 的SHA-1 雜湊：

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

上面的程式碼將輸出：

aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d

定義和用法

sha1_file() 函數計算檔案的SHA-1 雜湊。

sha1_file() 函數使用美國Secure Hash 演算法1。

來自RFC 3174 的解釋- 美國Secure Hash 演算法1： SHA-1 產生一個名為封包摘要的160 位元的輸出。報文摘要可以被輸入到一個可產生或驗證封包簽章的簽章演算法。對報文摘要進行簽名，而不是對報文進行簽名，這樣可以提高進程效率，因為報文摘要的大小通常比報文小很多。數位簽章的驗證者必須像數位簽章的創建者一樣，使用相同的雜湊演算法。

如果成功則傳回已計算的SHA-1 雜湊，如果失敗則傳回FALSE。

文法

sha1_file( file,raw )

參數	描述
file	必需。規定要計算的文件。
raw	可選。一個規定十六進位或二進位輸出格式的布林值： TRUE - 原始20 字元二進位格式 FALSE - 預設。 40 字元十六進位數

技術細節

傳回值：	如果成功則傳回已計算的SHA-1 雜湊，如果失敗則傳回FALSE。
PHP 版本：	4.3.0+
更新日誌：	在PHP 5.0 中， raw參數變成可選的。自PHP 5.1 起，可以透過封裝使用sha1_file()。例如： sha1_file("http://w3cschool.cc/..")

更多實例

實例1

在檔案中儲存"test.txt" 的SHA-1 雜湊：

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

偵測"test.txt" 是否已變更（即SHA-1 雜湊是否已變更）：

<?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 ."; }?>

上面的程式碼將輸出：

The file is ok.