انتقل إلى محتوى الدرس
الدرس 100
تاريخ النشر: تاريخ التحديث:
دورة PHP

إرسال البريد واستعادة كلمة المرور في PHPPHP Password Reset and Email Verification طريقة توليد رموز استعادة محددة الصلاحية، وإرسال رسائل البريد عبر SMTP، وفحص الرمز وتحديث كلمة المرور

ابنِ دورة كاملة لتفعيل البريد الإلكتروني واستعادة كلمة المرور في PHP 8 باستخدام الرموز المشفرة وتواريخ انتهاء الصلاحية وإرسال الرسائل عبر SMTP.
أقسام الدرس
6
الأمثلة
6
اللغة
العربية
المشاهدات
36
محتوى الدرس
في هذا الدرس 6تصفّح المواضيع

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

  • مسار تفعيل البريد الإلكتروني: يثبت ملكية المستخدم للبريد المسجل حديثاً عبر تحديث الحقل email_verified_at فور النقر على رابط التفعيل.
  • مسار استعادة كلمة المرور: يتيح للمستخدم الذي نسي كلمة مروره إثبات ملكيته للبريد عبر رمز قصير الأجل (غالباً من 15 إلى 30 دقيقة) لتعيين كلمة مرور جديدة.
  • ضمان الاستخدام لمرة واحدة: بمجرد استهلاك رمز التفعيل أو الاستعادة، يحذفه الخادم فوراً من قاعدة البيانات لمنع إعادة استخدام الرابط من سجل المتصفح أو البريد.

يوضّح المثال التالي استخدام تعبير match لتحديد مدة صلاحية الرمز بالدقائق بحسب نوع العملية المطلوبة.

مخطط دورة حياة رمز تفعيل البريد واستعادة كلمة المرور المشفر في PHP 8
PHP
<?php
declare(strict_types=1);

$action = $_GET['flow'] ?? 'verify_email';
$ttlMinutes = match ($action) {
    'verify_email' => 60,
    'password_reset' => 30,
    default => 15,
};

echo "Flow: {$action} | TTL: {$ttlMinutes} mins\n";

يجب أن تكون رموز الاستعادة عشوائية تماماً وغير قابلة للتخمين. لذلك نولّد الرمز الخام دائماً باستخدام مولد الأرقام العشوائية الآمن تشفيرياً random_bytes(32) ثم نحول الـ 32 بايتاً إلى نص ست عشري مكون من 64 حرفاً عبر دالة bin2hex().

  • عشوائية بقوة 256 بت: تستمد دالة random_bytes(32) العشوائية من نواة نظام التشغيل مباشرة، مما يجعل تخمين الرابط مستحيلاً عملياً.
  • التلبيد السريع بـ SHA-256: نظراً لأن الرمز العشوائي يمتلك 256 بت من الإنتروبيا العالية، فإن دالة hash('sha256', $rawToken) تعد مثالية لحفظ البصمة والبحث عنها بسرعة في الفهرس.
  • تاريخ انتهاء الصلاحية: نستخدم الكائن new DateTimeImmutable('+30 minutes') بصيغة Y-m-d H:i:s لحفظ وقت انتهاء الصلاحية بدقة.

يولّد الكود التالي الرمز الخام المخصص لرابط البريد، ويحسب بصمة SHA-256 الخاصة بقاعدة البيانات مع وقت الانتهاء بعد 30 دقيقة.

PHP
<?php
declare(strict_types=1);

$rawToken = bin2hex(random_bytes(32));
$tokenHash = hash('sha256', $rawToken);
$expiresAt = (new DateTimeImmutable('+30 minutes'))
    ->format('Y-m-d H:i:s');

echo "URL Token (64 hex): " . substr($rawToken, 0, 16) . "...\n";
echo "DB SHA-256 Hash:    " . substr($tokenHash, 0, 16) . "...\n";
echo "Expires At (UTC):   {$expiresAt}\n";

عند حفظ رمز استعادة كلمة المرور في جدول مستقل باسم password_resets، يجب أولاً حذف أي رموز سابقة غير مستخدمة تخص نفس المستخدم user_id. يضمن ذلك بقاء أحدث رابط بريد فقط صالحاً للعمل إذا طلب المستخدم استعادة كلمة المرور أكثر من مرة.

  • أعمدة جدول الاستعادة: يتكون جدول password_resets القياسي من المعرف id ومعرف المستخدم user_id وبصمة الرمز المفهرسة token_hash بحجم CHAR(64) وحقل الوقت expires_at.
  • إلغاء الطلبات القديمة: تنفيذ استعلام DELETE FROM password_resets WHERE user_id = :u قبل الإدراج يمنع تراكم الرموز القديمة.
  • الاستعلامات المحضرة بـ PDO: نمرر القيم :u و:h و:e عبر الاستعلامات المحضرة لضمان سلامة وأداء قاعدة البيانات.

