Bezeichnung
easy:SetOpt_HTTPHeader -- legt den benutzerdefinierten HTTP-Header fest
Übersicht
easy:SetOpt_HTTPHeader(headers)
Beschreibung
Übergibt eine Tabelle mit einer Liste von HTTP-Header, die an den Server und/oder Proxy in Ihrer HTTP-Anfrage übergeben werden sollen. Die gleiche Liste kann sowohl für Host- als auch für Proxy-Anfragen verwendet werden!

Wenn Sie einen Header hinzufügen, der anderweitig generiert und intern von libcurl verwendet wird, wird stattdessen Ihr hinzugefügter Header verwendet. Wenn Sie einen Header ohne Inhalt wie in 'Accept:' (keine Daten auf der rechten Seite des Doppelpunktes) hinzufügen, wird der intern verwendete Header deaktiviert. Mit dieser Option können Sie neue Header hinzufügen, interne Header ersetzen und interne Header entfernen. Um einen Header ohne Inhalt (nichts auf der rechten Seite des Doppelpunktes) hinzuzufügen, verwenden Sie die Form 'MyHeader;' (beachten Sie das abschließende Semikolon).

Der in der Liste enthaltene Header darf nicht CRLF-terminiert sein, da libcurl nach jeder Header-Position CRLF hinzufügt. Die Nichteinhaltung führt zu seltsamen Fehlern, da der Server höchstwahrscheinlich einen Teil der von Ihnen angegebenen Header ignoriert.

Die erste Zeile einer Anforderung (die die Methode enthält, in der Regel ein GET oder POST) ist kein Header und kann mit dieser Option nicht ersetzt werden. Nur die Zeilen hinter der Anfragezeile sind Headers. Das Hinzufügen dieser Methodenzeile in diese Liste von Headers bewirkt nur, dass Ihre Anfrage einen ungültigen Header sendet. Verwenden Sie #CURLOPT_CUSTOMREQUEST, um die Methode zu ändern.

Übergeben Sie dieser Option Nil, um auf keinen benutzerdefinierten Header zurückzusetzen.

Die am häufigsten ersetzten Header haben "shortcuts" in den Optionen #CURLOPT_COOKIE, #CURLOPT_USERAGENT und #CURLOPT_REFERERER. Wir empfehlen, diese zu verwenden.

Es gibt eine alternative Option, die Headers nur für Anfragen setzt oder ersetzt, die mit CONNECT an einen Proxy gesendet werden: #CURLOPT_PROXYHEADER. Verwenden Sie #CURLOPT_HEADEROPT, um das Verhalten zu steuern.

Eingaben
headers
Eingabewert
Beispiel
e:SetOpt_HTTPHeader({"Custom-Header1: Test", "Custom-Header2: Test"})
Der obige Code fügt der HTTP-Anfrage zwei benutzerdefinierte Header hinzu.

Navigation zeigen