php curl手册,PHP: curl_setopt - Manual

CURLOPT_ABSTRACT_UNIX_SOCKET

Aktiviert die Verwendung eines abstrakten Unix Domainsocket anstatt eine

TCP-Verbindung zu einem Host aufzubauen, und setzt den Pfad auf den gegebenen

string. Diese Option teilt sich die gleiche Bedeutung mit

CURLOPT_UNIX_SOCKET_PATH. Diese beiden Optionen verwenden

den selben Speicher, und daher kann nur eine pro Handle genutzt werden.

Verfügbar seit PHP 7.3.0 und cURL 7.53.0

CURLOPT_CAINFO

Der Name einer Datei, die ein oder mehrere Zerifikate enthält, gegen

die der Peer geprüft wird. Macht nur Sinn in Verbindung mit

CURLOPT_SSL_VERIFYPEER.

Erfodert möglicherweise einen absoluten Pfad.

CURLOPT_CAPATH

Ein Verzeichnis, das mehrere CA-Zertifikate enthält. Diese Option

sollte In Kombination mit CURLOPT_SSL_VERIFYPEER

genutzt werden.

CURLOPT_COOKIE

Der Inhalt des im HTTP-Request zu setzenden

"Cookie: "-Headers

Beachten Sie daß mehrere Cookies durch ein Semikolon gefolgt von einem

Leerzeichen getrennt werden (z.B. "fruit=apple; colour=red")

CURLOPT_COOKIEFILE

Der Name einer Datei, die Cookiedaten enthält. Diese Datei kann im

Netscape-Format sein oder HTTP-geformte Header enthalten.

Wenn der Name eine leere Zeichenkette ist, werden keine Cookies geladen,

aber die Cookie-Behandlung ist dennoch aktiviert.

CURLOPT_COOKIEJAR

Der Name einer Datei in der alle internen Cookies beim Schließen

des Handles gespeichert werden, z.B. nach einem Aufruf von curl_close.

CURLOPT_COOKIELIST

Eine Cookie-Zeichenkette (d.h. eine einzelne Zeile im Netscape/Mozilla-Format, oder ein regulärer

Set-Cookie-Header im HTTP-Stil), die dieses einzelne Cookie dem internen Cookie-Speicher hinzufügt.

"ALL" löscht alle Cookies, die im Speicher vorgehalten werden.

"SESS" löscht alle Sitzungscookies, die im Speicher vorgehalten werden.

"FLUSH" schreibt alle bekannten Cookies in die durch CURLOPT_COOKIEJAR angegebene Datei.

"RELOAD" lädt alle Cookies aus der durch CURLOPT_COOKIEFILE angegebenen Datei.

Verfügbar seit PHP 5.5.0 und cURL 7.14.1.

CURLOPT_CUSTOMREQUEST

Eine benutzerdefinierte Request-Methode, die anstelle von

GET oder HEAD für den

HTTP-Request benutzt werden soll. Dies ist nützlich bei

DELETE oder anderen unüblichen Requests. Zulässige

Werte sind GET, POST,

CONNECT etc. Vollständige HTTP-Requests wie

GET /index.html HTTP/1.0\r\n\r\n sind unzulässig!Hinweis:

Führen Sie diese Anfragen nicht durch ohne sicherzugehen, daß Ihr

Server die betreffenden Kommandos unterstützt.

CURLOPT_DEFAULT_PROTOCOL

Das Standardprotokoll, das verwendet werden soll, wenn die URL kein

Schema angibt.

Hinzugefügt in cURL 7.45.0. Verfügbar seit PHP 7.0.7.

CURLOPT_DNS_INTERFACE

Setze den Namen der Netzwerkschnittstelle, an die sich der

DNS-Resolver binden soll. Dies muss ein Schnittstellenname sein

(keine Adresse).

Hinzugefügt in cURL 7.33.0. Verfügbar seit PHP 7.0.7.

