(PHP 4 >= 4.0.2, PHP 5)
curl_setopt — Bir cURL aktarım seçeneği tanımlar
Belirtilen cURL oturum tanıtıcısı üzerinde bir seçenek tanımlar.
ct
curl_init() işlevinden dönen bir cURL tanıtıcısı.
seçenek
Atanacak CURLOPT_XXX seçeneği.
değer
Atanacak seçenek
değeri.
değer
değiştirgesine aşağıdaki
seçenek
'ler için bir mantıksal değer
atanmalıdır:
Seçenek | Atanacak değer |
Ek bilgi |
---|---|---|
CURLOPT_AUTOREFERER |
Bir Location: yönlendirmesini izleyen bir
isteğin Referer: başlığının özdevinimli
olarak atanması için TRUE olmalıdır.
|
|
CURLOPT_BINARYTRANSFER |
CURLOPT_RETURNTRANSFER kullanıldığında ham
çıktı dönmesi için TRUE olmalıdır.
|
|
CURLOPT_COOKIESESSION |
Oturumu yeni bir çerez oturumu olarak imlemek için TRUE
olmalıdır. libcurl'un önceki oturumdan yüklenecek oturum
çerezlerini yoksaymasına sebep olur. Öntanımlı olarak libcurl,
oturum çerezi olup olmadıklarına bakmaksızın tüm çerezleri daima
saklar ve yükler. Oturum çerezleri için belli bir zaman aşımı
yoktur ve atandıkları oturum boyunca etkindirler.
|
|
CURLOPT_CRLF |
Aktarım sırasında Unix satırsonlarını CRLF satırsonlarına
dönüştürmek için TRUE olmalıdır.
|
|
CURLOPT_DNS_USE_GLOBAL_CACHE |
Küresel DNS önbelleğini kullanmak için TRUE olmalıdır. Bu
seçenek evreler bakımından güvenli değildir ve öntanımlı olarak
etkindir.
|
|
CURLOPT_FAILONERROR |
Dönen HTTP kodunun 400'e eşit veya büyük olması durumunda sessiz
kalmak için TRUE olmalıdır. Öntanımlı davranış kodu yok sayıp
sayfayı normal olarak döndürmektir.
|
|
CURLOPT_FILETIME |
Uzak belgenin değişiklik tarihi alınmaya çalışılacaksa TRUE
olmalıdır. Bu değer, curl_getinfo() ile
CURLINFO_FILETIME seçeneği kullanılarak
alınabilir.
|
|
CURLOPT_FOLLOWLOCATION |
HTTP başlığının bir parçası olarak sunucunun gönderdiği
"Location: " başlığını izlemek için TRUE
olmalıdır. Bu izleme, CURLOPT_MAXREDIRS
tanımlanmadıkça ardışıktır, yani PHP gönderilen tüm
"Location: " başlıklarını izleyecektir.
|
|
CURLOPT_FORBID_REUSE |
İşlem bittiğinde yeniden kullanım için havuzlanmaksızın ve
beklemeksizin bağlantının mutlaka kapatılması için
TRUE olmalıdır.
|
|
CURLOPT_FRESH_CONNECT |
Önbellektekini kullanmaksızın yeni bir bağlantı açmak için
TRUE olmalıdır.
|
|
CURLOPT_FTP_USE_EPRT |
Etkin FTP indirmeleri yapılırken EPRT (ve LPRT) kullanmak için
TRUE olmalıdır. EPRT ve LPRT'yi iptal edip sadece PORT
kullanmak için FALSE kullanın.
|
|
CURLOPT_FTP_USE_EPSV |
PASV'ye dönmeden önce FTP aktarımı için önce EPSV komutunu
denemek için TRUE olmalıdır.
|
|
CURLOPT_FTPAPPEND |
Uzak dosyanın üzerine yazmak yerine sonuna ekleme yapmak için
TRUE olmalıdır.
|
|
CURLOPT_FTPASCII |
CURLOPT_TRANSFERTEXT için takma addır; onun
yerine bunu kullanın.
|
|
CURLOPT_FTPLISTONLY |
Sadece FTP dizinindeki isimler listelenecekse TRUE olmalıdır.
|
|
CURLOPT_HEADER |
Çıktıda başlık bulunması için TRUE olmalıdır.
|
|
CURLOPT_HTTPGET |
HTTP istek yönteminin GET olması için TRUE olmalıdır. GET
öntanımlı olduğundan bu sadece istek yöntemi değiştiğinde işe
yarar.
|
|
CURLOPT_HTTPPROXYTUNNEL |
Belirtilen HTTP vekili üzerinden tünel kullanılacaksa TRUE
olmalıdır.
|
|
CURLOPT_MUTE |
cURL işlevleriyle ilgili olarak tamamen sessiz kalınması için
TRUE olmalıdır.
|
|
CURLOPT_NETRC |
Bağlantı kurulan uzak site için kullanıcı adını ve parolasını
bulmak amacıyla ~/.netrc dosyasına
bakılmasını sağlamak için TRUE olmalıdır.
|
|
CURLOPT_NOBODY |
Çıktıdaki gövdeyi dışlamak için TRUE olmalıdır. Ardından istek
yöntemi HEAD yapılır. Bunu FALSE olarak değiştirmek yöntemi
GET yapmaz.
|
|
CURLOPT_NOPROGRESS |
cURL aktarımının gelişim göstergesini kapatmak için
|
|
CURLOPT_NOSIGNAL |
PHP sürecine bir sinyal gönderilmesine sebep olan cURL
işlevlerini yoksaymak için TRUE olmalıdır. Çok evreli
SAPI'lerde, öntanımlı olarak böyledir; dolayısıyla zaman aşımı
seçenekleri hala kullanılabilir olur.
|
cURL 7.10'da eklendi. |
CURLOPT_POST |
Normal bir HTTP POST yapmak için TRUE olmalıdır. Bu, HTML
formlarında sıklıkla kullanılan normal
application/x-www-form-urlencoded çeşididir.
|
|
CURLOPT_PUT |
Bir dosyaya HTTP PUT yapmak için TRUE olmalıdır. Bu dosya
CURLOPT_INFILE ve
CURLOPT_INFILESIZE ile atanmalıdır.
|
|
CURLOPT_RETURNTRANSFER |
Aktarımı doğrudan çıktılamak yerine bir dizge olarak
curl_exec() işlevinden döndürmek için TRUE
olmalıdır.
|
|
CURLOPT_SSL_VERIFYPEER |
cURL'un eş sertifikasını doğrulamayı durdurması için FALSE
olmalıdır. Doğrulayıcı diğer sertifikalar
CURLOPT_CAINFO seçeneği ile
belirtilebileceği gibi CURLOPT_CAPATH
seçeneği ile bir sertifika dizini de belirtilebilir. Ayrıca,
CURLOPT_SSL_VERIFYHOST seçeneği de TRUE
veya FALSE olabilir (öntanımlı olarak 2 olan
CURLOPT_SSL_VERIFYPEER iptal edilmişse).
|
cURL 7.10 itibariyle öntanımlı olarak TRUE 'dur.
|
CURLOPT_TRANSFERTEXT |
FTP aktarımlarında ASCII kip kullanmak için TRUE olmalıdır.
LDAP için veri, HTML yerine salt metin olarak alınır. Windows
sistemlerinde, STDOUT'a ikil kip atanmaz.
|
|
CURLOPT_UNRESTRICTED_AUTH |
(CURLOPT_FOLLOWLOCATION kullanarak)
Location: yönlendirmelerini izlerken konut
ismi değişse bile, kullanıcı ve parola gönderimini sağlamak için
TRUE olmalıdır.
|
|
CURLOPT_UPLOAD |
Karşıya yüklemeye hazır olmak için TRUE olmalıdır.
|
|
CURLOPT_VERBOSE |
Ayrıntılı bilgi çıktılanması için TRUE olmalıdır. Çıktıyı
standart hataya veya CURLOPT_STDERR
kullanarak belirtilen dosyaya yazar.
|
değer
değiştirgesine aşağıdaki
seçenek
'ler için bir tamsayı atanmalıdır:
Seçenek | Atanacak değer |
Ek bilgi |
---|---|---|
CURLOPT_BUFFERSIZE |
Okuma için kullanılacak tamponun boyutu. Ancak, bu isteğin yerine getirileceğinin bir garantisi yoktur. | cURL 7.10'da eklendi. |
CURLOPT_CLOSEPOLICY |
CURLCLOSEPOLICY_LEAST_RECENTLY_USED veya
CURLCLOSEPOLICY_OLDEST olabilir.
Bunlardan başka CURLCLOSEPOLICY_ önekli üç
sabit daha vardır, ancak, bunlar cURL tarafından henüz
desteklenmemektedir.
|
|
CURLOPT_CONNECTTIMEOUT |
Saniye cinsinden bağlantının deneneceği süre. Bağlantının sonsuza kadar beklenmesi için 0 kullanın. | |
CURLOPT_CONNECTTIMEOUT_MS |
Milisaniye cinsinden bağlantının deneneceği süre. Bağlantının sonsuza kadar beklenmesi için 0 kullanın. | cURL 7.16.2'de eklendi. PHP 5.2.3'ten beri kullanılabilmektedir. |
CURLOPT_DNS_CACHE_TIMEOUT |
Saniye cinsinden DNS girdilerinin bellekte kalma süresi. Bu seçeneğin öntanımlı değeri 120 saniyedir. | |
CURLOPT_FTPSSLAUTH |
FTP kimlik doğrulama yöntemi (etkinse): CURLFTPAUTH_SSL (önce SSL denenir), CURLFTPAUTH_TLS (önce TLS denenir) veya CURLFTPAUTH_DEFAULT (cURL karar verir). | cURL 7.12.2'de eklendi. |
CURLOPT_HTTP_VERSION |
CURL_HTTP_VERSION_NONE (öntanımlı olup
hangi sürümün kullanılacağına CURL karar verir),
CURL_HTTP_VERSION_1_0 (HTTP/1.0 zorlanır),
veya CURL_HTTP_VERSION_1_1 (HTTP/1.1
zorlanır).
|
|
CURLOPT_HTTPAUTH |
HTTP kimlik doğrulama yöntem(ler)i:
Birden fazla yöntem belirtilecekse sabitler arasında bitsel VEYA işleci kullanılabilir. Bu takdirde, cURL belirtilen yöntemlerden hangisinin sunucu tarafından en iyi desteklendiğini saptamaya çalışır ve onu kullanır.
|
|
CURLOPT_INFILESIZE |
Dosya karşıya yüklenirken dosyanın bayt cinsinden tahmini boyutu. | |
CURLOPT_LOW_SPEED_LIMIT |
PHP'nin aktarımın çok yavaş olduğunu varsayarak çıkması için,
CURLOPT_LOW_SPEED_TIME saniye süresince
aktarımın altında kalacağı, saniyedeki bayt sayısı olarak
aktarım hızı.
|
|
CURLOPT_LOW_SPEED_TIME |
PHP'nin aktarımın çok yavaş olduğunu varsayarak çıkması için,
aktarım hızının CURLOPT_LOW_SPEED_LIMIT 'in
altında kalacağı, saniye cinsinden aktarım süresi.
|
|
CURLOPT_MAXCONNECTS |
İzin verilen kalıcı bağlantıların azami sayısı. Bu sınıra
ulaşıldığında hangi bağlantının kapatılacağını saptamak için
CURLOPT_CLOSEPOLICY kullanılır.
|
|
CURLOPT_MAXREDIRS |
İzlenecek HTTP yönlendirmelerinin azami sayısı.
CURLOPT_FOLLOWLOCATION ile birlikte
kullanılır.
|
|
CURLOPT_PORT |
Bağlantı için kullanılacak ikincil port numarası. | |
CURLOPT_PROTOCOLS |
Olası protokol seçenekleri:
|
cURL 7.19.4'te eklendi. |
CURLOPT_PROXYAUTH |
Vekil bağlantı için kullanılacak HTTP kimlik doğrulama
yöntem(ler)i. CURLOPT_HTTPAUTH
seçeneğindeki bit maskesi kullanılır. Vekil kimlik doğrulaması
için şimdilik sadece CURLAUTH_BASIC ve
CURLAUTH_NTLM desteklenmektedir.
|
cURL 7.10.7'de eklendi. |
CURLOPT_PROXYPORT |
Bağlanılacak vekil port numarası. Port numarası
CURLOPT_PROXY ile de atanabilir.
|
|
CURLOPT_PROXYTYPE |
CURLPROXY_HTTP (öntanımlı) veya
CURLPROXY_SOCKS5 olabilir.
|
cURL 7.10'da eklendi. |
CURLOPT_REDIR_PROTOCOLS |
CURLPROTO_* değerlerinden oluşan bir bit
maskesi. CURLOPT_FOLLOWLOCATION etkin
olduğu takdirde, bir yönlendirme izlenirken libcurl'un aktarımda
kullanacağı protokoller belirtilir. Bu seçenek, yönlendirmelerde
aktarımın belli protokollerle sınırlanmasına imkan verir.
libcurl öntanımlı olarak FILE ve SCP haricinde tüm protokollere
izin verir. Bu davranış, izlemelerde tüm protokollerin koşulsuz
olarak desteklendiği 7.19.4 öncesi sürümlerden farklıdır.
Protokol sabitleri için CURLOPT_PROTOCOLS
seçeneğine de bakınız.
|
cURL 7.19.4'te eklendi. |
CURLOPT_RESUME_FROM |
Bayt cinsinden aktarımın devam ettirileceği konum. | |
CURLOPT_SSL_VERIFYHOST |
SSL eş sertifikasında ortak bir ismin varlığına bakılması için 1 olmalıdır. Ortak bir ismin varlığının yanında sağlanan konak ismi ile eşleşmenin de aranması için 2 olmalıdır. | |
CURLOPT_SSLVERSION |
Kullanılacak SSL sürümü (2 veya 3). Öntanımlı olarak PHP bunu kendi saptamaya çalışırsa da bazı durumlarda bunun elle belirtilmesi gerekir. | |
CURLOPT_TIMECONDITION |
CURLOPT_TIMEVALUE değerinin nasıl ele
alınacağı belirtilir. Sayfayı sadece,
CURLOPT_TIMEVALUE ile belirtilen süre
içinde değiştirilmediği takdirde döndürmek için
CURL_TIMECOND_IFMODSINCE kullanın. Sayfa
değişmişse, CURLOPT_HEADER seçeneğinin
TRUE olduğu varsayımıyla "304 Not Modified"
(304 değişiklik yok) başlığı döndürülür. Bu davranışı ters
çevirmek için CURL_TIMECOND_IFUNMODSINCE
kullanın. CURL_TIMECOND_IFMODSINCE
öntanımlıdır.
|
|
CURLOPT_TIMEOUT |
cURL işlevlerinin çalışmasına izin verilecek azami saniye sayısı. | |
CURLOPT_TIMEOUT_MS |
cURL işlevlerinin çalışmasına izin verilecek azami milisaniye sayısı. | cURL 7.16.2'de eklendi. PHP 5.2.3'ten beri kullanılabilmektedir. |
CURLOPT_TIMEVALUE |
1 Ocak 1970'den beri geçen saniye sayısı. Bu değer
CURLOPT_TIMECONDITION tarafından
kullanılır. CURL_TIMECOND_IFMODSINCE
öntanımlıdır.
|
değer
değiştirgesine aşağıdaki
seçenek
'ler için bir dizge atanmalıdır:
Seçenek | Atanacak değer |
Ek bilgi |
---|---|---|
CURLOPT_CAINFO |
Eşle doğrulanacak bir veya daha fazla sertifikanın tutulduğu
dosyanın ismi. Bu sadece
CURLOPT_SSL_VERIFYPEER ile birlikte
kullanıldığında anlamlıdır.
|
|
CURLOPT_CAPATH |
Çok sayıda CA sertifikasının tutulduğu dizinin yolu.
CURLOPT_SSL_VERIFYPEER seçeneğiyle birlikte
kullanılır.
|
|
CURLOPT_COOKIE |
HTTP isteğinde kullanılacak "Cookie: " başlığının içeriği. Bir noktalı virgülden sonra gelen bir boşlukla ayrılarak çok sayıda çerez belirtilebilir ("meyve=elma; renk=turkuaz" gibi). | |
CURLOPT_COOKIEFILE |
Çerez verisini içeren dosyanın adı. Çerez dosyası Netscape biçeminde veya bir dosyaya dökümlenmiş salt HTTP tarzı başlıklar biçeminde olabilir. | |
CURLOPT_COOKIEJAR |
Bağlantı kapandığında tüm dahili çerezlerin kaydedileceği dosyanın ismi. | |
CURLOPT_CUSTOMREQUEST |
Bir HTTP isteği yaparken "GET" veya "HEAD" yerine kullanılacak özel istek yöntemi. "DELETE" veya biraz daha çapraşık HTTP istekleri yapmak için kullanışlıdır. Geçerli değerlerin bazıları: "GET", "POST", "CONNECT"; yani, istek satırının tamamını buraya girmeyin. Örneğin, "GET /index.html HTTP/1.0\r\n\r\n" girdisi yanlış olacaktır.
|
|
CURLOPT_EGDSOCKET |
Bozunum değerlerini toplama uygulamasına bir dosya ismi
belirtmesi dışında CURLOPT_RANDOM_FILE
gibidir.
|
|
CURLOPT_ENCODING |
"Accept-Encoding: " başlığının içeriği. Yanıtın kodlanmasını sağlar. Desteklenen kodlamalar: "identity", "deflate" ve "gzip". Boş bir dizge "" belirtilirse desteklenen tüm kodlamaları içeren bir başlık gönderilir. | cURL 7.10'da eklendi. |
CURLOPT_FTPPORT |
FTP "POST" komutu için kullanılacak IP adresini almakta kullanılacak değer. "POST" komutu, uzak sunucunun bizim belirttiğimiz IP adresine bağlanmasını söyler. Dizge bir IP adresi içerebileceği gibi bir konakismi, (Unix altında) bir ağ arayüzü adı veya sistemin öntanımlı IP adresinin kullanılacağı anlamında '-' olabilir. | |
CURLOPT_INTERFACE |
Kullanılacak giden ağ arayüzünün ismi. Bir ağ arabirimi ismi, bir IP adresi veya bir konak ismi olabilir. | |
CURLOPT_KRB4LEVEL |
KRB4 (Kerberos 4) güvenlik seviyesi. Geçerli değerler (en
güçsüzden en güçlüye doğru):
"clear",
"safe",
"confidential",
"private"..
Dizge bunlardan biri değilse "private"
kullanılır. Bu seçeneğe NULL atanması KRB4 güvenliğini iptal
eder. Şimdilik KRB4 güvenliği sadece FTP aktarımlarında
çalışmaktadır.
|
|
CURLOPT_POSTFIELDS |
Bir HTTP "POST" işleminde gönderilecek verinin tamamı. Bir dosya
göndermek için dosya ismini başına @ koyarak
tam yoluyla belirtin.
'para1=val1¶2=val2&...' benzeri
kodlanmış bir dizge veya alan isimlerinin anahtar, değerlerinin
değer olarak yer aldığı bir dizi belirtilebilir.
değer bir dizi ise
Content-Type başlığına
multipart/form-data atanır.
|
|
CURLOPT_PROXY |
İstekleri tünelleyecek HTTP vekili. | |
CURLOPT_PROXYUSERPWD |
Vekil bağlantısı için kullanılacak kullanıcı adı ve parola; "[kullanıcı]:[parola]" biçeminde belirtilir. | |
CURLOPT_RANDOM_FILE |
SSL için rasgele sayı üretecini tohumlamakta kullanılacak dosya ismi. | |
CURLOPT_RANGE |
X ve Y isteğe bağlı olmak üzere "X-Y" biçeminde alınacak veri aralığı. HTTP aktarımları, "X-Y,N-M" biçeminde virgüllerle ayrılmış olarak çok sayıda aralığı destekler. | |
CURLOPT_REFERER |
Bir HTTP isteğinde kullanılacak "Referer: " başlığının içeriği. | |
CURLOPT_SSL_CIPHER_LIST |
SSL için kullanılacak şifrelerin listesi. Örneğin, RC4-SHA ve TLSv1 geçerli şifre listeleridir. | |
CURLOPT_SSLCERT |
PEM biçemli sertifikayı içeren dosyanın ismi. | |
CURLOPT_SSLCERTPASSWD |
CURLOPT_SSLCERT sertifikasını kullanmak
için gereken parola.
|
|
CURLOPT_SSLCERTTYPE |
Sertifika biçemi. Desteklenen biçemler: "PEM" (öntanımlı), "DER" ve "ENG". | cURL 7.9.3'te eklendi. |
CURLOPT_SSLENGINE |
CURLOPT_SSLKEY ile belirtilmiş gizli SSL
anahtarının şifreleme motoru için betimleyici.
|
|
CURLOPT_SSLENGINE_DEFAULT |
Bakışımsız şifreleme işlemleri için kullanılan şifreleme motoru için betimleyici. | |
CURLOPT_SSLKEY |
Gizli SSL anahtarını içeren dosyanın ismi. | |
CURLOPT_SSLKEYPASSWD |
|
|
CURLOPT_SSLKEYTYPE |
CURLOPT_SSLKEY ile belirtilen gizli SSL
anahtarının anahtar türü. Desteklenen anahtar türleri:
"PEM" (öntanımlı), "DER",
ve "ENG".
|
|
CURLOPT_URL |
İçeriği alınacak URL. Oturumu curl_init() ile ilklendirirken de belirtilebilir. | |
CURLOPT_USERAGENT |
HTTP isteğinde kullanılacak "User-Agent: "başlığının içeriği. | |
CURLOPT_USERPWD |
Bağlantı için kullanılmak üzere "[kullanıcı]:[parola]" biçeminde kullanıcı adı ve parola. |
değer
değiştirgesine aşağıdaki
seçenek
'ler için bir dizi atanmalıdır:
Seçenek | Atanacak değer |
Ek bilgi |
---|---|---|
CURLOPT_HTTP200ALIASES |
Hata değil geçerli yanıtlar olarak ele alınmak üzere HTTP 200 yanıtlarını içeren bir dizi. | cURL 7.10.3'te eklendi. |
CURLOPT_HTTPHEADER |
HTTP başlık alanlarını içeren bir dizi. | |
CURLOPT_POSTQUOTE |
FTP isteği yapıldıktan sonra sunucu üzerinde çalıştırılacak komutları içeren bir dizi. | |
CURLOPT_QUOTE |
FTP isteği yapılmadan önce sunucu üzerinde çalıştırılacak komutları içeren bir dizi. |
değer
değiştirgesine aşağıdaki
seçenek
'ler için (örneğin
fopen() kullanarak) bir akım özkaynağı atanmalıdır:
Seçenek | Atanacak değer |
Ek bilgi |
---|---|---|
CURLOPT_FILE |
Aktarımın yazılacağı dosya. STDOUT (tarayıcı penceresi) öntanımlıdır. | |
CURLOPT_INFILE |
Karşıya yükleme sırasında aktarımın okuyacağı dosya. | |
CURLOPT_STDERR |
Çıktı hatalarının gönderileceği STDERR yerine kullanılacak dosya. | |
CURLOPT_WRITEHEADER |
Aktarımın başlık bölümünün yazılacağı dosya. |
değer
değiştirgesine aşağıdaki
seçenek
'ler için bir geriçağırım işlevinin adı
atanmalıdır:
Seçenek | Atanacak değer |
Ek bilgi |
---|---|---|
CURLOPT_HEADERFUNCTION |
İki değiştirgeli bir geriçağırım işlevinin ismi. Değiştirgelerin ilki bir cURL özkaynağı, ikincisi ise başlık verisinin yazılacağı bir dizge olmalıdır. Başlık verisi bu geriçağırım işlevi kullanılırken yazılmalıdır. İşlevin dönüş değeri yazılan bayt sayısı olmalıdır. | |
CURLOPT_PASSWDFUNCTION |
Üç değiştirgeli bir geriçağırım işlevinin ismi. Değiştirgelerin ilki bir cURL özkaynağı, ikincisi parola istemi belirten bir dizge, üçüncüsü ise parolanın azami uzunluğu olmalıdır. İşlevin dönüş değeri parolayı içeren bir dizge olmalıdır. | |
CURLOPT_PROGRESSFUNCTION |
Geriçağırım işlevinin üç değiştirge aldığı durumda geriçağırım işlevinin ismi. Değiştirgelerin ilki bir cURL özkaynağı, ikincisi bir dosya tanıtıcısı, üçüncüsü ise uzunluk olmalıdır. İşlevin dönüş değeri veriyi içeren bir dizge olmalıdır. | |
CURLOPT_READFUNCTION |
İki değiştirgeli bir geriçağırım işlevinin ismi. Değiştirgelerin ilki bir cURL özkaynağı, ikincisi ise okunacak veriyi iceren bir dizge olmalıdır. Veri bu geriçağırım işlevi kullanılarak okunmalıdır. İşlevin dönüş değeri okunan bayt sayısı olmalıdır. Dosya sonunun bildirmek için ise 0 dönmelidir. | |
CURLOPT_WRITEFUNCTION |
İki değiştirgeli bir geriçağırım işlevinin ismi. Değiştirgelerin ilki bir cURL özkaynağı, ikincisi ise yazılacak veriyi içeren bir dizge olmalıdır. Veri bu geriçağırım işlevi kullanılarak yazılmalıdır. İşlevin dönüş değeri yazılan bayt sayısı olmalıdır. |
Başarı durumunda TRUE
, başarısızlık durumunda FALSE
döner.
Sürüm: | Açıklama |
---|---|
5.2.10 |
CURLOPT_PROTOCOLS ve
CURLOPT_REDIR_PROTOCOLS kullanılabilir oldu.
|
5.1.0 |
CURLOPT_AUTOREFERER ,
CURLOPT_BINARYTRANSFER ,
CURLOPT_FTPSSLAUTH ,
CURLOPT_AUTOREFERER ,
CURLOPT_PROXYAUTH ve
CURLOPT_TIMECONDITION kullanılabilir oldu.
|
5.0.0 |
CURLOPT_FTP_USE_EPRT ,
CURLOPT_NOSIGNAL ,
CURLOPT_UNRESTRICTED_AUTH ,
CURLOPT_BUFFERSIZE ,
CURLOPT_HTTPAUTH ,
CURLOPT_PROXYPORT ,
CURLOPT_PROXYTYPE ,
CURLOPT_SSLCERTTYPE ve
CURLOPT_HTTP200ALIASES kullanılabilir oldu.
|
Örnek 1 - Yeni bir cURL oturumunun ilklendirilmesi ve bir HTML sayfasının alınması
<?php
// Yeni bir cURL özkaynağı oluşturalım
$ct = curl_init();
// URL'yi ve ilgili seçenekleri belirtelim
curl_setopt($ct, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ct, CURLOPT_HEADER, false);
// URL'yi tarayıcıya aktaralım
curl_exec($ct);
// cURL özkaynağını kapatıp sistem özkaynaklarını serbest bırakalım
curl_close($ct);
?>
Örnek 2 - Karşıya dosya yüklemek
<?php
/* http://localhost/upload.php:
print_r($_POST);
print_r($_FILES);
*/
$ch = curl_init();
$data = array('name' => 'Foo', 'file' => '@/home/user/test.png');
curl_setopt($ch, CURLOPT_URL, 'http://localhost/upload.php');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_exec($ch);
?>
Yukarıdaki örneğin çıktısı:
Array ( [name] => Foo ) Array ( [file] => Array ( [name] => test.png [type] => image/png [tmp_name] => /tmp/phpcpjNeQ [error] => 0 [size] => 279 ) )
Bilginize:
CURLOPT_POSTFIELDS
seçeneğine bir dizinin aktarılması verinin multipart/form-data olarak kodlanmasına, bir URL kodlu dizge atanması ise verinin application/x-www-form-urlencoded olarak kodlanmasına sebep olur.