Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 7.5   8.0   8.1   8.2   8.3   8.4   8.5   9.0   9.1   9.2    Statistic  


Sets the redirect policy.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
CURL 2.5 Yes Yes Yes Yes Yes
MBS( "CURL.SetOptionPostRedir"; curl; Value )   More


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


Returns "OK" on success.


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)


See also POSTREDIR option in CURL manual.

See also

Created 18th August 2014, last changed 18th August 2014

CURL.SetOptionPostQuote   -   CURL.SetOptionPreProxy

Feedback: Report problem or ask question.

MBS Xojo Chart Plugins