password_hash() وpassword_verify() في PHP: حفظ كلمات المرور

خزّن كلمات المرور بـ password_hash($password, PASSWORD_DEFAULT) وافحص تسجيل الدخول بـ password_verify($password, $hash)، التي تعيد true أو false. لا تخزّن كلمة المرور نفسها أبدًا، ولا تستخدم md5() أو sha1() لها أبدًا.

<?php
$hash = password_hash('correct horse battery staple', PASSWORD_DEFAULT);
echo $hash, "\n";

var_dump(password_verify('correct horse battery staple', $hash));
var_dump(password_verify('Correct horse battery staple', $hash));

شغّله مرتين: التجزئة مختلفة في كل مرة، والنسختان تجتازان الفحص. وينطبق الأمر نفسه على كل تجزئة في هذه الصفحة، فلن تطابق مخرجاتك مخرجات أي شخص آخر.

تسجيل الدخول بـ password_verify

يفحص تسجيل الدخول كلمة المرور المرسلة مقابل التجزئة المحفوظة عند إنشاء الحساب. «تسجّل» هذه الكتلة مستخدمًا واحدًا ثم تعرض نموذج تسجيل دخول؛ جرّب كلمة المرور الصحيحة (hunter2)، ثم كلمة خاطئة.

<?php
// The users table: one row, hashed when the account was created
$users = ['ada@example.com' => password_hash('hunter2', PASSWORD_DEFAULT)];

$email = trim((string) ($_POST['email'] ?? 'ada@example.com'));
$message = '';

if (($_SERVER['REQUEST_METHOD'] ?? 'GET') === 'POST') {
    $hash = $users[$email] ?? null;
    if ($hash !== null && password_verify((string) ($_POST['password'] ?? ''), $hash)) {
        $message = 'Welcome back, ' . htmlspecialchars($email) . '.';
    } else {
        $message = 'Wrong email or password.';
    }
}
?>
<form method="post">
  <input name="email" value="<?= htmlspecialchars($email) ?>">
  <input name="password" type="password" placeholder="Password">
  <button>Log in</button>
</form>
<p><?= $message ?></p>

رسالة الخطأ واحدة للبريد غير المعروف ولكلمة المرور الخاطئة. فالقول أيهما كان خاطئًا يخبر المهاجم بأي عناوين البريد لها حسابات. وبعد تسجيل دخول ناجح، يخزّن الموقع الحقيقي معرّف المستخدم في الجلسة، كما تبيّن صفحة الجلسات.

ما الذي داخل التجزئة

تجزئة bcrypt نص واحد يحمل كل ما تحتاجه password_verify(): الخوارزمية، والتكلفة، والملح، ثم التجزئة نفسها. وتقرأ password_get_info() الأجزاء الأولى.

<?php
$hash = password_hash('secret', PASSWORD_DEFAULT);
echo $hash, "\n";
echo strlen($hash), " characters\n\n";

[, $algo, $cost, $rest] = explode('$', $hash);
echo "algorithm: $algo (bcrypt)\n";
echo "cost:      $cost\n";
echo 'salt:      ', substr($rest, 0, 22), "\n";
echo 'hash:      ', substr($rest, 22), "\n\n";

print_r(password_get_info($hash));

لأن الملح مخزّن في التجزئة، لا تحتاج إلا إلى عمود واحد في قاعدة البيانات، ويحصل مستخدمان لهما كلمة المرور نفسها على تجزئتين مختلفتين. اجعل ذلك العمود VARCHAR(255): طول bcrypt هو 60 محرفًا، لكن يُسمح لـ PASSWORD_DEFAULT بالتغير إلى خوارزمية مخرجاتها أطول.

اختيار التكلفة

التكلفة هي مدى بطء كل تجزئة عمدًا، وكل خطوة إلى الأعلى تضاعف العمل. تستخدم PHP 8.3 التكلفة 10 لـ bcrypt (ورفعت PHP 8.4 القيمة الافتراضية إلى 12). يجب أن يستغرق تسجيل الدخول نحو 100 إلى 300 ميلي ثانية من التجزئة؛ قِس ذلك على خادمك:

