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 |
可选。布尔值,规定十六进制或二进制输出格式:
|
技术细节
返回值: | 如果成功则返回已计算的 SHA-1 散列,如果失败则返回 FALSE。 |
PHP 版本: | 4.3.0+ |
更新日志: |
在 PHP 5.0 中,raw 参数变成可选的。 自 PHP 5.1 起,可以通过封装来使用 sha1_file()。例如: sha1_file("http://w3school.com.cn/..") |
更多实例
例子 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.