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

صلاحيات الأدوار RBAC ونشر تطبيقات PHP للإنتاجPHP Role-Based Access Control and Production Deployment طريقة تصميم الأدوار والصلاحيات RBAC، وتطبيق حراس الصلاحيات على المسارات، وعزل مجلد العرض العام public

طبّق نظام صلاحيات متعدد الأدوار RBAC في PHP 8 وانشر تطبيقك بأمان على خوادم الإنتاج مع عزل مجلد public وضبط إعدادات php.ini وفرض HTTPS.
أقسام الدرس
6
الأمثلة
6
اللغة
العربية
المشاهدات
37
محتوى الدرس
في هذا الدرس 6تصفّح المواضيع

تثبت المصادقة (Authentication) هوية المستخدم، بينما يحدد التحكم بالوصول المبني على الأدوار (RBAC) الصلاحيات المسموحة لهذا المستخدم داخل النظام. وفي PHP 8.1+ يتيح التعداد المدعوم بنص enum Role: string تمثيل أدوار مثل admin وeditor وuser بدقة وأمان.

  • تخزين الدور: يُحفظ دور المستخدم في عمود role داخل جدول users بقيمة افتراضية 'user' عند التسجيل.
  • خريطة الصلاحيات: يُربط كل دور بمجموعة صلاحيات دقيقة (مثل posts.edit وusers.manage) لفصل منطق التفويض عن قوالب العرض.
  • مبدأ أقل صلاحية: يبدأ كل حساب جديد بدور المستخدم العادي Role::User ولا يُمنح صلاحيات الإدارة إلا بترقية صريحة.

يعرّف المثال التالي تعداد Role المدعوم بنص ويربط كل دور بقائمة الصلاحيات المسموحة له.

مخطط صلاحيات الأدوار RBAC وعزل مجلد العرض العام public في تطبيقات PHP 8
PHP
<?php
declare(strict_types=1);

enum Role: string {
    case Admin = 'admin';
    case Editor = 'editor';
    case User = 'user';
}

$perms = [
    Role::Admin->value => ['users.manage', 'posts.edit', 'posts.view'],
    Role::Editor->value => ['posts.edit', 'posts.view'],
];

إن إخفاء زر "لوحة الإدارة" من واجهة HTML لا يُعد حماية أمنية على الإطلاق؛ إذ يستطيع أي مهاجم إرسال طلب HTTP مباشر إلى المسار /admin/users/delete. لذلك يجب استدعاء دالة حراسة على الخادم مثل requireRole(array $allowedRoles) في بداية كل متحكم محمي.

  • الفرق بين الرمزين 401 و403: نُرجع 401 Unauthorized (أو نحول المستخدم لصفحة الدخول) إذا لم يكن مسجلاً للدخول، ونُرجع 403 Forbidden إذا كان مسجلاً ولكنه لا يملك الدور المطلوب.
  • المقارنة الصارمة للأنواع: مرّر دائماً القيمة true كمعامل ثالث للدالة in_array($currentRole, $allowedRoles, true) لمنع التلاعب بالأنواع.
  • التحقق المباشر للعمليات الحساسة: عند تنفيذ عمليات خطيرة مثل حذف الحسابات، استعلم عن دور المستخدم الحالي من قاعدة البيانات مباشرة لضمان تطبيق سحب الصلاحيات فوراً.

تفحص دالة الحراسة التالية دور المستخدم في الجلسة وتوقف التنفيذ برمز 403 Forbidden عند عدم تطابق الصلاحية.

PHP
<?php
declare(strict_types=1);

function requireRole(array $allowedRoles): void
{
    $currentRole = $_SESSION['user_role'] ?? 'guest';
    if (!in_array($currentRole, $allowedRoles, true)) {
        http_response_code(403);
        exit('403 Forbidden: Insufficient role permissions.');
    }
}

requireRole(['admin', 'editor']);

