ฟังก์ชั่น PHPpassword_needs_rehash()

ผู้เขียน：Eve Cole เวลาอัปเดต：2024-12-28 11:24:01

ฟังก์ชันpassword_hash()ใช้เพื่อตรวจสอบว่าค่าแฮชตรงกับตัวเลือกที่ระบุหรือไม่

ข้อกำหนดเวอร์ชัน PHP: PHP 5 >= 5.5.0, PHP 7

ไวยากรณ์

 boolpassword_needs_rehash ( สตริง $hash , int $algo [, อาร์เรย์ $options ] )

คำอธิบายพารามิเตอร์:

hash: ค่าแฮชที่สร้างโดยpassword_hash()

algo: ค่าคงที่อัลกอริทึมการเข้ารหัสที่ใช้เพื่อระบุอัลกอริทึมที่ใช้เมื่อแฮชรหัสผ่าน

ตัวเลือก: อาร์เรย์ที่เชื่อมโยงที่มีตัวเลือก ปัจจุบัน รองรับสองตัวเลือก ได้แก่ Salt, Salt (สตริงการรบกวน) ที่เพิ่มเมื่อแฮชรหัสผ่าน และต้นทุน ซึ่งใช้เพื่อระบุจำนวนระดับของการเรียกซ้ำของอัลกอริทึม ตัวอย่างของค่าทั้งสองนี้สามารถดูได้ที่หน้า crypt() เมื่อละเว้น ระบบจะใช้ค่าเกลือแบบสุ่มและต้นทุนเริ่มต้น

ส่งกลับค่า

ฟังก์ชันนี้จะตรวจสอบว่าค่าแฮชที่ระบุใช้อัลกอริทึมและตัวเลือกที่ให้มาหรือไม่ ถ้าไม่เช่นนั้น จะต้องสร้างค่าแฮชใหม่

ตัวอย่าง

การใช้งานpassword_needs_rehash()

<?php $password = ' rasmuslerdorf ' ; $hash = ' $ 2y $10$YCFsG6elYca568hBi2pZ0.3LDL5wjgxct1N8w/oLR/jfHsiQwCqTS ' // พารามิเตอร์ต้นทุนสามารถแก้ไขได้เมื่อประสิทธิภาพของฮาร์ดแวร์ได้รับการปรับปรุง $options = array ( ' cost ' => 11 ) ; // ตรวจสอบแฮชที่เก็บไว้กับรหัสผ่านข้อความที่ชัดเจน ถ้า ( รหัสผ่าน_ยืนยัน ( $รหัสผ่าน , $แฮช ) ) - // ตรวจสอบว่ามีอัลกอริธึมแฮชที่ใหม่กว่าหรือไม่ // หรือการเปลี่ยนแปลงต้นทุน ถ้า ( password_needs_rehash ( $hash , PASSWORD_DEFAULT , $options ) ) - // หากเป็นเช่นนั้น ให้สร้างแฮชใหม่แทนที่อันเก่า $newHash = password_hash ( $password , PASSWORD_DEFAULT , $ options ) ; // ให้ผู้ใช้เข้าสู่ระบบได้ - -