« curl_errno
curl_escape »

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

参考

関連キーワード:
curl   直近   ハンドル   multi   セッション   cURL   CurlHandle   handle   info   read   errno   エラーメッセージ   init   exec   strerror   期待   Curl   エラーコード   escape   操作   クリア   テキスト   メッセージ   個々   キー
関連する関数・ページ:
function.curl-errno   function.curl-multi-getcontent   function.curl-multi-remove-handle   function.curl-exec   function.curl-multi-add-handle   function.curl-multi-strerror