CURLOPT_DNS_LOCAL_IP4

Setze die lokale IPv4 Adresse, an die sich der Resolver binden soll.

Das Argument sollte eine einzige numerische IPv4 Adresse als

Zeichenkette enthalten.

Hinzugefügt in cURL 7.33.0. Verfügbar seit PHP 7.0.7.

CURLOPT_DNS_LOCAL_IP6

Setze die lokale IPv6 Adresse, an die sich der Resolver binden soll.

Das Argument sollte eine einzige numerische IPv6 Adresse als

Zeichenkette enthalten.

Hinzugefügt in cURL 7.33.0. Verfügbar seit PHP 7.0.7.

CURLOPT_EGDSOCKET

Analog CURLOPT_RANDOM_FILE, hier wird der

Dateiname eines Entropy Gathering Daemon Socket erwartet.

CURLOPT_ENCODING

Der Inhalt des "Accept-Encoding: "-Headers. Damit

wird das Dekodieren der Serverantwort aktiviert. Unterstützte

Kodierungen sind identity, deflate

und gzip. Wird ein leerer String ""

gesetzt wird ein Header mit allen unterstützten Kodierungen gesetzt.

Hinzugefügt in cURL 7.10.

CURLOPT_FTPPORT

Ein String, der genutzt wird, um die IP-Adresse zu erlangen, die von

der FTP-PORT-Anweisung genutzt wird.

Die PORT-Anweisung teilt dem entfernten Server mit, zu der angegebenen

IP-Adresse zu verbinden. Der String kann eine einfache IP-Addresse,

ein Hostname, der Name eines Netzwerkinterfaces (unter Unix) oder nur

'-' sein, um die vordefinierte IP-Addresse (des Systems) zu nutzen.

CURLOPT_INTERFACE

Der Name des zu nutzenden Netzwerkinterfaces für ausgehende Daten.

Statt des Namens des Interfaces kann auch eine IP-Adresse oder ein

Hostname übergeben werden.

CURLOPT_KEYPASSWD

Das erforderliche Passwort, um die privaten CURLOPT_SSLKEY

oder CURLOPT_SSH_PRIVATE_KEYFILE Schlüssel zu verwenden.

Hinzugefügt in cURL 7.16.1.

CURLOPT_KRB4LEVEL

Die KRB4 (Kerberos 4) Sicherheitsstufe. Folgende Werte (von niedriger

zu höherer Stufe) sind gültig: clear,

safe, confidential,

private.

Sollte der String keinen dieser Werte enthalten dann wird die höchste

Stufe genutzt, d.h private. Sollte diese Option mit

dem Wert NULL besetzt werden, wird KRB4 Security deaktiviert. Bislang

wird KRB4 nur unter Verwendung des FTP unterstützt.

CURLOPT_LOGIN_OPTIONS

Kann verwendet werden, um Protokoll spezifische Anmeldeoptionen, wie

den bevorzugten Authentifizierungsmechanismus per "AUTH=NUM" oder

"AUTH=*", zu setzen, und sollte in Verbindung mit der

CURLOPT_USERNAME Option verwendet werden.

Hinzugefügt in cURL 7.34.0. Verfügbar seit PHP 7.0.7.

CURLOPT_PINNEDPUBLICKEY

Setze den pinned öffentlichen Schlüssel.

Die Zeichenkette kann der Dateiname des pinned öffentlichen

Schlüssels sein. Das erwartete Dateiformat ist "PEM" oder "DER".

Die Zeichenkette kann ebenfalls eine beliebige Anzahl von base64

kodierten SHA-256 Hashes sein, denen "sha256//" vorangestellt ist,

und die durch ";" getrennt sind.

Hinzugefügt in cURL 7.39.0. Verfügbar seit PHP 7.0.7.

CURLOPT_POSTFIELDS

Die in einem HTTP-POST-Request zu nutzenden Daten.

Um eine Datei zu posten stellen Sie dem Dateinamen @