تحذف الدالة التالية أي رموز استعادة سابقة للمستخدم ثم تدرج البصمة الجديدة token_hash وتاريخ انتهاء الصلاحية.

PHP
<?php
declare(strict_types=1);

function storeResetToken(PDO $pdo, int $uid, string $hash, string $exp): void
{
    $pdo->prepare('DELETE FROM password_resets WHERE user_id = :u')
        ->execute(['u' => $uid]);

    $sql = 'INSERT INTO password_resets (user_id, token_hash, expires_at)
            VALUES (:u, :h, :e)';
    $pdo->prepare($sql)->execute(['u' => $uid, 'h' => $hash, 'e' => $exp]);
}

بعد حفظ بصمة الرمز في قاعدة البيانات، يبني التطبيق رابط استعادة يعمل ببروتوكول HTTPS ويحتوي على الرمز الخام، ثم يرسله عبر خادم بريد SMTP موثق. ويضمن استخدام الدالة http_build_query() ترميز معاملات الرابط بطريقة قياسية سليمة.

  • نطاق أساسي ثابت وموثوق: ابنِ روابط الاستعادة دائماً بالاعتماد على متغير بيئة موثوق مثل APP_URL، ولا تعتمد أبداً على الرأس غير الموثوق $_SERVER['HTTP_HOST'].
  • الإرسال عبر SMTP الموثق: تستخدم تطبيقات PHP الإنتاجية مكتبات مثل PHPMailer أو Symfony Mailer عبر اتصال TLS على المنفذ 587 لضمان وصول الرسائل.
  • تنبيه مدة الصلاحية: وضّح داخل نص الرسالة أن الرابط صالح لمدة 30 دقيقة فقط وللاستخدام مرة واحدة.

ينشئ الكود التالي رابط استعادة آمناً باستخدام http_build_query() ويجهز رؤوس البريد القياسية بترميز UTF-8.

مخطط إرسال بريد الاستعادة عبر SMTP وتحديث كلمة المرور داخل معاملة PDO
PHP
<?php
declare(strict_types=1);

$query = http_build_query(['token' => $rawToken]);
$resetUrl = "https://app.example.com/reset-password.php?{$query}";

$subject = 'Reset Your Account Password';
$headers = [
    'From' => '[email protected]',
    'Content-Type' => 'text/plain; charset=UTF-8',
];
echo "Reset Link Ready: {$resetUrl}\n";

عندما يرسل المستخدم نموذج كلمة المرور الجديدة، يحسب الخادم بصمة الرمز القادم $_POST['token'] عبر الدالة hash('sha256', $token) ويبحث في جدول password_resets عن سجل مطابق بشرط أن يكون expires_at > CURRENT_TIMESTAMP.

  • تحديث ذري داخل معاملة: نفّذ تحديث كلمة المرور وحذف الرمز داخل معاملة PDO لضمان عدم بقاء الرمز فعالاً بعد تغيير كلمة المرور.
  • تشفير كلمة المرور الجديدة: استخدم دالة password_hash($newPassword, PASSWORD_ARGON2ID) لتشفير كلمة المرور الجديدة قبل حفظها في جدول users.
  • إنهاء الجلسات السابقة: بعد استعادة كلمة المرور بنجاح، ألغِ رموز تذكرني القديمة وجدّد معرف الجلسة الحالية.

يحسب المثال التالي بصمة الرمز المرسل، ويتحقق من وجود سجل صالح غير منتهي الصلاحية في password_resets، ثم يجهز التشفير الجديد لكلمة المرور.

PHP
<?php
declare(strict_types=1);

$hash = hash('sha256', (string) ($_POST['token'] ?? ''));
$stmt = $pdo->prepare(
    'SELECT user_id FROM password_resets
     WHERE token_hash = :h AND expires_at > CURRENT_TIMESTAMP LIMIT 1'
);
$stmt->execute(['h' => $hash]);
$row = $stmt->fetch(PDO::FETCH_ASSOC);
if ($row) {
    $newHash = password_hash($_POST['password'], PASSWORD_ARGON2ID);
}

