Mohamed Sabil 83

مدونة تقنية لكل المهتمين بتطوير المواقع الإلكترونية وأنظمة الويب

Laravel - Vue - Tailwind

دعم لغات الواجهة في لارافيل

دعم لغات الواجهة في لارافيل

يهدف فريق عمل حزمة laravel-lang إلى توفير ترجمة جاهزة لجميع العبارات الأساسية في إطار العمل laravel إضافة إلى حزمته الجديدة jetstream والتي ظهرت للوجود مع الإصدارة 8 من laravel. حزمة laravel-lang الآن بها 9 لغات يتم تحديثها أول بأول بجديد العبارات التي تنضاف إلى إطار العمل laravel مع استهداف إضافة المزيد من اللغات.

من خلال مراجعة كود لارافيل، وفي الكود الخاص بك أيضاً، ستجد استخدام أحد الصيغ التالية:

{{ _('translated_text') }}
{{ trans('translated_text') }}
@lang('translated_text')

الصيغ المذكورة أعلاه هي عملية تهيئة النص ليقوم بقراءة الترجمة المناسبة حسب اللغة المحددة من مطور التطبيقات. فالعبارة translated_text في المثال أعلاه هي بمثابة المعّرف ID للنص المطلوب إظهاره والذي يجب إضافته في مجلد اللغة / اللغات المطلوبة مع ترجمتها وبالتالي عند استعراض المشروع من قبل المستخدم، فإنه وحسب لغة المشروع التي اختارها (العربية مثلا) فإن لارافيل يقوم بالذهاب لمجلد اللغة العربية ويقوم بالبحث عن النص صاحب المعرّف translated_text ويقوم بإرجاع النص الخاص به.

تثبيت حزمة laravel-lang

تثبيت حزمة laravel-lang يتم من خلال الأمر التالي:

composer require laravel-lang/lang

بعد الانتهاء من تثبيت الحزمة، ستجد جميع اللغات في المسار التالي vendor/laravel-lang/lang .بإمكانك الآن نسخ مجلد اللغة المطلوبة - مثلا العربية ورمزها ar - إلى مجلد اللغات resources/lang. والآن عند تغيير لغة المشروع إلى العربية من خلال تغيير قيمة locale إلى ar ضمن ملف app/config.php ومن ثم عمل تحديث لصفحة المشروع، فستجد جميع العبارات النصية الأساسية في لارافيل والمكتوبة بالصيغة التي ذكرناها سابقا، قد ظهرت بالترجمة العربية بدلا من الإنجليزية.

تسهيلا للخطوات السابقة، وحتى لا نقوم بنسخ مجلدات اللغات المطلوبة يدويا، يمكننا استخدام حزمة overtrue/laravel-lang والتي تقوم بتثبيت حزمة laravel-lang الأساسية التي ذكرناها أعلاه مع توفير أمر نشر للغة / اللغات المطلوبة من خلال سطر الأوامر.

تثبيت حزمة overtrue/laravel-lang

لتثبيت حزمة overtrue/laravel-lang، فإننا ننفذ الأمر التالي:

composer require overtrue/laravel-lang

عند انتهاء التثبيت، يمكنك الآن إضافة اللغة المطلوبة لمشروعك - العربية في مثالنا ورمزها ar - عبر الأمر التالي:

php artisan lang:publish ar

بعد ظهور رسالة اكتمال النشر، يمكنك الإنتقال لمجلد اللغات resources/lang وستجد أن مجلد اللغة العربية قد انضاف هناك دون الحاجة للقيام بذلك يدويا. يمكنك إضافة عدة لغات في نفس الوقت مثلا العربية ar والفرنسية fr من خلال الأمر:

php artisan lang:publish ar,fr

للإطلاع على المزيد يمكنك أخذ نظرة على مستودع الحزمتين laravel-lang/lang و overtrue/laravel-lang.

الكلمات المفتاحية لارافيل laravel دعم اللغات ملفات الترجمة lang overtrue