تدويل PHP: كيفية إنشاء موقع بجميع لغات العالم

تعلم Python بسهولة دون إرهاق نظري. حل مهام عملية مع التحقق التلقائي واكتب الكود مباشرة في المتصفح.

لماذا تدويل PHP ليس مجرد "ترجمة كلمات"

\n\n

تخيل: لقد كتبت مشروع PHP رائعًا. إنه يعمل، ويسعد المستخدمين، ويحقق أرباحًا. لكن في يوم من الأيام، تلاحظ في الإحصائيات أن 30% من الزوار من ألمانيا، و15% من اليابان، و10% من الإمارات. موقعك يتحدث الروسية فقط. يغادر المستخدمون دون أن يجدوا زر "شراء" بلغتهم.

\n\n

هل هذا الموقف مألوف؟ تدويل (i18n) تطبيقات PHP ليس مجرد استبدال كلمات في القالب. إنه نهج معماري يسمح لرمزك بـ "فهم" الثقافة، والعملة، والتواريخ، وحتى اتجاه النص (من اليسار إلى اليمين أو من اليمين إلى اليسار).

\n\n

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

\n\n

i18n مقابل l10n: ما الفرق (ولماذا هذا مهم)

\n\n

قبل كتابة الكود، دعنا نتفق على المصطلحات. التدويل (i18n) هو إعداد الكود للترجمة: استخراج النصوص، التعامل مع تنسيقات الأرقام، التواريخ، العملات. التوطين (l10n) هو عملية الترجمة والتكييف لمنطقة معينة.

\n\n

تشبيه بسيط: التدويل هو بناء منزل بغرف فارغة يمكن وضع أي أثاث فيها. التوطين هو ترتيب الأثاث وفقًا لأذواق ساكن معين.

\n\n

بالنسبة لمطور PHP، هذا يعني: لا تقم بتضمين النصوص في الكود! أبدًا. حتى لو كان الموقع بالروسية فقط حاليًا. يجب تغليف كل عبارة في دالة ترجمة.

\n\n

مجموعة التقنيات لـ i18n في PHP

\n\n

في نظام PHP البيئي، هناك عدة أدوات قوية. سننظر في نهجين رئيسيين: gettext الكلاسيكي و ICU MessageFormat الحديث عبر إضافة intl.

\n\n

1. Gettext — جد تعدد اللغات

\n\n

Gettext في PHP هو المعيار الفعلي للعديد من أنظمة إدارة المحتوى (WordPress، Drupal). يستخدم ملفات .po و .mo لتخزين الترجمات. المزايا: البساطة، دعم صيغ الجمع، التكامل مع Poedit.

\n\n

2. ICU MessageFormat — للمنطق المعقد

\n\n

إضافة PHP intl (التدويل) توفر الفئات MessageFormatter و NumberFormatter. هذا هو الخيار للمشاريع التي تحتاج إلى قوالب معقدة مع اختيار حالة الإعراب والجنس والعدد.

\n\n

3. مكتبات التغليف

symfony/translation — مكون Symfony، يعمل مع YAML/XLIFF و gettext.
laravel-localization — لـ Laravel (حزمة mcamara/laravel-localization).
zend-i18n — لـ Laminas (Zend Framework سابقًا).

\n\n

عمليًا: إعداد gettext في PHP من الصفر

\n\n

لنفترض أن لدينا سكريبت بسيط index.php يعرض تحية. سنجعله متعدد اللغات.

\n\n

الخطوة 1. تحضير الكود

\n\n

قم بتغليف جميع النصوص في الدالة _() (اسم مستعار لـ gettext()):

\n\n

<?php\n// index.php\necho _("مرحبًا بكم في موقعنا!");\n\n$items = 5;\n// لصيغ الجمع نستخدم ngettext\necho ngettext("%d منتج", "%d منتجات", $items);\n?>

\n\n

الخطوة 2. إنشاء ملف .pot

\n\n

قم بتثبيت gettext على الخادم أو استخدم xgettext:

\n\n

xgettext -o locales/messages.pot index.php --from-code=UTF-8

\n\n

الخطوة 3. إنشاء الترجمة

\n\n

انسخ messages.pot إلى locales/ar_SA/LC_MESSAGES/messages.po وقم بتحريره:

\n\n

msgid "مرحبًا بكم في موقعنا!"\nmsgstr "Welcome to our site!"\n\nmsgid "%d منتج"\nmsgid_plural "%d منتجات"\nmsgstr[0] "%d product"\nmsgstr[1] "%d products"

\n\n