PhpDig.net

What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.




curl_getinfo

Name

curl_getinfo — Queries a cURL session for the status information.

Synopsis

mixed curl_getinfo(curld[, info_option]);
int curld: Handle of cURL session to query
info_option (optional): Constant indicating which information to get

Returns

A string giving information about the state of the cURL session, or an associative array containing all known information

Description

Queries the cURL session indicated by the curld parameter for information regarding the status of the session. This function is only available if the cURL library version is 7.4.1 or above and the PHP version is 4.0.4 or above.

The following constants are defined for the info_option parameter:

CURLINFO_EFFECTIVE_URL (string)

Returns the effective URL as used in the most recent operation.

CURLINFO_HTTP_CODE (integer)

The HTTP code (if applicable) returned by the remote server for the most recent operation.

CURLINFO_HEADER_SIZE (integer)

The size, in bytes, of the headers returned for the most recent operation.

CURLINFO_REQUEST_SIZE (float)

The size, in bytes, of the body of the resource fetched in the most recent operation.

CURLINFO_TOTAL_TIME (float)

The elapsed total time (wall clock) for execution of the last curl_exec() call.

CURLINFO_NAMELOOKUP_TIME (float)

The length of time needed for the name lookup of the requested server, in seconds.

CURLINFO_CONNECT_TIME (float)

The length of time required to connect to the remote server, in seconds.

CURLINFO_PRETRANSFER_TIME (float)

The length of time between the beginning of the operation's execution and the beginning of the download itself, in seconds.

CURLINFO_SIZE_UPLOAD (float)

If the last operation was an upload, this returns the size of the uploaded data, in bytes.

CURLINFO_SIZE_DOWNLOAD (float)

If the last operation was a download, this returns the size of the downloaded data, in bytes.

CURLINFO_SPEED_UPLOAD (float)

If the last operation was an upload, this returns the average speed of the transfer, in bytes per second.

CURLINFO_SPEED_DOWNLOAD (float)

If the last operation was a download, this returns the average speed of the transfer, in bytes per second.



Example

Example 191. Get information from a cURL handle

<?php
if (!$curld = curl_init("http://www.php.net")) {
    echo "Could not initialize cURL session.\n";
    exit;
}

/* Indicate that we want the output returned into a variable. */
curl_setopt($curld, CURLOPT_RETURNTRANSFER, true);

/* For this example, just discard the output. */
curl_exec($curld);

/* Show all information about the tranfer. */
echo "<pre>";
print_r(curl_getinfo($curld));
echo "</pre>";

/* Clean up. */
curl_close($curld);
?>



PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing (Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch). This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). The authors of this book have elected not to choose any options under the OPL. This online book was obtained from http://www.fooassociates.com/phpfer/ and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4 for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All persons and entities shall have neither liability nor responsibility to any person or entity with respect to any loss or damage arising from the information contained in this book.

Powered by: vBulletin Version 3.0.7
Copyright ©2000 - 2005, Jelsoft Enterprises Ltd.
Copyright © 2001 - 2005, ThinkDing LLC. All Rights Reserved.