curl_error
PHP Manual
PHP Manual»cURL 関数»curl_error

curl_error

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

curl_error — 現在のセッションに関する直近のエラー文字列を返す

説明

function curl_error(CurlHandle $handle): string

直近の cURL 操作に関するエラーメッセージをクリアテキストで返します。

パラメータ

handle

curl_init() が返す cURL ハンドル。

戻り値

エラーメッセージ、あるいはエラーが発生しなかった場合は '' (空文字) を返します。

注意:

CurlHandle を curl_multi_exec() で実行した場合、curl_multi_info_read() がそのハンドルのメッセージを返すまでは、この関数は '' (空文字) を返します。 個々のハンドルのエラー文字列を取得するには、curl_multi_info_read() が返す result キーの値を curl_strerror() に渡してください。

変更履歴

バージョン 説明
8.0.0 handle は CurlHandle クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、resource を期待していました。

例

例1 curl_error() の例

<?php
// 存在しない場所への curl ハンドルを作成します
$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';
}
?>

参考

To Top