Bezeichnung
easy:SetOpt_PostRedir -- setzt die Vorgehensweise bei einer HTTP-POST-Umleitung
Übersicht
easy:SetOpt_PostRedir(bitmask)
Beschreibung
Übergeben Sie eine Bitmaske, um zu steuern, wie libcurl auf Umleitungungen nach POSTs reagiert, die eine 301-, 302- oder 303-Antwort zurückerhalten.

Ein Parameter mit gesetztem Bit 0 (Wert #CURL_REDIR_POST_301) weist die Bibliothek an, RFC 7231 (Abschnitt 6.4.2 bis 6.4.4) zu beachten und POST-Anforderungen bei einer 301-Umleitung nicht in GET-Anforderungen zu konvertieren. Das Setzen von Bit 1 (Wert #CURL_REDIR_POST_302) bewirkt, dass libcurl die Anforderungsmethode nach einer Umleitung von 302 beibehält, während das Setzen von Bit 2 (Wert #CURL_REDIR_POST_303) bewirkt, dass libcurl die Anforderungsmethode nach einer Umleitung von 303 beibehält. Der Wert #CURL_REDIR_POST_ALL ist eine Komfortfunktion, die alle drei Bits setzt.

Das Nicht-RFC-Verhalten ist in Webbrowsern allgegenwärtig, daher führt die Bibliothek die Konvertierung standardmäßig aus, um die Durchgängigkeit zu gewährleisten. Ein Server kann jedoch verlangen, dass ein POST nach einer solchen Umleitung ein POST bleibt. Diese Option ist nur beim Festlegen von #CURLOPT_FOLLOWLOCATION von Bedeutung.

Eingaben
bitmask
Eingabewert

Navigation zeigen