Curl Kütüphanesinin Php ile Kullanımı

CURL , ( Client URL Library Functions)

PHP 4.0.2 versiyonu ile yanında çok işe yarayacak bir kütüphane getirdi. Curl kütüphanesiyle upload/download, GET/POST işlemleri, çerez ve proxy yollama işlemleri, kullanıcı, şifre onaylama sayfaları(auth.) yapılabilir.

Bu makaleyi okumadan önce sunucunuzda curl yüklü olup olmadığından emin olun. Eğer yüklü değilse http://curl.haxx.se/libcurl/php/install.html adresinden nasıl yükleme & kurulum yapıldığına bakabilirsiniz.
Curl oturumlarında sıkça kullanacağımız birkaç fonksiyon var.

curl_init() : Yeni bir curl oturumu başlatır.
curl_setopt() : Curl transferi için seçenekleri parametreler halinde kullanmaya yarar.
curl_exec() : curl_setopt() ile belirlenmiş seçenekleri işler ve transfer işlemini yapar.
curl_close() : Daha önceden curl_init ile açılmış curl oturumunu kapatır.
curl_getinfo() : Yapılan curl işlemi hakkında çeşitli bilgilere ulaşmak için kullanılır.

Bu fonksiyonların hakkında daha ayrıntılı bilgiye tıklayarak (php manual) ulaşabilirsiniz. Curl ile bir sayfanın çıktısını alan örnek bir uygulama yapalım.

1.
// Curl oturum baslatiliyor.
2.
$ch = curl_init();
3.

4.
// URL
5.
curl_setopt($ch, CURLOPT_URL, "http://www.xhandros.net/bl/index.php");
6.
curl_setopt($ch, CURLOPT_HEADER, 0);
7.

8.
curl_exec($ch); // ekrana basiliyor
9.
curl_close($ch); // sunucu hafizasindan siliniyor


Bu kod URL içeriğini sayfaya basacaktır. curl_init ile yeni bir oturum başlatıldı, setopt ile transfer seçenekleri tanımlandı, işlem yapıldı ve curl_close ile hafızadan silindi. curl_setopt içindeki header parametresi sayfa çıktısını almak için gerekli. Url parametresi ise çıktısı alınacak adresi temsil ediyor. curl_init("$adres"); şeklinde yapılma imkanıda mevcut.
Şimdide curl ile localde olmayan bir sunucuya POST olarak veri gönderelim.

1.
$ch = curl_init(); // oturum baslat
2.
// POST adresi
3.
curl_setopt($ch, CURLOPT_URL,"http://www.site.com/test.php");
4.

5.
curl_setopt($ch, CURLOPT_POST, 1);
6.
curl_setopt($ch, CURLOPT_POSTFIELDS,"isim=ahmet&soyad=yilmaz");
7.

8.
curl_exec ($ch);
9.
curl_close ($ch);


POSTFIELDS seçeneğinde, normalde nasıl GET ile browser üzerinden veri yolluyorsak aynı şekilde yolluyoruz. Bu şekilde üyelik isteyen sitelere otomatik olarak üyelikler açılabilir. (foreach yardımıyla).çeşitli log sistemlerinde kullanılabilir. Mesela yazıp, sattığınız sistemlerin nerelerde kullanıldığını loglamak için kendi sunucunuza nerede kullanıldığına ait çeşitli bilgiler yollayabilirsiniz.

curl ile sockets kütüphanesinde olduğu gibi sahte isteklerde yollamak mümkündür. Örneğin; referer bilgisini istediğimiz şekilde değiştirip istek gönderebiliriz.

1.
$ch = curl_init();
2.
curl_setopt($ch, CURLOPT_URL,"http://localhost/test.php");
3.
curl_setopt($ch,CURLOPT_REFERER,"ceviz.net");
4.

5.
curl_exec ($ch);
6.
curl_close ($ch);


CURLOPT_REFERER parametresini istediğimiz şekilde değiştirdik :-) Bu şekilde ".htaccess" ile yapılan korumalarda aşılabiliyor. Diğer sayfada öğrendiklerimizle birkaç CURLOPT parametresi ekleyip bir dosya indirme fonksiyonu yazalım.

1.
2.
/*
3.
- Yunus Emre Yilmaz / a.k.a yns
4.
- http://www.ceviz.net disinda kaynak gösterilmeden kullanilamaz.
5.
*/
6.

7.
function dosya_indir($adres,$ad)
8.
{
9.
if (!extension_loaded(curl)) {
10.

11.
die("Extension yuklu degil socket deneyebilirsin");
12.
}
13.

14.
$ch = curl_init("$adres");
15.
if (!$ch) {
16.
die("Curl oturumu baslatamadim..");
17.

18.
}
19.
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
20.
$data = curl_exec($ch);
21.
curl_close($ch);
22.

23.
// baglantiyi kapa
24.

25.
$islem = fopen("$ad", "a+");
26.
fwrite($islem, $data);
27.
fclose($islem);
28.

29.
if ($islem) {
30.
echo" Dosya basariyla yuklendi...";
31.
} else {
32.
die("Dosya yuklenemedi");
33.
}
34.
}
35.
// Örnek kullanim
36.
// dosya_indir('http://www.ceviz.net/yns.rar','yns.rar');
37.
// 1. kisim yuklenecek URL , 2. kisim server'a yuklendigi zamanki dosya adi
38.
?>


Şimdi gelelim sistemin nasıl işlediğine ;

İlk once curl'un yüklü olup olmadığına bakılıyor, eğer yüklü değilse hata mesajı veriliyor. Curl işlemi başlatıldıktan sonra CURLOPT_RETURNTRANSFER seçeneğiyle curl_exec()'ten dönen dener sayfaya çıktı olarak verilmez, tanımlandığı değişkende, örnekte $data tutulur. $data değişkenine adres'in bilgileri alındıktan sonra dosya yazma işlemi fonksiyonları ile sunucuda yeni dosya oluşturulur. Sonra dosya indirme işlemi tamamlanır. Eğer bu işlemi local olmayan sunucunuzda yaparsanız çok büyük dosyaları çok az bir zamanda çekebileceğinizi görebilirsiniz.

Ben yaptığım testlerde saniyede 400 kb civarı çekiyordum :-) İşleme curl_Getinfo altında CURLINFO_SPEED_DOWNLOAD parametresi eklerseniz download hızını ölçebilirsiniz.

1.
$dlhizi = curl_getInfo($ch,"CURLINFO_SPEED_DOWNLOAD");


Tüm bu fonksiyonun yaptığını *nix curl'u ilede yapabilirsiniz. Örneğin;

1.
system("curl -o dosyaadi.rar http://www.ceviz.net/dosyaadi.rar ");


aynı işi görecektir. Ama system, passthru gibi komutlar güvenlik nedeniyle genelde yasaklıdır.

Genel olarak curl kullanımını anlamışsınızdır umarım. Şu an için curl hakkında daha fazla bilgi bulmak isterseniz 2 adresle sınırlısınız. http://www.php.net/curl/ ve http://curl.haxxe.se adresleri işinize yarayabilir.