Overview
KB
Technical FAQ
PHP Manual
CSS2 Manual
HTML Manual
JS Guide
JS Reference
PhpDock Manual
Nu-Coder Manual
PhpExpress Manual
PHP Joomla
Development
Learn PHP
 
<curl_errnocurl_escape>
^cURL FunctionsLast updated: Mon, 26 Oct 2026

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';
}
?>

See Also


<curl_errnocurl_escape>
^cURL FunctionsLast updated: Mon, 26 Oct 2026