(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:
Option | Açıklama |
---|---|
CURLINFO_CAINFO
|
Öntanımlı yerleşik CA sertifika yolu |
CURLINFO_CAPATH
|
Öntanımlı yerleşik CA yol dizgesi |
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.3.0 |
CURLINFO_CAINFO ve
CURLINFO_CAPATH tanımlandı.
|
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.