في هذا الدرس 6تصفّح المواضيع
تثبت المصادقة (Authentication) هوية المستخدم، بينما يحدد التحكم بالوصول المبني على الأدوار (RBAC) الصلاحيات المسموحة لهذا المستخدم داخل النظام. وفي PHP 8.1+ يتيح التعداد المدعوم بنص enum Role: string تمثيل أدوار مثل admin وeditor وuser بدقة وأمان.
- تخزين الدور: يُحفظ دور المستخدم في عمود
roleداخل جدولusersبقيمة افتراضية'user'عند التسجيل. - خريطة الصلاحيات: يُربط كل دور بمجموعة صلاحيات دقيقة (مثل
posts.editوusers.manage) لفصل منطق التفويض عن قوالب العرض. - مبدأ أقل صلاحية: يبدأ كل حساب جديد بدور المستخدم العادي
Role::Userولا يُمنح صلاحيات الإدارة إلا بترقية صريحة.
يعرّف المثال التالي تعداد Role المدعوم بنص ويربط كل دور بقائمة الصلاحيات المسموحة له.
<?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
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
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
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
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.ini | display_errors = Off وlog_errors = On وexpose_php = Off | إخفاء تفاصيل الأخطاء وإصدار الخادم عن المهاجمين |
| الحزم وذاكرة OPcache | composer install --no-dev -o مع تفعيل OPcache | حذف أدوات التطوير وتخزين الكود المترجم في الذاكرة |
<?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
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 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
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 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 لمعالجة طلبات الويب بكفاءة.
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
مهامك قبل الاختبار
خطوة صغيرة كل مرة. وإنجاز تقدر ترجع له.
-
اكتب دالة requireRole(array $allowedRoles) تفحص $_SESSION["user_role"] عبر الدالة in_array(..., true) الصارمة وتنهي التنفيذ بالرمز http_response_code(403) عند عدم وجود صلاحية.
-
أنشئ ملف تهيئة يضبط display_errors وdisplay_startup_errors على 0 ويفعّل log_errors ويسجل رسالة فحص عبر دالة error_log().
تأشير المهمة إقرار منك بإتمامها، وليس تصحيحًا آليًا للكود. يُحفظ تقدمك في حسابك.
اختبر فهمك.
ووصلها للإتقان.
كل سؤال خطوة لقدّام. اختار، اكتب كود، وشوف نتيجتك فورًا.
أكمل المهام، واجمع كل الإجابات الصحيحة. أقل من 100%؟ راجع وأعد المحاولة.
الأسئلة متاحة للاطلاع. سجّل الدخول للتفاعل وحفظ تقدمك.
لمحة عن التحدي8 أسئلة تنتظرك +
ما الفرق الجوهري بين المصادقة (Authentication) والتفويض المبني على الأدوار (RBAC) في تطبيق ويب PHP؟
المصادقة تتحقق من هوية المستخدم، بينما يحدد التفويض (RBAC) الموارد والعمليات التي يملك المستخدم صلاحية الوصول إليها.
ما رمز حالة HTTP القياسي الذي يجب أن يُرجعه حارس الصلاحيات عندما يحاول مستخدم مسجل بدور "editor" الوصول إلى مسار مخصص لـ "admin" فقط؟
يرمز الكود 403 Forbidden إلى أن الخادم يعرف هوية المستخدم المسجل ولكنه يرفض السماح له بتنفيذ الطلب لنقص الصلاحيات.
يكفي إخفاء أزرار وروابط الإدارة من قوالب HTML لمنع المستخدمين غير المصرح لهم من استدعاء مسارات الإدارة على الخادم.
خطأ؛ لأن المهاجم يستطيع إرسال طلبات HTTP مباشرة لأي رابط، لذا يجب فرض فحص requireRole() داخل الخادم.
لماذا يجب ضبط جذر المستندات DocumentRoot في خادم الإنتاج ليشير إلى المجلد الفرعي public/ بدلاً من المجلد الرئيسي للمشروع؟
عزل مجلد public/ يمنع الزوار من طلب الملفات الحساسة مثل .env وconfig/ وsrc/ وvendor/ مباشرة عبر المتصفح.
ما الإعدادان الإلزاميان في ملف php.ini لمعالجة الأخطاء بأمان على خادم الإنتاج الحي؟
يجب في خادم الإنتاج إخفاء تفاصيل الأخطاء عن الزوار (display_errors = Off) مع تسجيلها في سجل الخادم الخاص (log_errors = On).
أي توجيه في خادم Nginx يمرر جميع المسارات غير الموجودة كملفات ثابتة إلى الموجه المركزي public/index.php؟
التوجيه try_files $uri $uri/ /index.php?$query_string; يخدم الملفات الثابتة إن وُجدت ويحول باقي المسارات إلى index.php.
أي أمر في Composer يثبّت حزم الإنتاج فقط ويولّد خريطة تحميل تلقائي محسّنة للأصناف؟
الأمر composer install --no-dev --optimize-autoloader يستبعد حزم التطوير ويبني خريطة الأصناف لتسريع الأداء في الإنتاج.
يمنع ضبط الإعداد expose_php = Off في ملف php.ini للإنتاج إظهار رقم إصدار PHP الدقيق في رأس الاستجابة X-Powered-By.
تعطيل expose_php يزيل الرأس X-Powered-By بحيث لا تكشف الاستجابة عن إصدار PHP للمفحصات الآلية.