وظيفة PHPpassword_needs_rehash()

الكاتب：Eve Cole وقت التحديث：2024-12-28 11:24:01

يتم استخدام الدالةpassword_hash() للتحقق مما إذا كانت قيمة التجزئة تطابق الخيارات المحددة.

متطلبات إصدار PHP: PHP 5 >= 5.5.0، PHP 7

قواعد اللغة

 كلمة المرور المنطقية_تحتاج_rehash (سلسلة $hash، int $algo [، array $options])

وصف المعلمة:

hash: قيمة تجزئة تم إنشاؤها بواسطةpassword_hash().

algo: ثابت خوارزمية تشفير يُستخدم للإشارة إلى الخوارزمية المستخدمة عند تجزئة كلمات المرور.

الخيارات: مصفوفة ترابطية تحتوي على خيارات. حاليًا، يتم دعم خيارين: الملح، والملح (سلسلة التداخل) المضافة عند تجزئة كلمة المرور، والتكلفة، والتي تُستخدم لتحديد عدد مستويات تكرار الخوارزمية. يمكن العثور على أمثلة لهاتين القيمتين في صفحة crypt(). عند حذفها، سيتم استخدام قيمة الملح العشوائية والتكلفة الافتراضية.

قيمة الإرجاع

تكتشف هذه الوظيفة ما إذا كانت قيمة التجزئة المحددة تطبق الخوارزمية والخيارات المتوفرة. إذا لم يكن الأمر كذلك، فيجب إعادة إنشاء قيمة التجزئة.

مثال

استخدام كلمة المرور_needs_rehash()

<?php $password = ' rasmuslerdorf ' ; $hash = ' $ 2y $10$YCFsG6elYca568hBi2pZ0.3LDL5wjgxct1N8w/oLR/jfHsiQwCqTS ' // يمكن تعديل معلمة التكلفة عند تحسين أداء الأجهزة. $options = array ( ' cost ' => 11 ) ; // تحقق من التجزئة المخزنة مقابل كلمة المرور ذات النص الواضح لو ( password_verify ( $password ، $hash ) ) { // تحقق مما إذا كانت هناك خوارزمية تجزئة أحدث متاحة // أو تغييرات التكلفة لو ( password_needs_rehash ( $hash ، PASSWORD_DEFAULT ، $options ) ) { // إذا كان الأمر كذلك، قم بإنشاء تجزئة جديدة، لتحل محل القديمة $ newHash = pass_hash ( $password , PASSWORD_DEFAULT , $options ) } // تمكين المستخدم من تسجيل الدخول } ?>