Topics
All
MacOS
(Only)
Windows
(Only)
Linux
(Only, Not)
iOS
(Only, Not)
Components
Crossplatform Mac & Win
Server
Client
Old
Deprecated
Guides
Examples
Videos
New in version:
12.1
12.2
12.3
12.4
12.5
13.0
13.1
13.2
13.3
13.4
Statistic
FMM
Blog
CURL.SetOptionPostRedir
Sets the redirect policy.
Component |
Version |
macOS |
Windows |
Linux |
Server |
iOS SDK |
CURL
|
2.5 |
✅ Yes |
✅ Yes |
✅ Yes |
✅ Yes |
✅ Yes |
MBS( "CURL.SetOptionPostRedir"; curl; Value )
More
MBS(
"CURL.SetOptionPostRedir"; /* Sets the redirect policy. */
$curl; /* The CURL session handle. */
$Value) /* The new bitmask for redirections.e.g. 3 */
Less
Parameters
Parameter |
Description |
Example |
curl |
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 behavior 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_301 | 1 |
CURL_REDIR_POST_302 | 2 |
CURL_REDIR_POST_ALL | 3 |
See also POSTREDIR option in CURL manual.
See also
Blog Entries
Created 18th August 2014, last changed 3th February 2021
CURL.SetOptionPostQuote
-
CURL.SetOptionPreProxy