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

Understanding CORS in JSON APIs مفهوم مشاركة الموارد CORS

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

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

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

عندما يتصل تطبيق واجهة أمامية يعمل على النطاق https://app.example.com بواجهة JSON API مستضافة على https://api.example.com، يفرض المتصفح سياسة النطاق الواحد (Same-Origin Policy). وما لم يرسل خادم PHP رؤوس مشاركة الموارد عبر النطاقات (CORS) التي تصرح لهذا النطاق، سيمنع المتصفح كود JavaScript من قراءة الاستجابة.

  • لا ترسل أبداً الرأس المفتوح Access-Control-Allow-Origin: * في الواجهات المحمية؛ بل افحص $_SERVER['HTTP_ORIGIN'] مقابل قائمة بيضاء صريحة باستخدام in_array($origin, $allowed, true).
  • أرسل دائماً الرأس Vary: Origin عند اختيار النطاق ديناميكياً لمنع خوادم التخزين المؤقت (CDN) من خلط رؤوس النطاقات.
  • حدد طرق HTTP والرؤوس المسموحة صراحةً عبر Access-Control-Allow-Methods وAccess-Control-Allow-Headers.

تفحص هذه الدالة النطاق الطالب مقابل قائمة بيضاء صارمة وتضبط رؤوس CORS المناسبة:

مخطط مصادقة واجهات API برموز Bearer ورؤوس CORS في PHP
PHP
<?php
$origin = $_SERVER['HTTP_ORIGIN'] ?? 'https://app.closetag.com';
$allowed = ['https://app.closetag.com', 'https://admin.closetag.com'];
$headers = ['Vary: Origin'];
if (in_array($origin, $allowed, true)) {
    $headers[] = "Access-Control-Allow-Origin: {$origin}";
    $headers[] = 'Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS';
    $headers[] = 'Access-Control-Allow-Headers: Content-Type, Authorization';
}
echo implode("\n", $headers) . "\n";