من أهم قواعد الأمان في نماذج استعادة كلمة المرور منع كشف الحسابات المسجلة (User Enumeration). فإذا أظهر الموقع رسالة "البريد غير مسجل" للحسابات غير الموجودة ورسالة "تم إرسال الرابط" للحسابات المسجلة، فسيتمكن المهاجم من فحص آلاف الإيميلات لمعرفة المشتركين.

  • رسالة تأكيد موحدة دائماً: اعرض نفس الرسالة النصية في جميع الحالات: "If that email exists, a reset link has been sent." وبنفس رمز استجابة HTTP.
  • تقييد معدل الطلبات: طبّق تحديد عدد المحاولات (Rate Limiting) بحسب عنوان IP والبريد الإلكتروني لمنع إغراق بريد المستخدمين.
  • إرسال البريد في الخلفية: إرسال رسائل SMTP عبر طابور خلفي يوحد زمن الاستجابة ويمنع كشف الحسابات عبر فرق التوقيت.

يتحقق الكود التالي من صيغة البريد ويبحث في قاعدة البيانات بصمت، ثم يعرض رسالة تأكيد محايدة وموحدة في جميع الحالات.

خطوة الأمانالتنفيذ القياسي في PHP 8المخاطر التي تمنعها
توليد الرمز العشوائيbin2hex(random_bytes(32))توقع الرموز أو تخمينها بالقوة الغاشمة
التخزين في قاعدة البياناتhash('sha256', $rawToken) مع وقت انتهاءاختراق الحسابات عند تسرب نسخة قاعدة البيانات
بناء رابط الاستعادةمتغير APP_URL الثابت مع http_build_query()تسميم رأس المضيف (Host Header Poisoning)
رسالة استجابة النموذجرسالة تأكيد عامة وموحدة لجميع الإيميلاتكشف الحسابات المسجلة (User Enumeration)
PHP
<?php
declare(strict_types=1);

$email = filter_var($_POST['email'] ?? '', FILTER_VALIDATE_EMAIL);
if ($email !== false) {
    $stmt = $pdo->prepare('SELECT id FROM users WHERE email = :e');
    $stmt->execute(['e' => $email]);
    $user = $stmt->fetch(PDO::FETCH_ASSOC);
    // Queue reset email only when $user exists
}
$msg = 'If that email exists, a reset link has been sent.';
echo $msg;
خلاصة المعرفة ومحطة الانتقال

ملخص الدرس

حصاد الدرس

مراجعة مركّزة لأهم المفاهيم والقواعد الهندسية التي أتقنتها في هذا الدرس قبل التطبيق العملي

ماذا تعلّمت في هذا الدرس؟

بنينا في هذا الدرس دورة متكاملة لتفعيل البريد واستعادة كلمة المرور في PHP 8 باستخدام random_bytes(32) وتخزين بصمة SHA-256 وتحديد وقت انتهاء الصلاحية ومنع كشف الحسابات. في الخطوة التالية سنجمع هذه المهارات لبناء لوحة تحكم CRUD متكاملة ومحمية.

مشاركة

هل كان هذا الدرس مفيدًا؟

جارٍ تحميل الآراء…

ابنِ لغتك البرمجية

المصطلحات4

راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.

0 / 4 مفهومةأول بطاقة، أول خطوة
01 Password Reset Token رمز استعادة كلمة المرور
رمز عشوائي مشفر قصير الصلاحية يُستخدم لمرة واحدة ويُرسل إلى بريد المستخدم لتفويضه بتعيين كلمة مرور جديدة.
للمراجعة
02 Token Hashing (SHA-256) تلبيد الرمز بـ SHA-256
حساب بصمة ذات اتجاه واحد بخوارزمية SHA-256 للرمز الخام قبل حفظه في قاعدة البيانات لحماية الحسابات عند تسرب الجداول.
للمراجعة
03 User Enumeration كشف الحسابات المسجلة
ثغرة أمنية يكشف فيها التطبيق ما إذا كان البريد الإلكتروني مسجلاً أم لا عبر اختلاف رسائل الخطأ أو زمن الاستجابة.
للمراجعة
04 Host Header Poisoning تسميم رأس المضيف
هجوم يمرر فيه المهاجم رأس Host مزيفاً لخداع الخادم وتوليد رابط استعادة كلمة مرور يشير إلى نطاق يملكه المهاجم.
للمراجعة

اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.

حروف قليلة. معنى كامل.

الاختصارات4

راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.

