انتقل إلى محتوى الدرس
ابدأ رحلتك
الدرس 13
دورة إطار العمل Laravel

إنشاء وعرض ملفات الواجهات في LaravelCreating and Rendering Laravel Views

إنشاء ملفات العرض داخل مجلد resources/views وتنظيم المجلدات الفرعية بالصيغة النقطية وإرجاعها من المتحكم وفق أحدث معايير إطار العمل Laravel 12 مع أمثلة وتطبيقات عملية متدرجة.
ابدأ التعلّم استكشف الأمثلة
أقسام الدرس
6
الأمثلة
6
اللغة
العربية
تاريخ النشر
غير محدد
المشاهدات
0
محتوى الدرس
في هذا الدرس 6تصفّح المواضيع

Laravel Views Role in MVC دور واجهات العرض في MVC

تمثل طبقة الواجهات في معمارية MVC الجزء المسؤول عن عرض صفحات HTML للمستخدم النهائي. يساعد فصل الكود المرئي داخل ملفات عرض مستقلة على إبقاء المتحكمات نظيفة ومركزة على معالجة الطلبات فقط.

  • فصل طبقة العرض (Presentation Separation): تعزل الواجهات وسوم HTML عن منطق التوجيه والمتحكمات البرمجية.
  • مجلد التخزين الافتراضي (Default Directory): تُحفظ جميع قوالب العرض داخل مجلد resources/views القياسي.
  • امتداد ملفات القوالب (Blade Extension): تنتهي الملفات بامتداد .blade.php ليتعرف عليها محرك القوالب.
مخطط معماري يوضح إنشاء وعرض ملفات الواجهات في Laravel في إطار العمل Laravel 12
PHP 
<!-- resources/views/welcome.blade.php -->
<!DOCTYPE html>
<html lang="en">
<body>
    <h1>Welcome to CloseTag Store</h1>
</body>
</html>

Creating Views in Resources Folder إنشاء ملفات الواجهات بأمر Artisan

يوفر إطار Laravel في إصداراته الحديثة أمر Artisan مخصصاً لتوليد ملفات الواجهات مباشرة من سطر الأوامر. يمكنك تمرير مسارات فرعية باستخدام النقطة أو الشرطة المائلة لتنظيم القوالب حسب أقسام المشروع.

  • التوليد عبر الأوامر (Artisan Generation): ينشئ أمر make:view ملف قالب جديد بالامتداد الصحيح فوراً.
  • إنشاء المجلدات تلقائياً (Auto Subfolders): يتولى الأمر بناء أي مجلدات فرعية غير موجودة داخل resources/views.
  • التنظيم حسب الميزات (Feature Grouping): يسهل تقسيم الواجهات في مجلدات مثل products صيانة المشاريع الكبيرة.
PHP 
# Generate top-level view
php artisan make:view home

# Generate nested view with dot syntax
php artisan make:view pages.contact

# Resulting file path:
# resources/views/pages/contact.blade.php

Rendering Views with View Helper إرجاع الواجهات عبر دالة view

يمكنك إرجاع أي واجهة عرض من داخل دوال المتحكم أو المسارات عبر الدالة المساعدة view أو الواجهة الساكنة View::make. كما يتيح المسار المختصر Route::view عرض الصفحات الثابتة مباشرة دون الحاجة لإنشاء متحكم.

  • الدالة المساعدة (view Helper): تُرجع الدالة كائن عرض متكامل يتحول تلقائياً إلى استجابة HTTP.
  • الواجهة الساكنة (View::make): تؤدي نفس الوظيفة تماماً عبر مصنع الواجهات في حاوي الخدمات.
  • مسارات العرض المباشر (Route::view): تختصر تسجيل الصفحات الثابتة التي لا تتطلب معالجة داخل متحكم.
PHP 
<?php
use Illuminate\Support\Facades\Route;
use Illuminate\Support\Facades\View;

Route::get('/home', fn () => view('home'));
Route::get('/terms', fn () => View::make('terms'));
Route::view('/about', 'pages.about');

Nested View Folders Dot Notation تنظيم مجلدات العرض بالصيغة النقطية

