التدويل (i18n) في PHP

التدويل (i18n) في PHP: من الأساسيات إلى الحلول الحديثة

\n\n

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

\n\n

لماذا نحتاج إلى التدويل؟

الهدف الرئيسي لـ i18n هو فصل نص الواجهة عن الكود. يتيح ذلك:

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

\n\n

الدعم المدمج: gettext

تقدم PHP آلية قوية gettext للعمل مع الترجمات. هذا هو النهج الكلاسيكي المستخدم في معظم أنظمة Linux.

\n\n

التثبيت والإعداد

تأكد من تثبيت إضافة gettext. في معظم توزيعات Linux، تكون متاحة افتراضيًا. بالنسبة لنظام Windows، قد تحتاج إلى تفعيل php_gettext.dll في ملف php.ini.

\n\n

إنشاء ملفات الترجمة

أولاً، أنشئ دليلاً للإعدادات المحلية. الهيكل النموذجي:

locale/\n  ru_RU/\n    LC_MESSAGES/\n      messages.po\n      messages.mo\n  en_US/\n    LC_MESSAGES/\n      messages.po\n      messages.mo

\n\n

ملفات .po (Portable Object) هي ملفات نصية تحتوي على الترجمات. مثال على محتوى messages.po للغة الروسية:

msgid "Welcome"\nmsgstr "Добро пожаловать"\n\nmsgid "Hello, %s!"\nmsgstr "Здравствуйте, %s!"

\n\n

قم بترجمة .po إلى .mo الثنائي باستخدام الأداة msgfmt:

msgfmt locale/ru_RU/LC_MESSAGES/messages.po -o locale/ru_RU/LC_MESSAGES/messages.mo

\n\n

الاستخدام في الكود

مثال على سكريبت PHP مع gettext:

<?php\n// تعيين الإعداد المحلي والمجال\n$locale = 'ru_RU';\nputenv("LANG=$locale");\nsetlocale(LC_ALL, $locale);\nbindtextdomain('messages', __DIR__ . '/locale');\ntextdomain('messages');\n\n// ترجمة السلاسل\necho gettext('Welcome'); // سيطبع "Добро пожаловать"\necho _('Hello, %s!', 'Иван'); // سيطبع "Здравствуйте, Иван!"\n?>

\n\n

الدالة _() هي اختصار لـ gettext(). للترجمة مع العناصر النائبة، استخدم sprintf():

echo sprintf(_('Hello, %s!'), $username);

\n\n

النهج الحديث: symfony/translation

للمشاريع الكبيرة، من الأسهل استخدام مكتبة symfony/translation. تقدم واجهة أكثر مرونة، ودعمًا لتنسيقات مختلفة (YAML، XLIFF، JSON)، وتتكامل بسهولة مع الأطر.

\n\n

التثبيت عبر Composer

composer require symfony/translation

\n\n

مثال على الاستخدام

<?php\nrequire_once __DIR__ . '/vendor/autoload.php';\n\nuse Symfony\\Component\\Translation\\Translator;\nuse Symfony\\Component\\Translation\\Loader\\ArrayLoader;\n\n$translator = new Translator('ru_RU');\n$translator->addLoader('array', new ArrayLoader());\n\n// إضافة الترجمات مباشرة (للغرض التوضيحي)\n$translator->addResource('array', [\n    'Welcome' => 'Добро пожаловать',\n    'Hello %name%' => 'Здравствуйте, %name%',\n], 'ru_RU');\n\n// التبديل إلى الإنجليزية\n$translator->setLocale('en_US');\n$translator->addResource('array', [\n    'Welcome' => 'Welcome',\n    'Hello %name%' => 'Hello, %name%',\n], 'en_US');\n\n// الاستخدام\necho $translator->trans('Welcome'); // "Welcome"\necho $translator->trans('Hello %name%', ['%name%' => 'John']); // "Hello, John"\n?>

\n\n