voran; bitte geben Sie den vollen Pfad zur Datei an.

Der Dateityp kann explizit dadurch angegeben werden, dass dem Dateinamen

der Type im Format ';type=mimetype' nachgestellt wird.

Als Wert für diesen Parameter kann entweder ein URL-kodierter String übergeben werden wie

z.B. 'para1=val1&para2=val2&...' oder ein

Array, wobei die Feldnamen als Schlüssel und die Felddaten als Wert

verwendet werden.

Wird ein Array für value dann wird der

Content-Type-Header auf multipart/form-data

gesetzt.

Beginnend mit PHP 5.2.0 muss value ein Array

sein, wenn Dateien mit dem @-Präfix an diese

Option übergeben werden

Beginned mit PHP 5.5.0 gilt das @-Präfix als veraltet,

und Dateien können mit CURLFile gesendet werden.

Das @-Präfix kann deaktiviert werden, um die

sichere Übergabe von Werten, die mit @ beginnen,

zu gewährleisten, indem CURLOPT_SAFE_UPLOAD auf

true gesetzt wird.

CURLOPT_PRIVATE

Beliebige Daten, die mit diesem cURL-Handle assoziert werden sollen.

Diese Daten können in der Folge mit der

CURLINFO_PRIVATE Option von

Hinzugefügt in cURL 7.10.3.

CURLOPT_PRE_PROXY

Ein String, der den Hostnamen oder die IP-Adresse in Dezimalpunktschreibweise

des Preproxys enthält, zu dem sich curl für den bevorstehenden Request verbinden soll

bevor es sich zum HTTP(S) Proxy verbindet, der mit der CURLOPT_PROXY

Option angegeben wurde.

Der Preproxy kann nur ein SOCKS-Proxy sein, und er sollte mit vorangestelltem

[scheme]:// angegeben werden, um anzugeben welche Art von socks verwendet wird.

Eine numerische IPv6-Adresse muss in [eckigen Klammen] angegeben werden.

Wird der Preproxy als leere Zeichenkette angegeben, deaktiviert dies ausdrücklich die Verwendung

eines Preproxys.

Um eine Portnummer in dieser Zeichenkette anzugeben, wird ein :[port]

am Ende des Hostnamens angefügt. Die Portnummer des Proxys kann optinal mit der

separaten Option CURLOPT_PROXYPORT angegeben werden.

Per Voreinstellung wird Port 1080 für Proxys verwendet, wenn kein Port angegeben wurde.

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.52.0.

CURLOPT_PROXY

Der HTTP-Proxy, durch den Requests getunnelt werden sollen.

CURLOPT_PROXY_SERVICE_NAME

Der Name des Proxy-Authentifizierungsdienstes.

Hinzugefügt in cURL 7.34.0. Verfügbar seit PHP 7.0.7.

CURLOPT_PROXY_CAINFO

Der Pfad zu einem Proxy-Zertifikatsautoritätspaket (CA). Der Pfad wird

als String angegeben, der eine Datei benennt, die ein oder

mehrere Zertifikate enthält, die zur Prüfung des HTTPS-Proxys verwendet werden.

Diese Option gilt für die Verbindung zu einem HTTP-Proxy, nicht zu einem HTTPS-Server.

Der Standardwert ist der System-Pfad unter dem das cacert-Paket von libcurl

erwartet wird.

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.52.0.

CURLOPT_PROXY_CAPATH

Das Verzeichnis, das mehrere CA-Zertifikate enthält, mit denen der HTTPS-Proxy

geprüft wird.

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.52.0.

CURLOPT_PROXY_CRLFILE

Setzt den Dateinamen mit der Verkettung von CRL (Zertifikatswiderrufsliste)

im PEM-Format, die in der Zertifikatsprüfung, die während des SSL-Austauschs

stattfindet, verwendet wird.

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.52.0.

CURLOPT_PROXY_KEYPASSWD