عند توزيع ملفات العرض داخل مجلدات فرعية، يعتمد Laravel الصيغة النقطية الأنيقة لاستدعاء القوالب بدلاً من الفواصل المائلة. فالملف المحفوظ في المسار resources/views/shop/cart/index.blade.php يُستدعى بالصيغة النقطية shop.cart.index.

  • الفصل بالنقاط (Dot Notation): تعبر كل نقطة عن الانتقال لمجلد فرعي داخل مجلد الواجهات.
  • حذف الامتداد (Omit Extension): يُمرر اسم الملف مجرداً دون كتابة اللاحقة .blade.php في الكود.
  • توافق أنظمة التشغيل (OS Agnostic): تضمن الصيغة النقطية عمل المسارات بكفاءة على أنظمة Windows وLinux.
PHP 
<?php
class DashboardController extends Controller
{
    public function index()
    {
        return view('admin.reports.overview');
    }
}

Checking View Existence Before Render التحقق من وجود ملف الواجهة

تحتاج التطبيقات الديناميكية أحياناً للتحقق من وجود ملف القالب على القرص قبل محاولة عرضه لتجنب إطلاق استثناء. توفر دالة View::exists فحصاً منطقياً سريعاً، بينما تختار دالة View::first أول قالب متاح من قائمة مرتبة.

  • فحص توفر القالب (View::exists): تُرجع قيمة منطقية تؤكد وجود ملف الواجهة قبل استدعائه.
  • أولوية العرض البديل (View::first): تبحث في مصفوفة أسماء وتعرض أول قالب موجود فعلياً.
  • دعم القوالب المخصصة (Safe Fallbacks): تمنحك آلية آمنة لتوفير واجهات مخصصة مع وجود قالب افتراضي مضمون.
PHP 
<?php
use Illuminate\Support\Facades\View;

if (View::exists('themes.Eid.banner')) {
    return view('themes.Eid.banner');
}
return View::first(['custom.home', 'default.home']);

View Creation and Rendering Reference مرجع دوال إنشاء وعرض الواجهات

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

وجه المقارنة الهندسيالأسلوب اليدوي أو غير المحميمعيار Laravel 12 الحديث
فصل كود HTMLطباعة نصوص HTML مباشرة داخل دوال المتحكمملفات قوالب مستقلة داخل مجلد resources/views
مسارات المجلدات الفرعيةكتابة فواصل المسارات اليدوية غير المتوافقة بين الأنظمةاستخدام الصيغة النقطية القياسية view('shop.item')
إنشاء ملفات القوالبإنشاء المجلدات يدوياً واحتمال الخطأ في امتداد الملفالتوليد الفوري عبر أمر php artisan make:view
التحقق والبدائلفحص المسارات المطلقة يدوياً عبر دوال الملفات التقليديةاستخدام دوال View::exists وView::first المدمجة
PHP 
<?php
use Illuminate\Support\Facades\Route;
use Illuminate\Support\Facades\View;

Route::view('/privacy', 'legal.privacy');
Route::get('/portal', function () {
    return View::first(['portal.v2', 'portal.v1']);
});
خلاصة المعرفة ومحطة الانتقال

ملخص الدرس

حصاد الدرس

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

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

أتقنت في هذا الدرس حول «إنشاء وعرض ملفات الواجهات في Laravel» مفاهيم دور واجهات العرض في MVC، وإنشاء ملفات الواجهات بأمر Artisan، وإرجاع الواجهات عبر دالة view وفق معايير Laravel 12 الحديثة.

الخطوة التالية والدرس القادم

انتقل الآن إلى الدرس التالي «تمرير البيانات ومشاركتها عبر واجهات العرض في Laravel» للبناء التراكمي على ما تعلمته.

المهام التدريبية اختبر فهمك الآن الدرس التالي: تمرير البيانات ومشاركتها عبر واجهات العرض في Laravel

مشاركة

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

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

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

المصطلحات4

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

0 / 4 مفهومةأول بطاقة، أول خطوة
01 Creating Views إنشاء الواجهات
إنشاء ملفات العرض داخل مجلد resources/views وتنظيم المجلدات الفرعية بالصيغة النقطية وإرجاعها من المتحكم وفق أحدث معايير إطار العمل Laravel 12 مع أمثلة وتطبيقات عملية متدرجة.
للمراجعة
02 Laravel Views Role in MVC دور واجهات العرض في MVC
المفهوم الهندسي والتطبيق العملي المباشر لقسم دور واجهات العرض في MVC في إطار العمل Laravel 12.
للمراجعة
03 Creating Views in Resources Folder إنشاء ملفات الواجهات بأمر Artisan
المفهوم الهندسي والتطبيق العملي المباشر لقسم إنشاء ملفات الواجهات بأمر Artisan في إطار العمل Laravel 12.
للمراجعة
04 Rendering Views with View Helper إرجاع الواجهات عبر دالة view
المفهوم الهندسي والتطبيق العملي المباشر لقسم إرجاع الواجهات عبر دالة view في إطار العمل Laravel 12.
للمراجعة

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

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

