وظيفة PHP sha1_file ().

مثال

حساب تجزئة SHA-1 للملف النصي "test.txt":

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

سيتم إخراج الكود أعلاه:

aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d

التعريف والاستخدام

تقوم الدالة sha1_file() بحساب تجزئة SHA-1 للملف.

تستخدم الدالة sha1_file() خوارزمية التجزئة الآمنة الأمريكية1.

شرح من RFC 3174 - خوارزمية التجزئة الآمنة الأمريكية 1: ينتج SHA-1 مخرجات 160 بت تسمى ملخص الرسالة. يمكن تغذية ملخص الرسالة في خوارزمية التوقيع التي تنشئ توقيع الرسالة أو تتحقق منه. يمكن أن يؤدي توقيع ملخص الرسالة بدلاً من الرسالة إلى تحسين كفاءة العملية لأن حجم ملخص الرسالة عادة ما يكون أصغر بكثير من الرسالة. يجب أن يستخدم المتحقق من التوقيع الرقمي نفس خوارزمية التجزئة التي يستخدمها منشئ التوقيع الرقمي.

إرجاع تجزئة SHA-1 المحسوبة عند النجاح، أو FALSE عند الفشل.

القواعد

 sha1_file ( ملف، خام )

المعلمة	يصف
ملف	مطلوب. يحدد الملف الذي سيتم حسابه.
خام	خياري. قيمة منطقية تحدد تنسيق الإخراج السداسي العشري أو الثنائي: TRUE - تنسيق ثنائي أولي مكون من 20 حرفًا خطأ - افتراضي. رقم سداسي عشري مكون من 40 حرفًا

التفاصيل الفنية

قيمة الإرجاع:	إرجاع تجزئة SHA-1 المحسوبة عند النجاح، أو FALSE عند الفشل.
نسخة PHP:	4.3.0+
سجل التحديث:	في PHP 5.0، تصبح المعلمة الأولية اختيارية. منذ PHP 5.1، يمكن استخدام sha1_file() من خلال التغليف. على سبيل المثال: sha1_file("http://w3cschool.cc/..")

المزيد من الأمثلة

مثال 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 "تم تغيير الملف "; }?>

سيتم إخراج الكود أعلاه:

الملف على ما يرام.