Garfield
YZF Admin
PHP ile yapay zekâ kullanmanın en pratik yolu, PHP uygulamasından bir yapay zekâ sağlayıcısının HTTP API’sine istek göndermektir. PHP burada kullanıcı arayüzünü, iş kurallarını ve veritabanını yönetir; model ise gönderdiğiniz metni işler ve yanıt üretir. Aşağıdaki örnekte PHP’nin cURL ve JSON işlevleriyle bir metin isteği gönderip yanıtı ekrana alabilirsiniz. API anahtarını sunucu tarafında sakladığınız sürece bu yapı sohbet, özetleme, sınıflandırma ve içerik taslağı gibi işlerde kullanılabilir.
İşleyiş dört parçadan oluşur: Kullanıcıdan veya uygulamadan girdi alınır, PHP bu girdiyi JSON biçiminde API’ye gönderir, model bir yanıt üretir ve PHP yanıtı JSON’dan çıkarıp uygulamada kullanır. PHP kendi başına yapay zekâ modeli çalıştırmaz; çoğu projede bir API’ye bağlanır.
Örnekte OpenAI Responses API kullanılmaktadır. Farklı bir sağlayıcı tercih ederseniz URL, kimlik doğrulama başlığı, istek gövdesi ve yanıt alanları o sağlayıcının belgelerine göre değiştirilmelidir.
Sunucuda PHP’nin cURL ve JSON desteği etkin olmalıdır. cURL HTTP isteğini gönderir;
Aşağıdaki örnek varsayımsaldır.
Dosyayı sunucuda çalıştırın. Tarayıcıdan veya komut satırından
Sonucu doğrulayın. Yanıtın boş olmaması tek başına içeriğin doğru olduğunu kanıtlamaz. Üretimden gelen metni kullanıcıya göstermeden önce görev için uygunluğunu, hassas bilgi içerip içermediğini ve gerektiğinde insan onayını kontrol edin.
Kullanıcıdan gelen metni doğrudan
JSON biçiminde sonuç gerekiyorsa modelden belirli alanları istemek yeterli olmayabilir. Uygulamada dönen JSON’u
PHP ile yapay zekâ entegrasyonu nasıl çalışır?
İşleyiş dört parçadan oluşur: Kullanıcıdan veya uygulamadan girdi alınır, PHP bu girdiyi JSON biçiminde API’ye gönderir, model bir yanıt üretir ve PHP yanıtı JSON’dan çıkarıp uygulamada kullanır. PHP kendi başına yapay zekâ modeli çalıştırmaz; çoğu projede bir API’ye bağlanır.
Örnekte OpenAI Responses API kullanılmaktadır. Farklı bir sağlayıcı tercih ederseniz URL, kimlik doğrulama başlığı, istek gövdesi ve yanıt alanları o sağlayıcının belgelerine göre değiştirilmelidir.
Gerekli hazırlıklar
Sunucuda PHP’nin cURL ve JSON desteği etkin olmalıdır. cURL HTTP isteğini gönderir;
json_encode() PHP dizisini JSON’a, json_decode() ise API yanıtını PHP değerine dönüştürür. API anahtarını PHP dosyasına doğrudan yazmayın; ortam değişkeni veya sunucunun güvenli yapılandırması üzerinden okuyun.Çalışan temel PHP örneği
Aşağıdaki örnek varsayımsaldır.
OPENAI_API_KEY ortam değişkenine geçerli anahtarınızı, OPENAI_MODEL değişkenine hesabınızda kullanılabilen model kimliğini eklemeniz gerekir.- API anahtarını sunucu ortamına ekleyin. Anahtarı kaynak koduna veya tarayıcıya göndermeyin. Örnek olarak sunucuda
OPENAI_API_KEYveOPENAI_MODELdeğişkenlerini tanımlayın. - PHP dosyanızı oluşturun. Aşağıdaki kodu
ai.phpadıyla kaydedin. Kod, metni JSON olarak gönderir, HTTP hatasını kontrol eder ve yanıt içindeki metin parçalarını birleştirir.
PHP:
<?php
declare(strict_types=1);
$apiKey = getenv('OPENAI_API_KEY');
$model = getenv('OPENAI_MODEL');
if (!$apiKey || !$model) {
http_response_code(500);
exit('API yapılandırması eksik.');
}
$prompt = 'PHP ile yapay zekâ arasındaki ilişkiyi iki kısa paragrafta açıkla.';
$payload = [
'model' => $model,
'input' => [
[
'role' => 'user',
'content' => [
[
'type' => 'input_text',
'text' => $prompt
]
]
]
]
];
$ch = curl_init('https://api.openai.com/v1/responses');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 60,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Authorization: Bearer ' . $apiKey
],
CURLOPT_POSTFIELDS => json_encode($payload, JSON_THROW_ON_ERROR)
]);
$responseBody = curl_exec($ch);
$curlError = curl_error($ch);
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($responseBody === false) {
http_response_code(502);
exit('HTTP isteği başarısız: ' . $curlError);
}
$data = json_decode($responseBody, true, 512, JSON_THROW_ON_ERROR);
if ($statusCode < 200 || $statusCode >= 300) {
http_response_code($statusCode ?: 502);
exit('API hatası: ' . ($data['error']['message'] ?? 'Bilinmeyen hata'));
}
$text = '';
foreach ($data['output'] ?? [] as $item) {
foreach ($item['content'] ?? [] as $content) {
if (($content['type'] ?? '') === 'output_text') {
$text .= $content['text'] ?? '';
}
}
}
if ($text === '') {
exit('Model metin üretmedi. Yanıtın output alanını ve model erişimini kontrol edin.');
}
echo nl2br(htmlspecialchars($text, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'));
Dosyayı sunucuda çalıştırın. Tarayıcıdan veya komut satırından
ai.php dosyasını çağırın. Başarılı durumda modelin ürettiği açıklama görünür; yetkilendirme veya model hatasında kod HTTP durumunu ve API’nin hata mesajını döndürür.Sonucu doğrulayın. Yanıtın boş olmaması tek başına içeriğin doğru olduğunu kanıtlamaz. Üretimden gelen metni kullanıcıya göstermeden önce görev için uygunluğunu, hassas bilgi içerip içermediğini ve gerektiğinde insan onayını kontrol edin.
Girdi ve çıktı nasıl değiştirilir?
Kullanıcıdan gelen metni doğrudan
$prompt değişkenine koyabilirsiniz; ancak uzunluk sınırı, kötü amaçlı talimatlar ve kişisel veriler için doğrulama ekleyin. Örneğin destek talebi özetlemek için şu tür bir girdi kullanılabilir: “Aşağıdaki müşteri mesajını üç maddede özetle. Emin olmadığın bilgileri ekleme: …”. Çıktı, modelin tahminidir; veritabanındaki kesin kayıtların veya uzman incelemesinin yerine otomatik olarak geçirilmemelidir.JSON biçiminde sonuç gerekiyorsa modelden belirli alanları istemek yeterli olmayabilir. Uygulamada dönen JSON’u
json_decode() ile ayrıştırıp alanların gerçekten var olduğunu, türlerinin beklenen biçimde olduğunu ve izin verilen değerleri taşıdığını ayrıca doğrulayın.Yaygın hatalar ve anlamları
- 401 veya 403: API anahtarı eksik, yanlış ya da ilgili kaynağa erişim yetkisi yoktur. Ortam değişkeninin PHP sürecinde okunabildiğini ve anahtarın başında veya sonunda fazladan boşluk bulunmadığını kontrol edin.
- 404 veya model hatası: Model kimliği yanlış olabilir veya hesabınız bu modele erişemiyor olabilir.
OPENAI_MODELdeğerini hesabınızda kullanılabilen bir modelle değiştirin. - 429: İstek hızı veya kullanım limiti aşılmış olabilir. Yeniden deneme, istekleri kuyruklama ve kullanıcı başına sınır koyma mekanizmaları ekleyin.
- Boş yanıt: Yanıtı yalnız sabit bir dizi konumundan okumayın; API çıktısı birden fazla öğe içerebilir. Yukarıdaki döngü, metin parçalarını
outputiçindeki tür alanına göre toplar.