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

Reading Bearer Auth Headers قراءة رأس التفويض Bearer

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

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

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

يرسل العميل رمز الوصول داخل رأس HTTP القياسي Authorization: Bearer <token>. وباختلاف بيئة تشغيل PHP (سواء كانت Apache أو Nginx مع PHP-FPM)، قد يظهر هذا الرأس في مفاتيح مختلفة داخل المصفوفة $_SERVER.

  • افحص المفتاح $_SERVER['HTTP_AUTHORIZATION'] أولاً، ثم وفر بديلاً عبر $_SERVER['REDIRECT_HTTP_AUTHORIZATION'] الذي يضعه Apache عند تفعيل إعادة توجيه الروابط.
  • استخدم التعبير النمطي preg_match('/^Bearer\s+([A-Za-z0-9_\-\.]+)$/i', trim($header), $matches) لاستخراج الرمز بدقة ورفض الرؤوس المشوهة.
  • لا تقبل أبداً إرسال مفاتيح API داخل رابط الاستعلام (?api_key=...)، لأن الروابط تُسجّل كنص مكشوف في سجلات الخادم وتاريخ المتصفح.

تستخرج هذه الدالة رمز Bearer بأمان عبر بيئات Apache وNginx المختلفة:

مخطط توليد وتشفير رموز API بـ SHA-256 والتحقق منها عبر PDO
PHP
<?php
function getBearerToken(array $server): ?string {
    $header = $server['HTTP_AUTHORIZATION']
        ?? $server['REDIRECT_HTTP_AUTHORIZATION']
        ?? '';
    if (preg_match('/^Bearer\s+([A-Za-z0-9_\-\.]+)$/i', trim($header), $m) === 1) {
        return $m[1];
    }
    return null;
}
$token = getBearerToken(['HTTP_AUTHORIZATION' => 'Bearer ct_live_9988776655']);
echo 'Extracted: ' . ($token ?? 'NONE') . "\n";