aozisik/php-turkce

Turkish language friendly string manipulation functions for PHP.

v2.1.0 2022-08-19 12:29 UTC

This package is auto-updated.

Last update: 2024-04-19 16:25:18 UTC


README


Software License Total Downloads

Ne yapar?

  • PHP'nin strtoupper ve strtolower fonksiyonları Türkçe ile uyumsuzdur. Bu paket, i ve I harflerini bozmadan büyük ve küçük harfe çevirir.

  • Verilen Türkçe sözcüğü veya özel ismi, istenen eke göre çekimler. (-e, -i, -in, -de, -den)

Kurulum

composer require aozisik/php-turkce

Kullanım

Basit kullanım:

Büyük/küçük harfe çevirme metotlarının başına tr_ ekleyerek kullanın.

  • strtoupper -> tr_strtoupper
  • strtolower -> tr_strtolower

Alternatif kullanım:

// Büyültme
turkce('izmirin ılık ilkbaharları')->buyuk(); // İZMİRİN ILIK İLKBAHARLARI

// Küçültme
turkce('İZMİRİN ILIK İLKBAHARLARI')->kucuk(); // izmirin ılık ilkbaharları

// Başlık
turkce('İZMİRİN ILIK İLKBAHARLARI')->baslik(); // İzmirin Ilık İlkbaharları

İsmin Hallerine Çekimleme

İsimlerin yanına gelen ekleri koda gömersek "Ahmet'nin" veya "Hikmet'ye" gibi Türkçe'ye uygun olmayan ve hiç doğal gözükmeyen bir sonuç elde ederiz. Onun yerine, bırakın Türkçe paketi ismi uygun haline çeksin.

// Çekimleme
turkce('İstanbul')->den(); // "İstanbul'dan"
turkce('Hatice')->i(); // "Hatice'yi"
turkce('Kemal')->in(); // "Kemal'in"
turkce('Kazım')->e(); // "Kazım'a"
turkce('Asu')->de(); // "Asu'da"

// Hatta bunu diğer özelliklerle de birleştirebilirsiniz:
turkce('güzel İstanbul')->dan()->baslik(); // "Güzel İstanbul'dan"

Kullanılabilen ekler:

  • i (belirtme)
  • e (yönelme)
  • de (bulunma)
  • den (ayrılma)
  • in (iyelik)

Özel isim / genel isim ayrımı

İsmin hallerine çekimlerken, kütüphane son sözcüğün baş harfini özel genel isim ayrımı yapmak için kullanır. Eğer son sözcük büyük harfle başlıyorsa, özel isim olarak kabul edilir. Bu durumda, hal ekinden önce kesme işareti kullanılır.

Örneğin:

turkce('İstanbul')->den(); // "İstanbul'dan"
turkce('bakkal')->den(); // "bakkaldan"

Sonucu string olarak dönme

Eğer sonucu Sozcuk sınıfı değil, string olarak almak isterseniz aşağıdaki yöntemlerden birini kullanabilirsiniz:

turkce('güzel İstanbul')->dan()->baslik()->yap(); // (string) "Güzel İstanbul'dan"

// veya
(string) turkce('güzel İstanbul')->dan()->baslik(); // (string) "Güzel İstanbul'dan"