rfc:new-curl-error-functions

PHP RFC: Add curl_multi_errno(), curl_share_errno() and curl_share_strerror()

Introduction

The ext/curl extension define 3 different resource types :

  • cURL handle created by php curl_init()
  • cURL Multi Handle created by curl_multi_init()
  • cURL Share Handle created by curl_share_init()

As of today, it's possible to get the last error related to a cURL handle with the curl_errno() function, but there is no way to retrieve what was the last error related to a cURL Multi/Share handle.

Proposal

Add curl_multi_errno(), curl_share_errno() and curl_share_strerror() functions to get a consistent mechanism of error retrieval across all curl resource types.

Resource type init function last error error message
cURL handle curl_init() curl_errno() curl_strerror()
cURL Multi Handle curl_multi_init() curl_multi_errno() curl_multi_strerror()
cURL Share Handle curl_share_init() curl_share_errno() curl_share_strerror()

Functions in bold are the one that do not exists and that are be introduced in this RFC.

Functions signature

int curl_multi_errno(resource $mh);
int curl_share_errno(resource $rh);
string curl_share_strerror(int $errno);

Backward Incompatible Changes

None.

Proposed PHP Version(s)

7.1

Vote

Simple 50% +1 majority: “Should those functions be added in 7.1”. The voting began on Jun 9 and will close on Jun 23.

Should those functions should be added in 7.1
Real name Yes No
colinodell (colinodell)  
davey (davey)  
galvao (galvao)  
guilhermeblanco (guilhermeblanco)  
hywan (hywan)  
jgmdev (jgmdev)  
kalle (kalle)  
kguest (kguest)  
laruence (laruence)  
leigh (leigh)  
lstrojny (lstrojny)  
mariano (mariano)  
mbeccati (mbeccati)  
mike (mike)  
pierrick (pierrick)  
rasmus (rasmus)  
sammyk (sammyk)  
stas (stas)  
svpernova09 (svpernova09)  
tpunt (tpunt)  
trowski (trowski)  
zeev (zeev)  
zimt (zimt)  
Final result: 23 0
This poll has been closed.

Patches and Tests

Implementation

rfc/new-curl-error-functions.txt · Last modified: 2016/06/26 19:46 by pierrick