مقدمة

يُعَدُّ محرك القوالب Twig أحد أقوى المحركات المخصَّصة لفصل منطق التطبيق عن طبقة العرض في بيئات PHP، وقد برز مع إطار العمل Symfony ثم انتشر لاحقًا في أنظمة إدارة المحتوى مثل Drupal و Craft CMS و Shopware وغيرها. يوفِّر Twig تركيبة نحوية بسيطة شبيهة بتركيبة Jinja و Django Template Language، مع مجموعة غنية من الدوال والمرشِّحات والبُنى التحكّمية التي تتيح للمطوِّر إنشاء صفحات HTML نظيفة، آمنة، وقابلة لإعادة الاستخدام بسهولة. يهدف هذا المقال إلى تقديم دليل علمي موسَّع يتجاوز أربعة آلاف كلمة حول كيفية بناء القوالب باستخدام Twig، بدءًا من أساسيات التثبيت والتهيئة، مرورًا بمفاهيم البنية التكوينية، وانتهاءً بأفضل الممارسات المتقدِّمة المتعلقة بالأداء والأمن وتوحيد المعايير.

1. أهمية استخدام محرّك قوالب في تطبيقات PHP

يقتضي التصميم المنطقي لأي تطبيقٍ ويبٍ الالتزام بمبدأ «فصل الاهتمامات» (Separation of Concerns)، وهو مبدأ يُعزِّز قابلية الصيانة وقابلية الاختبار عبر عزل منطق الأعمال عن طبقة العرض. في التطبيقات التقليدية المعتمِدة على PHP الخام، غالبًا ما تُخلَط التعليمات PHP مع شيفرة HTML في الملف نفسه، ما يخلق تداخُلًا معقدًا يَصعُب تتبُّعه على المدى البعيد. يؤدي استخدام محرّك قوالب مثل Twig إلى:

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

• تعزيز الإنتاجية: إذ يوفِّر بنية نحوية مختصرة وفلاتر جاهزة وميزات التوريث (Inheritance) والأقسام (Blocks) والتضمين (Include).

• تحسين الأداء: حيث يُحوِّل القوالب إلى صفوف PHP مُجمَّعة للتنفيذ السريع ويحفظها في ذاكرة التخزين المؤقّت (Cache).

• إعادة الاستخدام: عبر بناء مكتبة مكوّنات عرض قابلة للتضمين مرارًا.

تعتمد الكثير من أطر العمل الحديثة على فكرة القوالب المركِّبة (Composite Templates)، وهو ما يتيحه Twig بمرونة فائقة، كما يُسهِّل على المصمِّمين غير المتخصِّصين في PHP التعديل على الواجهات دون المساس بالمنطق.

2. تثبيت وتكوين Twig في مشاريع PHP

2.1. التثبيت باستخدام Composer

bash
CopyEdit
composer require twig/twig

يُدرِج Composer الحزمة في ملف composer.json مع ضبط التابع التلقائي (Autoloader).

2.2. إنشاء المحرّك

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

$loader = new FilesystemLoader(__DIR__.'/templates');
$twig   = new Environment($loader, [
    'cache' => __DIR__.'/cache',
    'auto_reload' => true,
]);

• FilesystemLoader: يُعلِّم Twig مكان العثور على ملفات القوالب.

• cache: تفعيل التكهين لتسريع التنفيذ في بيئة الإنتاج.

• auto_reload: يُعيد تجميع القالب إذا تغيَّر قبل كل طلب، ما يلائم بيئات التطوير.

2.3. دمج Twig في أُطر العمل

• Symfony: مُدمَج جوهريًّا، ويكفي تفعيل الحزمة symfony/twig-bundle.

• Laravel: توجد حزمة ‎rcrowe/TwigBridge‎ توفر تكامُلًا سهلًا مع النظام البيئي لـ Blade.

• Slim أو Lumen: يُضاف TwigMiddleware في مُعالج الطلبات.

3. البنية التركيبية لقوالب Twig

3.1. التعليمات الأساسية

3.2. المتغيرات والعمليات

يمكن الوصول إلى خصائص الكائنات أو عناصر المصفوفات باستخدام النقطة أو الأقواس:

twig
CopyEdit
{{ post.title }}
{{ user['email'] }}

يدعم Twig تعبيريّات رياضية ومنطقية كاملة:

twig
CopyEdit
{% set subtotal = price * quantity %}

3.3. الحلقات والشروط

twig
CopyEdit
{% for item in items %}
  
{{ loop.index }} - {{ item.name }}
{% else %}
  
لا توجد عناصر
{% endfor %}

تتيح بنية loop‎ معلومات حول الفهرس، العَدّ، الحالة الأولى أو الأخيرة، وغيرها.

3.4. المرشِّحات (Filters)

