CURL, (Client URL Library Functions)
PHP 4.0.2 versiyonu ile yanında çok işe yarayacak bir kütüphane getirdi..Curl !
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() -[curl initialize]- : Yeni bir curl oturumu başlatır.
curl_setopt() -[curl setoption]- : Curl transferi için seçenekleri parametreler halinde kullanmaya yarar.
curl_exec() -[curl execute]- : curl_setopt() ile belirlenmiş seçenekleri işler ve transfer işlemini yapar.
curl_close()-[curl close]- : Daha önceden curl_init ile açılmış curl oturumunu kapatır.
curl_getinfo() -[curl get information]- : 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 php.net/curl/ adresinden ulaşabilirsiniz.
Curl ile bir sayfanın çıktısını alan örnek bir uygulama yapalım.
PHP Kodu:
<?
// Curl oturum başlatılıyor..
$ch = curl_init();
//URL
curl_setopt($ch, CURLOPT_URL, "http://www.xhandros.net/bl/index.php");
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_exec($ch); // ekrana basılıyor
curl_close($ch); // sunucu hafızasından 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.
PHP Kodu:
<?
$ch = curl_init(); // oturum başlat
//POST adresi
curl_setopt($ch, CURLOPT_URL,"http://www.site.com/test.php");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS,"isim=ahmet&soyad=yilmaz");
curl_exec ($ch);
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.
PHP Kodu:
<?
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,"http://localhost/test.php");
curl_setopt($ch,CURLOPT_REFERER,"ceviz.net");
curl_exec ($ch);
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.
PHP Kodu:
<?
/*
- Yunus Emre Yilmaz / a.k.a
- http://www.ceviz.net dışında kaynak gösterilmeden kullanılamaz.
*/
function dosya_indir($adres,$ad)
{
if (!extension_loaded(curl)) {
die("Extension yuklu degil socket deneyebilirsin");
}
$ch = curl_init("$adres");
if (!$ch) {
die("Curl oturumu baslatamadim..");
}
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$data = curl_exec($ch);
curl_close($ch);
// baglantiyi kapa
$islem = fopen("$ad", "a+");
fwrite($islem, $data);
fclose($islem);
if ($islem) {
echo" Dosya basariyla yuklendi...";
} else {
die("Dosya yuklenemedi");
}
}
// Örnek kullanım
// dosya_indir('http://www.ceviz.net/ .rar',' .rar');
// 1. kısım yuklenecek URL , 2. kısım server'a yuklendigi zamanki dosya adi
?>
Ş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.
Ve 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.
PHP Kodu:
$dlhizi = curl_getInfo($ch,"CURLINFO_SPEED_DOWNLOAD");
gibi..
Tüm bu fonksiyonun yaptığını *nix curl'u ilede yapabilirsiniz.Örneğin ;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/ http://curl.haxxe.se adresleri işinize yarayabilir.
Kolay gelsin ,