في بيئة الإنتاج الحقيقية، يجب توجيه جذر المستندات DocumentRoot في خادم الويب ليشير حصرياً إلى المجلد الفرعي public/ وليس إلى المجلد الرئيسي للمشروع. يضمن هذا العزل الفيزيائي استحالة تحميل الملفات السرية عبر المتصفح.

  • داخل مجلد public/: نضع فقط نقطة الدخول الوحيدة public/index.php والملفات الثابتة مثل التنسيقات والصور.
  • خارج مجلد public/: نحتفظ بملف .env ومجلدات config/ وsrc/ وviews/ وstorage/ وvendor/ في المستوى الأعلى باستخدام dirname(__DIR__).
  • منع التنفيذ المباشر للملفات: نظراً لعدم وجود أي ملفات PHP أخرى داخل public/، لا يمكن للزائر تجاوز الموجه المركزي أو حراس الصلاحيات.

يعرّف الكود التالي الثابت BASE_PATH ليشير إلى المجلد الأب أعلى public/ ويحمّل ملفات Composer والإعدادات بأمان تام.

PHP
<?php
declare(strict_types=1);

// File: public/index.php (Only web-accessible PHP entry point)
define('BASE_PATH', dirname(__DIR__));

require BASE_PATH . '/vendor/autoload.php';
$config = require BASE_PATH . '/config/app.php';

echo 'App Root Isolated: ' . basename(BASE_PATH) . "\n";
echo 'Public Webroot:    ' . basename(__DIR__) . "\n";

تُفعّل بيئة التطوير عرض الأخطاء التفصيلية لتسريع البرمجة، لكن في خوادم الإنتاج يمنع منعاً باتاً إظهار رسائل الخطأ البرمجية أو إصدار PHP للزوار. لذلك يجب تحصين ملف php.ini وتفعيل ذاكرة OPcache لتسريع الأداء.

  • إخفاء الأخطاء عن الزوار: اضبط display_errors = Off وdisplay_startup_errors = Off لمنع تسريب مسارات الملفات واستعلامات قاعدة البيانات.
  • تفعيل التسجيل الداخلي للأخطاء: اضبط log_errors = On وحدد مسار ملف error_log خارج مجلد public/ لمراجعة الأعطال بأمان.
  • إخفاء بصمة الإصدار وتفعيل OPcache: اضبط expose_php = Off لإزالة الرأس X-Powered-By، وفعّل opcache.enable = 1 لحفظ الكود المترجم في الذاكرة.

يوقف الكود التالي عرض الأخطاء على الشاشة، ويفعّل تسجيلها في سجل الخادم الخاص، ويكتب رسالة تدقيق في السجل.

مخطط ضبط php.ini وقواعد توجيه Apache وNginx وقائمة النشر الآمن للإنتاج
PHP
<?php
declare(strict_types=1);

ini_set('display_errors', '0');
ini_set('display_startup_errors', '0');
ini_set('log_errors', '1');
error_reporting(E_ALL);

error_log('[PROD] Application bootstrap initialized cleanly.');
echo 'display_errors=' . ini_get('display_errors') . "\n";
echo 'log_errors=' . ini_get('log_errors') . "\n";

تتطلب الروابط النظيفة مثل /posts/42 أو /admin/roles ضبط قواعد إعادة التوجيه في خادم الويب لتمرير جميع الطلبات غير الموجودة كملفات ثابتة إلى public/index.php مع فرض الاتصال المشفر HTTPS.

  • في خادم Apache (ملف public/.htaccess): نستخدم التوجيه المباشر FallbackResource /index.php مع إضافة Options -Indexes لمنع استعراض محتويات المجلدات.
  • في خادم Nginx: نضبط root /var/www/app/public; وقاعدة try_files $uri $uri/ /index.php?$query_string; لتمرير المسارات إلى PHP-FPM.
  • فرض التحويل إلى HTTPS: نفحص المتغير $_SERVER['HTTPS'] أو رأس الخادم العكسي $_SERVER['HTTP_X_FORWARDED_PROTO'] ونصدر تحويلاً دائماً برمز 301.

يوضّح الكود التالي قواعد التوجيه القياسية لـ Apache وNginx مع فحص الاتصال المشفر والتحويل التلقائي إلى HTTPS.

PHP
<?php
declare(strict_types=1);

// Apache .htaccess: FallbackResource /index.php
// Nginx: try_files $uri $uri/ /index.php?$query_string;
$https = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off')
    || (($_SERVER['HTTP_X_FORWARDED_PROTO'] ?? '') === 'https');

if (!$https) {
    header('Location: https://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'], true, 301);
    exit;
}