<?php
foreach ([10, 11, 12] as $cost) {
    $start = hrtime(true);
    password_hash('secret', PASSWORD_BCRYPT, ['cost' => $cost]);
    printf("cost %d: %.0f ms\n", $cost, (hrtime(true) - $start) / 1e6);
}

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

ترقية التجزئات القديمة بـ password_needs_rehash

عندما ترفع التكلفة أو تغيّر PHP قيمة PASSWORD_DEFAULT، تظل التجزئات الموجودة تعمل، وتخبرك password_needs_rehash() بأيها قديم. واللحظة الوحيدة التي تملك فيها كلمة المرور العادية هي تسجيل الدخول، لذا فهناك تجري الترقية:

<?php
$options = ['cost' => 12];

// A hash created years ago with cost 10
$stored = password_hash('hunter2', PASSWORD_DEFAULT, ['cost' => 10]);
echo 'stored: ', substr($stored, 0, 7), "...\n";

$input = 'hunter2';
if (password_verify($input, $stored)) {
    if (password_needs_rehash($stored, PASSWORD_DEFAULT, $options)) {
        $stored = password_hash($input, PASSWORD_DEFAULT, $options);
        echo "Rehashed and saved: ", substr($stored, 0, 7), "...\n";
    }
    echo "Logged in.\n";
}

var_dump(password_needs_rehash($stored, PASSWORD_DEFAULT, $options));

تصبح البادئة $2y$10$ على شكل $2y$12$، وفي تسجيل الدخول التالي تعيد password_needs_rehash() القيمة false.

لا تستخدم md5 أو sha1 لكلمات المرور أبدًا

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

<?php
echo md5('password'), "\n";       // the same on every server, forever

$start = hrtime(true);
for ($i = 0; $i < 100000; $i++) {
    md5("password$i");
}
printf("100,000 md5 hashes: %.0f ms\n", (hrtime(true) - $start) / 1e6);

$start = hrtime(true);
password_hash('password', PASSWORD_DEFAULT);
printf("1 password_hash:    %.0f ms\n", (hrtime(true) - $start) / 1e6);

في الوقت الذي تصنع فيه password_hash() تجزئة واحدة، تصنع md5 مئات الآلاف، فيصبح كل تخمين يجريه الكاسر أرخص بذلك القدر. ابحث عن 5f4dcc3b5aa765d61d8327deb882cf99 وستجد كلمة "password" فورًا.

إذا ورثت جدولًا من تجزئات md5، فلا تستطيع تحويلها مباشرة. غلّفها بدلًا من ذلك: خزّن password_hash($oldMd5) وتحقق بـ password_verify(md5($input), $stored)، ثم استبدل كلًّا منها بتجزئة عادية حين يسجل ذلك المستخدم دخوله في المرة التالية.

Argon2id وحد 72 بايتًا

يستخدم PASSWORD_ARGON2ID ذاكرة أكثر لكل تجزئة، وهذا يجعل الكسر بوحدات GPU أغلى بكثير. وهو متاح حين تُبنى PHP مع libargon2 (ومعظم حزم Linux كذلك)؛ تحقق بـ defined('PASSWORD_ARGON2ID').

<?php
if (defined('PASSWORD_ARGON2ID')) {
    $hash = password_hash('secret', PASSWORD_ARGON2ID);
    echo $hash, "\n";
    var_dump(password_verify('secret', $hash));
}

// bcrypt only looks at the first 72 bytes of the password
$a = str_repeat('a', 72) . 'X';
$b = str_repeat('a', 72) . 'Y';
var_dump(password_verify($b, password_hash($a, PASSWORD_BCRYPT)));

يطبع السطر الأخير bool(true): كلمتا مرور مختلفتان تتطابقان لأن bcrypt يتجاهل كل ما بعد البايت 72. ونادرًا ما تبلغ كلمات المرور الحقيقية ذلك، لكن العبارات السرية باليابانية أو بخطوط متعددة البايتات أخرى تبلغ 72 بايتًا عند نحو 24 محرفًا. وإذا سمحت بكلمات مرور طويلة جدًا، فاستخدم Argon2id، الذي ليس له مثل هذا الحد. وتعمل password_verify() مع أي من الخوارزميتين، فيمكنك التبديل بـ password_needs_rehash() كما في الأعلى.