localization.md

Yerelleştirme

• Giriş
• Dil Dosyaları
• Temel Kullanım
• Çoğullaştırma

Giriş

Laravel'in Lang sınıfı farklı dillerdeki yazılara ulaşabileceğiniz bir hizmet verir, bu sayede uygulamanızda rahatlıkla çoklu dil desteği verebilirsiniz.

Dil Dosyaları

Diller için kayıtlar app/lang dizininin içerisindeki dosyalarda tutulur. Bu dizin içerisinde desteklenen her dil için bir klasör oluşturulmalıdır.

/app
	/lang
		/en
			mesajlar.php
		/tr
			mesajlar.php

Dil dosyaları basitçe anahtarlı bir şekilde kayıtları barındıran bir dizi döndürür. Örneğin:

Örnek Dil Dosyası

<?php

return array(
	'hosgeldiniz' => 'Uygulamamıza hoş geldiniz!'
);

Uygulamanız için varsayılan dil app/config/app.php ayar dosyasında tutulmaktadır. Bunun dışında, aktif dili App::setLocale metoduyla çalışma esnasında da değiştirebilirsiniz.

Varsayılan Dili Çalışma Esnasında Değiştirmek

App::setLocale('tr');

Temel Kullanım

Bir Dil Dosyasından Satırları Almak

echo Lang::get('mesajlar.hosgeldin');

get metoduna verilen parametrenin ilk kısmı dil dosyasının adını, ikinci kısım ise alınmak istenen satırın anahtarını içerir.

Not: Eğer istenen dil satırı bulunmuyorsa, get metodu anahtarı döndürecektir.

Satırlarda Değişiklik Yapmak

Ayrıca dil satırlarınızda yertutucular tanımlayabilirsiniz:

'hosgeldin' => 'Hoşgeldin, :isim',

Daha sonra, Lang::get metoduna ikinci bir parametreyle yapılacak değişiklikleri belirtin:

echo Lang::get('mesajlar.hosgeldin', array('isim' => 'Ekrem'));

Bir Dil Dosyasının İstenen Satıra Sahip Olup Olmadığını Kontrol Etmek

if (Lang::has('mesajlar.hosgeldin'))
{
	//
}

Çoğullaştırma

Çoğullaştırma karmaşık bir problemdir, çünkü her dilin farklı ve karmaşık çoğullaştırma kuralları vardır. Dil dosyalarınızda bunu kolaylıkla yönetebilirsiniz. dik çubuk karakteri ile, bir çevirinin tekil ve çoğul hallerini birbirinden ayırabilirsiniz:

'elmalar' => 'Bir elma var|Bir sürü elma var',

Daha sonra Lang::choise metoduyla satırı alabilirsiniz:

echo Lang::choice('mesajlar.elmalar', 10);

Laravel'in tercüme sınıfı gücünü Symfony'nin tercüme bileşeninden aldığı için, daha belirgin çoğullaştırma kuralları da belirleyebilirsiniz:

'elmalar' => '{0} Hiç elma yok|[1,19] Bir kaç elma var|[20,Inf] Çok fazla elma var',