PHP sha1_file() 函数

PHP String فونکشن

实例

计算文本文件 "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(فایل,خام)
پارامتر توضیح
فایل لازم. فایلی که باید محاسبه شود را مشخص می‌کند:
خام

اختیاری. بولین، که فرمت خروجی شانزده‌ریز یا باینری را مشخص می‌کند:

  • TRUE - فرمت باینری اصلی 20 رشته‌ای
  • FALSE - پیش‌فرض. 40 عدد شانزده‌ریز

جزئیات فنی

مقدار بازگشتی: اگر موفق شود، SHA-1 هش محاسبه شده را برمی‌گرداند، اگر ناموفق باشد FALSE برمی‌گرداند.
نسخه PHP: 4.3.0+
رویدادهای به‌روزرسانی:

در PHP 5.0،خام پارامترها اختیاری هستند.

از PHP 5.1 به بعد، می‌توان sha1_file() را با بسته‌بندی استفاده کرد. به عنوان مثال: sha1_file("http://codew3c.com/..")

مثال‌های بیشتر

مثال 1

SHA-1 هش فایل "test.txt" را در فایل ذخیره کنید:

<?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 "فایل خوب است.";
  }
else
  {
  echo "فایل تغییر کرده است.";
  }
?>

خروجی کد بالا:

فایل خوب است.

PHP String فونکشن