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://codingdict.com/..")

实例 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.