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

curl_errorВозвращает строку с описанием последней ошибки текущего сеанса


curl_error ( CurlHandle $handle ) : string

Возвращает понятное сообщение об ошибке для последней операции cURL.

Список параметров


Дескриптор cURL, полученный из curl_init().

Возвращаемые значения

Возвращает сообщение об ошибке или '' (пустую строку), если ошибки не произошло.

Список изменений

Версия Описание
8.0.0 handle теперь ожидает экземпляр CurlHandle; раньше, ожидался ресурс (resource).


Пример #1 Пример использования curl_error()

// Создаём дескриптор curl к несуществующему адресу
$ch curl_init('');

curl_exec($ch) === false)
'Ошибка curl: ' curl_error($ch);
'Операция завершена без каких-либо ошибок';

// Закрываем дескриптор

Смотрите также

add a note add a note

User Contributed Notes 4 notes

patrick at ibuildings dot nl
7 years ago
If you want to fetch the error message, make sure you fetch it before you close the current cURL session or the error message will be reset to an empty string.
paul at paulmcgarry dot com
12 years ago
For a 404 response to actually trigger an error as the example seems to be trying to demonstrate the following option should be set:


As per

This is returned if CURLOPT_FAILONERROR is set TRUE and the HTTP server returns an error code that is >= 400. (This error code was formerly known as CURLE_HTTP_NOT_FOUND.)
anrdaemon at freemail dot ru
2 years ago
curl_error is not a textual representation of curl_errno.
It's an actual error *message*.
If you want textual representation of error *code*, look for curl_strerror.
Additional information
5 years ago
Please note that periodically the developers go through the notes and may incorporate information from them into the documentation. This means that any note submitted here becomes the property of the PHP Documentation Group and will be available under the same license as the documentation.

Your IP Address will be logged with the submitted note and made public on the PHP manual user notes mailing list. The IP address is logged as part of the notes moderation process, and won't be shown within the PHP manual itself.

It may take up to an hour for your note to appear in the documentation.

The SPAM challenge requires numbers to written out in English, so, an appropriate answer may be nine but not 9.
To Top