انتقل إلى محتوى الدرس

Handling Preflight OPTIONS Requests معالجة طلبات OPTIONS الاستباقية

أمّن واجهات JSON البرمجية في PHP 8 باستخدام مصادقة رموز Bearer وتخزين مفاتيح API المشفرة بـ SHA-256 وضبط رؤوس CORS ومعالجة طلبات OPTIONS الاستباقية.
1 صفوف تعليمية
PHP
32 مشاهدة

شرح صفوف ومحتوى الفقرة

الصف 1 شرح توضيحي

قبل أن يرسل المتصفح طلباً عابراً للنطاقات يحتوي على جسم Content-Type: application/json أو رأس المصادقة Authorization: Bearer، فإنه يرسل تلقائياً طلب فحص استباقي (CORS Preflight) بطريقة OPTIONS للتأكد من موافقة الخادم.

  • لا يرسل المتصفح رأس Authorization أثناء طلب OPTIONS الاستباقي؛ لذلك إذا شغل سكربت PHP فحص المصادقة قبل فحص طريقة OPTIONS فستفشل جميع الطلبات الاستباقية بخطأ 401!
  • اعترض الشرط $_SERVER['REQUEST_METHOD'] === 'OPTIONS' في بداية نقطة دخول الـ API، وأرسل رؤوس CORS مع كود الحالة 204 No Content وأنهِ التنفيذ فوراً.
  • أضف الرأس Access-Control-Max-Age: 86400 ليحفظ المتصفح نتيجة الفحص الاستباقي لمدة 24 ساعة بدلاً من تكرار طلب OPTIONS قبل كل استدعاء.

يوضح هذا المثال كيفية معالجة طلب OPTIONS الاستباقي فوراً قبل تشغيل أي استعلامات قاعدة بيانات:

PHP
<?php
function handleCorsPreflight(string $method, string $origin): array {
    $allowed = ['https://app.closetag.com'];
    if (!in_array($origin, $allowed, true)) return ['status' => 403, 'headers' => []];
    $headers = ["Access-Control-Allow-Origin: {$origin}", 'Access-Control-Max-Age: 86400'];
    if ($method === 'OPTIONS') return ['status' => 204, 'headers' => $headers];
    return ['status' => 200, 'headers' => $headers];
}
$res = handleCorsPreflight('OPTIONS', 'https://app.closetag.com');
echo "Status: {$res['status']} (" . count($res['headers']) . " CORS headers)\n";