تضمن قائمة فحص النشر القياسية إطلاق تحديثات تطبيق PHP إلى بيئة الإنتاج بدون توقف للخدمة أو أخطاء بشرية. وتشمل تثبيت الحزم الإنتاجية فقط، وتحسين التحميل التلقائي للأصناف، وضبط صلاحيات الملفات ورؤوس الأمان.

  • تحسين محمّل Composer: نفّذ الأمر composer install --no-dev --optimize-autoloader --classmap-authoritative لاستبعاد حزم الاختبار وبناء خريطة أصناف سريعة.
  • صلاحيات الملفات والمجلدات: اجعل ملفات الكود للقراءة فقط بالنسبة لعملية الويب (0644 للملفات و0755 للمجلدات) وامنه صلاحية الكتابة لمستخدم php-fpm على مجلدات storage/ وlogs/ فقط.
  • رأس HSTS وتحديث OPcache: أرسل رأس Strict-Transport-Security وأعد تحميل خدمة php-fpm بعد التحديث لتفريغ ذاكرة OPcache القديمة.

يرسل كود فحص الجاهزية التالي رأس الحماية HSTS ويتحقق من حالة OPcache وخريطة التحميل التلقائي.

طبقة النشرالإعداد أو الأمر القياسي في الإنتاجالأثر الأمني وتحسين الأداء
تفويض الصلاحيات (RBAC)تعداد Role مع دالة requireRole() ورمز 403منع تصعيد الصلاحيات والوصول غير المصرح به
جذر خادم الويبDocumentRoot /var/www/app/publicمنع تحميل ملف .env ومجلدات src/ وvendor/
إعدادات php.inidisplay_errors = Off وlog_errors = On وexpose_php = Offإخفاء تفاصيل الأخطاء وإصدار الخادم عن المهاجمين
الحزم وذاكرة OPcachecomposer install --no-dev -o مع تفعيل OPcacheحذف أدوات التطوير وتخزين الكود المترجم في الذاكرة
PHP
<?php
declare(strict_types=1);

header('Strict-Transport-Security: max-age=31536000; includeSubDomains');
$opcacheStatus = function_exists('opcache_get_status')
    ? 'Enabled'
    : 'Available in FPM';

$checks = ['autoload_optimized' => true, 'opcache' => $opcacheStatus];
echo json_encode($checks, JSON_UNESCAPED_SLASHES) . "\n";
خلاصة المعرفة ومحطة الانتقال

ملخص الدرس

حصاد الدرس

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

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

أتقنت في هذا الدرس تصميم صلاحيات الأدوار RBAC بالتعدادات المدعومة وحراسة المتحكمات برمز 403 Forbidden، وعزل مجلد public/ وضبط php.ini وقواعد توجيه Apache وNginx وقائمة النشر الآمن للإنتاج. في الخطوة التالية يمكنك الانطلاق لتطبيق هذه الأسس الهندسية في بناء مشاريعك المتقدمة وأطر العمل الحديثة.

مشاركة

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

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

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

المصطلحات4

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

0 / 4 مفهومةأول بطاقة، أول خطوة
01 Role-Based Access Control (RBAC) التحكم بالوصول المبني على الأدوار
نموذج تفويض يمنح الصلاحيات لأدوار محددة (مثل مدير أو محرر أو مستخدم) ويفحصها على الخادم قبل تنفيذ أي مسار.
للمراجعة
02 DocumentRoot Isolation عزل جذر المستندات العام
ضبط جذر خادم الويب ليشير حصرياً إلى مجلد public/ بحيث تبقى ملفات الكود والحزم وملف .env خارج نطاق الوصول عبر المتصفح.
للمراجعة
03 Front Controller Rewrite إعادة التوجيه لنقطة الدخول الموحدة
قواعد في خادم Apache أو Nginx تمرر جميع الروابط النظيفة إلى الملف public/index.php لضمان عمل الموجه وحراس الأمان.
للمراجعة
04 Autoloader Optimization تحسين التحميل التلقائي للأصناف
بناء خريطة مسبقة تربط كل صنف بمسار ملفه عبر Composer لتسريع تحميل الأصناف في الإنتاج دون البحث في القرص.
للمراجعة

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

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

الاختصارات4

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

