في هذا الدرس 6تصفّح المواضيع
في الدرس السابق بنينا نقطة الدخول الأمامية (Front Controller) وموجه المسارات، لكن وضع استعلامات PDO وقواعد التحقق ووسوم HTML داخل دالة واحدة يحول المشروع سريعاً إلى كود متشابك يصعب صيانته. تحل معمارية MVC (Model-View-Controller) هذه المشكلة عبر تقسيم المسؤوليات إلى ثلاث طبقات متخصصة:
- النموذج (Model): يغلف استعلامات قاعدة البيانات (PDO) وقواعد العمل؛ ولا يقرأ
$_POSTمباشرة ولا يطبع أي HTML. - العرض (View): يرسم قوالب HTML الآمنة والمهرّبة من البيانات الممررة إليه؛ ولا ينفذ أي استعلامات SQL.
- المتحكم (Controller): يستقبل الطلب من الموجه، ويتحقق من المدخلات، ويستدعي النموذج، ثم يختار قالب العرض أو رمز الحالة المناسب.
يوضح هذا المثال كائن نقل بيانات غير قابل للتعديل (readonly class) ينقل البيانات الموثقة بأمان بين الطبقات الثلاث:
<?php
readonly class CourseViewModel {
public function __construct(
public int $id,
public string $title,
public int $lessonsCount,
) {}
}
$vm = new CourseViewModel(7, 'Modern PHP 8.4', 102);
echo "ViewModel Ready: #{$vm->id} {$vm->title} ({$vm->lessonsCount} lessons)\n";
يستقبل صنف النموذج (أو المستودع Repository) كائن الاتصال PDO عبر حقن الاعتمادية في الباني (Constructor Dependency Injection) بالشكل __construct(private readonly PDO $pdo) بدلاً من الاعتماد على المتغيرات العامة أو فتح اتصالات مكررة.
- تمثل كل دالة عامة داخل النموذج عملية واضحة في منطق التطبيق مثل
findById(int $id)أوlistPublished()أوcreate(string $title). - تستخدم جميع استعلامات النموذج الاستعلامات المحضرة (
$this->pdo->prepare(...)) وتعيد مصفوفات ترابطية أو كائنات محددة النوع. - يسمح حقن كائن
PDOفي الباني بتمرير قاعدة بياناتsqlite::memory:سريعة في الذاكرة أثناء الاختبارات الآلية.
يغلف الصنف CourseModel التالي استعلامات PDO المحضرة خلف دوال نظيفة قابلة لإعادة الاستخدام:
<?php
final class CourseModel {
public function __construct(private readonly PDO $pdo) {}
public function findById(int $id): ?array {
$stmt = $this->pdo->prepare('SELECT id, title, level FROM courses WHERE id = :id');
$stmt->execute(['id' => $id]);
return $stmt->fetch(PDO::FETCH_ASSOC) ?: null;
}
}
$pdo = new PDO('sqlite::memory:');
$pdo->exec("CREATE TABLE courses (id INT, title TEXT, level TEXT); INSERT INTO courses VALUES (1, 'PHP MVC', 'Advanced')");
print_r((new CourseModel($pdo))->findById(1));
يحوّل قالب العرض (View) مصفوفة البيانات القادمة من المتحكم إلى كود HTML آمن. وفي لغة PHP القياسية، نعزل متغيرات القالب داخل دالة عرض مخصصة ونلتقط المخرجات باستخدام تخزين المخرجات المؤقت (Output Buffering) عبر ob_start() وob_get_clean().
- وفّر دائماً دالة مساعدة مختصرة لتهريب النصوص (مثل
e(string $val)التي تغلفhtmlspecialchars()) ليصبح تأمين المتغيرات داخل القوالب سهلاً ومباشراً. - استخدم
extract($data, EXTR_SKIP)داخل النطاق المحلي لدالة العرض لتحويل مفاتيح المصفوفة إلى متغيرات محلية مع منع الكتابة فوق أي متغير موجود بفضل العلمEXTR_SKIP. - يسمح التقاط الناتج كنص عبر
ob_get_clean()بحقنه لاحقاً داخل التخطيط العام أو إرجاعه في كائن الاستجابة.
يبني هذا المثال دالة عرض قوالب معزولة تستخرج المتغيرات بأمان وتهرب النصوص ضد ثغرات XSS:
<?php
function e(string $value): string {
return htmlspecialchars($value, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
}
function renderView(callable $template, array $data = []): string {
ob_start();
$template($data);
return (string) ob_get_clean();
}
$output = renderView(fn(array $d) => print('<div class="card"><h2>' . e($d['title']) . '</h2></div>'), ['title' => 'MVC <Views>']);
echo $output . "\n";
تتشابه جميع صفحات تطبيق الويب في الهيكل الخارجي العام: وسوم <head>، وملفات التنسيق، وشريط التنقل العلوي، والتذييل. وبدلاً من تكرار استدعاء الرأس والتذييل في كل ملف عرض، نلتقط مخرجات القالب الداخلي أولاً عبر ob_start() في متغير $content، ثم نحقنه داخل قالب التخطيط المشترك (Shared Layout).
- يركز القالب الداخلي فقط على محتوى الصفحة المحدد (مثل بطاقات الدورات أو جدول المهام).
- يغلف قالب التخطيط العام المتغير
$contentداخل وسم<main>...</main>ويهرب عنوان الصفحة$pageTitleداخل وسم<title>. - أي تعديل على القائمة العلوية أو زر المظهر الليلي في ملف التخطيط ينعكس فوراً على جميع شاشات التطبيق.
يدمج هذا المثال محتوى الصفحة الفرعية داخل هيكل التخطيط الرئيسي للتطبيق:
<?php
function renderLayout(string $pageTitle, string $content): string {
$safeTitle = htmlspecialchars($pageTitle, ENT_QUOTES, 'UTF-8');
ob_start();
echo "<!DOCTYPE html>\n<html lang=\"en\"><head><title>{$safeTitle} | CloseTag</title></head>\n";
echo "<body><header>Nav</header><main>{$content}</main><footer>Footer</footer></body></html>";
return (string) ob_get_clean();
}
$innerHtml = '<section><h1>Courses Catalog</h1></section>';
echo renderLayout('All Courses', $innerHtml) . "\n";
لربط موجه المسارات (Router) بأصناف المتحكمات في معمارية MVC، نربط كل مسار (مثل 'GET /courses/show') بمصفوفة ثنائية تضم اسم الصنف واسم الدالة [CourseController::class, 'show'].
- يوفر استخدام الثابت
::classدعماً كاملاً للإكمال التلقائي وإعادة التسمية الآمنة في بيئات التطوير (IDEs). - ينشئ الموزع (Dispatcher) نسخة من المتحكم مع تمرير النموذج المطلوب له، ثم يستدعي دالة الإجراء المحددة.
- حافظ على بساطة دوال المتحكم (Thin Controllers): تحقق من المعاملات، واستدعِ النموذج، ثم أعد استجابة العرض.
يوجه هذا المثال المسار المطابق إلى دالة CourseController::index() ويطبع الاستجابة الناتجة:
<?php
final class CatalogController {
public function index(): array {
return ['status' => 200, 'body' => '<h1>Catalog Index via CatalogController::index()</h1>'];
}
}
$routes = ['GET /catalog' => [CatalogController::class, 'index']];
[$class, $method] = $routes['GET /catalog'];
$res = (new $class())->{$method}();
echo "HTTP {$res['status']}: {$res['body']}\n";
بجمع الطبقات الثلاث معاً نحصل على دورة حياة طلب واضحة وقابلة للاختبار: يتحقق المتحكم من المعرف الوارد، ويطلب السجل من نموذج PDO، ويعالج حالة غياب السجل بإرجاع صفحة 404 Not Found نظيفة، أو يمرر السجل الموجود إلى قالب العرض المهرّب.
- إذا أرسل المستخدم معرفاً سالباً أو غير رقمي، يرفضه المتحكم فوراً قبل استشارة قاعدة البيانات.
- إذا أعادت الدالة
$this->model->find($id)القيمةnull، يعيد المتحكم الحالة404بدلاً من تمرير قيمة فارغة تسبب أخطاء داخل ملف العرض. - عند وجود السجل، تهرب طبقة العرض جميع الحقول عبر
htmlspecialchars()وتعيد كود HTML النهائي.
يلخص الجدول التالي المسؤوليات الصارمة لكل طبقة من طبقات MVC في تطبيقات PHP 8:
| طبقة MVC | المسؤولية الأساسية | ما يُمنع وضعه داخل هذه الطبقة |
|---|---|---|
| النموذج (Model) | استعلامات PDO المحضرة وسلامة البيانات ومنطق المجال | طباعة وسوم HTML أو قراءة $_GET و$_POST مباشرة |
| العرض (View) | تهريب المتغيرات بـ htmlspecialchars() ورسم القوالب | تشغيل استعلامات SQL أو تعديل حالة قاعدة البيانات |
| المتحكم (Controller) | التحقق من المدخلات واستدعاء النموذج واختيار العرض وكود HTTP | كتابة استعلامات SQL خام أو كتل HTML ضخمة |
<?php
final class LessonController {
public function __construct(private readonly PDO $pdo) {}
public function show(int $id): array {
$stmt = $this->pdo->prepare('SELECT id, title FROM lessons WHERE id = :id');
$stmt->execute(['id' => $id]);
$lesson = $stmt->fetch(PDO::FETCH_ASSOC);
if (!$lesson) return ['status' => 404, 'html' => '<h1>404 Not Found</h1>'];
$safe = htmlspecialchars($lesson['title'], ENT_QUOTES, 'UTF-8');
return ['status' => 200, 'html' => "<article><h1>#{$lesson['id']} {$safe}</h1></article>"];
}
}
echo "MVC Controller Ready\n";
ملخص الدرس
حصاد الدرسمراجعة مركّزة لأهم المفاهيم والقواعد الهندسية التي أتقنتها في هذا الدرس قبل التطبيق العملي
ماذا تعلّمت في هذا الدرس؟
نظّمت في هذا الدرس تطبيق PHP 8 وفق معمارية MVC القياسية عبر فصل نماذج PDO، والمتحكمات الرشيقة، وقوالب العرض المعتمدة على تخزين المخرجات والقوالب المشتركة. في الدرس التالي سنبني نظام تسجيل المستخدمين فوق هذه المعمارية النظيفة.
سجّل الدخول لحفظ تقدمك
تابع إنجاز المواضيع والمصطلحات والمهام، وكمّل من آخر خطوة على أي جهاز.
المصطلحات4
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 01 Model-View-Controller (MVC) معمارية النموذج والعرض والمتحكم (MVC)
- نمط معماري يقسم التطبيق إلى ثلاث طبقات مترابطة: منطق البيانات (Model)، وواجهة المستخدم (View)، وتنسيق الطلبات (Controller).
- للمراجعة
- 02 Output Buffering (ob_start) تخزين المخرجات المؤقت (Output Buffering)
- آلية في PHP تلتقط النصوص المطبوعة داخل ذاكرة مؤقتة لإرجاع القوالب كنصوص وحقنها داخل التخطيط المشترك.
- للمراجعة
- 03 Constructor Dependency Injection حقن الاعتماديات عبر الباني
- تمرير الكائنات المطلوبة (مثل اتصال PDO أو كائن النموذج) إلى باني الصنف بدلاً من إنشائها داخلياً أو استخدام متغيرات عامة.
- للمراجعة
- 04 Shared Layout Template قالب التخطيط المشترك (Layout)
- الهيكل الخارجي الموحد لصفحات HTML الذي يضم الرأس وشريط التنقل والتذييل ويُحقن بداخله محتوى كل صفحة فرعية.
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
الاختصارات4
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 01 MVC نموذج - عرض - متحكم
- Model-View-Controller
- المعمارية البرمجية القياسية لفصل بيانات المجال عن قوالب العرض ومعالجة الطلبات.
- للمراجعة
- 02 DTO كائن نقل البيانات
- Data Transfer Object
- كائن غير قابل للتعديل ومحدد الأنواع يُستخدم لنقل البيانات المهيكلة بأمان بين طبقات MVC.
- للمراجعة
- 03 DI حقن الاعتماديات
- Dependency Injection
- تزويد الصنف باعتمادياته الخارجية (مثل اتصال PDO) عبر دالة الباني.
- للمراجعة
- 04 XSS البرمجة العابرة للمواقع
- Cross-Site Scripting
- ثغرة أمنية تمنعها طبقة العرض عبر تهريب جميع البيانات الديناميكية بدالة htmlspecialchars().
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
مهامك قبل الاختبار
خطوة صغيرة كل مرة. وإنجاز تقدر ترجع له.
-
اكتب صنفاً نهائياً ArticleModel يستقبل private readonly PDO $pdo في الباني وينفذ الدالة findById(int $id): ?array.
-
التقط مقطع HTML مهرّباً باستخدام ob_start() وob_get_clean() ثم احقن النص الناتج داخل قالب التخطيط الرئيسي.
تأشير المهمة إقرار منك بإتمامها، وليس تصحيحًا آليًا للكود. يُحفظ تقدمك في حسابك.
اختبر فهمك.
ووصلها للإتقان.
كل سؤال خطوة لقدّام. اختار، اكتب كود، وشوف نتيجتك فورًا.
أكمل المهام، واجمع كل الإجابات الصحيحة. أقل من 100%؟ راجع وأعد المحاولة.
الأسئلة متاحة للاطلاع. سجّل الدخول للتفاعل وحفظ تقدمك.
لمحة عن التحدي8 أسئلة تنتظرك +
في معمارية MVC، أي طبقة تتحمل حصرياً مسؤولية تنفيذ استعلامات SQL المحضرة عبر PDO؟
تغلف طبقة النموذج (Model) جميع استعلامات قاعدة البيانات ومنطق حفظ واسترجاع البيانات.
لماذا يجب أن يستقبل صنف النموذج كائن PDO عبر الباني __construct(private readonly PDO $pdo) بدلاً من استدعاء new PDO() داخل كل دالة؟
يسمح حقن الاعتمادية بإعادة استخدام اتصال واحد بقاعدة البيانات وتمرير قاعدة بيانات SQLite في الذاكرة أثناء الاختبارات.
استدعاء الدالة ob_start() قبل رسم قالب العرض ثم ob_get_clean() بعده يلتقط كود HTML المتولد كنص بدلاً من إرساله فوراً إلى المتصفح.
صواب؛ يلتقط تخزين المخرجات المؤقت النصوص المطبوعة في الذاكرة ويعيدها كسلسلة نصية عبر ob_get_clean().
عند استخدام الدالة extract($data, EXTR_SKIP) داخل دالة رسم القالب، ما الذي يحمينا منه العلم EXTR_SKIP؟
يمنع العلم EXTR_SKIP مفاتيح المصفوفة $data من الكتابة فوق المتغيرات المحلية الموجودة مسبقاً داخل دالة العرض.
ما ميزة ربط المسارات بالمصفوفة [CourseController::class, "show"] بدلاً من إنشاء كائنات من جميع المتحكمات مسبقاً داخل جدول التوجيه؟
يقوم PHP بإنشاء نسخة فقط من صنف المتحكم المطابق للطلب الحالي، مما يوفر الذاكرة ووقت التهيئة.
عندما تعيد الدالة CourseModel::findById($id) القيمة null لعدم وجود السجل، ماذا يجب أن يفعل المتحكم (Controller)؟
يجب أن يعيد المتحكم رمز الحالة 404 Not Found ويعرض قالب خطأ 404 بدلاً من تمرير قيمة فارغة لقالب العرض.
اختر جميع القواعد المعمارية الصحيحة عند تنظيم مشروع PHP 8 باستخدام نمط MVC:
تتولى النماذج استعلامات PDO، وتهرب العروض المخرجات بـ htmlspecialchars()، وتنسق المتحكمات الطلبات.
وضع ملفات أصناف MVC (في مجلد src/) وقوالب العرض (في مجلد views/) خارج مجلد النشر العام public/ يمنع الوصول المباشر إليها من المتصفح.
صواب؛ يجب أن يكون الملف public/index.php فقط متاحاً للوصول المباشر عبر الويب.