Setzt die Zeichenkette, die als Passwort erforderlich ist, um den

CURLOPT_PROXY_SSLKEY privaten Schlüssel zu verwenden.

Es wird niemals ein Passwort benötigt, um ein Zertifikat zu laden, aber

es wird eins benötigt, um den privaten Schlüssel zu laden.

Diese Option gilt für die Verbindung zu einem HTTPS-Proxy, nicht zu einem HTTPS-Server.

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.52.0.

CURLOPT_PROXY_PINNEDPUBLICKEY

Setzt den festgesteckten (pinned) öffentlichen Schlüssel für den HTTPS-Proxy.

Die Zeichenkette kann der Dateiname des festgesteckten öffentlichen Schlüssels

sein. Das erwartete Dateiformat ist "PEM" oder "DER". Die Zeichenkette kann

ebenfalls eine beliebige Anzahl von Base64-kodierten SHA256-Hashwerten enthalten, denen

"sha256://" vorangestellt, und die durch ";" getrennt sind.

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.52.0.

CURLOPT_PROXY_SSLCERT

Der Dateiname des Client-Zertifikats, das zur Verbindung mit dem HTTPS-Proxy

verwendet wird. Das Standardformat ist "P12" bei Secure Transport, und "PEM"

bei anderen Engines, kann aber mit CURLOPT_PROXY_SSLCERTTYPE

geändert werden. Bei Verwendung von NSS oder Secure Transport kann es ebenfalls

der Spitzname des Zertifikats sein, das zur Authentifizierung verwendet werden soll,

wie in der Sicherheitsdatenbank hinterlegt.

Soll eine Datei im aktuellen Verzeichnis verwendet werden, sollte sie mit einem

"./"-Präfix angegeben werden, um Verwechslungen mit einem Spitznamen zu vermeiden.

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.52.0.

CURLOPT_PROXY_SSLCERTTYPE

Das Format des Client-Zertifikats, das zur Verbindung mit dem HTTPS-Proxy

verwendet wird. Unterstützte Formate sind "PEM" und "DER", außer bei Secure Transport.

OpenSSL (Version 0.9.3 und später) und Secure Transport (unter iOS 5 oder später,

oder OS X 10.7 oder später) unterstützen ebenso "P12" für PKCS#12-kodierte Dateien.

Der Standardwert ist "PEM".

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.52.0.

CURLOPT_PROXY_SSL_CIPHER_LIST

Die Liste von Chiffren, die zur Verbindung mit dem HTTPS-Proxy verwendet wird.

Die Liste muss syntaktisch korrekt sein; sie besteht aus einer oder mehreren

Chiffre-Zeichenketten, die durch Doppelpunkt getrennt sind. Kommas und Leerzeichen

sind ebenfalls als Trennzeichen erlaubt, aber normalerweise werden Doppelpunkte

verwendet; !, - und + können als Operatoren verwendet werden.

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.52.0.

CURLOPT_PROXY_TLS13_CIPHERS

Die Liste von Chiffre-Folgen, die für die TLS 1.3 Verbindung zu einem Proxy

verwendet werden. Die Liste muss syntaktisch korrekt sein; sie besteht aus einer

oder mehreren Chiffre-Folgen-Zeichenketten, die durch Doppelpunkt getrennt sind.

Die Option wird zurzeit nur verwendet, wenn curl mit OpenSSL 1.1.1 oder später

kompiliert wurde. Wird ein anderes SSL-Backend verwendet, kann versucht werden

die Chiffre-Folgen unter Verwendung der CURLOPT_PROXY_SSL_CIPHER_LIST

Option zu setzen.

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.61.0. Verfügbar wenn mit OpenSSL >= 1.1.1 kompiliert.

CURLOPT_PROXY_SSLKEY

Der Dateiname des privaten Schlüssels, der für die Verbindung zum HTTPS-Proxy verwendet wird.

