مقدمة

يشكّل محرك القوالب «تويغ» (Twig) أحد أعمدة منظومة التطوير في عالم PHP المعاصر، حيث يوفّر طبقةَ عرضٍ مرنة وآمنة وقوية، تفصل المنطق البرمجي عن واجهة المستخدم، وتُيسّر على المطوّر إنجاز التطبيقات بسرعة مع الحفاظ على نظافة الشيفرة وقابليتها للتوسّع.

سنخوض في هذا المقال الموسّع رحلةً شاملة تبدأ بمفاهيم التهيئة السريعة لـ Twig وتصل إلى أعماق آلياته الداخلية، مرورًا بأفضل الممارسات، واستراتيجيات الأداء والحماية، وأمثلة تفصيلية تبرز قدرته على تلبية حاجات المشاريع الصغيرة والمؤسساتية على حدّ سواء. يمثّل هذا الدليل حصيلة أحدث التوصيات الهندسية حتى مايو 2025، ويستند إلى التوثيق الرسمي ومجتمع Symfony وخبرات ميدانية متراكمة.

1 | لماذا Twig؟ الأسس الفلسفية وخريطة الميزات

1.1  فصل الاهتمامات (Separation of Concerns)

يرتكز تصميم Twig على مبدأ فصل طبقة العرض (View) عن منطق التطبيق، ما يُفضي إلى:

• قابلية صيانة أعلى: يستطيع فريق التصميم تعديل القوالب دون خشية تعطل الوظائف الخلفية.

• إعادة استخدام المكوّنات بسهولة: أجزاء الواجهة تُحوّل إلى وحدات مستقلة يمكن استدعاؤها في صفحات متعددة.

• أمان مُدمج: يمنع Twig تمرير أوامر PHP مباشرةً داخل القوالب، ويطبّق الهروب التلقائي (auto‑escaping) لإحباط هجمات XSS.

1.2  بنية نحوية شبيهة بكتابة البشر

يعتمد Twig ثلاثة أنواع من المحددات:

تمنح هذه الصيغة انسيابية قراءة قريبة من لغة Markdown وتُبعد التشويش الناتج عن وسوم PHP المضمنة في ملفات HTML التقليدية.

1.3  نظام توريث القوالب (Template Inheritance)

يمكن بناء قالب رئيسي يحتوي على الهيكل العام (رأس الصفحة، شريط التنقّل، تذييل)، ثم يُنشئ المطوّر قوالب فرعية تورِّث هذا الهيكل وتملأ كتلًا محدَّدة (blocks) بالمحتوى الفريد لكل صفحة؛ ما يختصر الوقت ويضمن اتساق الهوية البصرية.

1.4  الامتدادات (Extensions) والمرشِّحات (Filters)

يوفّر Twig مكتبة واسعة من المرشِّحات مثل |upper, |date, |length، كما يتيح إنشاء مرشّحات ودوال مخصّصة لتلبية متطلبات الأعمال، مثل تنسيق أرقام الفواتير أو تحويل العملات.

2 | خطوات الانطلاقة السريعة

2.1  التثبيت عبر Composer

bash
CopyEdit
composer require twig/twig:^3.8

تُعدُّ السلسلة 3.x الأحدث حتى تاريخ كتابة هذا الدليل، وتُقدِّم تحسينات على الأداء عبر محرّك PhpToken وإلغاء أوامر منزوعة الصلاحية.

2.2  تهيئة بيئة العمل الأساسية في خمس دقائق

php
CopyEdit
use Twig\Environment;
use Twig\Loader\FilesystemLoader;

$loader = new FilesystemLoader(__DIR__.'/templates');
$twig   = new Environment($loader, [
    'cache' => __DIR__.'/var/cache/twig',
    'debug' => true,          // إيقاف في الإنتاج
    'auto_reload' => true,    // يعيد تجميع القوالب عند التعديل
]);

echo $twig->render('home.html.twig', [
    'title' => 'مرحبًا بكم',
    'posts' => $repository->latest(10),
]);

• FilesystemLoader يخبر Twig بمكان القوالب.

• مجلد cache يُخزّن الملفات المحوَّلة إلى PHP لتحسين السرعة.

• الخيار auto_reload يُجنِّبك مسح ذاكرة التخزين يدويًّا أثناء التطوير.

2.3  إنشاء أول قالب

twig
CopyEdit
{# templates/base.html.twig #}


  
    
    
    
  
  
    
{% include 'partials/navbar.html.twig' %}

    

      {% block body %}{% endblock %}
    

    
  

ثم:

twig
CopyEdit
{# templates/home.html.twig #}
{% extends 'base.html.twig' %}

{% block title %}{{ title }}{% endblock %}

{% block body %}
  
{{ title }}
  

    {% for post in posts %}
      

        
          {{ post.title|e }}
        
      
    {% else %}
      
لا توجد مقالات بعد.
    {% endfor %}
  
{% endblock %}

3 | جدول مقارنة بين Twig و PHP «المضمن» (Inline PHP)

4 | التعمق في المحرك: دورة الحياة من القالب إلى الإخراج

1. التحميل (Loading): يستدعي FilesystemLoader القالب من القرص.

2. التحويل إلى نص PHP: يحوّل Twig العلامات إلى أوامر PHP مكافئة، مع تضمين عمليات الهروب.

3. التجميع (Compilation): يُخزن ملف PHP الناتج في مجلد «cache».

4. التنفيذ (Execution): عند الاستدعاء اللاحق، يُشغّل الملف المخبّأ مباشرة دون تمرير بطيء على محلل Twig، مما يزيد الأداء.

تشير اختبارات Symfony Profiler إلى أن تفعيل ذاكرة التخزين يقلّل زمن التجاوب بنسبة قد تصل إلى 60 ٪ في الصفحات ذات القوالب الثقيلة.

5 | أفضل الممارسات للإنتاج

5.1  تعطيل الوضع debug

أثناء الإطلاق إلى الخادم الحيّ، اضبط:

php
CopyEdit
$twig = new Environment($loader, [
    'cache' => '/path/to/cache',
    'debug' => false,
    'auto_reload' => false,
    'strict_variables' => true, // يكشف المتغيّرات غير المعرفة
]);

5.2  استخدام وظائف التوطين

يتيح الامتداد الرسمي twig/intl-extra تنسيق التواريخ والأرقام تبعًا للغة المستخدم:

twig
CopyEdit
{{ price|format_currency('USD', locale='ar_EG') }}
{{ date|format_date(locale='ar_SA', pattern='d MMMM y') }}

5.3  تقسيم القوالب إلى مكوّنات صغيرة (Components)

• استخرج عناصر متكررة (بطاقة مقال، رسالة خطأ) إلى ملفات داخل مجلد components/.

• استخدم include مع تمرير المتغيرات ذات الصلة فقط لتقليل الاقتران.

5.4  تسريع الترجمة عبر opcache

احرص على تفعيل Zend Opcache في PHP php.ini لتخزين بايت كود القوالب المجمَّعة.

6 | نصائح SEO متقدمة مع Twig

1. عناوين ديناميكية: خصّص وسم