Curl Nedir ? Fonksiyonları Nelerdir ?

CURL (Client URL)
1.Curl Nedir ? Curl php’nin değişik türlerdeki severlarla bir çok protokol ile alış-veriş yapması sağlayan bir kütüphanedir.
Curl ile http, ftp, telnet.. gibi protokollerde çalışabilrisiniz. Ancak benim şimdilik bildiğim sadece http kısmı. Http ile post/get işlemleri yapabilir bu işlemlerde cookie kullanabilirsiniz.
Php’ye Curl kütüphanesini eklemek için php.ini dosyanızdan curl’e ait extension satırının başındaki noktalı virgülü silmeniz yeterli olacaktır. (Aşağıda yazacağım kodları PHP4 ile denedim PHP5 ‘te çalışma garantisi yok 😉 )
CURL işlemleri birer oturum olarak çalıştırılır. Bu da demek oluyor ki eğer curl ile bir işlem yapacaksak önce bir curl oturumu başlatmanız lazım. Daha sonra bu işleme ait ayarları yapıp işlemi çalıştırmak sonunda da oturumu kapatmalıyız.

2. CURL Fonksiyonları 2.1.

curl_init()
Bu fonksiyon curl oturumu başlatmaya yarar. Argüman olarak oturumun açılacağı url’yi verebilirsinizde tabii isterseniz argümansız olarak çağırıp url’yi sonradan ayarlayabilirsiniz. Oturum açtığınız zaman bu oturumu bir değişkene atayarak oturum işlemlerini bu değişken üstünden yapmalısınız.
$curl_oturumu =curl_init();
veya
$curl_oturumu =curl_init(“www.keykubad.com/“;
Artık oturum açılmış ve $curl_oturumu adlı değikende tutulmuştur.
2.2. curl_setopt()
Curl_setopt fonksiyonu açtığınız oturumun özelliklerini belirlemek yani değişkenlerini değiştirmek içindir. Bu değişkenlerin bazıları açıklamalarıyla aşağıdadır:
– CURLOPT_URL : Oturumun açılacağı adresi bu değişken tutmaktadır. Eğer curl_init fonksiyonunu argümansız olarak çağırdıysanız burada oturumun açılacağı adresi mutlaka belirtmeniz lazım. Curl_init ile adresi verdiyseniz bile burada tekrar adresi değiştirebilirsiniz.
curl_setopt($curl_oturumu, CURLOPT_URL, “http://www.keykubad.com“);
– CURLOPT_HEADER: Curl oturumunun çıktısında header’ların gösterilip gösterilmeyeceğine ait değişkendir. Eğer çıktıda header’lar görünmesin istiyorsanız bu değişkene sıfır (0) atamalısınız. Sıfır haricindeki değerlerde header çıktıda gösterilir.
curl_setopt($curl_oturumu, CURLOPT_HEADER, 1);
curl_setopt($curl_oturumu, CURLOPT_HEADER, 0);
– CURLOPT_POST: Eğer Curl ile herhangi bir adresteki forma post ile veri yollamak istiyorsanız bu değişlene sıfır haricinde bir değer atamanız gereklidir.
curl_setopt($curl_oturumu, CURLOPT_POST, 1);
curl_setopt($curl_oturumu, CURLOPT_POST, 0);
– CURLOPT_POSTFIELDS : Post işlemi yapacaksanız buraya yollıyacağınız değişken isimlerini ve değerlerini girmelisiniz.
curl_setopt($curl_oturumu, CURLOPT_POSTFIELDS,”yazan=undertaker&okuyan=keykubad_uyeleri”);
curl_setopt($curl_oturumu, CURLOPT_POSTFIELDS, $post_degerleri);
– CURLOPT_FOLLOWLOCATION : Çalıştırdığınız oturumda gelen header içinde “Location:adres” gibi bir yönlendirme varsa bu yönlendirmeye uyup uymuyacağı bu değişken ile belirlenir.
curl_setopt($curl_oturumu, CURLOPT_FOLLOWLOCATION, 1);
curl_setopt($curl_oturumu, CURLOPT_FOLLOWLOCATION, 0);
– CURLOPT_REFERER : Bu değişken oturum açtığınız siteye header bilgisi ile geldiğiniz adresi (hangi siteden oraya geldiğiniz) istediğiniz gibi değiştirebilmenizi sağlar.
curl_setopt($curl_oturumu,CURLOPT_REFERER, “www.keykubad.com“);
– CURLOPT_USERAGENT : Oturum açılan siteye sizi tanıtan bilgileri içieren (ör: “Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0) bir header olan useragent’ı bu değişken ile değiştirebilirsiniz. (Bu değişkene “googlebot” atadığınız zaman bazı forumların üyelik gerektiren sayfalarına direk erişebilirsiniz 😀 )
curl_setopt($curl_oturumu, CURLOPT_USERAGENT, “UndeRTakeR”);
– CURLOPT_COOKIE : Oturum açılan siteye yollamak istediğiniz cookie “içeriğini” bu değişken tutmaktadır.
curl_setopt($curl_oturumu, CURLOPT_COOKIE, “cookie içinde bunlar olsun”);
– CURLOPT_COOKIEFILE : Eğer cookie içeriğini string olarak değilde bir dosya içerisinden yollamak istiyorsanız bu değişkene dosya adını yazarak yapabilirsiniz.
curl_setopt($curl_oturumu, CURLOPT_COOKIEFILE, ‘giden_cookie_dosyasi.txt’);
– CURLOPT_COOKIEJAR : Oturum açarak işlem yaptığınız sayfadan gelen cookie’yi kaydetmek istiyorsanız bu değişkene kaydedilecek dosya adını yazmalısınız.
curl_setopt($curl_oturumu, CURLOPT_COOKIEJAR, ‘gelen_cookie_dosyasi.txt’);
– CURLOPT_RETURNTRANSFER : Curl oturumunu çalıştırdığınız zaman gelen veriyi çıktı olarak almak yerine değilde bir değişkene atanmasını istiyorsanız bu değişkene true veya 1 olarak atamalısınız. Aksi halde gelen çıktı direk olarak ekrana bastırılacaktır.
curl_setopt($curl_oturumu, CURLOPT_RETURNTRANSFER, 1); // Açık
curl_setopt($curl_oturumu, CURLOPT_RETURNTRANSFER, 0); // Kapalı
– CURLOPT_FILE : Curl işlemi çalıştığında gelen veriyi dosyaya yazmak istiyorsanız buraya dosyayı açtığınız değişkeni yazmalısınız.
$dosya = fopen(“gelen_veriler_yazilacak.txt”, “w”);
curl_setopt($curl_oturumu, CURLOPT_FILE, $dosya);
– CURLOPT_NOBODY : Curl işlemi çalıştırıldığ zaman çıktıda body bilgileri gelmesin istiyorsanız (örneğin sadece header’ı istediğiniz zaman bunu kullanabilirsiniz) bu değişkene 1 veya true atamalısınız.
curl_setopt($curl_oturumu, CURLOPT_NOBODY, 1);
curl_setopt($curl_oturumu, CURLOPT_NOBODY, 0);
– CURLOPT_TIMEOUT : Curl işlemi çalıştırılıdığı zaman fonksiyonun çalışacağı en uzun süre sınırı bu değişkende tutulur.
curl_setopt($cUrl, CURLOPT_TIMEOUT, $max_calisacagi_saniye);

Eğer Curl oturumunuzda proxy kullanmak istiyorsanız aşağıdaki 3 ayarı da yapmanız gereklidir:
curl_setopt($curl_oturumu, CURLOPT_HTTPPROXYTUNNEL, 1);
curl_setopt($curl_oturumu, CURLOPT_PROXY, ‘proxy_ismi_VEYA_ip_adresi:proxy_portu’);
curl_setopt($curl_oturumu, CURLOPT_PROXYUSERPWD, ‘kullanici_adi:sifre’);
– CURLOPT_HTTPPROXYTUNNEL : Bu değişken ile proxy kullanacağımızı belirtiyoruz.
– CURLOPT_PROXY : Bu değişken ise kullanacağımız proxy adını veya ip adresini tutmaktadır.
– PROXYUSERPWD : Eğer kullanılan proxy şifreli ise bu değişkene kullanıcı adını ve şifreyi üstteki formatta girmelisiniz.

2.3. curl_exec()
Bu fonksiyon setpot ile gerekli ayarları yaptıktan sonra oturumu çalıştırmanızı sağlar. Dönen veriyi eğer setopt ile ayarını yaptıysanız dosyaya, değişkene veya çıktı olarak ekrana aktarabilirsiniz.

2.4. curl_close()
Curl oturumuyla işiniz bittiği zaman php’yi yormamak için kapatırsak iyi olur 🙂
2.5 curl_version()
Kullandığınız server’a ait curl versiyonunu verir. http://curl.haxx.se adresinden yeni versiyonları indirebilirsiniz.

Bu fonksiyonlardan başka Curl’ün çoklu olarak çalışması için multi fonksiyonları var ancak onları henüz kullanmadığım için birşeyler yazamıyacağım.