Das Standardformat ist "PEM", und kann mit CURLOPT_PROXY_SSLKEYTYPE

geändert werden.

(nur für iOS und Mac OS X) Diese Option wird ignoriert, wenn curl mit Secure Transport

kompiliert wurde.

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.52.0. Verfügbar wenn beim Kompilieren TLS aktivert war.

CURLOPT_PROXY_SSLKEYTYPE

Das Format des privaten Schlüssels. Unterstützte Formate sind "PEM", "DER" und "ENG".

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.52.0.

CURLOPT_PROXY_TLSAUTH_PASSWORD

Das Passwort, das für die TLS-Authentifizierungsmethode, die mit der

CURLOPT_PROXY_TLSAUTH_TYPE Option angegeben wurde,

verwendet werden soll. Erfordert, dass die CURLOPT_PROXY_TLSAUTH_USERNAME

Option ebenfalls angegeben wird.

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.52.0.

CURLOPT_PROXY_TLSAUTH_TYPE

Die Methode der TLS-Authentifizierung, die für die HTTPS-Verbindung verwendet wird.

Die unterstützte Methode is "SRP".

Hinweis:

Die Secure Remote Password (SRP) Authentifizierung für TLS bietet gegenseitige

Authentifizierung, wenn beide Seiten ein geteiltes Geheimnis (shared secret) haben.

Um TLS-SRP zu verwenden, müssen ebenfalls die

CURLOPT_PROXY_TLSAUTH_USERNAME und

CURLOPT_PROXY_TLSAUTH_PASSWORD Optionen gesetzt werden.

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.52.0.

CURLOPT_PROXY_TLSAUTH_USERNAME

Benutzername für die HTTPS-Proxy TLS-Authentifizierungsmethode, die mit der

CURLOPT_PROXY_TLSAUTH_TYPE Option angegeben wurde. Erfordert, dass die

CURLOPT_PROXY_TLSAUTH_PASSWORD Option ebenfalls angegeben wird.

Verfügbar seit PHP 7.3.0 and libcurl >= cURL 7.52.0.

CURLOPT_PROXYUSERPWD

Benutzername und Passwort in der Form

"[benutzername]:[passwort]"

für die Proxy-Verbindung.

CURLOPT_RANDOM_FILE

Ein Dateiname der zur Initialisierung des Zufallsgenerators für SSL

benutzt wird.

CURLOPT_RANGE

Bereiche an Daten, die empfangen werden sollen. Das Format sollte

"X-Y" sein, wobei X oder

Y optional sind. HTTP-Transfers unterstützen auch

mehrere Komma-getrennte Intervalle im Format "X-Y,N-M".

CURLOPT_REFERER

Der Inhalt des "Referer: "-Headers

CURLOPT_SERVICE_NAME

Der Name des Authentifizierungsdienstes.

Hinzugefügt in cURL 7.43.0. Verfügbar seit PHP 7.0.7.

CURLOPT_SSH_HOST_PUBLIC_KEY_MD5

Eine Zeichenkette, die 32 hexadezimale Ziffern enthält. Die

Zeichenkette sollte die MD5 Prüfsumme des öffentlichen Schlüssels

des Remote-Hosts sein. libcurl wird die Verbindung zum Host

zurückweisen, falls die Prüfsummen nicht übereinstimmen.

Diese Option gilt nur für SCP und SFTP Übertragungen.

Hinzugefügt in cURL 7.17.1.

CURLOPT_SSH_PUBLIC_KEYFILE

Der Dateiname des öffentlichen Schlüssels. Wenn nicht gesetzt, nimmt

libcurl $HOME/.ssh/id_dsa.pub an, falls die HOME Umgebungsvariable

gesetzt ist, und andernfalls "id_dsa.pub" im aktuellen Verzeichnis.

Hinzugefügt in cURL 7.16.1.

CURLOPT_SSH_PRIVATE_KEYFILE

Der Dateiname des privaten Schlüssels. Wenn nicht gesetzt, nimmt

