Laravel أداة قوية تمكن المطورين من إنشاء مواقع ويب متعددة اللغات. من خلال تنفيذ توطين الويب في Laravel ، يمكنك توفير تجربة مستخدم مخصصة للزائرين من خلفيات لغوية مختلفة، مما يؤدي في النهاية إلى توسيع نطاق وصولك وتحسين مشاركة المستخدم.
سنرشدك خلال عملية تنفيذ الترجمة في تطبيق Laravel الخاص بك ونقدم لك أداة يمكنها تبسيط جهود الترجمة الخاصة بك وتعزيزها!
فيما يلي بعض الأسباب المهمة التي تدفعك إلى توطين موقع Laravel الإلكتروني الخاص بك.
هناك بعض المتطلبات والخطوات التي يجب مراعاتها عند تنفيذ الترجمة متعددة اللغات في Laravel .
بعد فهم المتطلبات التي يجب استيفاؤها قبل ترجمة تطبيق Laravel أو الويب، سنقدم بعض الخطوات لترجمة Laravel ببساطة.
للقيام بذلك، افتح ملف العرض الذي تريد تعريبه، على سبيل المثال، Resources/views/welcome.blade.php. ثم استبدل علامة الجسم بالكود التالي.
<body class="antialiased"> <div class="relative flex items-top justify-center min-h-screen bg-gray-100 sm:items-center py-4 sm:pt-0"> <div class="max-w-6xl mx-auto sm:px-6 lg:px-8"> <div class="flex justify-center pt-8 sm:justify-start sm:pt-0"> Welcome to Linguise website! </div> </div> </div> </body>
كما ترون، النص أعلاه مكتوب حاليًا مباشرة في الكود. وهذا أقل كفاءة ويجعل من الصعب ترجمة مواقع الويب إلى لغات مختلفة (التدويل).
سنجعل النص أعلاه أكثر مرونة حتى يمكن تكييفه بسهولة مع اللغات المختلفة. يوفر Laravel ميزة مفيدة جدًا لهذا الغرض؛ نظام التوطين. كخطوة أولى، استبدل النص الموجود بالكود التالي.
{{ __('Welcome to Linguise website!') }}
سيعرض Laravel النص أعلاه افتراضيًا ويبحث عن الترجمة إذا اختار المستخدم لغة أخرى غير الإنجليزية. في هذه الحالة، سيتم استخدام اللغة الإنجليزية كلغة افتراضية للتطبيق.
لكن كيف يحدد Laravel اللغة الحالية أو يعرف اللغات المتوفرة في التطبيق؟ يقوم بالتحقق من الإعدادات المحلية في ملف config/app.php. افتح هذا الملف وابحث عن المفتاحين التاليين.
/* |-------------------------------------------------------------------------- | Application Locale Configuration |-------------------------------------------------------------------------- | | The application locale determines the default locale that will be used | by the translation service provider. You are free to set this value | to any of the locales which will be supported by the application. | */ 'locale' => 'en', /* |-------------------------------------------------------------------------- | Application Fallback Locale |-------------------------------------------------------------------------- | | The fallback locale determines the locale to use when the current one | is not available. You may change the value to correspond to any of | the language folders that are provided through your application. | */ 'fallback_locale' => 'en',
يجب أن يكون الشرح الموجود فوق المفاتيح واضحًا. باختصار، يحتفظ مفتاح اللغة باللغة الافتراضية لتطبيقك (إذا لم يتم تحديد لغة أخرى في الكود). يتم تنشيط Fallback_locale إذا تم طلب لغة غير موجودة في التطبيق الخاص بك.
الآن، دعونا نضيف مفتاحًا جديدًا لهذا الملف لتوفير قائمة بجميع اللغات المدعومة.
/* |-------------------------------------------------------------------------- | Available locales |-------------------------------------------------------------------------- | | List all locales that your application works with | */ 'available_locales' => [ 'English' => 'en', 'Italian' => 'it', 'French' => 'fr', ],
في هذه المرحلة، قمنا بتجربة Laravel web لدعم ثلاث لغات، وهي الإنجليزية والإيطالية والفرنسية.
في Laravel ، كما هو الحال في العديد من الأطر الأخرى، يتم تخزين الترجمات للغات المختلفة في ملفات منفصلة. يتم استخدام طريقتين لتنظيم ملفات الترجمة هذه.
تقوم الطريقة القديمة بتخزين الملفات بالبنية التالية: Resources/lang/{en,fr,it}/{myfile.php}. تستخدم الطريقة الأحدث ملفات JSON، مثل Resources/lang/{fr.json, it.json}. ستركز هذه المقالة على الطريقة الأحدث، على الرغم من أن المبادئ متشابهة مع الطريقة القديمة، بصرف النظر عن الاختلافات في كيفية تسمية مفاتيح الترجمة والوصول إليها.
بالنسبة للغات ذات الاختلافات الإقليمية، يجب عليك تسمية أدلة أو ملفات اللغة وفقًا لمعيار ISO 15897. على سبيل المثال، سيتم تسمية اللغة الإنجليزية البريطانية باسم en_GB بدلاً من en-gb.
في Laravel ، كما هو الحال مع العديد من أطر العمل، يتم تخزين الترجمات للغات المختلفة في ملفات منفصلة. هناك طريقتان أساسيتان لتنظيم ملفات ترجمة Laravel .
ستركز هذه المقالة على الطريقة الثانية، على الرغم من أن المبادئ تنطبق على كليهما (مع اختلافات في كيفية تسمية مفاتيح الترجمة والوصول إليها).
بالنسبة للغات التي تختلف حسب المنطقة، يوصى بتسمية أدلة/ملفات اللغة وفقًا لمعايير ISO 15897. على سبيل المثال، سيتم الإشارة إلى اللغة الإنجليزية البريطانية بالصيغة en_GB بدلاً من en-gb.
بعد تكوين الإعدادات المحلية لتطبيقنا، يمكننا متابعة ترجمة رسالة الترحيب الافتراضية الخاصة بنا.
لنبدأ بإنشاء ملفات ترجمة جديدة بتنسيق JSON داخل دليل Resources/lang. أولاً، سنقوم بإنشاء ملف Resources/lang/it.json وملؤه بالترجمات المناسبة.
{ "Welcome to Linguise website!": "Benvenuti nel sito web di Linguise!" }
بعد ذلك، أضف ملف Resources/lang/fr.json.
{ "Welcome to Linguise website!": "Bienvenue sur le site de Linguise" }
كما تلاحظ، فإننا نشير باستمرار إلى الرسالة الافتراضية من ملف Welcome.blade.php ({{ __('مرحبًا بك في موقع Linguise !') }}). ليست هناك حاجة لإنشاء ملف en.json، حيث يتعرف Laravel تلقائيًا على أن الرسائل الافتراضية باللغة الإنجليزية.
علاوة على ذلك، لم يتم إعداد Laravel بعد لتجاوز اللغة المحلية، لذا، في الوقت الحالي، سنتعامل مع الترجمة مباشرة داخل المسار. قم بتعديل مسار الترحيب الافتراضي داخل ملف المسارات/web.php مثل هذا.
Route::get('/{locale?}', function ($locale = null) { if (isset($locale) && in_array($locale, config('app.available_locales'))) { app()->setLocale($locale); } return view('welcome'); });
في هذه الحالة، نقوم بالتقاط معلمة GET للغة اختيارية ونقوم بتعيين اللغة الحالية بناءً عليها (إذا كانت اللغة المطلوبة مدعومة).
يمكنك الآن زيارة موقع الويب الخاص بك وتضمين أي من اللغات المدعومة كالجزء الأول في عنوان URL. على سبيل المثال، سيؤدي الانتقال إلى localhost/it أو localhost/fr إلى عرض المحتوى المترجم. إذا لم تحدد لغة أو اخترت لغة غير مدعومة، فسيتم تعيين Laravel افتراضيًا على اللغة الإنجليزية (en).
قد لا يكون تضمين اللغة في كل عنوان URL أمرًا مثاليًا وقد يؤدي إلى تعطيل المظهر المرئي للموقع. لمعالجة هذه المشكلة، سنقوم بإعداد محوّل لغة واستخدام جلسة المستخدم لعرض المحتوى المترجم. يمكنك إنشاء برامج وسيطة جديدة في ملف app/Http/Middleware/Localization.php، أو إنشائها عن طريق تشغيل الأمر الحرفي make:middleware Localization.
ثم قم بإضافة الكود التالي بداخله.
<?php namespace App\Http\Middleware; use Closure; use Illuminate\Http\Request; use Illuminate\Support\Facades\App; use Illuminate\Support\Facades\Session; class Localization { /** * Handle an incoming request. * * @param \Illuminate\Http\Request $request * @param \Closure $next * @return mixed */ public function handle(Request $request, Closure $next) { if (Session::has('locale')) { App::setLocale(Session::get('locale')); } return $next($request); } }
ستقوم هذه البرمجيات الوسيطة بتوجيه Laravel لاستخدام الموقع الذي حدده المستخدم إذا كان هذا الخيار موجودًا في الجلسة.
نظرًا لأننا نحتاج إلى تنفيذ العملية عند كل طلب، أضفها إلى حزمة البرامج الوسيطة الافتراضية في app/Http/Kernel.php لمجموعة البرامج الوسيطة على الويب.
/** * The application's route middleware groups. * * @var array<string, array<int, class-string|string>> */ protected $middlewareGroups = [ 'web' => [ \App\Http\Middleware\EncryptCookies::class, \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class, \Illuminate\Session\Middleware\StartSession::class, \Illuminate\View\Middleware\ShareErrorsFromSession::class, \App\Http\Middleware\VerifyCsrfToken::class, \Illuminate\Routing\Middleware\SubstituteBindings::class, \App\Http\Middleware\Localization::class, // <--- add this ],
بعد ذلك، حدد مسارًا لتغيير الإعدادات المحلية في ملف Routes/web.php. نحن نستخدم مسار إغلاق هنا، ولكن يمكنك وضع نفس الرمز داخل وحدة التحكم إذا كنت تفضل ذلك.
Route::get('language/{locale}', function ($locale) { app()->setLocale($locale); session()->put('locale', $locale); return redirect()->back(); });
بالإضافة إلى ذلك، قم بإزالة تبديل الإعدادات المحلية الذي تمت إضافته مسبقًا إلى مسار الترحيب الافتراضي. يجب أن يبدو مسار الجذر الخاص بك الآن هكذا.
Route::get('/', function () { return view('welcome'); });
بمجرد الانتهاء من ذلك، يمكن للمستخدم فقط تبديل اللغة النشطة عن طريق زيارة localhost/language/{locale}. سيتم حفظ اللغة المحددة في الجلسة، وسيتم إعادة توجيه المستخدمين مرة أخرى إلى صفحتهم السابقة (كما يتم التعامل معها بواسطة البرنامج الوسيط للتعريب).
لاختباره، انتقل إلى localhost/language/it (بافتراض أن ملف تعريف ارتباط الجلسة نشط في متصفحك)، ومن المفترض أن تشاهد المحتوى المترجم. يمكنك التنقل في الموقع أو تحديث الصفحة، وستظل اللغة المختارة سارية المفعول.
الآن، نحن بحاجة إلى تزويد المستخدم بخيار قابل للنقر لتغيير محوّل اللغة Laravel web بدلاً من مطالبته بإدخال رموز الإعدادات المحلية في عنوان URL يدويًا. ولتحقيق ذلك، قم بإنشاء محوّل لغة بسيط. أضف ملفًا جديدًا على Resources/views/partials/language_switcher.blade.php وأدخل الكود التالي.
<div class="flex justify-center pt-8 sm:justify-start sm:pt-0"> @foreach($available_locales as $locale_name => $available_locale) @if($available_locale === $current_locale) <span class="ml-2 mr-2 text-gray-700">{{ $locale_name }}</span> @else <a class="ml-1 underline ml-2 mr-2" href="language/{{ $available_locale }}"> <span>{{ $locale_name }}</span> </a> @endif @endforeach </div>
لتضمين محوّل اللغة الذي تم إنشاؤه حديثًا في عرض "الترحيب"، ما عليك سوى إضافة السطر التالي إلى ملف Welcome.blade.php الخاص بك حيث تريد أن يظهر المحوّل.
<body class="antialiased"> <div class="relative flex items-top justify-center min-h-screen bg-gray-100 sm:items-center py-4 sm:pt-0"> <div class="max-w-6xl mx-auto sm:px-6 lg:px-8"> @include('partials/language_switcher') <div class="flex justify-center pt-8 sm:justify-start sm:pt-0"> {{ __('Welcome to our website!') }} </div> </div> </div> </body>
افتح ملف app/Providers/AppServiceProvider.php وأضف الكود التالي في طريقة boot() لمشاركة اللغة الحالية مع جميع طرق العرض عند استخدام محوّل اللغة
* Bootstrap any application services. * * @return void */ public function boot() { view()->composer('partials.language_switcher', function ($view) { $view->with('current_locale', app()->getLocale()); $view->with('available_locales', config('app.available_locales')); }); }
في هذه المناقشة، سنتعامل بعد ذلك مع مكونات الترجمة الأخرى، وهي التاريخ والرقم والعملة. وهنا الخطوات.
يعد التعامل مع التواريخ والأوقات أمرًا بالغ الأهمية في عملية الترجمة. يستخدم Laravel الكربون لإدارة التواريخ والأوقات. إليك كيفية استخدام Carbon لعرض تاريخ محلي.
<?php Route::get('/', function () { $today = \Carbon\Carbon::now() ->settings( [ 'locale' => app()->getLocale(), ] ); // LL is macro placeholder for MMMM D, YYYY (you could write same as dddd, MMMM D, YYYY) $dateMessage = $today->isoFormat('dddd, LL'); return view('welcome', [ 'date_message' => $dateMessage ]); });
يقوم هذا الرمز بتعيين لغة Carbon بناءً على اللغة الحالية للتطبيق ويقوم بتنسيق التاريخ وفقًا لذلك.
لعرض التاريخ المترجم في طريقة عرض:
{{ __('Welcome to our website, :Name', ['name' => ‘Johb’]) }} <br> {{ trans_choice('{0} There :form :count apples|{1} There :form just :count apple|[2,19] There :form :count apples', 1, ['form' => 'is']) }} <br> {{ $date_message }}
لدى البلدان المختلفة طرق مختلفة لتنسيق الأرقام. على سبيل المثال.
لاستيعاب هذه الاختلافات في تطبيق Laravel ، يمكنك استخدام NumberFormatter.
<?php $num = NumberFormatter::create('en_US', NumberFormatter::DECIMAL); $num2 = NumberFormatter::create('fr', NumberFormatter::DECIMAL);
يمكنك أيضًا تهجئة الأرقام بلغة معينة.
<?php $num = NumberFormatter::create('en_US', NumberFormatter::SPELLOUT); $num2 = NumberFormatter::create('it', NumberFormatter::SPELLOUT);
وهنا العملات. بالنسبة للغة الفرنسية (`fr`)، سيتم عرض العملة باليورو (€)، بينما بالنسبة للغة الأمريكية (`en_US`)، فسيتم عرضها بالدولار الأمريكي ($).
<?php $currency1 = NumberFormatter::create('it', NumberFormatter::CURRENCY); $currency2 = NumberFormatter::create('en_US', NumberFormatter::CURRENCY);
بعد فهم خطوات توطين Laravel كما هو موضح في المقال، تتضمن هذه العملية العديد من الخطوات التي تتطلب من المستخدمين فهم كود برنامج Laravel بعمق.
وهذا بالتأكيد يمكن أن يجعل الأمر صعبًا على المستخدمين المبتدئين الذين يرغبون في توطين تطبيقاتهم. ولذلك، هناك حاجة إلى حل أكثر ابتكارًا يكون قادرًا على الترجمة السريعة، ويدعم الترجمة، ولا يتطلب سوى بضع خطوات بسيطة للتنفيذ.
أحد الحلول الواعدة هو Linguise . تقدم Linguise طريقة أسهل وأكثر كفاءة لتوطين Laravel دون الحاجة إلى معرفة متعمقة بالبرمجة. وتشمل الميزات الرئيسية ل Linguise .
يمكن أيضًا تنفيذ خطوات تثبيت Linguise على مواقع Laravel وهنا شرح موجز.
كيف؟ مع Linguise ، ما عليك سوى التسجيل والتنشيط، وسيظهر محوّل اللغة. بعد ذلك، لديك الحرية في الترجمة، على سبيل المثال، من خلال المحرر المباشر، وترجمة الوسائط، والصور، وما إلى ذلك.
يعد توطين Laravel ميزة قوية تمكن المطورين من إنشاء مواقع وتطبيقات متعددة اللغات. كما رأينا، تتضمن عملية التعريب المضمنة في Laravel خطوات متعددة وتتطلب فهمًا جيدًا لإطار العمل. قد يكون الأمر صعبًا بالنسبة للمبتدئين أو أولئك الذين يبحثون عن حل أسرع.
أدوات مثل Linguise بديلاً مبتكرًا لأولئك الذين يبحثون عن نهج أكثر بساطة. توفر هذه الحلول إمكانات ترجمة سريعة وتكاملًا سهلاً وميزات سهلة الاستخدام مثل محولات اللغة القابلة للتخصيص وترجمة الصور. الآن، حساب Linguise الخاص بك واستمتع بميزاتنا لترجمة Laravel !
تلقي أخبار حول الترجمة الآلية للمواقع الإلكترونية وتحسين محركات البحث الدولية والمزيد!
لا تغادر دون مشاركة بريدك الإلكتروني!
لا يمكننا ضمان فوزك باليانصيب ، ولكن يمكننا أن نعدك ببعض الأخبار المفيدة حول الترجمة والخصومات العرضية.
![تعريب Laravel خطوة بخطوة [الدليل]](https://www.linguise.com/wp-content/uploads/2024/10/FI_Step-by-Step-Laravel-Localization.png)
![تعريب Laravel خطوة بخطوة [الدليل]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Why-should-you-localize-the-Laravel-website-.png)
![تعريب Laravel خطوة بخطوة [الدليل]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Requirements-for-a-multilingual-Laravel-localization.png)
![تعريب Laravel خطوة بخطوة [الدليل]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Simple-Laravel-translations.png)
![تعريب Laravel خطوة بخطوة [الدليل]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Setting-up-locales-in-a-Laravel-multilingual-web.png)
![تعريب Laravel خطوة بخطوة [الدليل]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Laravel-translation-files-overview.png)
![تعريب Laravel خطوة بخطوة [الدليل]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Language-switcher-in-a-Laravel-multilingual-app.png)
![تعريب Laravel خطوة بخطوة [الدليل]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Advanced-translation-features-in-Laravel-PHP.png)
![تعريب Laravel خطوة بخطوة [الدليل]](https://www.linguise.com/wp-content/uploads/2024/10/ilustrasi_Laravel-localization-with-Linguise.png)
