PHP sha1_file() 函数 - PHP 5 函数参考手册

PHP sha1_file() 函数计算文件的 SHA-1 散列

( PHP >= 4.3.0 )

函数原型

sha1_file( file,raw )

sha1_file() 函数使用美国 Secure Hash 算法 1

来自 RFC 3174 的解释

美国 Secure Hash 算法 1：

SHA-1 产生一个名为报文摘要的 160 位的输出
报文摘要可以被输入到一个可生成或验证报文签名的签名算法
对报文摘要进行签名，而不是对报文进行签名，这样可以提高进程效率，因为报文摘要的大小通常比报文要小很多
数字签名的验证者必须像数字签名的创建者一样，使用相同的散列算法

参数

参数	描述
file	必需。规定要计算的文件
raw	可选。一个规定十六进制或二进制输出格式的布尔值： TRUE - 原始 20 字符二进制格式 FALSE - 默认。40 字符十六进制数

返回值

如果成功则返回已计算的 SHA-1 散列，如果失败则返回 FALSE

更新日志

PHP 版本	更新说明
PHP 5.1	sha1_file() 可以使用各种文件访问协议如：sha1_file("https://www.twle.cn")
PHP 5.0	raw参数变成可选的

范例

假设存在文件 demo.txt , 文件内容如下

简单教程，简单编程！

计算文本文件 "demo.txt" 的 SHA-1 散列:

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

运行范例 »

运行以上 PHP 范例，输出结果如下

b67d645831250878751eb1eb5d6acda557fb53c3

实例 1

在文件中存储 "demo.txt" 的 SHA-1 散列:

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

检测 "demo.txt" 是否已被更改（即 SHA-1 散列是否已被更改）

<?php
$sha1file = file_get_contents("sha1file.txt");
if (sha1_file("demo.txt") == $sha1file)
{
    echo "The file is ok.";
}
else
{
    echo "The file has been changed.";
}

运行以上 PHP 范例，输出结果如下

The file is ok.