Laravel Custom Helper Oluşturma: Adım Adım Rehber

Laravel projelerinde sıklıkla kullanılan fonksiyonları tekrar tekrar yazmak yerine, kendi özel helper fonksiyonlarınızı oluşturabilirsiniz. Custom helper fonksiyonları, projenizde kod tekrarını azaltır ve geliştirme sürecinizi hızlandırır. Bu makalede, Laravel’de custom helper fonksiyonların nasıl oluşturulacağını detaylı bir şekilde anlatacağız.

Custom Helper Nasıl Oluşturulur?

Laravel’de kendi helper fonksiyonlarınızı oluşturmak için aşağıdaki adımları takip edebilirsiniz:

1. Helper Dosyası Oluşturun

Projenizin app dizini altında bir Helpers klasörü oluşturun. Ardından, bu klasör içinde bir PHP dosyası oluşturun. Örneğin:

mkdir app/Helpers

touch app/Helpers/custom_helpers.php

custom_helpers.php dosyasına örnek bir fonksiyon ekleyelim:

<?php
if (!function_exists('format_price')) {
function format_price($amount)
{
return number_format($amount, 2) . ' ₺';
}
}
if (!function_exists('generate_slug')) {
function generate_slug($string)
{
return strtolower(trim(preg_replace('/[^A-Za-z0-9-]+/', '-', $string)));
}
}

2. Composer’a Helper Dosyasını Tanıtın

Helper dosyasını projede otomatik olarak yüklemek için composer.json dosyasında autoload kısmına bir ekleme yapın:

"autoload": {
    "psr-4": {
        "App\\": "app/"
    },
    "files": [
        "app/Helpers/custom_helpers.php"
    ]
}

3. Autoload’u Yeniden Oluşturun

Helper dosyasının projede tanımlanması için composer dump-autoload komutunu çalıştırın:

composer dump-autoload

4. Helper Fonksiyonlarını Kullanmaya Başlayın

Helper fonksiyonlarınız artık projenizin herhangi bir yerinde kullanılabilir. Örneğin:

// Örnek Kullanım 1: format_price
$price = format_price(1234.56);
echo $price; // Çıktı: 1,234.56 ₺
// Örnek Kullanım 2: generate_slug
$slug = generate_slug('Laravel Custom Helper Oluşturma');
echo $slug; // Çıktı: laravel-custom-helper-olusturma

Neden Custom Helper Kullanmalısınız?

• Kod Tekrarını Azaltır: Sıkça kullanılan fonksiyonları merkezi bir yerde tanımlayarak, kod tekrarından kaçınabilirsiniz.
• Kolay Bakım: Helper fonksiyonları tek bir dosyada toplandığı için, gerektiğinde kolayca düzenlenebilir.
• Proje Genelinde Kullanım: Helper fonksiyonlarınız, projenizin her yerinde kullanılabilecek şekilde yüklenir.

Sık Karşılaşılan Sorunlar ve Çözümleri

1. Fonksiyon Tanımlı Değil Hatası

   • Helper fonksiyonlarınızın composer.json dosyasında yüklenip yüklenmediğini kontrol edin.
   • composer dump-autoload komutunu yeniden çalıştırın.

2. Fonksiyon Çakışması

   • İsimlendirmede Laravel’in varsayılan fonksiyonlarıyla veya başka helper fonksiyonlarla çakışmaması için dikkatli olun.