Sayfa yükleniyor

Destek Müşteri Girişi Sepet (0)

Ders 92 – cURL ile HTTP istemci

Bu derste PHP cURL ile GET/POST istekleri, timeout ayarları, hata kontrolü ve güvenli kullanım örnekleri adım adım anlatılıyor.

Ders 92 – cURL ile HTTP istemci

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() ve curl_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_RETURNTRANSFER yanıtı ekrana basmak yerine bir string olarak döndürür.
  • CURLOPT_CONNECTTIMEOUT ve CURLOPT_TIMEOUT ağ 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_VERIFYPEER değerini false yapabilirsiniz, ancak üretimde true olmalı.
  • Timeout aşımı: CURLOPT_CONNECTTIMEOUT ve CURLOPT_TIMEOUT değerlerini ihtiyaca göre artırın. Ağ gecikmesi yüksekse curl_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_CODE ile 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.

Paylaş

Yorumlar

Henüz onaylanmış yorum yok. İlk yorumu siz yazın.

Yorum yaz

Yorumunuz yönetici onayından sonra yayınlanır.

İlgili yazılar

Ders 100 – İleri yol haritası

PHP serisinin son dersinde ileri seviye konular, framework seçimi, Composer ekosistemi, mikro pro…

Ders 99 – Güvenli yapılandırma kontrol listesi

Üretim ortamı için PHP yapılandırma ayarlarını adım adım kontrol eden, hatasız ve güvenli bir yap…

Ders 98 – OpCache ve performans ipuçları

OpCache'ın çalışma prensibi, yapılandırma adımları ve gerçek dünyada performans artırmak için pra…

Ders 97 – Fibers’a kısa bakış (PHP 8.1)

PHP 8.1 ile gelen Fibers özelliğini adım adım öğrenin, kooperatif concurrency kavramını kavrayın …

Demo
Büyütülmüş Görsel