PHP Manual
Prev |  | Next

# curl_getinfo

(PHP 4 >= 4.0.4, PHP 5)

curl_getinfo -- Get information regarding a specific transfer

## Description

mixed curl_getinfo ( resource ch [, int opt] )

Gets information about the last transfer,

## Parameters

`ch`

  A cURL handle returned by curl_init().

`opt`

  This may be one of the following constants:

  - `CURLINFO_EFFECTIVE_URL` - Last effective URL

  - `CURLINFO_HTTP_CODE` - Last received HTTP code

  - `CURLINFO_FILETIME` - Remote time of the retrieved document, if -1 is returned the time of the document is unknown

  - `CURLINFO_TOTAL_TIME` - Total transaction time in seconds for last transfer

  - `CURLINFO_NAMELOOKUP_TIME` - Time in seconds until name resolving was complete

  - `CURLINFO_CONNECT_TIME` - Time in seconds it took to establish the connection

  - `CURLINFO_PRETRANSFER_TIME` - Time in seconds from start until just before file transfer begins

  - `CURLINFO_STARTTRANSFER_TIME` - Time in seconds until the first byte is about to be transferred

  - `CURLINFO_REDIRECT_TIME` - Time in seconds of all redirection steps before final transaction was started

  - `CURLINFO_SIZE_UPLOAD` - Total number of bytes uploaded

  - `CURLINFO_SIZE_DOWNLOAD` - Total number of bytes downloaded

  - `CURLINFO_SPEED_DOWNLOAD` - Average download speed

  - `CURLINFO_SPEED_UPLOAD` - Average upload speed

  - `CURLINFO_HEADER_SIZE` - Total size of all headers received

  - `CURLINFO_HEADER_OUT` - The request string sent. Available since PHP 6.0.0

  - `CURLINFO_REQUEST_SIZE` - Total size of issued requests, currently only for HTTP requests

  - `CURLINFO_SSL_VERIFYRESULT` - Result of SSL certification verification requested by setting CURLOPT_SSL_VERIFYPEER

  - `CURLINFO_CONTENT_LENGTH_DOWNLOAD` - content-length of download, read from Content-Length: field

  - `CURLINFO_CONTENT_LENGTH_UPLOAD` - Specified size of upload

  - `CURLINFO_CONTENT_TYPE` - Content-type of downloaded object, NULL indicates server did not send valid Content-Type: header

## Return Values

If `opt` is given, returns its value as a string. Otherwise, returns an associative array with the following elements (which correspond to `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"

Prev | Home | Next
curl_exec | Up | curl_init