Garfield
YZF Admin
PHP ile yapay zekâ kullanmanın en pratik yolu, PHP uygulamanızdan bir yapay zekâ API’sine HTTPS isteği göndermektir. PHP burada kullanıcı arayüzünü, doğrulamayı ve iş akışını yönetir; model ise metin üretme, sınıflandırma, özetleme veya JSON döndürme işini yapar. Yeni bir uygulama için Responses API gibi güncel bir API yüzeyini kullanabilir, PHP’nin yerleşik cURL desteğiyle ilk isteği SDK kurmadan çalıştırabilirsiniz.
Akış dört parçadan oluşur: kullanıcıdan veri alınır, PHP bu veriyi API isteğine dönüştürür, servis model yanıtını JSON olarak döndürür ve PHP yalnızca gerekli metni kullanıcıya gösterir. API anahtarını tarayıcıya, HTML içine veya Git deposuna koymamalısınız; anahtar yalnızca sunucu tarafındaki PHP kodunda ya da ortam değişkeninde bulunmalıdır.
Aşağıdaki örnek, varsayımsal olarak bir metni Türkçe özetletir. Model adı hesabınızda kullanılabilen bir modelle değiştirilmelidir; geçersiz model adı kullanılırsa istek kimlik doğrulamasından geçse bile model hatası alırsınız.
Ön koşul olarak PHP’nin cURL ve JSON uzantılarının etkin olması, bir API anahtarının sunucuda ortam değişkeni olarak tanımlanması gerekir. Linux veya macOS ortamında örnek değişken tanımı şöyledir:
Dosyayı sunucuda çalıştırın. İstek başarılıysa
HTTP durum kodunu ve gerçek yanıtı kontrol edin. 200–299 arası kod başarılı isteği gösterir. 401 anahtarın eksik veya hatalı olduğunu, 400 istek gövdesinin ya da model adının geçersiz olabileceğini, 429 ise kota veya hız sınırı sorununu gösterir. Üretim ortamında ham yanıtı kullanıcıya göstermeyin; ayrıntıyı sunucu günlüğüne, hassas verileri maskeleyerek yazın.
Aynı yapı yalnızca özetleme için kullanılmaz. Kullanıcı metnini sınıflandırabilir, destek talebine taslak yanıt üretebilir, ürün açıklaması hazırlayabilir veya belirli alanları JSON olarak döndürtebilirsiniz. Sonuç bir uygulama tarafından işlenecekse serbest metin istemek yerine JSON şemasıyla yapılandırılmış çıktı kullanmak daha güvenlidir; böylece PHP’nin beklediği alanların üretildiğini doğrulayabilirsiniz.
Seçim yaparken işin türünü ve hata maliyetini ayırın:
Tablodaki son satır özellikle önemlidir: modelin ürettiği komut, ödeme, silme veya kayıt güncelleme işlemini doğrudan çalıştırmayın. PHP önce yetkiyi, parametreleri, kullanıcı oturumunu ve iş kuralını kendisi doğrulamalı; riskli işlemler için ayrıca kullanıcı onayı istemelidir. Yapay zekâ çıktısı olasılıksal bir öneridir, doğrulanmış iş kuralı veya güvenilir veri kaynağı değildir.
API anahtarını istemci tarafına göndermeyin, kullanıcı girdisini uzunluk ve içerik bakımından sınırlayın, zaman aşımı belirleyin ve hata durumlarını ayrı ele alın. Kişisel veya gizli verileri modele göndermeden önce veri işleme gereksinimlerini, saklama tercihlerini ve kuruluşunuzun güvenlik kurallarını inceleyin. Geliştirme sırasında tuttuğunuz istek ve yanıt günlüklerini iş bitince kaldırın veya maskeleyin.
İlk testte sabit bir örnek metinle başarılı yanıt aldıktan sonra form girdisini bağlayın. Ardından boş giriş, çok uzun giriş, hatalı API anahtarı, geçersiz model ve ağ kesintisi senaryolarını deneyin. Başarılı görünen yanıtın doğruluğunu ayrıca kontrol edin; PHP entegrasyonunun çalışması, modelin ürettiği bilginin doğru olduğu anlamına gelmez.
PHP yapay zekâ entegrasyonu nasıl çalışır?
Akış dört parçadan oluşur: kullanıcıdan veri alınır, PHP bu veriyi API isteğine dönüştürür, servis model yanıtını JSON olarak döndürür ve PHP yalnızca gerekli metni kullanıcıya gösterir. API anahtarını tarayıcıya, HTML içine veya Git deposuna koymamalısınız; anahtar yalnızca sunucu tarafındaki PHP kodunda ya da ortam değişkeninde bulunmalıdır.
Aşağıdaki örnek, varsayımsal olarak bir metni Türkçe özetletir. Model adı hesabınızda kullanılabilen bir modelle değiştirilmelidir; geçersiz model adı kullanılırsa istek kimlik doğrulamasından geçse bile model hatası alırsınız.
PHP ile ilk yapay zekâ isteğini gönderme
Ön koşul olarak PHP’nin cURL ve JSON uzantılarının etkin olması, bir API anahtarının sunucuda ortam değişkeni olarak tanımlanması gerekir. Linux veya macOS ortamında örnek değişken tanımı şöyledir:
export OPENAI_API_KEY="anahtarınız". Anahtarı kaynak koda sabit olarak yazmayın.- API anahtarını sunucu ortamına ekleyin. PHP’nin çalıştığı kullanıcı tarafından okunabilen
OPENAI_API_KEYdeğişkenini tanımlayın. Değişken boşsa uygulama isteği göndermeden hata vermelidir. - PHP dosyanızda kullanıcı metnini belirleyin. Gerçek uygulamada bu değer formdan gelebilir; doğrudan dışarıdan gelen metni güvenilir talimat kabul etmeyin ve gerektiğinde uzunluk sınırı uygulayın.
- Responses API’ye JSON isteği gönderin. Aşağıdaki dosyada
gpt-5.5yerine hesabınızda etkin olan model adını yazın.
PHP:
<?php
$apiKey = getenv('OPENAI_API_KEY');
if (!$apiKey) {
http_response_code(500);
exit('OPENAI_API_KEY tanımlı değil.');
}
$metin = 'PHP, sunucu tarafında çalışan ve web uygulamaları geliştirmede kullanılan bir programlama dilidir.';
$payload = [
'model' => 'gpt-5.5',
'input' => [
[
'role' => 'developer',
'content' => 'Yanıtı Türkçe ver. Kısa ve anlaşılır bir özet üret.'
],
[
'role' => 'user',
'content' => "Aşağıdaki metni iki cümlede özetle:\n\n$metin"
]
]
];
$ch = curl_init('https://api.openai.com/v1/responses');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Authorization: Bearer ' . $apiKey
],
CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
CURLOPT_TIMEOUT => 60
]);
$rawResponse = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$curlError = curl_error($ch);
curl_close($ch);
if ($rawResponse === false) {
http_response_code(502);
exit('API bağlantısı kurulamadı: ' . $curlError);
}
$data = json_decode($rawResponse, true);
if ($httpCode < 200 || $httpCode >= 300) {
$message = $data['error']['message'] ?? 'Bilinmeyen API hatası';
http_response_code(502);
exit('Yapay zekâ isteği başarısız: ' . $message);
}
$cevap = '';
foreach ($data['output'] ?? [] as $item) {
if (($item['type'] ?? '') !== 'message') {
continue;
}
foreach ($item['content'] ?? [] as $content) {
if (($content['type'] ?? '') === 'output_text') {
$cevap .= $content['text'] ?? '';
}
}
}
if ($cevap === '') {
exit('Model metin üretmedi. Yanıtın output alanını ve kullanılan modeli kontrol edin.');
}
echo htmlspecialchars($cevap, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
Dosyayı sunucuda çalıştırın. İstek başarılıysa
cevap değişkenindeki metin ekrana gelir. API yanıtında birden fazla çıktı türü bulunabileceği için kod, doğrudan output[0] konumunu varsaymak yerine metin türündeki içerikleri dolaşır.HTTP durum kodunu ve gerçek yanıtı kontrol edin. 200–299 arası kod başarılı isteği gösterir. 401 anahtarın eksik veya hatalı olduğunu, 400 istek gövdesinin ya da model adının geçersiz olabileceğini, 429 ise kota veya hız sınırı sorununu gösterir. Üretim ortamında ham yanıtı kullanıcıya göstermeyin; ayrıntıyı sunucu günlüğüne, hassas verileri maskeleyerek yazın.
Hangi yapay zekâ işini PHP’ye bağlayabilirsiniz?
Aynı yapı yalnızca özetleme için kullanılmaz. Kullanıcı metnini sınıflandırabilir, destek talebine taslak yanıt üretebilir, ürün açıklaması hazırlayabilir veya belirli alanları JSON olarak döndürtebilirsiniz. Sonuç bir uygulama tarafından işlenecekse serbest metin istemek yerine JSON şemasıyla yapılandırılmış çıktı kullanmak daha güvenlidir; böylece PHP’nin beklediği alanların üretildiğini doğrulayabilirsiniz.
Seçim yaparken işin türünü ve hata maliyetini ayırın:
| İhtiyaç | Uygun yaklaşım | Kontrol edilmesi gereken sonuç |
|---|---|---|
| Özet veya taslak metin | Metin üretimi | Uzunluk, dil ve anlam doğruluğu |
| Kategori veya duygu etiketi | Sınıflandırma istemi | Beklenen etiketlerden biri dönüyor mu? |
| Fatura, form veya kayıt alanları | Yapılandırılmış JSON çıktısı | Şema, tür ve zorunlu alanlar |
| Veritabanı ya da dış servis işlemi | Fonksiyon çağırma ve sunucu doğrulaması | Modelin isteği tek başına çalıştırılmamalı |
Üretim ortamına almadan önce kontrol edin
API anahtarını istemci tarafına göndermeyin, kullanıcı girdisini uzunluk ve içerik bakımından sınırlayın, zaman aşımı belirleyin ve hata durumlarını ayrı ele alın. Kişisel veya gizli verileri modele göndermeden önce veri işleme gereksinimlerini, saklama tercihlerini ve kuruluşunuzun güvenlik kurallarını inceleyin. Geliştirme sırasında tuttuğunuz istek ve yanıt günlüklerini iş bitince kaldırın veya maskeleyin.
İlk testte sabit bir örnek metinle başarılı yanıt aldıktan sonra form girdisini bağlayın. Ardından boş giriş, çok uzun giriş, hatalı API anahtarı, geçersiz model ve ağ kesintisi senaryolarını deneyin. Başarılı görünen yanıtın doğruluğunu ayrıca kontrol edin; PHP entegrasyonunun çalışması, modelin ürettiği bilginin doğru olduğu anlamına gelmez.
Sık sorulan sorular
PHP için mutlaka özel bir yapay zekâ kütüphanesi gerekir mi?
Hayır. REST API’ye cURL ile istek göndererek SDK kullanmadan başlayabilirsiniz. Proje büyüdüğünde hata yönetimi, yeniden deneme, yapılandırılmış çıktı ve testler için bakımı yapılan bir istemci kütüphanesi tercih edilebilir; ancak kullanılan kütüphanenin güncel API yüzeyini desteklediğini doğrulamalısınız.
Model neden yanıt verdiği hâlde PHP boş çıktı gösteriyor?
Yanıtın
output alanı yalnızca tek bir metin öğesinden oluşmayabilir; araç çağrıları veya başka çıktı türleri de bulunabilir. HTTP durum kodunu, JSON ayrıştırma sonucunu ve output içindeki message ile output_text öğelerini kontrol edin. Geliştirme sırasında ham yanıtı yalnızca güvenli sunucu günlüğünde inceleyin; anahtarı veya kişisel verileri günlüğe yazmayın.