libcurl $HOME/.ssh/id_dsa an, falls die HOME Umgebungsvariable

gesetzt ist, und andernfalls "id_dsa" im aktuellen Verzeichnis.

Wenn die Datei passwort geschützt ist, muss das Passwort mit

CURLOPT_KEYPASSWD bestimmt werden.

Hinzugefügt in cURL 7.16.1.

CURLOPT_SSL_CIPHER_LIST

Eine Liste der für SSL zulässigen Chiffren. RC4-SHA

und TLSv1 sind zulässig.

CURLOPT_SSLCERT

Der Name einer Datei die ein Zertifikat im PEM-Format enthält.

CURLOPT_SSLCERTPASSWD

Das Passwort für das CURLOPT_SSLCERT-Zertifikat.

CURLOPT_SSLCERTTYPE

Das Format des Zertifikats. Unterstützt werden PEM

(Standard), DER und ENG.

Von OpenSSL 0.9.3 an wird "P12" (für PKCS#12-kodierte Dateien)

ebenfalls unterstützt.

Hinzugefügt in cURL 7.9.3.

CURLOPT_SSLENGINE

Der Bezeichner für die Crypto Engine des privaten SSL-Schlüssels, der

in CURLOPT_SSLKEY definiert ist.

CURLOPT_SSLENGINE_DEFAULT

Der Bezeichner für die Crypto-Engine für asymmetrische kryptographische

Operationen.

CURLOPT_SSLKEY

Der Name einer Datei, die einen privaten SSL-Schlüssel enthält.

CURLOPT_SSLKEYPASSWD

Das geheime Passwort das für den in CURLOPT_SSLKEY

definierten privaten SSL-Schlüssel.Hinweis:

Da diese Option sensible Daten enthält sollte das PHP-Script in

einer sicheren Umgebung liegen.

CURLOPT_SSLKEYTYPE

Der Typ des in CURLOPT_SSLKEY definierten

privaten SSL-Schlüssels. Unterstützte Schlüssel-Typen sind

PEM (Standard), DER

und ENG.

CURLOPT_TLS13_CIPHERS

Die Liste von Chiffre-Folgen, die für die TLS 1.3 Verbindung verwendet werden. Die

List muss syntaktisch korrekt sein; sie besteht aus einer oder mehreren

Chiffre-Folgen-Zeichenketten, die durch Doppelpunkt getrennt sind. Die Option wird

zurzeit nur verwendet, wenn curl mit OpenSSL 1.1.1 oder später kompiliert wurde.

Wird ein anderes SSL-Backend verwendet, kann versucht werden die TLS 1.3

Chiffre-Folgen unter Verwendung der CURLOPT_SSL_CIPHER_LIST

Option zu setzen.

Verfügbar seit PHP 7.3.0 und libcurl >= cURL 7.61.0. Verfügbar wenn mit OpenSSL >= 1.1.1 kompiliert.

CURLOPT_UNIX_SOCKET_PATH

Aktiviert die Verwendung von Unix-Domain-Sockets als Verbindsendpunkt,

und setzt den Pfad auf den angegebenen String.

Hinzugefügt in cURL 7.40.0. Verfügbar seit PHP 7.0.7.

CURLOPT_URL

Der abzurufende URL; kann auch beim initialisieren der Session mittels

CURLOPT_USERAGENT

Der Wert des "User-Agent: "-Headers für den

HTTP-Request

CURLOPT_USERNAME

Der für die Authentifizierung zu verwendende Benutzername.

Hinzugefügt in cURL 7.19.1. Verfügbar seit PHP 5.5.0.

CURLOPT_USERPWD

Benutzername und Passwort im Format "[benutzername]:[passwort]"

CURLOPT_XOAUTH2_BEARER

Gibt das OAuth 2.0 Access-Token an.

Hinzugefügt in cURL 7.33.0. Verfügbar seit PHP 7.0.7.