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.0   7.1   7.2   7.3   7.4   7.5   8.0   8.1   8.2   8.3    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"; Handle; Value )


Parameter Description Example value
Handle 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

CURL.SetOptionPostQuote   -   CURL.SetOptionPreProxy

Feedback: Report problem or ask question.

MBS Xojo Plugins