openai-php/laravel — Laravel Uygulamanıza Yapay Zeka Özellikleri Ekleyin

Laravel Uygulamalarında Yapay Zeka Neden Artık Zorunlu?

Web geliştirmede günümüzde kullanıcılar daha akıllı uygulamalar bekliyor. Büyük metin yığınlarını okumak istemiyorlar; anında net, doğru bir özet istiyorlar. Standart bir destek yanıtının iki gün sürmesini asla istemiyorlar.

Eğer uygulamanız “dumb” hissi veriyorsa, rakipler hızla öne geçer. Laravel’e yapay zeka desteği eklemek artık bir şaka değil, modern platformlar için tartışılmaz bir gereklilik. Serbest çalışan müşteriler, işlerini modernize etmek konusunda ciddi bir baskı altında. Bu baskı, doğrudan geliştiricilere yansıyor, bu nedenle programlama becerilerimizi hızla adapte etmemiz gerekiyor.

İyi haber şu ki, makine öğrenimi diplomasına ihtiyaç yok. Sadece sağlam bir API istemcisi ve temel PHP bilgisi yeterli. Çok az kod ile inanılmaz akıllı özellikler geliştirebiliriz.

openai-php/laravel Paketi Nedir?

Bu belirli araç, resmi OpenAI PHP istemcisinin etrafında temiz bir şekilde yer alan topluluk destekli bir wrapper’dır. Kaynak koduna github.com/openai-php/laravel adresinden ulaşabilirsiniz. Topluluğumuzdaki harika geliştiriciler tarafından aktif bir şekilde korunmaktadır.

Teorik olarak Laravel’in yerel HTTP facade’ını kullanabilirsiniz, ancak bu yol başlangıçta oldukça karmaşık hale gelecek. Özel başlıkları yönetmek, devasa JSON yüklerini formatlamak ve garip API istisnalarını yakalamak çabası yorucu olabilir.

Bu ChatGPT Laravel paketi, tüm bu sıkıcı işlemleri yönetir. Güzel ve akıcı bir facade sağlar. Modern Laravel ekosistemine tamamen yerleşik bir hissiyat verir. API iletişimi için tartışmasız en iyi seçimdir.

openai-php/laravel’ı Laravel Projenizde Kurmak

Şimdi uygulamamıza bunu dahil etmeye başlayalım. Aktif projenize çekmek sadece iki dakikanızı alacak. Önce, yerel terminal penceresini açarak aşağıdaki composer komutunu çalıştırın:

composer require openai-php/laravel

İndirme tamamlandığında, yapılandırmayı yayınlamanız gerekiyor. Bu, yapılandırma dosyasını uygulama dizininize açar. İleride istemci ayarlarını buradan özelleştirebilirsiniz.

php artisan vendor:publish --provider="OpenAI\Laravel\ServiceProvider"

Bu, projenizde bir config/openai.php dosyası oluşturur. Bu dosyayı çok fazla düzenlemenize gerek yoktur — tüm önemli bilgiler .env dosyanızda olacak, bu da Laravel geliştiricileri için hoş bir durumdur.

Şimdi projenizin .env dosyasını açın. Güvenli bir şekilde OPENAI_API_KEY’inizi eklemeniz gerekiyor. Bu anahtarı direkt olarak platform.openai.com üzerinden alabilirsiniz:

OPENAI_API_KEY=your-api-key-here
OPENAI_ORGANIZATION=your-org-id-here

Kurulum süreci bu kadar basit. Laravel’in harika otomatik keşfi, geri kalan her şeyi otomatik olarak halleder. Hemen API çağrısı yapmaya başlayabilirsiniz.

API anahtarınızı almak için platform.openai.com adresine gidin, oturum açın, sol kenar çubuğundaki API Keys’e gidin ve yeni bir gizli anahtar oluşturun. “Laravel App” gibi bir isim verin ki amacı hatırlanınca kolaylıkla bulabilesiniz. Hemen kopyalayın; OpenAI bunu sadece bir kez gösterir.

Bu anahtarı .env dosyanıza yapıştırın, ardından php artisan config:clear çalıştırın ve tamamen hazır hale geleceksiniz. Hiçbir servis sağlayıcı kaydı, manuel bağlama yok — Laravel paketi otomatik olarak keşfeder. İşte bu kadar. Gerçekten.

ChatGPT’ye İlk API Çağrınızı Yapmak

Artık her şey kurulu, bunu test etme zamanı. Bugün basit bir kontrolör metodu yazacağız. Her şeyin sunucuya düzgün bağlandığını kontrol etmek istiyoruz. Burada standart create metodunu kullanıyoruz.

Bazı gerçek kodlar yazalım. Bir kontrolör oluşturun:

php artisan make:controller AiController

Bu kontrolörü açın ve basit bir test metodu ekleyin:

create([
            'model'    => 'gpt-4',         // Kullanılacak AI modeli
            'messages' => [
                [
                    'role'    => 'user',     // 'user' = soruyu soran kişi
                    'content' => 'Laravel’i bir cümle ile yeni başlayanlar için açıkla.',
                ],
            ],
            'max_tokens' => 100,            // Yanıtın uzunluğunu sınırlayın
        ]);

        // Yanıt nesnesinden metni çıkarın
        $reply = $result->choices[0]->message->content;

        return response()->json(['reply' => $reply]);
    }
}

Bu metodu routes/web.php dosyasında tanımlayın:

use App\Http\Controllers\AiController;

Route::get('/ai-test', [AiController::class, 'test']);

Tarayıcınızda /ai-test adresine gidin. Her şey düzgün yapılandırılmışsa, ChatGPT’nin yanıtını içeren bir JSON yanıtı göreceksiniz. Bu, Laravel uygulamanızda AI yanıtını görmek gerçekten tatmin edici bir an.

Ayrıca choices[0] hakkında kısa bir not: OpenAI, olası yanıtların bir dizisini döndürür. Varsayılan olarak bir yanıt alırsınız. N parametresi ile birden fazla isteyebilirsiniz, ancak %99 kullanım durumu için choices[0] yeterli olacaktır.

Ve maksimum token max_tokens parametresini her zaman ayarlamayı unutmayın. Bunun maliyet kısmında daha fazla ele alacağız, fakat şu andan itibaren başlamanızı öneririm.

Yapay zeka ile ChatGPT’yi Laravel projenizde nasıl kullanabileceğinizi pratik örneklerle öğrenmek için buraya göz atabilirsiniz.