شرح صفوف ومحتوى الفقرة
قبل أن يرسل المتصفح طلباً عابراً للنطاقات يحتوي على جسم 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";