0 / 4 مفهومةأول بطاقة، أول خطوة
01 CSPRNG CSPRNG
Cryptographically Secure Pseudo-Random Number Generator
مولد أرقام عشوائية آمن تشفيرياً يتم الوصول إليه عبر دالة random_bytes() لتوليد رموز غير قابلة للتوقع.
للمراجعة
02 SMTP SMTP
Simple Mail Transfer Protocol
البروتوكول القياسي المستخدم لإرسال رسائل البريد التفاعلية مثل روابط تفعيل الحساب واستعادة كلمة المرور.
للمراجعة
03 SHA-256 SHA-256
Secure Hash Algorithm 256-bit
دالة تلبيد تشفيرية بطول 256 بت تُستخدم لحفظ ومطابقة رموز الاستعادة العشوائية في قاعدة البيانات.
للمراجعة
04 TTL TTL
Time To Live
مدة الصلاحية الزمنية المحددة (مثل 30 دقيقة) التي يصبح بعدها رمز الاستعادة غير صالح للاستخدام.
للمراجعة

اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.

من الفهم للتطبيق

مهامك قبل الاختبار

خطوة صغيرة كل مرة. وإنجاز تقدر ترجع له.

0/2مهام منجزة
  1. اكتب سكريبت PHP يولّد رمزاً بطول 32 بايت عبر bin2hex(random_bytes(32)) ويحسب بصمته بدالة hash("sha256", $rawToken) مع طباعة وقت انتهاء الصلاحية بعد 30 دقيقة.

  2. أنشئ نقطة نهاية لطلب استعادة كلمة المرور تتحقق من البريد بدالة filter_var() وتبحث في جدول users عبر PDO وتُرجع نفس رسالة التأكيد الموحدة سواء وُجد البريد أم لا.

تأشير المهمة إقرار منك بإتمامها، وليس تصحيحًا آليًا للكود. يُحفظ تقدمك في حسابك.

مساحة التحدي

اختبر فهمك.
ووصلها للإتقان.

كل سؤال خطوة لقدّام. اختار، اكتب كود، وشوف نتيجتك فورًا.

8أسئلة 3أنواع تحديات 100%هدف الإتقان
تصحيح تلقائي. فرص بلا حدود.

أكمل المهام، واجمع كل الإجابات الصحيحة. أقل من 100%؟ راجع وأعد المحاولة.

الأسئلة متاحة للاطلاع. سجّل الدخول للتفاعل وحفظ تقدمك.

لمحة عن التحدي8 أسئلة تنتظرك
01

لماذا يجب تخزين بصمة الرمز hash("sha256", $rawToken) في جدول password_resets بدلاً من حفظ الرمز الخام كنص صريح؟

تخزين بصمة SHA-256 فقط يمنع أي مهاجم يحصل على نسخة مسربة من قاعدة البيانات من استخدام الرموز النشطة لاختراق الحسابات.

02

أي تعبير في PHP يولّد رمز استعادة عشوائياً آمناً تشفيرياً مكوناً من 64 حرفاً ست عشرياً؟

تولّد دالة random_bytes(32) اثنين وثلاثين بايتاً عشوائياً آمناً، وتحولها bin2hex() إلى 64 حرفاً ست عشرياً.

03

قبل إدراج رمز استعادة كلمة مرور جديد للمستخدم، يجب حذف أو إبطال أي رموز استعادة سابقة غير مستخدمة لنفس معرف المستخدم user_id.

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

04

لماذا يجب بناء روابط استعادة كلمة المرور باستخدام قيمة APP_URL الثابتة في الإعدادات بدلاً من $_SERVER["HTTP_HOST"]؟

الاعتماد على $_SERVER["HTTP_HOST"] يفتح ثغرة تسميم رأس المضيف، حيث يخدع المهاجم الخادم لإرسال رابط يشير إلى نطاق المهاجم.

05

ما الشرطان اللذان يجب تحققهما معاً في قاعدة البيانات عند التحقق من رمز استعادة كلمة المرور المرسل؟

يجب أن تتطابق بصمة SHA-256 للرمز المرسل مع الحقل token_hash، وأن يكون وقت الانتهاء expires_at أكبر من الوقت الحالي.

06

بعد استخدام رمز استعادة كلمة المرور بنجاح لتحديث كلمة المرور، يجب حذف سجل الرمز فوراً لمنع إعادة استخدامه.

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

07

ماذا يجب أن يعرض نموذج نسيت كلمة المرور عندما يُدخل الزائر بريداً إلكترونياً غير موجود في جدول users؟

إرجاع نفس الرسالة المحايدة الموحدة يمنع المهاجمين من اكتشاف العناوين المسجلة في النظام.

08

أي دالة مدمجة في PHP ترمّز عناصر المصفوفة الترابطية بأمان لتكوين جزء الاستعلام في رابط الاستعادة؟

تتولى دالة http_build_query() ترميز المفاتيح والقيم بشكل قياسي لبناء روابط آمنة.