إدارة توطين لارافيل وواجهة برمجة التطبيقات (مصفوفة PHP)

تقدم Localization.One دعمًا أصليًا لعمليات PHP وLaravel. توقف عن نسخ ولصق المصفوفات والتعامل مع أخطاء التركيب. قم بتصدير الترجمات الخاصة بك مباشرة كملفات PHP أصلية جاهزة لدليل lang/ الخاص بك.

لماذا يختار المطورون واجهة برمجة التطبيقات الخاصة بنا في لارافيل؟

  • مصفوفات PHP أصلية: نقوم بإنشاء ملفات PHP صالحة تعيد مصفوفة (return [ 'key' => 'value' ];)، وهو المعيار لـ Laravel وSymfony.
  • أمان التركيب: يتم تلقائيًا الهروب من علامات الاقتباس المفردة (') (\')، مما يضمن أن تطبيقك لا يتعطل أبدًا بسبب خطأ في التركيب في ملف اللغة.
  • صفر عبء: لا حاجة لتحليل JSON في وقت التشغيل. استخدم أداء PHP الأصلي لتوطينك.

إدارة مشاريع متقدمة

احتفظ بتوطين الواجهة الخلفية لديك منظمًا وقابلًا للتوسع.

تنظيم الملفات: استخدم الفئات لتجميع السلاسل في ملفات منطقية (مثل، المصادقة، الترقيم، الرسائل) لتتناسب مع هيكل دليل لارافيل.

التسميات والعلامات: قم بتمييز السلاسل بتسميات مخصصة مثل "قوالب البريد الإلكتروني" أو "التحقق" لتصفية التصديرات.

الأدوار والأذونات: دع مديري المحتوى يقومون بتحرير النص دون منحهم الوصول إلى قاعدة الشيفرة الخاصة بك.

الويب هوكس: قم بتشغيل سكربتات النشر تلقائيًا عند تحديث الترجمات.

كيفية الدمج

الخيار 1: التصدير اليدوي (واجهة المستخدم)

مفيد للتحديثات السريعة أو التحقق من المحتوى.

  1. اذهب إلى لوحة التحكم في المشروع.
  2. انقر على زر تنزيل .
  3. اختر Laravel PHP من قائمة التنسيق المنسدلة.
  4. اختر اللغة وقم بتنزيل ملف .php.

الخيار 2: الأتمتة باستخدام واجهة برمجة التطبيقات (CI/CD)

استرجع أحدث الترجمات باستخدام أمر بسيط في سكربت النشر الخاص بك (Envoyer، Forge، أو سكربت شل مخصص). مرر معلمة format=php-array.

# تنزيل الرسائل الإنجليزية
curl "https://api.localization.one/{YOUR_API_KEY}/getTranslations?translation_language=1&format=php-array" > lang/en/messages.php

# تنزيل الرسائل الإسبانية
curl "https://api.localization.one/{YOUR_API_KEY}/getTranslations?translation_language=2&format=php-array" > lang/es/messages.php

الخيار 3: الدفع عبر الويب هوكس

قم بتكوين عنوان URL للويب هوك في إعدادات مشروعك لتلقي إشعارات حول تحديثات الترجمات.

  • تحديثات سريعة: يتلقى خادمك طلب POST بعد فترة وجيزة من التغييرات (عادةً خلال 5 دقائق).
  • مزامنة CMS: قم بتحديث المحتوى تلقائيًا على الواجهة الخلفية لديك دون الحاجة لاستطلاع واجهة برمجة التطبيقات.
  • مسح التخزين المؤقت: استخدم الويب هوك لتشغيل php artisan optimize:clear أو أوامر مشابهة بعد تحديث ملفات اللغة.

أسئلة متكررة

أين يجب أن أحفظ الملف؟

بالنسبة للإصدارات الحديثة من لارافيل (9+)، احفظ الملف الذي تم تنزيله في lang/{locale}/messages.php. بالنسبة للإصدارات القديمة، استخدم resources/lang/{locale}/messages.php.

هل يدعم المعلمات؟

نعم. يمكنك تضمين عناصر نائبة قياسية من لارافيل (مثل: الاسم،: العد) في سلاسل الترجمة الخاصة بك. يحتفظ محررنا بها تمامًا كما هو مكتوب.

دمج الواجهة الأمامية:

هل أنت مستعد لتبسيط توطين الواجهة الخلفية لديك؟ أنشئ حسابك المجاني اليوم.