الاختصارات4

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

0 / 4 مفهومةأول بطاقة، أول خطوة
01 MVC MVC
Model View Controller
النمط المعماري الذي يفصل بين نماذج البيانات Models، وطبقات العرض Views، والمتحكمات Controllers في Laravel.
للمراجعة
02 CLI CLI
Command Line Interface
واجهة سطر الأوامر التي تعمل عبر أداة php artisan لتوليد الملفات وإدارة التطبيق.
للمراجعة
03 HTTP HTTP
Hypertext Transfer Protocol
بروتوكول نقل النص الفائق الذي ينظم طلبات المتصفح واستجابات خادم Laravel.
للمراجعة
04 PSR PSR
PHP Standards Recommendations
المعايير القياسية للغة PHP مثل التحميل التلقائي PSR-4 التي يلتزم بها إطار العمل Laravel.
للمراجعة

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

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

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

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

0/2مهام منجزة

  1. اكتب ونفّذ المثال البرمجي المشروح في قسم «دور واجهات العرض في MVC» داخل مشروع Laravel 12 المحلي وتحقق من النتيجة.

    مطلوبةتم الإنجاز ✓جارٍ الحفظ…
    الموضوع أو التطبيق المرتبط

  2. بدّل بين الحالات الثلاث في المحاكي التفاعلي ضمن قسم «إنشاء ملفات الواجهات بأمر Artisan» وقارن مخرجات التنفيذ.

    مطلوبةتم الإنجاز ✓جارٍ الحفظ…
    الموضوع أو التطبيق المرتبط

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

مساحة التحدي

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

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

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

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

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

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

ما الهدف الهندسي الأساسي من دور واجهات العرض في MVC في إطار العمل Laravel 12؟

يسهم دور واجهات العرض في MVC في تنظيم منطق التطبيق بأسلوب معياري آمن وقابل للصيانة في Laravel 12.

02

يساعد الالتزام باصطلاحات Laravel 12 الرسمية في قسم «إنشاء ملفات الواجهات بأمر Artisan» على رفع جودة الكود وسهولة اختباره آلياً.

صواب؛ الالتزام بالمعايير القياسية في Laravel 12 يجعل الكود واضحاً وسهل الفحص والصيانة.

03

أي آلية في Laravel 12 تتولى إدارة إرجاع الواجهات عبر دالة view بشكل مباشر ومنظم؟

توفر طبقة إطار العمل وحاوية الخدمات في Laravel 12 الأدوات القياسية لإدارة إرجاع الواجهات عبر دالة view.

04

لماذا يُعد تطبيق تنظيم مجلدات العرض بالصيغة النقطية مهماً عند بناء تطبيقات Laravel 12 جاهزة للإنتاج؟

لأنه يمنع الأخطاء البرمجية الخفية ويوحد سلوك التطبيق بين بيئتي التطوير والإنتاج.

05

في Laravel 12، يُنصح بكتابة مفاتيح الإنتاج السرية مباشرة داخل ملفات الكود المصدري المرفوعة إلى Git بدلاً من ملفات البيئة.

خطأ؛ يجب حفظ المفاتيح والبيانات السرية في متغيرات البيئة وعدم رفعها أبداً إلى مستودع Git.

06

ما المزايا الهندسية التي يحققها تطبيق التحقق من وجود ملف الواجهة في Laravel 12؟ (اختر كل ما ينطبق)

يوفر فصلاً واضحاً للمسؤوليات، وأماناً أعلى أثناء التنفيذ، وتعاوناً أسهل بين أفراد الفريق.

07

يوظف إطار العمل Laravel 12 ميزات PHP 8 الحديثة مثل تحديد أنواع القيم المرجعة لجعل الكود أكثر وضوحاً وأماناً.

صواب؛ يعتمد Laravel 12 بشكل كامل على الصياغة الحديثة للغة PHP 8.2+ وسلامة الأنواع.

08

ما الفرق الجوهري بين معيار Laravel 12 الحديث والملفات اليدوية التقليدية في مرجع دوال إنشاء وعرض الواجهات؟

يوفر Laravel 12 واجهات قياسية موحدة وحماية مدمجة تغني عن الكود اليدوي المعرض للأخطاء.