(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
curl_getinfo — Belli bir oturum ile ilgili bilgi döndürür
Belirtilen tanıtıcı ile ilgili son aktarım hakkında bilgi verir.
tanıtıcı
curl_init() işlevinden dönen bir cURL tanıtıcısı.
seçenek
Şu sabitlerden biri olabilir:
CURLINFO_EFFECTIVE_URL
- Etkin son URL. CURLINFO_HTTP_CODE
- Alınan son yanıt kodu. cURL 7.10.8 itibariyle, bu sabit CURLINFO_RESPONSE_CODE
sabitinin takma adıdır. CURLINFO_FILETIME
- CURLOPT_FILETIME
etkinken belgenin karşıdan alınma süresi; -1 ise süre bilinmiyor demektir. CURLINFO_TOTAL_TIME
- Saniye cinsinden son aktarımın toplam süresi. CURLINFO_NAMELOOKUP_TIME
- Saniye cinsinden isim çözümlenene kadar geçen süre. CURLINFO_CONNECT_TIME
- Saniye cinsinden bağlantı kurulana kadar geçen süre. CURLINFO_PRETRANSFER_TIME
- Saniye cinsinden başlangıçtan aktarım başlayana kadar geçen süre. CURLINFO_STARTTRANSFER_TIME
- Saniye cinsinden ilk bayt aktarılana kadar geçen süre. CURLINFO_REDIRECT_COUNT
- CURLOPT_FOLLOWLOCATION
etkinken, yönlendirme sayısı. CURLINFO_REDIRECT_TIME
- CURLOPT_FOLLOWLOCATION
etkinken, saniye cinsinden son aktarım başlayana kadar tüm yönlendirme adımlarının süresi. CURLINFO_REDIRECT_URL
- CURLOPT_FOLLOWLOCATION
etkin değilken: son aktarımda bulunan yönlendirme URL'si; sonradan elle istenmesi gerekir. CURLOPT_FOLLOWLOCATION
etkinken: bu boştur. Bu durumda yönlendirme URL'si CURLINFO_EFFECTIVE_URL
'de bulunur. CURLINFO_PRIMARY_IP
- En son bağlanının IP adresi. CURLINFO_PRIMARY_PORT
- En son bağlanının hedef portu. CURLINFO_LOCAL_IP
- En son bağlanının yerel (kaynak) IP adresi. CURLINFO_LOCAL_PORT
- En son bağlanının yerel (kaynak) portu. CURLINFO_SIZE_UPLOAD
- Karşıya yüklenen toplam bayt sayısı. CURLINFO_SIZE_DOWNLOAD
- İndirilen toplam bayt sayısı. CURLINFO_SPEED_DOWNLOAD
- Ortalama indirme hızı. CURLINFO_SPEED_UPLOAD
- Ortalama karşıya yükleme hızı. CURLINFO_HEADER_SIZE
- Alınan tüm başlıkların toplam boyutu. CURLINFO_HEADER_OUT
- Gönderilen istek dizgesi. Bunun çalışması için, curl_setopt() çağrılarak tanıtıcıya CURLINFO_HEADER_OUT
seçeneği eklenmelidir. CURLINFO_REFERER
- Yönlendiren başlığı CURLINFO_REQUEST_SIZE
- Toplam istek boyutu; şimdilik sadece HTTP istekleri için. CURLINFO_RETRY_AFTER
- Retry-After:
başlığındaki bilgi veya geçerli başlık yoksa sıfır. CURLINFO_SSL_VERIFYRESULT
- CURLOPT_SSL_VERIFYPEER
atanarak istenen SSL sertifikalarının doğrulanmasının sonucu. CURLINFO_CONTENT_LENGTH_DOWNLOAD
- Content-Length:
başlığından okunan indirilen içerik uzunluğu. CURLINFO_CONTENT_LENGTH_UPLOAD
- Belirtilen karşıya yükleme boyutu. CURLINFO_CONTENT_TYPE
- İstenenbelgenin Content-Type:
başlığının değeri; null
değeri sunucunun geçerli bir Content-Type:
başlığı göndermediği anlamına gelir. CURLINFO_PRIVATE
- curl_setopt() işlevinin CURLOPT_PRIVATE
seçeneği ile evvelce atanmış, bu cURL tanıtıcısı ile ilişkili özel veri. CURLINFO_PROXY_ERROR
- Son aktarım CURLE_PROXY
hatası döndürdüğünde ayrıntılı (SOCKS) vekil hata kodu. Dönen değer tam olarak CURLPX_*
değerlerinden biri olacaktır. Hiçbir yanıt kodu yoksa hata kodu CURLPX_OK
olur. CURLINFO_RESPONSE_CODE
- Son yanıt kodu CURLINFO_HTTP_CONNECTCODE
- CONNECT yanıt kodu CURLINFO_HTTPAUTH_AVAIL
- önceki yanıta göre, kullanılabilen kimlik kanıtlama yöntemlerini gösteren bit maskesi. CURLINFO_PROXYAUTH_AVAIL
- Önceki yanıta göre kullanılabilen vekil kimlik kanıtlama yöntemlerini gösteren bit maskesi. CURLINFO_OS_ERRNO
- Bir bağlantı hatasındaki hata numarası. Numara, işletim sistemine ve sisteme özeldir. CURLINFO_NUM_CONNECTS
- Önceki aktarımı gerçekleştirmek için curl tarafından oluşturulması gereken bağlantı sayısı. CURLINFO_SSL_ENGINES
- OpenSSL kripto motorları desteklenir. CURLINFO_COOKIELIST
- Bilinen tüm çerezler CURLINFO_FTP_ENTRY_PATH
- FTP sunucusundaki girdi yolu. CURLINFO_APPCONNECT_TIME
- Uzak konağa SSL/SSH bağlantısı/anlaşması tamamlanana kadar başlangıçtan itibaren geçen saniye cinsinden süre CURLINFO_CERTINFO
- TLS sertifika zinciri CURLINFO_CONDITION_UNMET
- Karşılanmayan süre koşulu hakkında bilgi. CURLINFO_RTSP_CLIENT_CSEQ
- Sonraki RTSP istemci CSeq CURLINFO_RTSP_CSEQ_RECV
- Son alınan CSeq CURLINFO_RTSP_SERVER_CSEQ
- Sonraki RTSP sunucu CSeq CURLINFO_RTSP_SESSION_ID
- RTSP oturum kimiliği CURLINFO_CONTENT_LENGTH_DOWNLOAD_T
- İndirmenin içerik uzunluğu. Bu değer, Content-Length:
başlığından okunur. Boyut bilinmiyorsa -1 CURLINFO_CONTENT_LENGTH_UPLOAD_T
- Yüklemenin belirtilen boyutu. Boyut bilinmiyorsa -1 CURLINFO_HTTP_VERSION
- Son HTTP bağlantısında kullanılan sürüm. Dönüş değeri, tanımlı CURL_HTTP_VERSION_*
sabitlerinden biri veya sürüm belirlenemiyorsa 0 olacaktır CURLINFO_PROTOCOL
- Son HTTP bağlantısında kullanılan protokol. Döndürülen değer kesin olarak CURLPROTO_*
değerlerinden biri olacaktır. CURLINFO_PROXY_SSL_VERIFYRESULT
- İstenen sertifika doğrulamasının sonucu (CURLOPT_PROXY_SSL_VERIFYPEER
seçeneği kullanılarak). Yalnızca HTTPS vekilleri için kullanılır. CURLINFO_SCHEME
- En son bağlantıda kullanılan URL şeması CURLINFO_SIZE_DOWNLOAD_T
- İndirilen toplam bayt sayısı. Sayı yalnızca en son aktarım içindir ve her yeni aktarım için sıfırlanır. CURLINFO_SIZE_UPLOAD_T
- Yüklenen toplam bayt sayısı CURLINFO_SPEED_DOWNLOAD_T
- Tam indirme için curl'un ölçtüğü bayt/saniye cinsinden ortalama indirme hızı. CURLINFO_SPEED_UPLOAD_T
- Tam yükleme için curl'un ölçtüğü bayt/saniye cinsinden ortalama yükleme hızı. CURLINFO_APPCONNECT_TIME_T
- Başlangıçtan uzak konağa SSL/SSH bağlantısı/anlaşması tamamlanana kadar geçen mikrosaniye cinsinden süre. CURLINFO_CONNECT_TIME_T
- Uzak konağa (veya vekile) bağlantı tamamlanana kadar başlangıştan itibaren geçen mikrosaniye cinsinden toplam süre. CURLINFO_FILETIME_T
- Alınan belgenin uzaktan alınma zamanı (Unix zaman damgası olarak), 32 bitlik sistemlerin 32 bit zaman damgası aralığı dışındaki tarihleri ayıklamasını sağlamak için bir CURLINFO_FILETIME
seçeneği. CURLINFO_NAMELOOKUP_TIME_T
- İsim çözümlemesi tamamlanana kadar başlangıçtan itibaren geçen milisaniye cinsinden süre. CURLINFO_PRETRANSFER_TIME_T
- Dosya aktarımı başlayana kadar başlangıçtan itibaren geçen milisaniye cinsinden süre. CURLINFO_REDIRECT_TIME_T
- Mikrosaniye cinsinden tüm yönlendirme adımları için geçen toplam süre, son işlem başlamadan önce ad arama, bağlanma, ön aktarımı ve aktarımı içerir. CURLINFO_STARTTRANSFER_TIME_T
- Başlangıçtan ilk bayt alınıncaya kadar geçen milisaniye cinsinden süre. CURLINFO_TOTAL_TIME_T
- Ad çözümleme, TCP bağlantısı vb. dahil olmak üzere önceki aktarım için mikrosaniye cinsinden toplam süre. seçenek
belirtilirse, seçeneğin değeri bir dizge olarak döndürülür. Aksi takdirde aşağıdaki elemanları içeren bir dizi veya başarısızlık durumunda false
döner:
CURLINFO_HEADER_OUT
is set by a previous call to curl_setopt()) CURLINFO_PRIVATE
seçeneğiyle tek tek alınması gerektiği unutulmamalıdır. Sürüm: | Açıklama |
---|---|
8.2.0 | CURLINFO_PROXY_ERROR , CURLINFO_REFERER , CURLINFO_RETRY_AFTER tanımlandı. |
8.0.0 | tanıtıcı için artık bir CurlHandle örneği bekleniyor; evvelce, resource türünde bir değer beklenirdi. |
8.0.0 | seçenek artık null olabiliyor; evvelce 0 öntanımlı değerdi. |
7.3.0 | CURLINFO_CONTENT_LENGTH_DOWNLOAD_T , CURLINFO_CONTENT_LENGTH_UPLOAD_T , CURLINFO_HTTP_VERSION , CURLINFO_PROTOCOL , CURLINFO_PROXY_SSL_VERIFYRESULT , CURLINFO_SCHEME , CURLINFO_SIZE_DOWNLOAD_T , CURLINFO_SIZE_UPLOAD_T , CURLINFO_SPEED_DOWNLOAD_T , CURLINFO_SPEED_UPLOAD_T , CURLINFO_APPCONNECT_TIME_T , CURLINFO_CONNECT_TIME_T , CURLINFO_FILETIME_T , CURLINFO_NAMELOOKUP_TIME_T , CURLINFO_PRETRANSFER_TIME_T , CURLINFO_REDIRECT_TIME_T , CURLINFO_STARTTRANSFER_TIME_T , CURLINFO_TOTAL_TIME_T devreye girdi. |
Örnek 1 - curl_getinfo() örneği
<?php
// Yeni bir tanıtıcı oluşturalım
$ch = curl_init('http://www.example.com/');
// Çalıştıralım
curl_exec($ch);
// Bir hata var mı bakalım
if(!curl_errno($ch)) {
$info = curl_getinfo($ch);
echo 'İsteğin' . $info['url'] . ' adresine gönderilmesi ' .
$info['total_time'] . ' saniye sürdü';
}
// Tanıtıcıyı kapatalım
curl_close($ch);
?>
Örnek 2 - seçenek
bağımsız değişkenli curl_getinfo() örneği
<?php
// Bir cURL tanıtıcısı oluştur
$ch = curl_init('http://www.example.com/');
// Çalıştır
curl_exec($ch);
// HTTP durum koduna bak
if (!curl_errno($ch)) {
switch ($http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE)) {
case 200: # OK
break;
default:
echo 'Beklenmedik HTTP kodu: ', $http_code, "\n";
}
}
curl_close($ch);
?>
Bilginize:
Tanıtıcı yeniden kullanılırsa işlev tarafından toplanan veri tutulur. Yani, bir istatistik bu işlev tarafından dahili olarak geçersiz kılınmadıkça önceki bilgi döner.