Web uygulamaları dış hizmetlerle iletişim kurmak zorundadır. API çağrıları, uzaktan veri çekme, dosya yükleme gibi senaryolarda PHP'nin en güçlü araçlarından biri cURLdır. Bu dersimizde cURL'un temellerini, GET ve POST isteklerini, timeout yönetimini, SSL doğrulamasını ve hata kontrolünü ayrıntılı olarak inceleyecek, örnek kodlarla pekiştireceğiz.
Temeller
cURL (Client URL Library), farklı protokoller (HTTP, HTTPS, FTP vb.) üzerinden veri transferi yapmayı sağlayan bir PHP uzantısıdır. cURL kullanmak için php_curl uzantısının yüklü olması gerekir. phpinfo() çıktısında "cURL support" satırını kontrol ederek kurulumun doğruluğunu teyit edebilirsiniz.
- cURL oturumu
curl_init()ile başlatılır. - İstek seçenekleri
curl_setopt()ile ayarlanır. - İşlem
curl_exec()ile yürütülür. - Sonuç ve hata bilgileri
curl_getinfo()vecurl_error()ile alınır. - Oturum
curl_close()ile serbest bırakılır.
Adım adım GET ve POST istekleri
Aşağıdaki örneklerde iki ayrı senaryo gösterilmektedir. İlk örnek basit bir GET isteği, ikinci örnek ise POST ile veri gönderimini ele alır.
Bu kodda:
CURLOPT_RETURNTRANSFERyanıtı ekrana basmak yerine bir string olarak döndürür.CURLOPT_CONNECTTIMEOUTveCURLOPT_TIMEOUTağ gecikmelerine karşı koruma sağlar.- HTTP durum kodu kontrolü, 200 dışındaki yanıtları erken yakalar.
- JSON decode işlemi hata kontrolüyle birlikte yapılır.
'demo_user',
'password' => 'S3cr3tP@ss'
];
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
// SSL doğrulama – üretim ortamında true olmalı
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (curl_errno($ch)) {
echo 'cURL Hatası: ' . curl_error($ch);
} elseif ($httpCode !== 200) {
echo "HTTP $httpCode - Giriş başarısız";
} else {
$data = json_decode($response, true);
if (json_last_error() === JSON_ERROR_NONE) {
echo "Token: " . $data['token'];
} else {
echo 'Yanıt JSON değil';
}
}
curl_close($ch);
?>
Sık karşılaşılan hatalar ve çözüm önerileri
- SSL sertifika hatası: Yerel geliştirme ortamında
CURLOPT_SSL_VERIFYPEERdeğerinifalseyapabilirsiniz, ancak üretimdetrueolmalı. - Timeout aşımı:
CURLOPT_CONNECTTIMEOUTveCURLOPT_TIMEOUTdeğerlerini ihtiyaca göre artırın. Ağ gecikmesi yükseksecurl_getinfo()ile gerçek süreyi loglayın. - HTTP 4xx/5xx kodları: cURL yanıtı başarılı döndürse bile sunucu hatalı bir kod gönderebilir.
CURLINFO_HTTP_CODEile kontrol edin ve kullanıcıya genel bir mesaj gösterin. - JSON decode hatası: Yanıtın gerçekten JSON olduğundan emin olun.
json_last_error_msg()ile detay alın.
Özet ve en iyi uygulamalar
cURL, PHP'de dış servislerle iletişim kurmanın temel taşıdır. Dersimizde şunları öğrendik:
- cURL oturumu oluşturma, seçenek ayarlama ve kapatma adımları.
- GET ve POST isteklerinde parametre gönderimi ve yanıt işleme.
- Timeout, SSL doğrulama ve HTTP durum kodu kontrolü ile güvenli istekler.
- Hata yönetimi: cURL hataları, HTTP hataları ve JSON çözümleme hataları ayrı ayrı ele alınmalı.
Bu prensipleri bir fonksiyon veya sınıf içinde paketleyerek tekrar kullanılabilir bir HTTP istemci oluşturabilirsiniz. Örneğin class HttpClient içinde request($method, $url, $data = []) metodu tanımlamak, kod tekrarını önler ve test edilebilirliği artırır.
SSS
Soru 1: cURL ile dosya yüklemek nasıl yapılır?
Cevap: CURLOPT_POSTFIELDS içine @/path/to/file (PHP 5.5 öncesi) ya da curl_file_create() (PHP 5.5+) kullanarak multipart/form-data gönderilir.
Soru 2: cURL oturumunu tekrar kullanabilir miyim?
Cevap: Evet, aynı curl_init() nesnesi üzerinde birden fazla curl_setopt() ve curl_exec() çağrısı yapabilirsiniz. Ancak her isteğin ardından curl_reset() ile ayarları sıfırlamak temiz bir başlangıç sağlar.
Soru 3: cURL hatalarını loglamak için en iyi yöntem nedir?
Cevap: curl_error() ve curl_errno() değerlerini bir log dosyasına veya izleme sistemine (ör. Monolog) yazmak, sorunları hızlıca tanılamanızı sağlar.
Yorumlar
Henüz onaylanmış yorum yok. İlk yorumu siz yazın.
Yorum yaz
Yorumunuz yönetici onayından sonra yayınlanır.