Meet us at at Real World in Orlando, Florida.

All functions   Mac OS X   Windows   Crossplatform   Components   Guides  
New in version: 2.0   2.1   2.2   2.3   2.4   2.5   2.6   2.7   2.8  

CURL.SetOptionPostRedir

Component: CURL
Version: 2.5
Mac OS X: Works
Windows: Works

MBS( "CURL.SetOptionPostRedir"; handle; value )

Parameters

Parameter Description Example value
Handle The CURL session handle. $curl
Value The new bitmask for redirections. 3

Result

Returns "OK" on success.

Description

Sets the redirect policy.
Pass a bitmask to control how libcurl acts on redirects after POSTs that get a 301 or 302 response back. A parameter with bit 0 set (value CURL_REDIR_POST_301) tells the library to respect RFC 2616/10.3.2 and not convert POST requests into GET requests when following a 301 redirection. Setting bit 1 (value CURL_REDIR_POST_302) makes libcurl maintain the request method after a 302 redirect. CURL_REDIR_POST_ALL is a convenience define that sets both bits.

The non-RFC behaviour is ubiquitous in web browsers, so the library does the conversion by default to maintain consistency. However, a server may require a POST to remain a POST after such a redirection. This option is meaningful only when setting CURL.SetOptionFollowLocation. (This option was known as CURLOPT_POST301 up to 7.19.0 as it only supported the 301 way before then)

CURL_REDIR_POST_3011
CURL_REDIR_POST_3022
CURL_REDIR_POST_ALL3

Feedback: Report problem or ask question.




Links
MBS REAL studio Plugins - Pfarrgemeinde Messdiener Nickenich