Forum und email

curl_getinfo

(PHP 4 >= 4.0.4, PHP 5)

curl_getinfo — Obtém uma informação sobre uma transferência específica

Descrição

mixed curl_getinfo ( resource $ch [, int $opt ] )

Obtém informação sobre a última transferência.

Parâmetros

ch

Um manipulador cURL retornado por curl_init().

opt

Pode ser uma das seguintes contantes:

  • CURLINFO_EFFECTIVE_URL - Última URL efetiva
  • CURLINFO_HTTP_CODE - Último código HTTP recebido
  • CURLINFO_FILETIME - Tempo remoto do documento obtido, se -1 for retornado, então o tempo do documento é desconhecido
  • CURLINFO_TOTAL_TIME - Tempo total da transação em segundos para a última transferencia
  • CURLINFO_NAMELOOKUP_TIME - Tempo em segundos até que a resolução tenha sido completada
  • CURLINFO_CONNECT_TIME - Tempo em segundos que levou para estabelecer a conexão
  • CURLINFO_PRETRANSFER_TIME - Tempo em segundos do início até que a transferencia esteja a ponto de começar
  • CURLINFO_STARTTRANSFER_TIME - Tempo em segundos até que o primeiro byte esteja a ponto de ser transferido
  • CURLINFO_REDIRECT_TIME - Tempo em segundos de todos os passos de redirecionamento antes que a transação tenha começado
  • CURLINFO_SIZE_UPLOAD - Número total de bytes enviados
  • CURLINFO_SIZE_DOWNLOAD - Número total de bytes baixados
  • CURLINFO_SPEED_DOWNLOAD - Média de tempo do download
  • CURLINFO_SPEED_UPLOAD - Média de tempo do upload
  • CURLINFO_HEADER_SIZE - Tamanho total dos cabeçalhos recebidos
  • CURLINFO_HEADER_OUT - A string da requisição enviada. Disponível desde o PHP 5.1.3
  • CURLINFO_REQUEST_SIZE - Tamanho da requisição emitida, atualmente somente para requisições HTTP
  • CURLINFO_SSL_VERIFYRESULT - Resultado da verificação da certificação SSL requisitada pela opção CURLOPT_SSL_VERIFYPEER
  • CURLINFO_CONTENT_LENGTH_DOWNLOAD - content-length do download, lido do campo Content-Length:.
  • CURLINFO_CONTENT_LENGTH_UPLOAD - Especifica o tamanho do upload
  • CURLINFO_CONTENT_TYPE - Content-type do objeto que foi feito download, NULL indica que o servidor não enviou um válido cabeçalho Content-Type.

Valor Retornado

Se opt é fornecido, retorna o valor como uma string. Caso contrário, retorna um array associativo com os seguintes elementos (que corresponde a opt ):

  • "url"
  • "content_type"
  • "http_code"
  • "header_size"
  • "request_size"
  • "filetime"
  • "ssl_verify_result"
  • "redirect_count"
  • "total_time"
  • "namelookup_time"
  • "connect_time"
  • "pretransfer_time"
  • "size_upload"
  • "size_download"
  • "speed_download"
  • "speed_upload"
  • "download_content_length"
  • "upload_content_length"
  • "starttransfer_time"
  • "redirect_time"