twig
CopyEdit
{{ "twig"|upper }}   {# النتيجة: TWIG #}
{{ date|date("d‑m‑Y") }}
{{ description|striptags|length }}

4. التوريث والتضمين: بناء معماري قابل للتوسُّع

4.1. القالب الأساس (Base Template)

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



  
  
  {% block stylesheets %}{% endblock %}


  {% block body %}{% endblock %}
  {% block javascripts %}{% endblock %}

4.2. الوراثة في الصفحات الفرعية

twig
CopyEdit
{% extends "base.html.twig" %}

{% block title %}الصفحة الرئيسية{% endblock %}

{% block body %}
  
مرحبًا بكم
  {% include "partials/_article.html.twig" with { article: featured } %}
{% endblock %}

يسمح التضمين (include) بإعادة استخدام قطع واجهة صغيرة دون وراثة كاملة.

5. بناء مكوّنات قابلة لإعادة الاستخدام

تُعَدُّ المكوّنات (Components) حجر أساسٍ في أنظمة تصميم الواجهات. في Twig يمكن إنشاء مكتبة مكوّنات وفق الصيغة التالية:

twig
CopyEdit
{# components/card.html.twig #}

  
  
{{ title }}
  
{{ content|raw }}

twig
CopyEdit
{% include "components/card.html.twig" with {
  image: post.cover,
  title: post.title,
  content: post.excerpt
} %}

6. التدويل (i18n) ودعم اللغة العربية

يدعم Twig التكامل مع مكتبات الترجمة في Symfony أو حزم مثل gettext.

twig
CopyEdit
{{ 'welcome'|trans }}

لا بدّ من مراعاة اتجاه النص (RTL) في أوراق الأنماط، وإمكان تمرير اتجاه الصفحة متغيرًا إلى القالب:

twig
CopyEdit

7. الأمن وإجراءات الحماية

1. التعقيم التلقائي: مُفعَّل افتراضيًّا لامتدادات HTML.

2. قائمة الحظر (Sandbox): تسمح بتقييد الدوال والمرشِّحات للمستخدمين غير الموثوقين.

3. الحدّ من منطق الأعمال: يجب إبقاء العمليات المحسوبة في طبقة PHP، وتجنُّب الحسابات الثقيلة داخل القوالب.

8. تحسين الأداء

8.1. التخزين المؤقّت

تفعيل ‎Environment::cache‎ يحفظ القوالب المُجمَّعة. يمكن كذلك استخدام إستراتيجية «ذاكرة التخزين المؤقت للكتل» (Fragment Caching):

twig
CopyEdit
{% cache 'homepage_featured' 3600 %}
  … محتوى مُكلف …
{% endcache %}

8.2. تتبُّع الأداء

يوفر Twig Profiler مؤشرات زمنية للتصيُّد الاختناقات. في Symfony يُفعَّل تلقائيًّا في بيئة التطوير.

9. الامتدادات (Extensions) وإنشاء مرشِّح مخصَّص

php
CopyEdit
class MarkdownExtension extends \Twig\Extension\AbstractExtension
{
    public function getFilters(): array
    {
        return [
            new \Twig\TwigFilter('markdown', [$this, 'parseMarkdown'], ['is_safe' => ['html']]),
        ];
    }
    public function parseMarkdown(string $content): string
    {
        return (new Parsedown())->text($content);
    }
}
$twig->addExtension(new MarkdownExtension());

ثم في القالب:

twig
CopyEdit
{{ article.body|markdown }}

10. التكامل مع واجهات برمجة التطبيقات (API) وFront‑End حديث

يمكن تمرير بيانات JSON إلى القوالب لإنشاء صفحات SPA هجينة:

twig
CopyEdit

يُستحسن إبقاء تهيئة البيانات في النهاية السفلى للصفحة لتسريع العرض الأولي.

11. الاختبار والتصحيح (Testing & Debugging)

تُسهِّل إضافة الامتداد Debug عملية طباعة المتغيرات:

php
CopyEdit
$twig = new Environment($loader, ['debug' => true]);
$twig->addExtension(new \Twig\Extension\DebugExtension());

twig
CopyEdit
{{ dump(user) }}

12. دليل أفضل الممارسات

13. خاتمة تقنية

يُشكِّل Twig حجر ارتكازٍ في منظومة PHP الحديثة، إذ يُبسِّط بناء واجهات نظيفة آمنة قابلة للتوسُّع، ويُعزِّز التزام المطوِّر بمبادئ التصميم الصالح للصيانة مثل MVC و Component‑Driven Development. إن إتقان مزاياه—بدءًا من التوريث والتضمين ومرورًا بالتدويل والكاش وانتهاءً بإنشاء الامتدادات—يؤهِّلك لبناء تطبيقات ويب عالية الجودة تتوافق مع متطلَّبات الأداء والأمن وتجربة المستخدم في آن.

المصادر

1. Fabien Potencier. Twig Documentation. SensioLabs, الإصدار 3.8, 2025.

2. Symfony SAS. Best Practices for Twig in Symfony Applications, 2024.