0 / 4 مفهومةأول بطاقة، أول خطوة
01 RBAC RBAC
Role-Based Access Control
معمارية تفويض تقيّد العمليات المسموحة في النظام بناءً على الدور الممنوح للمستخدم المسجل.
للمراجعة
02 OPcache OPcache
Zend Opcode Cache
إضافة مدمجة في محرك PHP تحفظ الشفرة المترجمة مسبقاً في الذاكرة المشتركة لتسريع استجابة الخادم في الإنتاج.
للمراجعة
03 HSTS HSTS
HTTP Strict Transport Security
رأس استجابة يلزم المتصفحات بالتواصل مع النطاق حصرياً عبر اتصالات HTTPS المشفرة.
للمراجعة
04 FPM FPM
FastCGI Process Manager
مدير عمليات PHP القياسي في بيئات الإنتاج الذي يعمل مع Nginx أو Apache لمعالجة طلبات الويب بكفاءة.
للمراجعة

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

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

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

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

0/2مهام منجزة
  1. اكتب دالة requireRole(array $allowedRoles) تفحص $_SESSION["user_role"] عبر الدالة in_array(..., true) الصارمة وتنهي التنفيذ بالرمز http_response_code(403) عند عدم وجود صلاحية.

  2. أنشئ ملف تهيئة يضبط display_errors وdisplay_startup_errors على 0 ويفعّل log_errors ويسجل رسالة فحص عبر دالة error_log().

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

مساحة التحدي

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

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

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

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

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

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

ما الفرق الجوهري بين المصادقة (Authentication) والتفويض المبني على الأدوار (RBAC) في تطبيق ويب PHP؟

المصادقة تتحقق من هوية المستخدم، بينما يحدد التفويض (RBAC) الموارد والعمليات التي يملك المستخدم صلاحية الوصول إليها.

02

ما رمز حالة HTTP القياسي الذي يجب أن يُرجعه حارس الصلاحيات عندما يحاول مستخدم مسجل بدور "editor" الوصول إلى مسار مخصص لـ "admin" فقط؟

يرمز الكود 403 Forbidden إلى أن الخادم يعرف هوية المستخدم المسجل ولكنه يرفض السماح له بتنفيذ الطلب لنقص الصلاحيات.

03

يكفي إخفاء أزرار وروابط الإدارة من قوالب HTML لمنع المستخدمين غير المصرح لهم من استدعاء مسارات الإدارة على الخادم.

خطأ؛ لأن المهاجم يستطيع إرسال طلبات HTTP مباشرة لأي رابط، لذا يجب فرض فحص requireRole() داخل الخادم.

04

لماذا يجب ضبط جذر المستندات DocumentRoot في خادم الإنتاج ليشير إلى المجلد الفرعي public/ بدلاً من المجلد الرئيسي للمشروع؟

عزل مجلد public/ يمنع الزوار من طلب الملفات الحساسة مثل .env وconfig/ وsrc/ وvendor/ مباشرة عبر المتصفح.

05

ما الإعدادان الإلزاميان في ملف php.ini لمعالجة الأخطاء بأمان على خادم الإنتاج الحي؟

يجب في خادم الإنتاج إخفاء تفاصيل الأخطاء عن الزوار (display_errors = Off) مع تسجيلها في سجل الخادم الخاص (log_errors = On).

06

أي توجيه في خادم Nginx يمرر جميع المسارات غير الموجودة كملفات ثابتة إلى الموجه المركزي public/index.php؟

التوجيه try_files $uri $uri/ /index.php?$query_string; يخدم الملفات الثابتة إن وُجدت ويحول باقي المسارات إلى index.php.

07

أي أمر في Composer يثبّت حزم الإنتاج فقط ويولّد خريطة تحميل تلقائي محسّنة للأصناف؟

الأمر composer install --no-dev --optimize-autoloader يستبعد حزم التطوير ويبني خريطة الأصناف لتسريع الأداء في الإنتاج.

08

يمنع ضبط الإعداد expose_php = Off في ملف php.ini للإنتاج إظهار رقم إصدار PHP الدقيق في رأس الاستجابة X-Powered-By.

تعطيل expose_php يزيل الرأس X-Powered-By بحيث لا تكشف الاستجابة عن إصدار PHP للمفحصات الآلية.