curl_strerror()

1. 定义

该函数返回指定错误代码的字符串描述。

注:

  • 不同于函数curl_error()只能返回最后一次操作出错的错误描述,而是指定错误代码的字符串描述。

2. 语法

curl_strerror ( int $errornum ) : string

3. 参数说明

参数 可选性 数据类型 描述
$errornum 必需 整型 指定的错误代码

4. 示例

<?php

// curl_strerror()
// 返回指定错误代码的字符串描述

// 由于该函数并不直接涉及 curl 传输会话,所以可以输出所有的 curl 传输会话的错误信息

for ($errcode=0; $errcode < 100; $errcode++) { 
    $info[$errcode] = curl_strerror($errcode);
}
// 去除不符合要求的(值为 Unknown error )的,这里使用 array_filter() 函数
$info = array_filter($info, 'filter', ARRAY_FILTER_USE_BOTH);
var_dump($info);
/* 类似输出:
 ...
 [87]=>
  string(29) "Unable to parse FTP file list"
  [88]=>
  string(21) "Chunk callback failed"
  [89]=>
  string(35) "The max connection limit is reached"
  [90]=>
  string(47) "SSL public key does not match pinned public key"
  [91]=>
  string(49) "SSL server certificate status verification FAILED"
  [92]=>
  string(40) "Stream error in the HTTP/2 framing layer"
  [93]=>
  string(40) "API function called from within callback"
}
*/

function filter($value, $key) {
    if($value != 'Unknown error') return true;
}

5. 延展阅读

  • curl_errno():返回cURL传输会话最后一次操作的错误代码
  • curl_error():返回cURL传输会话最后一次操作的错误代码的字符串,没有错误发生时将返回空字符串