curl_error

(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)

curl_error — Return a string containing the last error for the current session

Description

function curl_error(CurlHandle $handle): string

Returns a clear text error message for the last cURL operation.

Parameters

handle: A cURL handle returned by curl_init().

Return Values

Returns the error message or '' (the empty string) if no error occurred.

Note:
When a CurlHandle is executed via curl_multi_exec(), this function returns '' (the empty string) until curl_multi_info_read() has returned the message for that handle. To retrieve the error string for each individual handle, pass the result key returned by curl_multi_info_read() to curl_strerror().

Changelog

Version	Description
8.0.0	`handle` expects a CurlHandle instance now; previously, a resource was expected.

Examples

Example #1 curl_error() example

<?php
// Create a curl handle to a non-existing location
$ch = curl_init('http://404.php.net/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

if(curl_exec($ch) === false)
{
    echo 'Curl error: ' . curl_error($ch);
}
else
{
    echo 'Operation completed without any errors';
}
?>