PHP 8.4.0 RC4 available for testing

Vordefinierte Konstanten

Folgende Konstanten werden von dieser Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen wurde.

Beschreibungen und Funktionsweise dieser Konstanten sind unter curl_setopt(), curl_multi_setopt() und curl_getinfo() verfügbar.

CURLFTP_CREATE_DIR (int)
Verfübar seit PHP 7.0.7 und cURL 7.19.3
CURLFTP_CREATE_DIR_NONE (int)
Vefügbar seit PHP 7.0.7 und cURL 7.19.3
CURLFTP_CREATE_DIR_RETRY (int)
Verfübar seit PHP 7.0.7 und cURL 7.19.3
CURLFTPSSL_TRY (int)
CURLFTPSSL_ALL (int)
CURLFTPSSL_CONTROL (int)
CURLFTPSSL_NONE (int)
CURLFTPMETHOD_DEFAULT (int)
Verfügbar seit PHP 8.2.0 und cURL 7.15.3.
CURLALTSVC_H1 (int)
Verfügbar seit PHP 8.2.0 und cURL 7.64.1.
CURLALTSVC_H2 (int)
Verfügbar seit PHP 8.2.0 und cURL 7.64.1.
CURLALTSVC_H3 (int)
Verfügbar seit PHP 8.2.0 und cURL 7.64.1.
CURLALTSVC_READONLYFILE (int)
Verfügbar seit PHP 8.2.0 und cURL 7.64.1.
CURL_SSLVERSION_DEFAULT (int)
CURL_SSLVERSION_TLSv1 (int)
CURL_SSLVERSION_SSLv2 (int)
CURL_SSLVERSION_SSLv3 (int)
CURL_SSLVERSION_TLSv1_0 (int)
CURL_SSLVERSION_TLSv1_1 (int)
CURL_SSLVERSION_TLSv1_2 (int)
CURL_SSLVERSION_TLSv1_3 (int)
Verfügbar seit PHP 7.3.0 und cURL 7.52.0
CURLHSTS_ENABLE (int)
Verfügbar seit PHP 8.2.0 und cURL 7.74.0
CURLHSTS_READONLYFILE (int)
Verfügbar seit PHP 8.2.0 und cURL 7.74.0
CURLAUTH_BASIC (int)
CURLAUTH_DIGEST (int)
CURLAUTH_GSSNEGOTIATE (int)
CURLAUTH_NEGOTIATE (int)
Verfügbar seit PHP 7.0.7 und cURL 7.38.0.
CURLAUTH_NTLM (int)
CURLAUTH_NTLM_WB (int)
Verfügbar seit PHP 7.0.7 und cURL 7.22.0
CURLAUTH_ANY (int)
CURLAUTH_ANYSAFE (int)
CURLAUTH_AWS_SIGV4 (int)
Verfügbar seit PHP 8.2.0 und cURL 7.75.0.
CURLPX_BAD_ADDRESS_TYPE (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_BAD_VERSION (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_CLOSED (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_GSSAPI (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_GSSAPI_PERMSG (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_GSSAPI_PROTECTION (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_IDENTD_DIFFER (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_IDENTD (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_LONG_HOSTNAME (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_LONG_PASSWD (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_LONG_USER (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_NO_AUTH (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_OK (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_RECV_ADDRESS (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_RECV_AUTH (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_RECV_CONNECT (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_RECV_REQACK (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_REPLY_ADDRESS_TYPE_NOT_SUPPORTED (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_REPLY_COMMAND_NOT_SUPPORTED (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_REPLY_CONNECTION_REFUSED (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_REPLY_GENERAL_SERVER_FAILURE (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_REPLY_HOST_UNREACHABLE (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_REPLY_NETWORK_UNREACHABLE (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_REPLY_NOT_ALLOWED (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_REPLY_TTL_EXPIRED (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_REPLY_UNASSIGNED (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_REQUEST_FAILED (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_RESOLVE_HOST (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_SEND_AUTH (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_SEND_CONNECT (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_SEND_REQUEST (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_UNKNOWN_FAIL (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_UNKNOWN_MODE (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLPX_USER_REJECTED (int)
Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURL_PUSH_OK (int)
Verfügbar seit PHP 7.1.0 und cURL 7.44.0
CURL_PUSH_DENY (int)
Verfügbar seit PHP 7.1.0 und cURL 7.44.0
CURL_REDIR_POST_301 (int)
Verfügbar seit PHP 7.0.7 und cURL 7.18.2
CURL_REDIR_POST_302 (int)
Verfügbar seit PHP 7.0.7 und cURL 7.18.2
CURL_REDIR_POST_303 (int)
Verfügbar seit PHP 7.0.7 und cURL 7.25.1
CURL_REDIR_POST_ALL (int)
Verfügbar seit PHP 7.0.7 und cURL 7.18.2
CURL_TIMECOND_NONE (int)
CURL_TIMECOND_IFMODSINCE (int)
CURL_TIMECOND_IFUNMODSINCE (int)
CURL_TIMECOND_LASTMOD (int)
CURL_VERSION_ALTSVC (int)
Verfügbar seit PHP 7.3.6 und cURL 7.64.1
CURL_VERSION_ASYNCHDNS (int)
Asynchrone DNS-Auflösungen. Verfügbar seit PHP 7.3.0 und cURL 7.10.7
CURL_VERSION_BROTLI (int)
Verfügbar seit PHP 7.3.0 und cURL 7.57.0
CURL_VERSION_CONV (int)
Zeichenumwandlungen werden unterstützt. Verfügbar seit PHP 7.3.0 und cURL 7.15.4
CURL_VERSION_CURLDEBUG (int)
Speicher-Tracking für Debugging wird unterstützt. Verfügbar seit PHP 7.3.6 und cURL 7.19.6
CURL_VERSION_DEBUG (int)
Mit Debug-Unterstützung kompiliert. Verfügbar seit PHP 7.3.0 und cURL 7.10.6
CURL_VERSION_GSASL (int)
Verfügbar seit PHP 8.2.0 und cURL 7.76.0
CURL_VERSION_GSSAPI (int)
Wurde gegen eine GSS-API-Bibliothek kompiliert. Verfügbar seit PHP 7.3.0 und cURL 7.38.0
CURL_VERSION_GSSNEGOTIATE (int)
Das Aushandeln der Authentifizierung wird unterstützt. Verfügbar seit PHP 7.3.0 und cURL 7.10.6 (missbilligt seit 7.38.0)
CURL_VERSION_HSTS (int)
Verfügbar seit PHP 8.2.0 und cURL 7.74.0
CURL_VERSION_IDN (int)
Internationalisierte Domain-Namen werden unterstützt. Verfügbar seit PHP 7.3.0 und cURL 7.12.0
CURL_VERSION_MULTI_SSL (int)
Verfügbar seit PHP 7.3.0 und cURL 7.56.0
CURL_VERSION_NTLM (int)
Die NTLM-Authentifizierung wird unterstützt. Verfügbar seit PHP 7.3.0 und cURL 7.10.6
CURL_VERSION_NTLM_WB (int)
Die NTLM-Delegation an den Winbind-Assistenten wird unterstützt. Verfügbar seit PHP 7.3.0 und cURL 7.22.0
CURL_VERSION_IPV6 (int)
IPv6-fähig.
CURL_VERSION_KERBEROS4 (int)
Die Kerberos-V4-Authentifizierung wird unterstützt.
CURL_VERSION_KERBEROS5 (int)
Die Kerberos-V5-Authentifizierung wird unterstützt. Verfügbar seit PHP 7.0.7 und cURL 7.40.0
CURL_VERSION_HTTP2 (int)
Die Unterstützung für HTTP2 ist integriert. Verfügbar seit cURL 7.33.0
CURL_VERSION_HTTP3 (int)
Verfügbar seit PHP 8.2.0 und cURL 7.66.0
CURL_VERSION_LARGEFILE (int)
Unterstützt Dateien, die größer als 2 GB sind. Verfügbar seit cURL 7.33.0
CURL_VERSION_PSL (int)
Mozillas öffentliche Suffix-Liste, die für die Überprüfung der Cookie-Domäne verwendet wird. Verfügbar seit PHP 7.3.6 und cURL 7.47.0
CURL_VERSION_SPNEGO (int)
Die SPNEGO-Authentifizierung wird unterstützt. Verfügbar seit PHP 7.3.0 und cURL 7.10.8
CURL_VERSION_SSPI (int)
Wurde gegen die Windows-SSPI kompiliert. Verfügbar seit PHP 7.3.0 und cURL 7.13.2
CURL_VERSION_SSL (int)
SSL-Optionen sind verfügbar.
CURL_VERSION_TLSAUTH_SRP (int)
Die TLS-SRP-Authentifizierung wird unterstützt. Verfügbar seit PHP 7.3.0 und cURL 7.21.4
CURL_VERSION_UNICODE (int)
Verfügbar seit PHP 8.2.0 und cURL 7.72.0
CURL_VERSION_UNIX_SOCKETS (int)
Unterstützung von Unix-Domain-Sockets. Verfügbar seit PHP 7.0.7 und cURL 7.40.0
CURL_VERSION_ZSTD (int)
Verfügbar seit PHP 8.2.0 und cURL 7.72.0
CURL_VERSION_LIBZ (int)
libz-Funktionen sind verfügbar.
CURLVERSION_NOW (int)
CURLFTPAUTH_DEFAULT (int)
CURLFTPAUTH_SSL (int)
CURLFTPAUTH_TLS (int)
CURLPROXY_HTTP (int)
Verfügbar seit cURL 7.10.
CURLPROXY_HTTP_1_0 (int)
Verfügbar seit PHP 7.0.7 und cURL 7.19.3
CURLPROXY_SOCKS4 (int)
Verfübar seit cURL 7.10.
CURLPROXY_SOCKS5 (int)
Verfügbar seit cURL 7.10.
CURL_NETRC_OPTIONAL (int)
CURL_NETRC_IGNORED (int)
CURL_NETRC_REQUIRED (int)
CURL_HTTP_VERSION_NONE (int)
CURL_HTTP_VERSION_1_0 (int)
CURL_HTTP_VERSION_1_1 (int)
CURL_HTTP_VERSION_2 (int)
Verfügbar seit PHP 7.0.7 und cURL 7.43.0
CURL_HTTP_VERSION_2_0 (int)
Verfügbar seit cURL 7.33.0
CURL_HTTP_VERSION_2TLS (int)
Verfügbar seit PHP 7.0.7 und cURL 7.47.0
CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE (int)
Verfügbar seit PHP 7.0.7 und cURL 7.49.0
CURLMSG_DONE (int)
CURLSSLOPT_ALLOW_BEAST (int)
Verfügbar seit cURL 7.25.0
CURLSSLOPT_NO_REVOKE (int)
Verfügbar seit PHP 7.0.7 und cURL 7.44.0
CURLSSLOPT_AUTO_CLIENT_CERT (int)
Verfügbar seit PHP 8.2.0 und cURL 7.77.0
CURLSSLOPT_NATIVE_CA (int)
Verfügbar seit PHP 8.2.0 und cURL 7.71.0
CURLSSLOPT_NO_PARTIALCHAIN (int)
Verfügbar seit PHP 8.2.0 und cURL 7.68.0
CURLSSLOPT_REVOKE_BEST_EFFORT (int)
Verfügbar seit PHP 8.2.0 und cURL 7.70.0
CURLSSH_AUTH_AGENT (int)
Verfügbar seit PHP 7.0.7 und cURL 7.28.0
CURLSSH_AUTH_ANY (int)
CURLSSH_AUTH_DEFAULT (int)
CURLSSH_AUTH_HOST (int)
CURLSSH_AUTH_KEYBOARD (int)
CURLSSH_AUTH_NONE (int)
CURLSSH_AUTH_PASSWORD (int)
CURLSSH_AUTH_PUBLICKEY (int)
CURLPIPE_NOTHING (int)
Verfügbar seit cURL 7.43.0.
CURLPIPE_HTTP1 (int)
Verfügbar seit cURL 7.43.0.
CURLPIPE_MULTIPLEX (int)
Verfübar seit cURL 7.43.0.
CURLPROXY_SOCKS4A (int)
Verfügbar seit cURL 7.18.0.
CURLPROXY_SOCKS5_HOSTNAME (int)
Verfügbar seit cURL 7.18.0.
CURLHEADER_SEPARATE (int)
Verfügbar seit PHP 7.0.7 und cURL 7.37.0.
CURLHEADER_UNIFIED (int)
Verfügbar seit PHP 7.0.7 und cURL 7.37.0.
CURLAUTH_GSSAPI (int)
Verfügbar seit PHP 7.3.0 und cURL 7.54.1
CURL_MAX_READ_SIZE (int)
Verfügbar seit PHP 7.3.0 und cURL 7.53.0
CURLPROXY_HTTPS (int)
Verfügbar seit PHP 7.3.0 und cURL 7.52.0
CURL_SSLVERSION_MAX_DEFAULT (int)
Verfügbar seit PHP 7.3.0 und cURL 7.54.0
CURL_SSLVERSION_MAX_NONE (int)
Verfügbar seit PHP 7.3.0 und cURL 7.54.0
CURL_SSLVERSION_MAX_TLSv1_0 (int)
Verfügbar seit PHP 7.3.0 und cURL 7.54.0
CURL_SSLVERSION_MAX_TLSv1_1 (int)
Verfügbar seit PHP 7.3.0 und cURL 7.54.0
CURL_SSLVERSION_MAX_TLSv1_2 (int)
Verfügbar seit PHP 7.3.0 und cURL 7.54.0
CURL_SSLVERSION_MAX_TLSv1_3 (int)
Verfügbar seit PHP 7.3.0 und cURL 7.54.0
CURL_VERSION_HTTPS_PROXY (int)
Verfügbar seit PHP 7.3.0 und cURL 7.52.0
CURLAUTH_BEARER (int)
Verfügbar seit PHP 7.3.0 und cURL 7.61.0.
CURLSSH_AUTH_GSSAPI (int)
Verfügbar seit PHP 7.3.0 und cURL 7.58.0
CURLMIMEOPT_FORMESCAPE (int)
Verfügbar seit PHP 8.3.0 und cURL 7.81.0
CURLWS_RAW_MODE (int)
Verfügbar seit PHP 8.3.0 und cURL 7.86.0
CURLKHMATCH_OK (int)
Verfügbar seit PHP 8.3.0 und cURL 7.19.6
CURLKHMATCH_MISMATCH (int)
Verfügbar seit PHP 8.3.0 und cURL 7.19.6
CURLKHMATCH_MISSING (int)
Verfügbar seit PHP 8.3.0 und cURL 7.19.6
CURLKHMATCH_LAST (int)
Verfügbar seit PHP 8.3.0 und cURL 7.19.6
curl-setopt()
Konstanten Beschreibung
CURLOPT_ABSTRACT_UNIX_SOCKET (int)

Aktiviert die Verwendung eines abstrakten Unix-Domainsockets anstatt eine TCP-Verbindung zu einem Host aufzubauen, und setzt den Pfad auf den gegebenen String. Diese Option folgt der gleichen Semantik wie die Option CURLOPT_UNIX_SOCKET_PATH. Diese beiden Optionen verwenden den selben Speicher, weshalb nur eine pro Handle genutzt werden kann. Verfügbar seit PHP 7.3.0 und cURL 7.53.0

CURLOPT_ACCEPT_ENCODING (int)

Sets a string with the contents of the Accept-Encoding: header sent in an HTTP request. Set to null to disable sending the Accept-Encoding: header. Defaults to null. Available as of cURL 7.21.6.

CURLOPT_ACCEPTTIMEOUT_MS (int)

The maximum number of milliseconds to wait for a server to connect back to cURL when an active FTP connection is used. This option accepts any value that can be cast to a valid int. Defaults to 60000 milliseconds. Available as of cURL 7.24.0.

CURLOPT_ADDRESS_SCOPE (int)

The scope id value to use when connecting to IPv6 addresses. This option accepts any value that can be cast to a valid int. Defaults to 0. Available as of cURL 7.19.0.

CURLOPT_ALTSVC (int)

Gibt den Namen der Datei an, die cURL für den Alt-Svc-Cache verwenden soll, um den Inhalt des Caches auszulesen und gegebenenfalls nach einer Übertragung zurückzuschreiben. Letzteres ist allerdings nur möglich, wenn in CURLOPT_ALTSVC_CTRL nicht die Option CURLALTSVC_READONLYFILE verwendet wird. Verfügbar seit PHP 8.2.0 und cURL 7.64.1.

CURLOPT_ALTSVC_CTRL (int)

Eine Bitmaske mit dem gewünschten Satz von Merkmalen. Sie wird verwendet, um cURL anzuweisen, wie Alt-Svc bei der Übertragung mit diesem Handle zu verwenden ist. cURL akzeptiert Alt-Svc-Header nur über HTTPS. Es führt auch nur dann eine Anfrage an einen alternativen Ursprung aus, wenn dieser Ursprung ordnungsgemäß über HTTPS gehostet wird. Das Setzen eines beliebigen Bits aktiviert die Alt-Svc-Engine. Folgende Optionen stehen zur Verfügung: CURLALTSVC_H1, CURLALTSVC_H2, CURLALTSVC_H3 und CURLALTSVC_READONLYFILE. Verfügbar seit PHP 8.2.0 und cURL 7.64.1.

CURLOPT_APPEND (int)

Setting this option to 1 will cause FTP uploads to append to the remote file instead of overwriting it. Defaults to 0. Available as of cURL 7.17.0.

CURLOPT_AUTOREFERER (int)

true, um automatisch den Referer: in Anfragen zu setzen, die einer Weiterleitung per Location: folgen.

CURLOPT_AWS_SIGV4 (int)

Stellt die AWS V4-Signatur-Authentifizierung im HTTP(S)-Header bereit. Diese Option hat Vorrang vor allen anderen Authentifizierungstypen, die in CURLOPT_HTTPAUTH angegeben wurden. Diese Methode kann nicht mit anderen Authentifizierungstypen kombiniert werden. Verfügbar seit PHP 8.2.0 und cURL 7.75.0

CURLOPT_BINARYTRANSFER (int)

CURLOPT_BUFFERSIZE (int)

Die für jede Leseoperation zulässige Puffergröße. Es ist nicht garantiert, dass diese Einstellung genutzt wird. Verfügbar seit cURL 7.10.

CURLOPT_CAINFO (int)

Der Name einer Datei, die ein oder mehrere Zertifikate enthält, gegen die der Peer geprüft wird. Nur sinnvoll in Verbindung mit CURLOPT_SSL_VERIFYPEER. Erfodert möglicherweise einen absoluten Pfad.

CURLOPT_CAINFO_BLOB (int)

Der Name einer PEM-Datei, die ein oder mehrere Zertifikate enthält, mit denen die Gegenstelle verifiziert werden soll. Diese Option hat Vorrang vor CURLOPT_CAINFO. Verfügbar seit PHP 8.2.0 und cURL 7.77.0

CURLOPT_CAPATH (int)

Ein Verzeichnis, das mehrere CA-Zertifikate enthält. Diese Option sollte in Kombination mit CURLOPT_SSL_VERIFYPEER genutzt werden.

CURLOPT_CA_CACHE_TIMEOUT (int)

Verfügbar seit PHP 8.3.0 und cURL 7.87.0

CURLOPT_CERTINFO (int)

true, um die SSL-Zertifikatsinformation bei sicheren Übertragungen auf STDERR auszugeben. Verfügbar seit cURL 7.19.1. Erfordert, dass CURLOPT_VERBOSE gesetzt ist, um eine Wirkung zu haben.

CURLOPT_CONNECTTIMEOUT (int)

Die Anzahl Sekunden, die der Verbindungsaufbau maximal dauern darf; 0 hebt die Begrenzung auf.

CURLOPT_CONNECTTIMEOUT_MS (int)

Die Anzahl Millisekunden, die der Verbindungsaufbau maximal dauern darf; 0 hebt die Begrenzung auf. Wenn libcurl so kompiliert wurde, dass die Standard-Namensauflösung des Systems verwendet wird, wird dieser Teil der Verbindung dennoch die volle Sekunden-Auflösung für Zeitlimits mit einem minimalen Das Zeitlimit von einer Sekunde verwenden. Verfügbar seit cURL 7.16.2.

CURLOPT_CONNECT_ONLY (int)

true weist die Bibliothek an, die gesamte erforderliche Proxy-Authentifizierung und den Verbindungsaufbau durchzuführen, aber keine Datenübertragung. Diese Option ist für HTTP, SMTP und POP3 implementiert. Verfügbar seit cURL 7.15.2.

CURLOPT_CONNECT_TO (int)

Verbinde zu einem bestimmten Host und Port anstatt dem Host und Port, der in der URL angegeben ist. Erwartet ein Array von Zeichenketten im Format HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT. Verfügbar seit PHP 7.0.7 und cURL 7.49.0

Der Inhalt des in der HTTP-Anfrage zu setzenden "Cookie: "-Headers Es ist zu beachten dass mehrere Cookies durch ein Semikolon gefolgt von einem Leerzeichen getrennt werden (z. B. "fruit=apple; colour=red")

CURLOPT_COOKIEFILE (int)

Der Name einer Datei, die Cookiedaten enthält. Diese Datei kann im Netscape-Format sein oder nur einfache Header im HTTP-Stil enthalten. Wenn der Name eine leere Zeichenkette ist, werden keine Cookies geladen, aber die Cookie-Behandlung ist dennoch aktiviert.

CURLOPT_COOKIEJAR (int)

Der Name einer Datei, in der alle internen Cookies gespeichert werden, wenn der Destruktor des Handles aufgerufen wird.

Warnung

Seit PHP 8.0.0 ist curl_close() eine Null-Operation (no-op) und zerstört das Handle nicht. Wenn Cookies geschrieben werden müssen, bevor das Handle automatisch zerstört wird, muss unset() auf das Handle angewendet werden.

CURLOPT_COOKIELIST (int)

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 Session-Cookies, 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 cURL 7.14.1

CURLOPT_COOKIESESSION (int)

true, um diese Anfrage als neue Cookie-"Session" zu behandeln. Somit wird libcurl alle Cookies, die geladen werden sollen, ignorieren, sofern es sich um "Session-Cookies" einer vorherigen Session handelt. Standardmäßig lädt und speichert libcurl alle Cookies, unabhängig davon, ob es Session-Cookies sind. Bei Session-Cookies handelt es sich um Cookies ohne Ablaufdatum, die nur für die aktuelle Session gültig sind.

CURLOPT_CRLF (int)

true, um Unix-Zeilenumbrüche beim Transfer in CRLF-Zeilenumbrüche umzuwandeln.

CURLOPT_CRLFILE (int)

Pass a string naming a file with the concatenation of CRL (Certificate Revocation List) (in PEM format) to use in the certificate validation that occurs during the SSL exchange. When cURL is built to use GnuTLS, there is no way to influence the use of CRL passed to help in the verification process. When cURL is built with OpenSSL support, X509_V_FLAG_CRL_CHECK and X509_V_FLAG_CRL_CHECK_ALL are both set, requiring CRL check against all the elements of the certificate chain if a CRL file is passed. Also note that CURLOPT_CRLFILE implies CURLSSLOPT_NO_PARTIALCHAIN as of cURL 7.71.0 due to an OpenSSL bug. Available as of cURL 7.19.0

CURLOPT_CUSTOMREQUEST (int)

Eine benutzerdefinierte Anfragemethode, die anstelle von "GET" oder "HEAD" für die HTTP-Anfrage benutzt werden soll. Dies ist nützlich bei "DELETE" oder anderen unüblichen Anfragen. Zulässige Werte sind "GET", "POST", "CONNECT" etc. Vollständige HTTP-Anfragen wie "GET /index.html HTTP/1.0\r\n\r\n" sind unzulässig!

Hinweis:

Diese Anfragen sollten nicht durchgeführt werden, ohne sicherzustellen, dass der Server die betreffenden Kommandos unterstützt.

CURLOPT_DEFAULT_PROTOCOL (int)

Das Standardprotokoll, das verwendet werden soll, wenn die URL kein Schema angibt. Verfügbar seit PHP 7.0.7 und cURL 7.45.0

CURLOPT_DIRLISTONLY (int)

Setting this option to 1 will have different effects based on the protocol it is used with. FTP and SFTP based URLs will list only the names of files in a directory. POP3 will list the email message or messages on the POP3 server. For FILE, this option has no effect as directories are always listed in this mode. Using this option with CURLOPT_WILDCARDMATCH will prevent the latter from having any effect. Defaults to 0. Available as of cURL 7.17.0.

CURLOPT_DISALLOW_USERNAME_IN_URL (int)

true, um URLs, die einen Benutzernamen enthalten, zu verbieten. Benutzernamen sind in der Voreinstellung (0) erlaubt. Verfügbar seit PHP 7.3.0 und cURL 7.61.0

CURLOPT_DNS_CACHE_TIMEOUT (int)

Die Dauer in Sekunden, die ein DNS-Eintrag im Speicher gehalten wird. Der Standard sind 120 Sekunden (2 Minuten).

CURLOPT_DNS_INTERFACE (int)

Der Name der Netzwerkschnittstelle, an die sich der DNS-Resolver binden soll. Dies muss ein Schnittstellenname sein (keine Adresse). Verfügbar seit PHP 7.0.7 und cURL 7.33.0

CURLOPT_DNS_LOCAL_IP4 (int)

Die lokale IPv4-Adresse, an die sich der Resolver binden soll. Das Argument sollte eine einzige numerische IPv4-Adresse als Zeichenkette enthalten. Verfügbar seit PHP 7.0.7 und cURL 7.33.0

CURLOPT_DNS_LOCAL_IP6 (int)

Die lokale IPv6-Adresse, an die sich der Resolver binden soll. Das Argument sollte eine einzige numerische IPv6-Adresse als Zeichenkette enthalten. Verfügbar seit PHP 7.0.7 und cURL 7.33.0

CURLOPT_DNS_SERVERS (int)

Pass a string with a comma-separated list of DNS servers to be used instead of the system default (e.g.: 192.168.1.100,192.168.1.101:8080). Available as of cURL 7.24.0

CURLOPT_DNS_SHUFFLE_ADDRESSES (int)

true, um die Reihenfolge aller zurückgegebenen Adressen zu mischen sodass sie in zufälliger Reihenfolge verwendet werden, wenn ein Name aufgelöst wird und mehr als eine IP-Adresse zurückgegeben wurde. Dies kann bewirken, dass IPv4 vor IPv6 verwendet wird, oder umgekehrt. Verfügbar seit PHP 7.3.0 und cURL 7.60.0

CURLOPT_DNS_USE_GLOBAL_CACHE (int)

true, um den globalen DNS-Cache zu nutzen. Diese Option ist nicht thread-safe. Sie ist standardmäßig aktiviert, wenn PHP für Singlethread-Verwendung kompiliert wurde (CLI, FCGI, Apache2-Prefork etc.).

CURLOPT_DOH_SSL_VERIFYHOST (int)

Überprüft die Namensfelder des SSL-Zertifikats des DNS-over-HTTPS-Servers in Bezug auf den Hostnamen. Verfügbar seit PHP 8.2.0 und cURL 7.76.0.

CURLOPT_DOH_SSL_VERIFYPEER (int)

Überprüft die Authentizität des SSL-Zertifikats des DNS-over-HTTPS-Servers. Verfügbar seit PHP 8.2.0 und cURL 7.76.0.

CURLOPT_DOH_SSL_VERIFYSTATUS (int)

Weist cURL an, den Status des DNS-over-HTTPS-Serverzertifikats mit Hilfe der TLS-Erweiterung "Certificate Status Request" (OCSP-Stapling) zu überprüfen. Verfügbar seit PHP 8.2.0 und cURL 7.76.0.

CURLOPT_DOH_URL (int)

Gibt die URL für DNS-over-HTTPS an. Verfügbar seit PHP 8.1.0 und cURL 7.62.0.

CURLOPT_EGDSOCKET (int)

Wie CURLOPT_RANDOM_FILE, aber ein Dateiname für einen Entropy Gathering Daemon Socket.

CURLOPT_ENCODING (int)

Der Inhalt des "Accept-Encoding: "-Headers. Damit wird das Dekodieren der Serverantwort aktiviert. Unterstützte Kodierungen sind "identity", "deflate" und "gzip". Wenn eine leere Zeichenkette "" angegeben wird, wird ein Header mit allen unterstützten Kodierungen gesendet. Verfügbar seit cURL 7.10.

CURLOPT_EXPECT_100_TIMEOUT_MS (int)

Das Zeitlimit für Expect: 100-continue-Antworten in Millisekunden. Standardwert sind 1000 Millisekunden. Verfügbar seit PHP 7.0.7 und cURL 7.36.0

CURLOPT_FAILONERROR (int)

true, um PHP anzuweisen, bei Fehlern aufgrund eines HTTP-Codes größer oder gleich 400 eine ausführliche Fehlermeldung zu liefern. Das Standardverhalten ist, die Seite normal zurückzugeben und den Code zu ignorieren.

CURLOPT_FILE (int)

Die Datei, in die der Transfer geschrieben werden soll. Standard ist STDOUT (der Browser).

CURLOPT_FILETIME (int)

true, um zu versuchen, das Änderungsdatum des serverseitigen Dokuments zu ermitteln. Der Wert kann über die Funktion curl_getinfo() unter Verwendung des Parameters CURLINFO_FILETIME ermittelt werden.

CURLOPT_FNMATCH_FUNCTION (int)

Pass a callable that will be used for wildcard matching. The signature of the callback should be:

callback(resource $curlHandle, string $pattern, string $string): int
curlHandle
The cURL handle.
pattern
The wildcard pattern.
string
The string to run the wildcard pattern matching on.
The callback should return CURL_FNMATCHFUNC_MATCH if pattern matches the string, CURL_FNMATCHFUNC_NOMATCH if not or CURL_FNMATCHFUNC_FAIL if an error occurred. Available as of cURL 7.21.0.

CURLOPT_FOLLOWLOCATION (int)

true, um jedem "Location: "-Header zu folgen, den der Server als Teil der HTTP-Header zurückgibt. Siehe auch CURLOPT_MAXREDIRS. Diese Konstante ist nicht verfügbar, wenn open_basedir aktiviert ist.

CURLOPT_FORBID_REUSE (int)

true, um die Verbindung nach der Verarbeitung explizit zu schließen, sodass sie nicht wiederverwendet werden kann.

CURLOPT_FRESH_CONNECT (int)

true um die Verwendung einer neuen Verbindung zu erzwingen, statt eine zwischengespeicherte zu verwenden.

CURLOPT_FTPAPPEND (int)

true, um Daten an die serverseitige Datei anzuhängen anstatt diese zu überschreiben.

CURLOPT_FTPASCII (int)

Ein Alias für CURLOPT_TRANSFERTEXT, das bevorzugt werden sollte.

CURLOPT_FTPLISTONLY (int)

true, um nur die Namen in einem FTP-Verzeichnis aufzulisten.

CURLOPT_FTPPORT (int)

Der Wert, der genutzt wird, um die IP-Adresse zu erlangen, die von der FTP-Anweisung "PORT" genutzt wird. Die "PORT"-Anweisung teilt dem entfernten Server mit, zu der angegebenen IP-Adresse zu verbinden. Die Zeichenkette kann eine einfache IP-Addresse, ein Hostname, der Name einer Netzwerkschnittstelle (unter Unix) oder nur '-' sein, um die vordefinierte IP-Addresse des Systems zu nutzen.

CURLOPT_FTPSSLAUTH (int)

Die FTP-Authentifizierungsmethode (wenn aktiviert): CURLFTPAUTH_SSL (versuche zunächst SSL), CURLFTPAUTH_TLS (versuche zunächst TLS) oder CURLFTPAUTH_DEFAULT (lass cURL entscheiden). Verfügbar seit cURL 7.12.2.

CURLOPT_FTP_ACCOUNT (int)

Pass a string that will be sent as account information over FTP (using the ACCT command) after username and password has been provided to the server. Set to null to disable sending the account information. Defaults to null. Available as of cURL 7.13.0.

CURLOPT_FTP_ALTERNATIVE_TO_USER (int)

Pass a string that will be used to try to authenticate over FTP if the USER/PASS negotiation fails. Available as of cURL 7.15.5.

CURLOPT_FTP_CREATE_MISSING_DIRS (int)

true, um fehlende Verzeichnisse zu erzeugen, wenn eine FTP-Operation auf einen Pfad stößt, der zurzeit nicht existiert.

CURLOPT_FTP_FILEMETHOD (int)

Die zu verwendende Methode, um eine Datei auf einem FTP(S)-Server zu erreichen. Mögliche Werte sind CURLFTPMETHOD_DEFAULT, CURLFTPMETHOD_MULTICWD, CURLFTPMETHOD_NOCWD und CURLFTPMETHOD_SINGLECWD. Verfügbar seit cURL 7.15.1.

CURLOPT_FTP_RESPONSE_TIMEOUT (int)

A timeout in seconds cURL will wait for a response from an FTP server. This option overrides CURLOPT_TIMEOUT. This option accepts any value that can be cast to a valid int. Available as of cURL 7.10.8 and deprecated as of cURL 7.85.0.

CURLOPT_FTP_SKIP_PASV_IP (int)

If this option is set to 1 cURL will not use the IP address the server suggests in its 227-response to cURL's PASV command but will use the IP address it used for the connection. The port number received from the 227-response will not be ignored by cURL. Defaults to 1 as of cURL 7.74.0 and 0 prior to that. Available as of cURL 7.15.0.

CURLOPT_FTP_SSL (int)

CURLOPT_FTP_SSL_CCC (int)

This option makes cURL use CCC (Clear Command Channel) which shuts down the SSL/TLS layer after authenticating making the rest of the control channel communication unencrypted. Use one of the CURLFTPSSL_CCC_* constants. Defaults to CURLFTPSSL_CCC_NONE. Available as of cURL 7.16.1.

CURLOPT_FTP_USE_EPRT (int)

true, um für aktive FTP-Downloads EPRT (und LPRT) zu nutzen. Auf false setzen, um EPRT und LPRT zu deaktivieren und ausschließlich PORT zu nutzen.

CURLOPT_FTP_USE_EPSV (int)

true, um zunächst zu versuchen, einen EPSV-Befehl für FTP-Übertragungen auszuführen, bevor PASV verwendet wird. Auf false setzen, um EPSV zu deaktivieren.

CURLOPT_FTP_USE_PRET (int)

Set to 1 to send a PRET command before PASV (and EPSV). Has no effect when using the active FTP transfers mode. Defaults to 0. Available as of cURL 7.20.0.

CURLOPT_GSSAPI_DELEGATION (int)

Set to CURLGSSAPI_DELEGATION_FLAG to allow unconditional GSSAPI credential delegation. Set to CURLGSSAPI_DELEGATION_POLICY_FLAG to delegate only if the OK-AS-DELEGATE flag is set in the service ticket. Defaults to CURLGSSAPI_DELEGATION_NONE. Available as of cURL 7.22.0.

CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS (int)

Vorsprung für IPv6 für den Happy-Eyeballs-Algorithmus. Happy-Eyeballs versucht sich bei Dual-Stack-Hosts sowohl mit IPv4- als auch mit IPv6-Adressen zu verbinden verbinden, wobei IPv6 für die angegebe Dauer in Millisekunden bevorzugt wird. Die Voreinstellung ist CURL_HET_DEFAULT und beträgt zurzeit 200 Millisekunden. Verfügbar seit PHP 7.3.0 und 7.59.0

CURLOPT_HAPROXYPROTOCOL (int)

true, um zu Beginn der Verbindung einen HAProxy PROXY-Protokoll v1 Header zu senden. Standardmäßig wird dieser Header nicht gesendet. Verfügbar seit PHP 7.3.0 und cURL 7.60.0

CURLOPT_HEADER (int)

true, um den Header in die Ausgabe aufzunehmen.

CURLOPT_HEADERFUNCTION (int)

Ein Callback, der zwei Parameter erwartet. Der erste ist die cURL-Ressource, der zweite ist eine Zeichenkette mit den zu schreibenden Headern. Die Header-Daten müssen von diesem Callback geschrieben werden. Gibt die Anzahl der geschriebenen Bytes zurück.

CURLOPT_HEADEROPT (int)

Eine der Konstanten CURLHEADER_UNIFIED und CURLHEADER_SEPARATE. Seit cURL 7.42.1 ist der Standardwert CURLHEADER_SEPARATE; davor war es CURLHEADER_UNIFIED. Verfügbar seit PHP 7.0.7 und cURL 7.37.0

CURLOPT_HSTS (int)

Name der HSTS- (HTTP Strict Transport Security) Cache-Datei. Verfügbar seit PHP 8.2.0 und cURL 7.74.0

CURLOPT_HSTS_CTRL (int)

Steuert das Verhalten von HSTS (HTTP Strict Transport Security). Die Bitmaske sollte mit dem gewünschten Satz von Merkmalen gefüllt werden, um cURL anzuweisen, wie HSTS für die Übertragungen mit diesem Handle verwendet werden soll. CURLHSTS_ENABLE aktiviert den speicherinternen HSTS-Cache. Wenn die HSTS-Cache-Datei definiert ist, sollte CURLHSTS_READONLYFILE gesetzt werden, um sie schreibgeschützt zu machen. Verfügbar seit PHP 8.2.0 und cURL 7.74.0

CURLOPT_HTTP09_ALLOWED (int)

Gibt an, ob HTTP/0.9-Antworten erlaubt sind. Der Standardwert ist von libcurl 7.66.0 an false; zuvor war er true. Verfügbar seit PHP 7.3.15 bzw. 7.4.3 und cURL 7.64.0

CURLOPT_HTTP200ALIASES (int)

Ein Array von HTTP-200-Antworten, die als gültige Antoworten und nicht als Fehler behandelt werden. Verfügbar seit cURL 7.10.3.

CURLOPT_HTTPAUTH (int)

Die zu nutzende HTTP-Authentisierungsmethode; zur Verfügung stehen: CURLAUTH_BASIC, CURLAUTH_DIGEST, CURLAUTH_GSSNEGOTIATE, CURLAUTH_NTLM, CURLAUTH_AWS_SIGV4, CURLAUTH_ANY und CURLAUTH_ANYSAFE. Um mehrere Methoden zu kombinieren, kann der bitweise |- (oder) Operator verwendet werden; in diesem Fall fragt cURL den Server, welche Methoden er unterstützt, und wählt die beste aus. CURLAUTH_ANY setzt alle Bits. cURL wählt automatisch diejenige aus, die es als am sichersten erachtet. CURLAUTH_ANYSAFE setzt alle Bits außer CURLAUTH_BASIC. cURL wählt automatisch diejenige aus, die es als am sichersten erachtet.

CURLOPT_HTTPGET (int)

true, um die Methode der HTTP-Anfrage auf GET zu setzen. Da dies die Standard-Methode ist, sollte dies nur nach einem Wechsel der Anfrage-Methode notwendig sein.

CURLOPT_HTTPHEADER (int)

Ein Array von zu setzenden HTTP-Header-Feldern im Format array('Content-type: text/plain', 'Content-length: 100')

CURLOPT_HTTPPROXYTUNNEL (int)

true, um einen vorhandenen Proxy-Tunnel zu nutzen.

CURLOPT_HTTP_CONTENT_DECODING (int)

false, um den unbearbeiteten HTTP-Response-Body zu erhalten. Verfügbar seit cURL 7.16.2.

CURLOPT_HTTP_TRANSFER_DECODING (int)

If set to 0, transfer decoding is disabled. If set to 1, transfer decoding is enabled. cURL does chunked transfer decoding by default unless this option is set to 0. Defaults to 1. Available as of cURL 7.16.2.

CURLOPT_HTTP_VERSION (int)

CURL_HTTP_VERSION_NONE (Standard, lässt cURL entscheiden, welche Version genutzt werden soll), CURL_HTTP_VERSION_1_0 (erzwingt HTTP/1.0), CURL_HTTP_VERSION_1_1 (erzwingt HTTP/1.1), CURL_HTTP_VERSION_2_0 (versucht HTTP 2), CURL_HTTP_VERSION_2 (Alias von CURL_HTTP_VERSION_2_0), CURL_HTTP_VERSION_2TLS (versucht HTTP 2 nur über TLS (HTTPS)) oder CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE (stellt nicht-TLS HTTP-Anfragen unter Verwendung von HTTP/2 ohne HTTP/1.1-Upgrade).

CURLOPT_IGNORE_CONTENT_LENGTH (int)

If set to 1, ignore the Content-Length header in the HTTP response and ignore asking for or relying on it for FTP transfers. Defaults to 0. Available as of cURL 7.14.1.

CURLOPT_INFILE (int)

Die Datei, die zum Upload gelesen werden soll.

CURLOPT_INFILESIZE (int)

Die erwartete Größe der hochzuladenden Datei in Bytes. Es ist zu beachten, dass die Verwendung dieser Option libcurl nicht daran hindert, mehr Daten zu senden, da das, was genau gesendet wird, von CURLOPT_READFUNCTION abhängt.

CURLOPT_INTERFACE (int)

Der Name der zu nutzenden Netzwerkschnittstelle für ausgehende Daten. Statt des Namens der Schnittstelle kann auch eine IP-Adresse oder ein Hostname übergeben werden.

CURLOPT_IPRESOLVE (int)

Ermöglicht einer Anwendung, die Art der IP-Adressen auszuwählen, die für die Auflösung von Hostnamen verwendet werden sollen. Dies ist nur von Interesse, wenn Hostnamen verwendet werden, die Adressen unter mehr als einer IP-Version auflösen; mögliche Werte sind CURL_IPRESOLVE_WHATEVER, CURL_IPRESOLVE_V4, CURL_IPRESOLVE_V6; Voreinstellung ist CURL_IPRESOLVE_WHATEVER. Verfügbar seit cURL 7.10.8.

CURLOPT_ISSUERCERT (int)

If set to a string naming a file holding a CA certificate in PEM format, an additional check against the peer certificate is performed to verify the issuer is indeed the one associated with the certificate provided by the option. For the result of the check to be considered a failure, this option should be used in combination with the CURLOPT_SSL_VERIFYPEER option. Available as of cURL 7.19.0.

CURLOPT_ISSUERCERT_BLOB (int)

Issuer SSL certificate from memory blob. Verfügbar seit PHP 8.1.0 und cURL 7.71.0.

CURLOPT_KEEP_SENDING_ON_ERROR (int)

true, um den Request-Body weiterhin zu senden, wenn der zurückgegebene HTTP-Code gleich oder größer als 300 ist. Standardmäßig würde das Senden beendet und der Stream oder die Verbindung geschlossen. Zweckmäßig für manuelle NTML-Authentifizierung. Die meisten Anwendungen benötigen diese Option nicht. Verfügbar seit PHP 7.3.0 und cURL 7.51.0

CURLOPT_KEYPASSWD (int)

Das erforderliche Passwort, um den privaten CURLOPT_SSLKEY- oder CURLOPT_SSH_PRIVATE_KEYFILE-Schlüssel zu verwenden. Verfügbar seit cURL 7.16.1.

CURLOPT_KRB4LEVEL (int)

Die KRB4- (Kerberos 4) Sicherheitsstufe. Folgende Werte (von niedriger zu höherer Stufe) sind gültig: "clear", "safe", "confidential", "private". Sollte die Zeichenkette keinen dieser Werte enthalten, dann wird die höchste Stufe genutzt, d. h. "private". Wenn diese Option auf null gesetzt ist, wird die KRB4-Sicherheit deaktiviert. Derzeit funkioniert KRB4 nur bei FTP-Transaktionen.

CURLOPT_KRBLEVEL (int)

Set the kerberos security level for FTP and also enables kerberos awareness. This should be set to one of the following strings: clear, safe, confidential, private . If the string is set but does not match one of these, private is used. Setting this option to null will disable kerberos support for FTP. Defaults to null. Available as of cURL 7.16.4.

CURLOPT_LOCALPORT (int)

Sets the local port number of the socket used for the connection. This option accepts any value that can be cast to a valid int. Defaults to 0. Available as of cURL 7.15.2.

CURLOPT_LOCALPORTRANGE (int)

The number of attempts cURL makes to find a working local port number, starting with the one set with CURLOPT_LOCALPORT. This option accepts any value that can be cast to a valid int. Defaults to 1. Available as of cURL 7.15.2.

CURLOPT_LOGIN_OPTIONS (int)

Kann verwendet werden, um protokollspezifische Anmeldeoptionen zu setzen, z. B. den bevorzugten Authentifizierungsmechanismus per "AUTH=NTLM" oder "AUTH=*", und sollte in Verbindung mit der Option CURLOPT_USERNAME verwendet werden. Verfügbar seit PHP 7.0.7 und cURL 7.34.0

CURLOPT_LOW_SPEED_LIMIT (int)

Die Übertragungsgeschwindigkeit in Bytes pro Sekunde. Wenn dieser Wert für die Dauer von CURLOPT_LOW_SPEED_TIME Sekunden unterschritten wird, stuft PHP die Übertragung als zu langsam ein und bricht sie ab.

CURLOPT_LOW_SPEED_TIME (int)

Die Zeit in Sekunden, in der die Transferrate unter CURLOPT_LOW_SPEED_LIMIT geduldet wird. Nach dieser Zeit wird die Transferrate als zu langsam angesehen und der Transfer wird beendet.

CURLOPT_MAIL_AUTH (int)

Set a string with the authentication address (identity) of a submitted message that is being relayed to another server. The address should not be specified within a pair of angled brackets (><). If an empty string is used then a pair of brackets are sent by cURL as required by RFC 2554. Available as of cURL 7.25.0.

CURLOPT_MAIL_FROM (int)

Set a string with the sender's email address when sending SMTP mail. The email address should be specified with angled brackets (><) around it, which if not specified are added automatically. If this parameter is not specified then an empty address is sent to the SMTP server which might cause the email to be rejected. Available as of cURL 7.20.0.

CURLOPT_MAIL_RCPT (int)

Set to an array of strings with the recipients to pass to the server in an SMTP mail request. Each recipient should be specified within a pair of angled brackets (><). If an angled bracket is not used as the first character, cURL assumes a single email address has been provided and encloses that address within brackets. Available as of cURL 7.20.0.

CURLOPT_MAIL_RCPT_ALLLOWFAILS (int)

Verfügbar seit PHP 8.2.0 und cURL 7.69.0

CURLOPT_MAXAGE_CONN (int)

Die maximale Leerlaufzeit, für die eine bestehende Verbindung zur Wiederverwendung in Betracht gezogen wird. Standardmäßig ist die maximale Zeit auf 118 Sekunden eingestellt. Verfügbar seit PHP 8.2.0 und cURL 7.65.0

CURLOPT_MAXCONNECTS (int)

Die maximal erlaubte Anzahl persistenter Verbindungen; bei Erreichen des Limits wird die älteste Verbindung im Cache geschlossen, um zu verhindern, dass sich die Anzahl der offenen Verbindungen erhöht.

CURLOPT_MAXFILESIZE (int)

Sets the maximum accepted size (in bytes) of a file to download. If the file requested is found larger than this value, the transfer is aborted and CURLE_FILESIZE_EXCEEDED is returned. Passing 0 disables this option, and passing a negative size returns a CURLE_BAD_FUNCTION_ARGUMENT. If the file size is not known prior to the start of download, this option has no effect. For setting a size limit above 2GB, CURLOPT_MAXFILESIZE_LARGE should be used. As of cURL 8.4.0, this option also stops ongoing transfers if they reach this threshold. This option accepts any value that can be cast to a valid int. Defaults to 0. Available as of cURL 7.10.8.

CURLOPT_MAXFILESIZE_LARGE (int)

Die maximale Größe einer Datei in Bytes, die heruntergeladen werden darf. Ist die angeforderte Datei größer als dieser Wert, wird die Übertragung nicht gestartet und CURLE_FILESIZE_EXCEEDED zurückgegeben. Da die Größe einer Datei vor dem Herunterladen nicht immer bekannt ist, bewirkt diese Option bei solchen Dateien nichts, selbst wenn sie größer ist als der angegebene Grenzwert. Verfügbar seit PHP 8.2.0 und cURL 7.11.0

CURLOPT_MAXLIFETIME_CONN (int)

Die maximale Zeit in Sekunden, die bei einer bestehenden Verbindung seit ihrer Erstellung vergangen sein darf, um für eine erneute Verwendung in Betracht gezogen zu werden. Wenn im Cache eine Verbindung gefunden wird, die älter als dieser Wert ist, wird sie geschlossen, sobald alle laufenden Übertragungen abgeschlossen sind. Der Standardwert ist 0 Sekunden, was bedeutet, dass die Option deaktiviert ist und alle Verbindungen dafür in Frage kommen, wiederverwendet zu werden.

CURLOPT_MAXREDIRS (int)

Die maximal erlaubte Anzahl von HTTP-Weiterleitungen. Diese Option sollte zusammen mit CURLOPT_FOLLOWLOCATION verwendet werden. Der Standardwert von 20 wird gesetzt, um Endlos-Weiterleitungen zu verhindern. Der Wert -1 erlaubt unendlich viele Weiterleitungen und 0 verhindert jegliche Weiterleitung.

CURLOPT_MAX_RECV_SPEED_LARGE (int)

Wenn ein Download diese Geschwindigkeit (gezählt in Bytes pro Sekunde) im Gesamtdurchschnitt während der Übertragung überschreitet, wird die Übertragung angehalten, um die durschnittliche Rate kleiner oder gleich dem Wert des Parameters zu halten. Voreinstellung ist unbegrenzte Geschwindigkeit. Verfügbar seit cURL 7.15.5

CURLOPT_MAX_SEND_SPEED_LARGE (int)

Wenn ein Upload diese Geschwindigkeit (gezählt in Bytes pro Sekunde) im Gesamtdurchschnitt während der Übertragung überschreitet, wird die Übertragung angehalten, um die durschnittliche Rate kleiner oder gleich dem Wert des Parameters zu halten. Voreinstellung ist unbegrenzte Geschwindigkeit. Verfügbar seit cURL 7.15.5

CURLOPT_MIME_OPTIONS (int)

Verfügbar seit PHP 8.3.0 und cURL 7.81.0

CURLOPT_MUTE (int)

true, um jegliche Ausgabe der cURL-Funktionen zu unterbinden. Entfernt in cURL 7.15.5 (stattdessen kann CURLOPT_RETURNTRANSFER verwendet werden)

CURLOPT_NETRC (int)

true, um die lokale Datei ~/.netrc nach einem Benutzernamen und einem Passwort zu durchsuchen, mit dem eine Verbindung zur Gegenstelle aufgebaut wird.

CURLOPT_NETRC_FILE (int)

Set a string containing the full path name to a .netrc file. If this option is omitted and CURLOPT_NETRC is set, cURL checks for a .netrc file in the current user's home directory. Available as of cURL 7.11.0.

CURLOPT_NEW_DIRECTORY_PERMS (int)

Sets the value of the permissions (int) that is set on newly created directories on the remote server. The default value is 0755. The only protocols that can use this are sftp://, scp:// and file://. Available as of cURL 7.16.4.

CURLOPT_NEW_FILE_PERMS (int)

Sets the value of the permissions (as an int) that are set on newly created files on the remote server. The default value is 0644. The only protocols that can use this are sftp://, scp:// and file://. Available as of cURL 7.16.4.

CURLOPT_NOBODY (int)

true, um den Body nicht in die Ausgabe aufzunehmen. Die Anfragemethode wird dann auf HEAD gesetzt. Die Änderung in false ändert die Methode nicht in GET.

CURLOPT_NOPROGRESS (int)

true, um die Fortschrittsanzeige für den Transfer auszublenden.

Hinweis:

PHP setzt die Option automatisch auf true. Dies sollte ausschließlich für die Fehlersuche geändert werden.

CURLOPT_NOPROXY (int)

Set a string consisting of a comma separated list of hostnames that do not require a proxy to get reached. Each name in this list is matched as either a domain which contains the hostname or the hostname itself. The only wildcard available in the string is a single * character which matches all hosts, effectively disabling the proxy. Setting this option to an empty string enables the proxy for all hostnames. Since cURL 7.86.0, IP addresses set with this option can be provided using CIDR notation. Available as of cURL 7.19.4.

CURLOPT_NOSIGNAL (int)

true, um jegliche cURL-Funktion zu ignorieren, die ein Signal an den PHP-Prozess sendet. In multi-threaded SAPIs ist diese Option standardmäßig aktiviert, sodass Zeitüberschreitungen weiterhin abgefangen werden können. Verfügbar seit cURL 7.10.

CURLOPT_PASSWDFUNCTION (int)

Ein Callback, der drei Parameter erwartet. Der erste ist die cURL-Ressource, der zweite eine Zeichenkette die einen Passwort-Prompt enthält und der dritte Parameter enthält die maximal zulässige Länge des Passworts. Die Funktion sollte das Passwort als Zeichenkette zurückgeben. Entfernt in PHP 7.3.0.

CURLOPT_PASSWORD (int)

Das Passwort, das für die Authentifizierung verwendet wird. Verfügbar seit cURL 7.19.1.

CURLOPT_PATH_AS_IS (int)

true, um Dot-Dot-Sequenzen nicht aufzulösen. Verfügbar seit PHP 7.0.7 und cURL 7.42.0

CURLOPT_PINNEDPUBLICKEY (int)

Setzt den gepinnten öffentlichen Schlüssel. Die Zeichenkette kann der Dateiname des gepinnten öffentlichen Schlüssels sein. Das erwartete Dateiformat ist "PEM" oder "DER". Die Zeichenkette kann auch eine beliebige Anzahl von Base64-kodierten SHA-256-Hashes sein, denen "sha256//" vorangestellt ist und die durch ";" getrennt sind. Verfügbar seit PHP 7.0.7 und cURL 7.39.0

CURLOPT_PIPEWAIT (int)

true, um auf Pipelining/Multiplexing zu warten. Verfügbar seit PHP 7.0.7 und cURL 7.43.0

CURLOPT_PORT (int)

Ein alternativer Port für die Verbindung.

CURLOPT_POST (int)

true, um eine HTTP-POST-Anfrage abzusetzen. Dabei handelt es sich um das übliche application/x-www-form-urlencoded, wie es im Allgemeinen von HTML-Formularen erzeugt wird.

CURLOPT_POSTFIELDS (int)

Die in einer HTTP-POST-Anfrage zu nutzenden Daten. Als Wert für diesen Parameter kann entweder eine URL-kodierte Zeichenkette übergeben werden, z. B. "para1=val1&para2=val2&...", oder ein Array, wobei die Feldnamen als Schlüssel und die Felddaten als Wert verwendet werden. Ist value ein Array, dann wird der Content-Type-Header auf multipart/form-data gesetzt. Dateien können mit CURLFile oder CURLStringFile gesendet werden. In diesem Fall muss value ein Array sein.

CURLOPT_POSTQUOTE (int)

Ein Array von FTP-Kommandos, die nach der FTP-Anfrage auf dem Server ausgeführt werden sollen.

CURLOPT_POSTREDIR (int)

Eine Bitmaske von 1 (301 Moved Permanently), 2 (302 Found) und 4 (303 See Other), ob die HTTP-POST-Methode beibehalten werden soll, wenn CURLOPT_FOLLOWLOCATION gesetzt ist und ein sepzifischer Typ von Weiterleitung auftritt. Verfügbar seit cURL 7.19.1.

CURLOPT_PRE_PROXY (int)

Ein Wert vom Typ string, der den Hostnamen des Präproxys oder dessen IP-Adresse in Dezimalpunktschreibweise enthält, mit dem sich curl für die kommende Anfrage verbinden soll, bevor es sich mit dem in CURLOPT_PROXY angegebenen HTTP(S)-Proxy verbindet. Der Präproxy kann nur ein SOCKS-Proxy sein und sollte mit vorangestelltem [scheme]:// angegeben werden, um anzugeben welcher Typ von Socks verwendet wird. Eine numerische IPv6-Adresse muss in [eckigen Klammen] angegeben werden. Wird der Präproxy als leere Zeichenkette angegeben, deaktiviert dies die Verwendung eines Präproxys ausdrücklich. Um eine Portnummer in dieser Zeichenkette anzugeben, wird ein :[port] am Ende des Hostnamens angefügt. Die Portnummer des Proxys kann optinal separat mit der Option CURLOPT_PROXYPORT angegeben werden. Wenn kein Port angegeben wird, wird für Proxys standardmäßig Port 1080 verwendet. Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PREQUOTE (int)

Set an array of FTP command strings to pass to the server after the transfer type is set. These commands are not performed when a directory listing is performed, only for file transfers. Available as of cURL 7.9.5.

CURLOPT_PRIVATE (int)

Alle Daten, die mit diesem cURL-Handle verknüpft werden sollen. Diese Daten können später mit der Option CURLINFO_PRIVATE von curl_getinfo() abgerufen werden. cURL macht nichts mit diesen Daten. Bei cURL-Mehrfach-Handles sind diese privaten Daten typischerweise ein eindeutiger Schlüssel, um ein Standard-cURL-Handle zu identifizieren. Verfügbar seit cURL 7.10.3.

CURLOPT_PROGRESSFUNCTION (int)

Ein Callback, der fünf Parameter erwartet. Der erste ist die cURL-Ressource, der zweite ist die erwartete Gesamtzahl von Bytes, die in dieser Übertragung voraussichtlich heruntergeladen werden, der dritte ist die Anzahl von Bytes die bisher heruntergeladen wurden, der vierte ist die erwartete Gesamtzahl von Bytes, die bei dieser Übertragung hochgeladen werden, und der fünfte ist die Anzahl von Bytes, die bisher hochgeladen wurden.

Hinweis:

Der Callback wird nur dann aufgerufen, wenn die Option CURLOPT_NOPROGRESS auf false gesetzt ist.

Ein Rückgabewert ungleich 0 bricht die Übertragung ab. In diesem Fall setzt der Transfer einen CURLE_ABORTED_BY_CALLBACK-Fehler.

CURLOPT_PROTOCOLS (int)

Eine Bitmaske von CURLPROTO_*-Werten. Mit dieser Einstellung lassen sich die Protokolle einschränken, die libcurl für diesen Transfer nutzen darf. Damit wird es möglich ein libcurl mit einer Vielzahl an Protokollen zu benutzen, gleichzeitig aber lassen sich die für einen bestimmten Transfer zulässigen Protokolle beschränken. Standardmäßig akzeptiert libcurl alle unterstützten Protokolle. Siehe auch CURLOPT_REDIR_PROTOCOLS. Zulässige Optionen: CURLPROTO_HTTP, CURLPROTO_HTTPS, CURLPROTO_FTP, CURLPROTO_FTPS, CURLPROTO_SCP, CURLPROTO_SFTP, CURLPROTO_TELNET, CURLPROTO_LDAP, CURLPROTO_LDAPS, CURLPROTO_DICT, CURLPROTO_FILE, CURLPROTO_TFTP, CURLPROTO_MQTT und CURLPROTO_ALL. Verfügbar seit cURL 7.19.4.

CURLOPT_PROTOCOLS_STR (int)

Verfügbar seit PHP 8.3.0 und cURL 7.85.0

CURLOPT_PROXY (int)

Der HTTP-Proxy, durch den die Anfragen getunnelt werden sollen.

CURLOPT_PROXYAUTH (int)

Die HTTP-Authentifizierungsmethode(n), die für die Proxy-Verbindung verwendet werden sollen. Nutzt die gleiche Bitmaske wie in CURLOPT_HTTPAUTH beschrieben. Nur CURLAUTH_BASIC und CURLAUTH_NTLM sind derzeit für Proxy-Verbindungen zulässig. Verfügbar seit cURL 7.10.7.

CURLOPT_PROXYHEADER (int)

Ein Array von benutzerdefinierten HTTP-Headern, die an Proxies gesendet werden sollen. Verfügbar seit PHP 7.0.7 und cURL 7.37.0

CURLOPT_PROXYPASSWORD (int)

Set a string with the password to be used for authentication with the proxy. Available as of cURL 7.19.1.

CURLOPT_PROXYPORT (int)

Der Port des Proxys, mit dem eine Verbindung hergestellt werden soll; kann auch mittels CURLOPT_PROXY gesetzt werden.

CURLOPT_PROXYTYPE (int)

Entweder CURLPROXY_HTTP (Standard), CURLPROXY_SOCKS4, CURLPROXY_SOCKS5, CURLPROXY_SOCKS4A oder CURLPROXY_SOCKS5_HOSTNAME. Verfügbar seit cURL 7.10.

CURLOPT_PROXYUSERNAME (int)

Set a string with the username to be used for authentication with the proxy. Available as of cURL 7.19.1.

CURLOPT_PROXYUSERPWD (int)

Benutzername und Passwort, die für die Proxy-Verbindung verwendet werden sollen, in der Form "[benutzername]:[passwort]".

CURLOPT_PROXY_CAINFO (int)

Der Pfad zum Bundle der Proxy-Zertifizierungsstelle (CA). Der Pfad wird als String angegeben, der eine Datei mit einem oder mehreren Zertifikaten enthält, die zur Prüfung des HTTPS-Proxys verwendet werden sollen. Diese Option gilt für die Verbindung zu einem HTTPS-Proxy, nicht zu einem HTTPS-Server. Der Standardwert ist der Systempfad, unter dem das cacert-Bundle von libcurl gespeichert sein sollte. Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_CAINFO_BLOB (int)

Der Name einer PEM-Datei, die ein oder mehrere Zertifikate enthält, mit denen der HTTPS-Proxy verifiziert werden soll. Diese Option ist für die Verbindung zu einem HTTPS-Proxy, nicht zu einem HTTPS-Server. Standardmäßig ist dies der Systempfad, unter dem das cacert-Bundle von libcurl gespeichert sein sollte. Verfügbar seit PHP 8.2.0 und cURL 7.77.0

CURLOPT_PROXY_CAPATH (int)

Das Verzeichnis, das mehrere CA-Zertifikate enthält, mit denen der HTTPS-Proxy geprüft wird. Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_CRLFILE (int)

Der Name der CRL-Datei (Certificate Revocation List, Zertifikatsperrliste) im PEM-Format, die für die Zertifikatsprüfung beim SSL-Austausch verwendet wird. Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_ISSUERCERT (int)

Der Name der Datei, die das SSL-Zertifikat des Proxy-Ausstellers enthält. Verfügbar seit PHP 8.1.0 und cURL 7.71.0.

CURLOPT_PROXY_ISSUERCERT_BLOB (int)

Das SSL-Zertifikat des Proxy-Ausstellers aus dem Speicherblob. Verfügbar seit PHP 8.1.0 und cURL 7.71.0.

CURLOPT_PROXY_KEYPASSWD (int)

Die Zeichenkette, die als Passwort erforderlich ist, um den privaten Schlüssel aus CURLOPT_PROXY_SSLKEY 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 cURL 7.52.0

CURLOPT_PROXY_PINNEDPUBLICKEY (int)

Der festgesteckte (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 auch eine beliebige Anzahl von Base64-kodierten SHA256-Hashwerten enthalten, denen "sha256://" vorangestellt ist und die durch ";" getrennt sind. Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_SERVICE_NAME (int)

Der Name des Proxy-Authentifizierungsdienstes. Verfügbar seit PHP 7.0.7 und cURL 7.43.0 (für HTTP-Proxys) bzw. cURL 7.49.0 (für SOCKS5-Proxys).

CURLOPT_PROXY_SSLCERT (int)

Der Dateiname des Client-Zertifikats, das für die Verbindung mit dem HTTPS-Proxy verwendet wird. Das Standardformat ist "P12" für Secure Transport und "PEM" für andere Engines und kann mit CURLOPT_PROXY_SSLCERTTYPE geändert werden. Bei NSS oder Secure Transport kann dies auch der in der Sicherheitsdatenbank angegebene Kurzname des Zertifikats sein, das für die Authentifizierung verwendet werden soll. Soll eine Datei im aktuellen Verzeichnis verwendet werden, sollte sie mit dem Präfix "./" angegeben werden, um Verwechslungen mit einem Kurznamen zu vermeiden. Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_SSLCERTTYPE (int)

Das Format des Client-Zertifikats, das für die Verbindung mit dem HTTPS-Proxy verwendet wird. Unterstützte Formate sind "PEM" und "DER", außer bei Secure Transport. OpenSSL (ab Version 0.9.3) und Secure Transport (unter iOS 5 oder höher bzw. OS X 10.7 oder höher) unterstützen zusätzlich "P12" für PKCS#12-kodierte Dateien. Der Standardwert ist "PEM". Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_SSLCERT_BLOB (int)

Das Client-Zertifikat des SSL-Proxys aus dem Speicherblob. Verfügbar seit PHP 8.1.0 und cURL 7.71.0.

CURLOPT_PROXY_SSLKEY (int)

Der Dateiname des privaten Schlüssels, der für die Verbindung mit dem HTTPS-Proxy verwendet wird. Das Standardformat ist "PEM" und kann mit CURLOPT_PROXY_SSLKEYTYPE geändert werden (nur unter iOS und Mac OS X). Diese Option wird ignoriert, wenn cURL mit Secure Transport kompiliert wurde. Verfügbar, wenn TLS beim Kompilieren aktivert wurde. Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_SSLKEYTYPE (int)

Das Format des privaten Schlüssels. Unterstützte Formate sind "PEM", "DER" und "ENG". Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_SSLKEY_BLOB (int)

Der private Schlüssel für das Proxy-Zertifikat aus dem Speicherblob. Verfügbar seit PHP 8.1.0 und cURL 7.71.0.

CURLOPT_PROXY_SSLVERSION (int)

Eine der folgenden Konstanten: CURL_SSLVERSION_DEFAULT, CURL_SSLVERSION_TLSv1, CURL_SSLVERSION_TLSv1_0, CURL_SSLVERSION_TLSv1_1, CURL_SSLVERSION_TLSv1_2, CURL_SSLVERSION_TLSv1_3, CURL_SSLVERSION_MAX_DEFAULT, CURL_SSLVERSION_MAX_TLSv1_0, CURL_SSLVERSION_MAX_TLSv1_1, CURL_SSLVERSION_MAX_TLSv1_2, CURL_SSLVERSION_MAX_TLSv1_3, CURL_SSLVERSION_SSLv3 .

Warnung

Es ist besser, diese Option nicht zu setzen und den Standardwert CURL_SSLVERSION_DEFAULT zu verwenden, der versucht, die Remote-SSL-Protokollversion herauszufinden.

Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_SSL_CIPHER_LIST (int)

Die Liste der Chiffriersuiten, die für die Verbindung mit dem HTTPS-Proxy verwendet werden sollen. Die Liste muss syntaktisch korrekt sein und besteht aus einer oder mehreren Zeichenketten von Chiffriersuiten, die durch Doppelpunkt getrennt sind. Kommas und Leerzeichen sind zwar auch als Trennzeichen erlaubt, aber normalerweise werden Doppelpunkte verwendet; !, - und + können als Operatoren verwendet werden.

CURLOPT_PROXY_SSL_OPTIONS (int)

Definiert die Verhaltensoptionen für den SSL-Proxy, die eine Bitmaske der folgenden Konstanten sind: CURLSSLOPT_ALLOW_BEAST, CURLSSLOPT_NO_REVOKE, CURLSSLOPT_NO_PARTIALCHAIN Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_SSL_VERIFYHOST (int)

2 prüft die Namensfelder im Zertifikat des HTTP-Proxies gegen den Proxy-Namen. Wenn auf 0 gesetzt, gelingt die Verbindung unabhängig von dem im Zertifikat verwendeten Namen. Diese Möglichkeit ist mit Vorsicht zu verwenden! 1 wird in cURL 7.28.0 und früher als Debug-Option behandelt. Von cURL 7.28.1 bis 7.65.3 wird CURLE_BAD_FUNCTION_ARGUMENT zurückgegeben. Von cURL 7.66.0 an werden 1 und 2 gleich behandelt. In Produktivumgebungen sollte der Wert dieser Option beim Standardwert 2 belassen werden. Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_SSL_VERIFYPEER (int)

false, um cURL zu veranlassen, das Peer-Zertifikat nicht zu prüfen. Alternative Zertifikate zur Prüfung können mit der Option CURLOPT_CAINFO angegeben werden und das Verzeichnis mit den Zertifikaten mit der Option CURLOPT_CAPATH. Wenn der Wert auf false gesetzt ist, ist die Überprüfung des Peer-Zertifikats immer erfolgreich. Die Voreinstellung ist true. Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_TLS13_CIPHERS (int)

Die Liste der Chiffriersuiten, die für die TLS 1.3-Verbindung mit einem Proxy verwendet werden sollen. Die Liste muss syntaktisch korrekt sein und besteht aus einer oder mehreren Zeichenketten von Chiffriersuiten, die durch Doppelpunkt getrennt sind. Die Option wird zurzeit nur verwendet, wenn cURL mit OpenSSL 1.1.1 oder höher kompiliert wurde. Wird ein anderes SSL-Backend verwendet, kann versucht werden die Chiffriersuiten unter Verwendung der Option CURLOPT_PROXY_SSL_CIPHER_LIST zu setzen. Verfügbar, wenn mit OpenSSL >= 1.1.1 kompiliert. Verfügbar seit PHP 7.3.0 und cURL 7.61.0

CURLOPT_PROXY_TLSAUTH_PASSWORD (int)

Das Passwort, das für die TLS-Authentifizierungsmethode, die mit der Option CURLOPT_PROXY_TLSAUTH_TYPE angegeben wurde, verwendet werden soll. Erfordert, dass die Option CURLOPT_PROXY_TLSAUTH_USERNAME ebenfalls angegeben wird. Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_TLSAUTH_TYPE (int)

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 gemeinsames Geheimnis (shared secret) haben. Um TLS-SRP zu verwenden, müssen auch die Optionen CURLOPT_PROXY_TLSAUTH_USERNAME und CURLOPT_PROXY_TLSAUTH_PASSWORD gesetzt werden.

Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_TLSAUTH_USERNAME (int)

Der Benutzername, der für die mit der Option CURLOPT_PROXY_TLSAUTH_TYPE angegebene TLS-Authentifizierungsmethode des HTTPS-Proxys verwendet wird. Erfordert, dass die Option CURLOPT_PROXY_TLSAUTH_PASSWORD ebenfalls angegeben wird. Verfügbar seit PHP 7.3.0 und cURL 7.52.0

CURLOPT_PROXY_TRANSFER_MODE (int)

Set to 1 to set the transfer mode (binary or ASCII) for FTP transfers done via an HTTP proxy, by appending type=a or type=i to the URL. Without this setting or it being set to 0, CURLOPT_TRANSFERTEXT has no effect when doing FTP via a proxy. Defaults to 0. Available as of cURL 7.18.0.

CURLOPT_PUT (int)

true, um ein HTTP-PUT für eine Datei abzusetzen. Die fragliche Datei muss dabei über die Konstanten CURLOPT_INFILE und CURLOPT_INFILESIZE angegeben werden.

CURLOPT_QUICK_EXIT (int)

Verfügbar seit PHP 8.3.0 und cURL 7.87.0

CURLOPT_QUOTE (int)

Ein Array von FTP-Kommandos, die vor der FTP-Anfrage auf dem Server ausgeführt werden sollen.

CURLOPT_RANDOM_FILE (int)

Der Name der Datei, die zur Initialisierung des Zufallsgenerators für SSL benutzt werden soll.

CURLOPT_RANGE (int)

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 durch Komma getrennte Intervalle im Format "X-Y,N-M".

CURLOPT_READDATA (int)

Sets a file pointer resource that will be used by the file read function set with CURLOPT_READFUNCTION. Available as of cURL 7.9.7.

CURLOPT_READFUNCTION (int)

Ein Callback, der drei Parameter erwartet. Der erste ist die cURL-Ressource, der zweite ist eine Stream-Ressource, die cURL durch die Option CURLOPT_INFILE zur Verfügung gestellt wird, und der dritte ist die Höchstmenge von Daten, die gelesen werden. Der Callback muss eine Zeichenkette zurückgeben, deren Länge kleiner oder gleich der angeforderten Datenmenge ist, typischerweise durch Lesen aus der übergebenen Stream-Ressource. Er soll eine leere Zeichenkette zurückgeben, um EOF zu signalisieren.

CURLOPT_REDIR_PROTOCOLS (int)

Eine Bitmaske von CURLPROTO_*-Werten. Mit dieser Einstellung lassen sich die Protokolle einschränken, die libcurl in einer Übertragung nutzen darf, wenn eine Weiterleitung stattfindet (das setzt voraus, dass CURLOPT_FOLLOWLOCATION erlaubt ist). Auf diese Weise können bestimmte Übertragungen eingeschränkt werden, sodass nur eine Auswahl von Protokollen in Umleitungen verwendet werden darf. Standardmäßig akzeptiert libcurl alle unterstützten Protokolle außer FILE und SCP. Siehe auch CURLOPT_PROTOCOLS für weitere Informationen zu den Protokoll-Konstanten. Verfügbar seit cURL 7.19.4.

CURLOPT_REDIR_PROTOCOLS_STR (int)

Verfügbar seit PHP 8.3.0 und cURL 7.85.0.

CURLOPT_REFERER (int)

Der Inhalt des "Referer: "-Headers, der in einer HTTP-Anfrage verwendet werden soll.

CURLOPT_REQUEST_TARGET (int)

Verfügbar seit PHP 7.3.0 und cURL 7.55.0.

CURLOPT_RESOLVE (int)

Gibt eine benutzerdefinierte Adresse für eine bestimmte Kombination aus Host und Port an. Ein Array aus Zeichenketten für Hostname, Port und IP-Adresse, wobei die einzelnen Elemente durch einen Doppelpunkt getrennt sind; im Format: array("example.com:80:127.0.0.1") Verfügbar seit cURL 7.21.3.

CURLOPT_RESUME_FROM (int)

Die Position in Bytes, ab der ein Transfer fortgesetzt werden soll.

CURLOPT_RETURNTRANSFER (int)

true, um den Transfer als Zeichenkette zurückzugeben, anstatt ihn direkt auszugeben.

CURLOPT_RTSP_CLIENT_CSEQ (int)

Set an int with the CSEQ number to issue for the next RTSP request. Useful if the application is resuming a previously broken connection. The CSEQ increments from this new number henceforth. Defaults to 0. Available as of cURL 7.20.0.

CURLOPT_RTSP_REQUEST (int)

Sets the kind of RTSP request to make. Must be one of the CURL_RTSPREQ_* constants. Available as of cURL 7.20.0.

CURLOPT_RTSP_SERVER_CSEQ (int)

Set an int with the CSEQ number to expect for the next RTSP Server to Client request. This feature (listening for Server requests) is unimplemented. Defaults to 0. Available as of cURL 7.20.0.

CURLOPT_RTSP_SESSION_ID (int)

Set a string with the value of the current RTSP Session ID for the handle. Once this value is set to any non-null value, cURL returns CURLE_RTSP_SESSION_ERROR if the ID received from the server does not match. If set to null, cURL automatically sets the ID the first time the server sets it in a response. Defaults to null Available as of cURL 7.20.0.

CURLOPT_RTSP_STREAM_URI (int)

Sets a string with the stream URI to operate on. If not set, cURL defaults to operating on generic server options by passing * in the place of the RTSP Stream URI. When working with RTSP, CURLOPT_RTSP_STREAM_URI indicates what URL to send to the server in the request header while the CURLOPT_URL indicates where to make the connection to. Available as of cURL 7.20.0.

CURLOPT_RTSP_TRANSPORT (int)

Set the Transport: header for this RTSP session. Available as of cURL 7.20.0.

CURLOPT_SAFE_UPLOAD (int)

Immer true, was die Unterstützung für das Präfix @ für das Hochladen von Dateien in CURLOPT_POSTFIELDS deaktiviert. Das bedeutet, dass Werte, die mit @ beginnen, sicher als Felder übergeben werden können. Für das Hochladen kann stattdessen CURLFile verwendet werden.

CURLOPT_SASL_AUTHZID (int)

Die Autorisierungs-ID (authzid) für die Übertragung. Gilt nur für den Authentifizierungsmechanismus PLAIN SASL, wo sie optional ist. Wird nichts angegeben, wird nur die durch den Benutzernamen angegebene Authentifizierungskennung (authcid) zusammen mit dem Passwort an den Server gesendet. Wenn die authzid nicht angegeben wurde, leitet der Server die authzid von der authcid ab und verwendet sie intern.

CURLOPT_SASL_IR (int)

true, um die Übertragung der ersten Antwort im ersten Paket zu ermöglichen. Verfügbar seit PHP 7.0.7 und cURL 7.31.0

CURLOPT_SERVICE_NAME (int)

Der Name des Authentifizierungsdienstes. Verfügbar seit PHP 7.0.7 und cURL 7.43.0

CURLOPT_SHARE (int)

Ein Ergebnis von curl_share_init(). Veranlasst das cURL-Handle, die Daten des gemeinsamen Handles zu verwenden.

CURLOPT_SOCKS5_AUTH (int)

Die zu verwendende SOCKS5-Authentifizierungsmethode. Die Optionen sind: CURLAUTH_BASIC, CURLAUTH_GSSAPI, CURLAUTH_NONE. Der bitweise Operator | (oder) kann verwendet werden, um mehrere Methoden zu kombinieren. In diesem Fall fragt cURL den Server, welche Methoden er unterstützt, und wählt die beste aus. CURLAUTH_BASIC erlaubt die Authentifizierung mit Benutzername/Passwort. CURLAUTH_GSSAPI erlaubt die GSS-API-Authentifizierung. CURLAUTH_NONE erlaubt keine Authentifizierung. Voreinstellung ist CURLAUTH_BASIC|CURLAUTH_GSSAPI. Der eigentliche Benutzername und das Passwort werden mit der Option CURLOPT_PROXYUSERPWD gesetzt. Verfügbar seit PHP 7.3.0 und cURL 7.55.0

CURLOPT_SOCKS5_GSSAPI_NEC (int)

Set to 1 to enable and 0 to disable the unprotected exchange of the protection mode negotiation as part of the GSSAPI negotiation. Available as of cURL 7.19.4.

CURLOPT_SOCKS5_GSSAPI_SERVICE (int)

Set a string holding the name of the SOCKS5 service. Defaults to rcmd. Available as of cURL 7.19.4 and deprecated as of cURL 7.49.0. Use CURLOPT_PROXY_SERVICE_NAME instead.

CURLOPT_SSH_AUTH_TYPES (int)

Eine Bitmaske bestehend aus einer oder mehreren der Authentifizierungsmethoden CURLSSH_AUTH_PUBLICKEY, CURLSSH_AUTH_PASSWORD, CURLSSH_AUTH_HOST, CURLSSH_AUTH_KEYBOARD. CURLSSH_AUTH_ANY, damit libcurl eine auswählen kann. Verfügbar seit cURL 7.16.1.

CURLOPT_SSH_COMPRESSION (int)

true, um die eingebaute SSH-Komprimierung zu aktivieren. Dies ist eine Anfrage, kein Befehl; der Server kann diese ignorieren. Verfügbar seit PHP 7.3.0 und cURL 7.56.0

CURLOPT_SSH_HOSTKEYFUNCTION (int)

Verfügbar seit PHP 8.3.0 und cURL 7.84.0

CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 (int)

Eine Zeichenkette, die 32 hexadezimale Ziffern enthält. Die Zeichenkette sollte die MD5-Prüfsumme des öffentlichen Schlüssels des Remote-Hosts sein. Falls die Prüfsummen nicht übereinstimmen, weist libcurl die Verbindung zum Host zurück. Diese Option gilt nur für SCP- und SFTP-Übertragungen. Verfügbar seit cURL 7.17.1.

CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256 (int)

Der öffentliche Schlüssel des entfernten Hosts in Form eines Base64-kodierten SHA256-Hashes. Wenn der angegebene Hash nicht mit dem Hash des entfernten Hosts übereinstimmt, schlägt die Übertragung fehl.

CURLOPT_SSH_KNOWNHOSTS (int)

Set to the filename of the known_host file to use which should use the OpenSSH file format as supported by libssh2. Available as of cURL 7.19.6.

CURLOPT_SSH_PRIVATE_KEYFILE (int)

Der Dateiname des privaten Schlüssels. Wenn nicht gesetzt, verwendet libcurl standardmäßig $HOME/.ssh/id_dsa, falls die Umgebungsvariable HOME gesetzt ist, und andernfalls "id_dsa" im aktuellen Verzeichnis. Wenn die Datei passwortgeschützt ist, kann das Passwort über die Option CURLOPT_KEYPASSWD angegeben werden. Verfügbar seit cURL 7.16.1.

CURLOPT_SSH_PUBLIC_KEYFILE (int)

Der Dateiname des öffentlichen Schlüssels. Wenn nicht gesetzt, verwendet libcurl standardmäßig $HOME/.ssh/id_dsa.pub, falls die Umgebungsvariable HOME gesetzt ist, und andernfalls "id_dsa.pub" im aktuellen Verzeichnis. Verfügbar seit cURL 7.16.1.

CURLOPT_SSLCERT (int)

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

CURLOPT_SSLCERTPASSWD (int)

Das Passwort für das CURLOPT_SSLCERT-Zertifikat.

CURLOPT_SSLCERTTYPE (int)

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. Verfügbar seit cURL 7.9.3.

CURLOPT_SSLCERT_BLOB (int)

SSL client certificate from memory blob. Verfügbar seit PHP 8.1.0 und cURL 7.71.0.

CURLOPT_SSLENGINE (int)

Der Bezeichner für die Crypto-Engine des privaten SSL-Schlüssels, der in CURLOPT_SSLKEY definiert ist.

CURLOPT_SSLENGINE_DEFAULT (int)

Der Bezeichner für die Crypto-Engine, die für asymmetrische kryptographische Operationen verwendet wird.

CURLOPT_SSLKEY (int)

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

CURLOPT_SSLKEYPASSWD (int)

Das geheime Passwort, das für den in CURLOPT_SSLKEY definierten privaten SSL-Schlüssel benötigt wird.

Hinweis:

Da diese Option sensible Daten enthält, sollte das PHP-Skript in einer sicheren Umgebung liegen.

CURLOPT_SSLKEYTYPE (int)

Der Typ des in CURLOPT_SSLKEY definierten privaten SSL-Schlüssels. Unterstützte Schlüssel-Typen sind "PEM" (Standard), "DER" und "ENG".

CURLOPT_SSLKEY_BLOB (int)

Private key for client cert from memory blob. Verfügbar seit PHP 8.1.0 und cURL 7.71.0.

CURLOPT_SSLVERSION (int)

Eine der folgenden Konstanten: CURL_SSLVERSION_DEFAULT, CURL_SSLVERSION_TLSv1, CURL_SSLVERSION_SSLv2, CURL_SSLVERSION_SSLv3, CURL_SSLVERSION_TLSv1_0, CURL_SSLVERSION_TLSv1_1, CURL_SSLVERSION_TLSv1_2, CURL_SSLVERSION_TLSv1_3 . Die höchste TLS-Version kann durch Verwendung einer der CURL_SSLVERSION_MAX_*-Konstanten spezifiziert werden. Es ist ebenfalls möglich, eine der CURL_SSLVERSION_*-Konstanten mittels OR mit einer der CURL_SSLVERSION_MAX_*-Konstanten zu verknüpfen. CURL_SSLVERSION_MAX_DEFAULT (die höchste Version, die von der Bibliothek unterstützt wird), CURL_SSLVERSION_MAX_TLSv1_0, CURL_SSLVERSION_MAX_TLSv1_1, CURL_SSLVERSION_MAX_TLSv1_2, CURL_SSLVERSION_MAX_TLSv1_3 .

Warnung

Es ist besser, diese Option nicht zu setzen und die Standardeinstellungen beizubehalten. Sie auf CURL_SSLVERSION_SSLv2 oder CURL_SSLVERSION_SSLv3 zu setzen, ist angesichts der bekannten Sicherheitslücken in SSLv2 und SSLv3 sehr gefährlich.

CURLOPT_SSL_CIPHER_LIST (int)

Eine Liste der für SSL zu verwendenden Chiffren. Zum Beispiel sind RC4-SHA und TLSv1 gültige Chiffre-Listen.

CURLOPT_SSL_EC_CURVES (int)

Eine durch Doppelpunkte getrennte Liste von elliptischen Kurvenalgorithmen. Zum Beispiel ist X25519:P-521 eine gültige Liste von zwei elliptischen Kurven. Diese Option definiert die Schlüsselaustauschalgorithmen des Clients im SSL-Handshake, wenn das SSL-Backend, für das cURL gebaut wurde, diese unterstützt.

CURLOPT_SSL_ENABLE_ALPN (int)

false, um ALPN im SSL-Handshake zu deaktivieren (wenn das SSL-Backend, für das libcurl gebaut wurde, es unterstützt), was genutzt werden kann, um HTTP2 auszuhandeln. Verfügbar seit PHP 7.0.7 und cURL 7.36.0

CURLOPT_SSL_ENABLE_NPN (int)

false, um NPN im SSL-Handshake zu deaktivieren (wenn das SSL-Backend, für das libcurl gebaut wurde, es unterstützt), was genutzt werden kann, um HTTP2 auszuhandeln. Verfügbar seit PHP 7.0.7 und cURL 7.36.0

CURLOPT_SSL_FALSESTART (int)

true, um TLS-False-Start zu aktivieren. Verfügbar seit PHP 7.0.7 und cURL 7.42.0

CURLOPT_SSL_OPTIONS (int)

Definiert SSL-Verhaltensoptionen, die eine Bitmaske von beliebigen der folgenden Konstanten ist: CURLSSLOPT_ALLOW_BEAST, CURLSSLOPT_NO_REVOKE, CURLSSLOPT_AUTO_CLIENT_CERT, CURLSSLOPT_NATIVE_CA, CURLSSLOPT_NO_PARTIALCHAIN, CURLSSLOPT_REVOKE_BEST_EFFORT Verfügbar seit PHP 7.0.7 und cURL 7.25.0

CURLOPT_SSL_SESSIONID_CACHE (int)

Set to 0 to disable and 1 to enable SSL session-ID caching. By default all transfers are done using the cache enabled. Available as of cURL 7.16.0.

CURLOPT_SSL_VERIFYHOST (int)

2, um zu überprüfen, ob ein Common Name-Feld oder ein Subject Alternate Name-Feld im SSL-Peer-Zertifikat mit dem angegebenen Hostnamen übereinstimmt. 0, um die Namen nicht zu überprüfen. 1 sollte nicht verwendet werden. In Produktionsumgebungen sollte der Wert dieser Option auf 2 (Standardwert) belassen werden. Die Unterstützung für den Wert 1 wurde in cURL 7.28.1 entfernt.

CURLOPT_SSL_VERIFYPEER (int)

false, um die Überprüfung des Peer-Zertifikats seitens cURL zu unterdrücken. Alternative Zertifikate zur Überprüfung können mit der Option CURLOPT_CAINFO angegeben werden und das Verzeichnis mit den Zertifikaten kann mit CURLOPT_CAPATH ausgewiesen werden. Seit cURL 7.10 standardmäßig true. Seit cURL 7.10 installiertes Standardpaket.

CURLOPT_SSL_VERIFYSTATUS (int)

true, um den Status des Zertifikats zu überprüfen. Verfügbar seit PHP 7.0.7 und cURL 7.41.0

CURLOPT_STDERR (int)

Ein alternativer Ort für die Ausgabe von Fehlern anstelle von STDERR.

CURLOPT_STREAM_WEIGHT (int)

Die numerische Gewichtung des Streams (eine Zahl zwischen 1 und 256). Verfügbar seit PHP 7.0.7 und cURL 7.46.0

CURLOPT_SUPPRESS_CONNECT_HEADERS (int)

true, um Proxy-CONNECT-Antwortheader in den Benutzercallback-Funktionen CURLOPT_HEADERFUNCTION und CURLOPT_WRITEFUNCTION zu unterdrücken, wenn CURLOPT_HTTPPROXYTUNNEL verwendet wird und eine CONNECT-Anfrage durchgeführt wird. Verfügbar seit PHP 7.3.0 und cURL 7.54.0

CURLOPT_TCP_FASTOPEN (int)

true, um TCP-Fast-Open zu aktivieren. Verfügbar seit PHP 7.0.7 und cURL 7.49.0

CURLOPT_TCP_KEEPALIVE (int)

Ist diese Option auf 1 gesetzt, werden TCP-Keepalive-Signale gesendet. Die Verzögerung und Häufigkeit dieser Signale kann mit den Optionen CURLOPT_TCP_KEEPIDLE und CURLOPT_TCP_KEEPINTVL festgelegt werden, falls das Betriebssystem diese unterstützt. Wenn auf 0 gesetzt (Voreinstellung), sind Keepalive-Signale deaktiviert. Verfügbar seit cURL 7.25.0

CURLOPT_TCP_KEEPIDLE (int)

Wenn CURLOPT_TCP_KEEPALIVE aktiviert ist, gibt diese Option die Verzögerung in Sekunden an, die das Betriebssystem wartet, während die Verbindung inaktiv ist, bevor Keepalive-Signale gesendet werden. Nicht alle Betriebssysteme unterstützen diese Option. Die Voreinstellung ist 60. Verfügbar seit cURL 7.25.0

CURLOPT_TCP_KEEPINTVL (int)

Wenn CURLOPT_TCP_KEEPALIVE aktiviert ist, gibt diese Option den Zeitraum in Sekunden an, den das Betriebssystem zwischen dem Senden von Keepalive-Signalen wartet. Nicht alle Betriebssysteme unterstützen diese Option. Die Voreinstellung ist 60. Verfügbar seit cURL 7.25.0

CURLOPT_TCP_NODELAY (int)

true, um den Nagle-Algorithmus von TCP zu deaktivieren, der verucht, die Anzahl kleiner Pakete im Netzwerk zu reduzieren. Verfügbar seit cURL 7.11.2.

CURLOPT_TELNETOPTIONS (int)

Set an array of strings to pass to the telnet negotiations. The variables should be in the format >option=value<. cURL supports the options TTYPE, XDISPLOC and NEW_ENV. Available as of cURL 7.7.

CURLOPT_TFTP_BLKSIZE (int)

Set the blocksize to use for TFTP data transmission. Valid range is 8-65464 bytes. The default of 512 bytes is used if this option is not specified. The specified block size is only used if supported by the remote server. If the server does not return an option acknowledgment or returns an option acknowledgment with no block size, the default of 512 bytes is used. Available as of cURL 7.19.4.

CURLOPT_TFTP_NO_OPTIONS (int)

true, um keine TFTP-Optionen zu senden. Verfügbar seit PHP 7.0.7 und cURL 7.48.0

CURLOPT_TIMECONDITION (int)

Dieser Wert gibt an, wie CURLOPT_TIMEVALUE behandelt werden soll. Der Wert CURL_TIMECOND_IFMODSINCE bewirkt, dass die Seite nur dann zurückgegeben wird, wenn sie seit CURLOPT_TIMEVALUE verändert wurde; andernfalls wird ein "304 Not Modified"-Header zurückgegeben (vorausgesetzt CURLOPT_HEADER ist true). CURL_TIMECOND_IFUNMODSINCE bewirkt das gegenteilige Verhalten. Mit CURL_TIMECOND_NONE wird CURLOPT_TIMEVALUE ignoriert und die Seite immer zurückzugeben. Die Standardeinstellung ist CURL_TIMECOND_NONE. Vor cURL 7.46.0 war die Standardeinstellung CURL_TIMECOND_IFMODSINCE.

CURLOPT_TIMEOUT (int)

Die maximale Ausführungszeit für cURL-Funktionen in Sekunden.

CURLOPT_TIMEOUT_MS (int)

Die maximale Ausführungszeit für cURL-Funktionen in Millisekunden. Wenn libcurl so kompiliert wurde, dass die Standard-Namensauflösung des Systems verwendet wird, verwendet dieser Teil der Verbindung dennoch die volle Sekundenauflösung für Timeouts mit einem minimalen Timeout von einer Sekunde. Verfügbar seit cURL 7.16.2.

CURLOPT_TIMEVALUE (int)

Die Zeit seit dem 1. Januar 1970 in Sekunden. Dieser Wert wird von CURLOPT_TIMECONDITION verwendet.

CURLOPT_TIMEVALUE_LARGE (int)

Die Zeit seit dem 1. Januar 1970 in Sekunden. Dieser Wert wird von CURLOPT_TIMECONDITION verwendet. Der Standardwert ist Null. Der Unterschied zwischen dieser Option und CURLOPT_TIMEVALUE ist der Typ des Arguments. Auf Systemen, auf denen "long" nur aus 32-Bit besteht, muss diese Option verwendet werden, um Daten jenseits des Jahrs 2038 anzugeben. Verfügbar seit PHP 7.3.0 und cURL 7.59.0

CURLOPT_TLS13_CIPHERS (int)

Die Liste der Chiffriersuiten, die für die TLS 1.3-Verbindung verwendet werden sollen. Die Liste muss syntaktisch korrekt sein und besteht aus einer oder mehreren Zeichenketten von Chiffriersuiten, 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 Chiffriersuiten unter Verwendung der Option CURLOPT_SSL_CIPHER_LIST zu setzen. Verfügbar, wenn mit OpenSSL >= 1.1.1 kompiliert. Verfügbar seit PHP 7.3.0 und cURL 7.61.0

CURLOPT_TLSAUTH_PASSWORD (int)

Set a password to use for the TLS authentication method specified with the CURLOPT_TLSAUTH_TYPE option. Requires that the CURLOPT_TLSAUTH_USERNAME option also be set. This feature relies on TLS SRP which does not work with TLS 1.3. Available as of cURL 7.21.4.

CURLOPT_TLSAUTH_TYPE (int)

Set a string with the method of the TLS authentication. Supported method is SRP (TLS Secure Remote Password authentication). Available as of cURL 7.21.4.

CURLOPT_TLSAUTH_USERNAME (int)

Set a string with the username to use for the TLS authentication method specified with the CURLOPT_TLSAUTH_TYPE option. Requires that the CURLOPT_TLSAUTH_PASSWORD option also be set. This feature relies on TLS SRP which does not work with TLS 1.3. Available as of cURL 7.21.4.

CURLOPT_TRANSFER_ENCODING (int)

Set to 1 to enable and 0 to disable requesting compressed Transfer Encoding in the outgoing HTTP request. If the server responds with a compressed Transfer Encoding, cURL will automatically uncompress it on reception. Defaults to 0. Available as of cURL 7.21.6.

CURLOPT_TRANSFERTEXT (int)

true, um FTP-Transfers im ASCII-Modus durchzuführen. Für LDAP werden Daten in Klartext statt HTML übertragen. Unter Windows wird STDOUT nicht in den binären Modus gesetzt.

CURLOPT_UNIX_SOCKET_PATH (int)

Aktiviert die Verwendung von Unix-Domain-Sockets als Verbindsendpunkt und setzt den Pfad auf den angegebenen String. Verfügbar seit PHP 7.0.7 und cURL 7.40.0

CURLOPT_UNRESTRICTED_AUTH (int)

true, um beim Verfolgen eines Location: -Headers (siehe CURLOPT_FOLLOWLOCATION) weiterhin Benutzername und Passwort zu senden, selbst dann, wenn sich der Hostname geändert hat.

CURLOPT_UPKEEP_INTERVAL_MS (int)

Einige Protokolle verfügen über Mechanismen, um bestehende Verbindungen aufrecht zu erhalten, und senden zu diesem Zweck in der Regel einen Teil des Datenverkehrs an diese Verbindungen. Mit dieser Option wird das Intervall für die Aufrechterhaltung der Verbindung festgelegt. Derzeit ist HTTP/2 das einzige Protokoll mit einem solchen Mechanismus. Wenn das Intervall überschritten wird, wird ein HTTP/2-PING-Frame an die Verbindung gesendet. Die Voreinstellung ist 60 Sekunden. Verfügbar seit PHP 8.2.0 und cURL 7.62.0

CURLOPT_UPLOAD (int)

true, um einen Upload vorzubereiten

CURLOPT_UPLOAD_BUFFERSIZE (int)

Die bevorzugte Puffergröße für den cURL-Upload-Puffer in Bytes. Die Standardgröße des Upload-Puffers beträgt 64 Kilobytes. Als maximale Puffergröße können 2 Megabyte eingestellt werden, als Mindestgröße 16 Kilobyte. Verfügbar seit PHP 8.2.0 und cURL 7.62.0

CURLOPT_URL (int)

Der abzurufende URL. Diese kann auch bei der Initialisierung einer Session mittels curl_init() gesetzt werden.

CURLOPT_USE_SSL (int)

Sets the desired level of SSL/TLS for the transfer when using FTP, SMTP, POP3, IMAP, etc. These are all protocols that start out plain text and get "upgraded" to SSL using the STARTTLS command. Set to one of the following: CURLUSESSL_NONE, CURLUSESSL_TRY, CURLUSESSL_CONTROL or CURLUSESSL_ALL. Available as of cURL 7.17.0.

CURLOPT_USERAGENT (int)

Der Wert des Headers "User-Agent: ", der in einer HTTP-Anfrage verwendet werden soll.

CURLOPT_USERNAME (int)

Der für die Authentifizierung zu verwendende Benutzername. Verfügbar seit cURL 7.19.1

CURLOPT_USERPWD (int)

Benutzername und Passwort, die für die Verbindung verwendet werden sollen, im Format "[benutzername]:[passwort]".

CURLOPT_VERBOSE (int)

true, um ausführliche Informationen auszugeben, entweder nach STDERR oder in die mittels der Option CURLOPT_STDERR gewählte Datei.

CURLOPT_WILDCARDMATCH (int)

Set to 1 to transfer multiple files according to a filename pattern. The pattern can be specified as part of the CURLOPT_URL option, using an fnmatch-like pattern (Shell Pattern Matching) in the last part of URL (filename). Available as of cURL 7.21.0.

CURLOPT_WRITEFUNCTION (int)

Ein Callback, der zwei Parameter erwartet. Der erste ist die cURL-Ressource, der zweite ist eine Zeichenkette mit den zu schreibenden Daten. Die Daten müssen durch diesen Callback gespeichert werden. Er muss die genaue Anzahl der geschriebenen Bytes zurückgeben, sonst wird die Übertragung mit einem Fehler abgebrochen.

CURLOPT_WRITEHEADER (int)

In diese Datei werden die Header eines Transfers geschrieben.

CURLOPT_WS_OPTIONS (int)

Verfügbar seit PHP 8.3.0 und cURL 7.86.0

CURLOPT_XFERINFOFUNCTION (int)

Ein Callback, der zwei Parameter erwartet. Dient einem ähnlichen Zweck wie CURLOPT_PROGRESSFUNCTION, ist aber moderner und die bevorzugte Option von cURL. Verfügbar seit PHP 8.2.0 und cURL 7.32.0.

CURLOPT_XOAUTH2_BEARER (int)

Gibt das OAuth 2.0 Access-Token an. Verfügbar seit PHP 7.0.7 und cURL 7.33.0

curl_share_setopt()
Konstanten Beschreibung
CURL_LOCK_DATA_CONNECT (int) Aktiviert oder deaktiviert die gemeinsame Nutzung des Verbindungs-Caches. Verfügbar seit PHP 7.3.0 und cURL 7.10.3.
Aktiviert oder deaktiviert die gemeinsame Nutzung der Cookie-Daten. Verfügbar seit und cURL 7.10.3.
CURL_LOCK_DATA_DNS (int) Aktiviert oder deaktiviert die gemeinsame Nutzung des DNS-Caches. Es ist zu beachten, dass bei der Verwendung von cURL-Mehrfach-Handles alle Handles, die zum selben Mehrfach-Handle hinzugefügt werden, standardmäßig den DNS-Cache teilen. Verfügbar seit und cURL 7.10.3.
CURL_LOCK_DATA_PSL (int) Aktiviert oder deaktiviert die gemeinsame Nutzung der Liste öffentlicher Suffixe. Verfügbar seit PHP 7.3.0 und cURL 7.61.0.
CURL_LOCK_DATA_SSL_SESSION (int) Aktiviert oder deaktiviert die gemeinsame Nutzung von SSL-Session-IDs. Durch die gemeinsame Nutzung wird die Zeit reduziert, die für den SSL-Handshake bei der erneuten Verbindung mit demselben Server benötigt wird. Es ist zu beachten, dass SSL-Session-IDs innerhalb desselben Handles standardmäßig wiederverwendet werden. Verfügbar seit und cURL 7.10.3.
CURLSHOPT_NONE (int) Verfügbar seit und cURL 7.10.3.
CURLSHOPT_SHARE (int) Gibt an, welcher Datentyp gemeinsam genutzt werden soll. Verfügbar seit und cURL 7.10.3.
CURLSHOPT_UNSHARE (int) Gibt an, welcher Datentyp nicht mehr gemeinsam genutzt werden soll. Verfügbar seit und cURL 7.10.3.
curl_getinfo()
Konstanten Beschreibung
CURLINFO_APPCONNECT_TIME (int) Die Zeit in Sekunden, die vom Start bis zum Abschluss des SSL/SSH-Verbindungsaufbaus/-Handshakes zum entfernten Host verging
CURLINFO_APPCONNECT_TIME_T (int) Die Zeit in Mikrosekunden, die vom Start bis zum Abschluss des SSL/SSH-Verbindungsaufbaus/-Handshakes zum entfernten Host verging. Verfügbar seit PHP 7.3.0 und cURL 7.61.0
CURLINFO_CAINFO (int) Der standardmäßige interne Pfad zur CA-Zertifikatsdatei. Verfügbar seit PHP 8.3.0 und cURL 7.84.0
CURLINFO_CAPATH (int) Der standardmäßige interne Pfad zum CA-Verzeichnis. Verfügbar seit PHP 8.3.0 und cURL 7.84.0
CURLINFO_CERTINFO (int) Die TLS-Zertifikatskette
CURLINFO_CONDITION_UNMET (int) Die Info über eine nicht eingehaltene Zeitbedingung
CURLINFO_CONNECT_TIME (int) Die Zeit, die für den Verbindungsaufbau benötigt wurde, in Sekunden
CURLINFO_CONNECT_TIME_T (int) Die Zeit, die vom Beginn bis zum Abschluss des Verbindungsaufbaus zum entfernten Host (oder Proxy) verging, in Mikrosekunden. Verfügbar seit PHP 7.3.0 und cURL 7.61.0
CURLINFO_CONTENT_LENGTH_DOWNLOAD (int) Die inhaltliche Größe des Downloads, ermittelt aus dem Content-Length:-Header
CURLINFO_CONTENT_LENGTH_DOWNLOAD_T (int) Die inhaltliche Größe des Downloads. Das ist der Wert, der aus dem Content-Length:-Header gelesen wurde. -1, wenn die Größe nicht bekannt ist. Verfügbar seit PHP 7.3.0 und cURL 7.55.0
CURLINFO_CONTENT_LENGTH_UPLOAD (int) Die angegebene Größe des Uploads
CURLINFO_CONTENT_LENGTH_UPLOAD_T (int) Die angegebene Größe des Uploads. -1, wenn die Größe nicht bekannt ist. Verfügbar seit PHP 7.3.0 und cURL 7.55.0
CURLINFO_CONTENT_TYPE (int) Der Content-Type des angeforderten Dokuments. NULL zeigt an, dass der Server keinen gültigen Content-Type-Header gesendet hat
CURLINFO_COOKIELIST (int) Alle bekannten Cookies
CURLINFO_EFFECTIVE_METHOD (int) Ermittelt die zuletzt verwendete HTTP-Methode.
CURLINFO_EFFECTIVE_URL (int) Die letzte erfolgreiche URL
CURLINFO_FILETIME (int) Die (Server-)Zeit der letzten Änderung des abgerufenen Dokuments, wenn die Option CURLOPT_FILETIME aktiviert ist; wenn -1 zurückgegeben wird, ist die Zeit unbekannt
CURLINFO_FILETIME_T (int) Die (Server-)Zeit der letzten Änderung des abgerufenen Dokuments (als Unix-Zeitstempel); eine Alternative zu CURLINFO_FILETIME, die es Systemen mit 32-Bit-Long-Variablen ermöglicht, Daten außerhalb des 32-Bit-Zeitstempelbereichs zu extrahieren. Verfügbar seit PHP 7.3.0 und cURL 7.59.0
CURLINFO_FTP_ENTRY_PATH (int) Der Eingangspfad des FTP-Servers
CURLINFO_HEADER_OUT (int) Die gesendete Anfrage. Damit dies funktioniert, muss die Option CURLINFO_HEADER_OUT mittels curl_setopt() zum Handle hinzugefügt werden.
CURLINFO_HEADER_SIZE (int) Die Gesamtgröße aller empfangenen Header
CURLINFO_HTTPAUTH_AVAIL (int) Eine Bitmaske, die die verfügbare(n) Authentifizierungsmethode(n) gemäß der vorherigen Antwort angibt
CURLINFO_HTTP_CODE (int) Der letzte Antwortcode. Seit cURL 7.10.8 an ist dies ein veralteter Alias von CURLINFO_RESPONSE_CODE.
CURLINFO_HTTP_CONNECTCODE (int) Der CONNECT-Antwortcode
CURLINFO_HTTP_VERSION (int) Die Version, die in der letzten HTTP-Verbindung verwendet wurde. Der Rückgabewert ist eine der definierten CURL_HTTP_VERSION_*-Konstanten oder 0, wenn die Version nicht ermittelt werden kann. Verfügbar seit PHP 7.3.0 und cURL 7.50.0
CURLINFO_LASTONE (int) Der letzte Enum-Wert in der zugrundeliegenden CURLINFO-Enum in libcurl.
CURLINFO_LOCAL_IP (int) Die lokale (Quell-)IP-Adresse der letzten Verbindung
CURLINFO_LOCAL_PORT (int) Der lokale (Quell-)Port der letzten Verbindung
CURLINFO_NAMELOOKUP_TIME (int) Die Zeit, die für die Auflösung des Hostnamens benötigt wurde, in Sekunden
CURLINFO_NAMELOOKUP_TIME_T (int) Die Zeit vom Beginn bis zum Ende der Namensauflösung in Mikrosekunden. Verfügbar seit PHP 7.3.0 und cURL 7.61.0
CURLINFO_NUM_CONNECTS (int) Die Anzahl der Verbindungen, die cURL erzeugen musste, um die vorherige Übertragung durchzuführen
CURLINFO_OS_ERRNO (int) Die Fehlernummer eines Verbindungsfehlers. Die Zahl ist OS- und systemabhängig.
CURLINFO_PRETRANSFER_TIME (int) Die Zeit vom Start bis zum tatsächlichen Beginn der Dateiübertragung in Sekunden
CURLINFO_PRETRANSFER_TIME_T (int) Die Zeit vom Start bis zum tatsächlichen Beginn der Dateiübertragung in Mikrosekunden. Verfügbar seit PHP 7.3.0 und cURL 7.61.0
CURLINFO_PRIMARY_IP (int) Die IP-Adresse der letzten Verbindung
CURLINFO_PRIMARY_PORT (int) Der Zielport der letzten Verbindung
CURLINFO_PRIVATE (int) Private Daten, die mit diesem cURL-Handle verknüpft sind und zuvor mittels curl_setopt() mit der Option CURLOPT_PRIVATE definiert wurden
CURLINFO_PROTOCOL (int) Das Protokoll, das in der letzten HTTP-Verbindung verwendet wurde. Der Rückgabewert ist genau einer der CURLPROTO_*-Werte. Verfügbar seit PHP 7.3.0 und cURL 7.52.0
CURLINFO_PROXYAUTH_AVAIL (int) Eine Bitmaske, die die verfügbare(n) Proxy-Authentifikationsmethode(n) gemäß der vorherigen Antwort angibt
CURLINFO_PROXY_ERROR (int) Der detaillierte (SOCKS) Proxy-Fehlercode, wenn bei der letzten Übertragung ein CURLE_PROXY-Fehler aufgetreten ist. Der zurückgegebene Wert ist genau einer der CURLPX_*-Werte. Wenn kein Antwortcode verfügbar ist, lautet der Fehlercode CURLPX_OK. Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLINFO_PROXY_SSL_VERIFYRESULT (int) Das Ergebnis der mit der Option CURLOPT_PROXY_SSL_VERIFYPEER angeforderten Zertifikatsüberprüfung; wird nur für HTTPS-Proxies verwendet. Verfügbar seit PHP 7.3.0 und cURL 7.52.0
CURLINFO_REDIRECT_COUNT (int) Die Anzahl der Weiterleitungen, wenn die Option CURLOPT_FOLLOWLOCATION aktiviert ist
CURLINFO_REDIRECT_TIME (int) Die Zeit in Sekunden, die für alle Weiterleitungsschritte benötigt wurde, bevor der eigentliche Transfer beginnt, wenn die Option CURLOPT_FOLLOWLOCATION aktiviert ist
CURLINFO_REDIRECT_TIME_T (int) Die Zeit in Mikrosekunden, die für alle Weiterleitungsschritte benötigt wurde, einschließlich Namenssuche, Verbindungsaufbau, Vorübertragung und Übertragung, bevor die eigentliche Transaktion gestartet wurde. Verfügbar seit PHP 7.3.0 und cURL 7.61.0
CURLINFO_REDIRECT_URL (int) Wenn die Option CURLOPT_FOLLOWLOCATION deaktiviert ist: die Weiterleitungs-URL, die in der letzten Transaktion gefunden wurde und als nächstes manuell angefordert werden sollte. Wenn CURLOPT_FOLLOWLOCATION aktiviert ist: leer. Die Weiterleitungs-URL ist in diesem Fall in CURLINFO_EFFECTIVE_URL verfügbar
CURLINFO_REFERER (int) Der Referer-Header. Verfügbar seit PHP 8.2.0 und cURL 7.76.0
CURLINFO_REQUEST_SIZE (int) Die Gesamtgröße der ausgegebenen Anfragen; steht derzeit nur für HTTP-Anfragen zur Verfügung
CURLINFO_RESPONSE_CODE (int) Der letzte Antwortcode. Verfügbar seit cURL 7.10.8
CURLINFO_RETRY_AFTER (int) Die Information aus dem Retry-After-Header oder Null (0), wenn es keinen gültigen Header gibt. Verfügbar seit PHP 8.2.0 und cURL 7.66.0
CURLINFO_RTSP_CLIENT_CSEQ (int) Die nächste CSeq des RTSP-Clients
CURLINFO_RTSP_CSEQ_RECV (int) Die zuletzt empfangene CSeq
CURLINFO_RTSP_SERVER_CSEQ (int) Die nächste CSeq des RTSP-Servers
CURLINFO_RTSP_SESSION_ID (int) Die RTSP-Session-ID
CURLINFO_SCHEME (int) Das URL-Schema, das für die letzte Verbindung verwendet wurde. Verfügbar seit PHP 7.3.0 und cURL 7.52.0
CURLINFO_SIZE_DOWNLOAD (int) Die Anzahl der heruntergeladenen Bytes
CURLINFO_SIZE_DOWNLOAD_T (int) Die Anzahl der Bytes, die heruntergeladen wurden. Die Zahl gilt nur für die letzte Übertragung, und wird für jede neue Übertragung zurückgesetzt. Verfügbar seit PHP 7.3.0 und cURL 7.50.0
CURLINFO_SIZE_UPLOAD (int) Die Anzahl der hochgeladenen Bytes
CURLINFO_SIZE_UPLOAD_T (int) Die Anzahl der hochgeladenen Bytes. Verfügbar seit PHP 7.3.0 und cURL 7.50.0
CURLINFO_SPEED_DOWNLOAD (int) Die durchschnittliche Download-Geschwindigkeit
CURLINFO_SPEED_DOWNLOAD_T (int) Die durchschnittliche Download-Geschwindigkeit in Bytes pro Sekunde, die CURL für den vollständigen Download gemessen hat. Verfügbar seit PHP 7.3.0 und cURL 7.50.0
CURLINFO_SPEED_UPLOAD (int) Die durchschnittliche Upload-Geschwindigkeit
CURLINFO_SPEED_UPLOAD_T (int) Die durchschnittliche Upload-Geschwindigkeit in Bytes pro Sekunde, die CURL für den vollständigen Upload gemessen hat. Verfügbar seit PHP 7.3.0 und cURL 7.50.0
CURLINFO_SSL_ENGINES (int) Die unterstützten OpenSSL-Krypto-Engines
CURLINFO_SSL_VERIFYRESULT (int) Das Ergebnis der mit Option CURLOPT_SSL_VERIFYPEER angeforderten Überprüfung des SSL-Zertifikats
CURLINFO_STARTTRANSFER_TIME (int) Die Zeit bis zur Übertragung des ersten Bytes in Sekunden
CURLINFO_STARTTRANSFER_TIME_T (int) Die benötigte Zeit vom Beginn bis zum Empfang des ersten Bytes in Mikrosekunden. Verfügbar seit PHP 7.3.0 und cURL 7.61.0
CURLINFO_TOTAL_TIME (int) Die Dauer des letzten Transfers in Sekunden
CURLINFO_TOTAL_TIME_T (int) Die Dauer der vorhergehenden Übertragung in Mikrosekunden, einschließlich Namensauflösung, TCP-Verbindung usw. Verfügbar seit PHP 7.3.0 und cURL 7.61.0
curl_multi_setopt()
Konstanten Beschreibung
CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE (int) Gibt den Schwellenwert der Teilstücke-Länge für das Pipelining in Bytes an. Verfügbar seit PHP 7.0.7 und cURL 7.30.0
CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE (int) Gibt den Schwellenwert für die Größe der Pipelining-Strafe in Bytes an. Verfügbar seit PHP 7.0.7 und cURL 7.30.0
CURLMOPT_MAXCONNECTS (int) Gibt die maximale Anzahl der gleichzeitig geöffneten Verbindungen an, die libcurl zwischenspeichern darf. Standardmäßig wird die Anzahl so weit vergrößert, dass sie viermal so groß ist wie die Anzahl der Handles, die mit curl_multi_add_handle() hinzugefügt wurden. Wenn der Zwischenspeicher voll ist, schließt cURL die älteste Verbindung im Zwischenspeicher, um zu verhindern, dass die Anzahl der offenen Verbindungen ansteigt. Verfügbar seit cURL 7.16.3.
CURLMOPT_MAX_CONCURRENT_STREAMS (int) Gibt die maximale Anzahl gleichzeitiger Streams für Verbindungen an, die cURL bei Verbindungen mit HTTP/2 unterstützen soll. Gültige Werte reichen von 1 bis 2147483647 (2^31 - 1). Der hier übergebene Wert wird auf der Grundlage anderer Eigenschaften der Systemressourcen berücksichtigt. Standard ist 100. Verfügbar seit PHP 8.2.0 und cURL 7.67.0.
CURLMOPT_MAX_HOST_CONNECTIONS (int) Gibt die maximale Anzahl der Verbindungen zu einem einzelnen Host an. Verfügbar seit PHP 7.0.7 und cURL 7.30.0
CURLMOPT_MAX_PIPELINE_LENGTH (int) Gibt die maximale Anzahl von Anfragen in einer Pipeline an. Verfügbar seit PHP 7.0.7 und cURL 7.30.0
CURLMOPT_MAX_TOTAL_CONNECTIONS (int) Gibt die maximale Anzahl der gleichzeitig geöffneten Verbindungen an. Verfügbar seit PHP 7.0.7 und cURL 7.30.0
CURLMOPT_PIPELINING (int) Durch 1 wird das Pipelining aktiviert und durch 0 deaktiviert. Wenn Pipelining auf einem Mehrfach-Handle aktiviert wird, versucht cURL, für Übertragungen mit diesem Handle so weit wie möglich HTTP-Pipelining zu nutzen. Das bedeutet, dass eine zweite Anfrage, die eine bereits bestehende Verbindung nutzen kann, über dieselbe Verbindung geleitet (ge"pipe"t) wird. Seit cURL 7.43.0 ist der Wert eine Bitmaske und wenn 2 übergeben wird, wird versucht, die neue Übertragung über eine bestehende HTTP/2-Verbindung zu multiplexen. Die Übergabe von 3 weist cURL an, Pipelining und Multiplexing unabhängig voneinander anzufordern. Seit cURL 7.62.0 hat das Setzen des Pipelining-Bits keine Wirkung mehr. Anstelle der ganzzahligen Literale können auch die CURLPIPE_*-Konstanten verwendet werden. Verfügbar seit cURL 7.16.0.
CURLMOPT_PUSHFUNCTION (int)

Ein callable, der registriert wird, um Push-Benachrichtigungen des Servers zu verarbeiten. Er sollte die folgende Signatur haben:

pushfunction(resource $parent_ch, resource $pushed_ch, array $headers): int
parent_ch
Das übergeordnete cURL-Handle (die vom Client gestellte Anfrage).
pushed_ch
Ein neues cURL-Handle für die gesendete Anfrage.
headers
Die Push-Promise-Header.
Die Push-Funktion soll entweder CURL_PUSH_OK zurückgeben, wenn sie den Push verarbeiten kann, oder CURL_PUSH_DENY, um ihn abzulehnen. Verfügbar seit PHP 7.1.0 und cURL 7.44.0

cURL protocol constants
Konstanten Beschreibung
CURLPROTO_ALL (int) Verfügbar seit cURL 7.19.4.
CURLPROTO_DICT (int) Verfügbar seit cURL 7.19.4.
CURLPROTO_FILE (int) Verfügbar seit cURL 7.19.4.
CURLPROTO_FTP (int) Verfügbar seit cURL 7.19.4.
CURLPROTO_FTPS (int) Verfügbar seit cURL 7.19.4.
CURLPROTO_GOPHER (int) Verfügbar seit cURL 7.21.2.
CURLPROTO_HTTP (int) Verfügbar seit cURL 7.19.4.
CURLPROTO_HTTPS (int) Verfügbar seit cURL 7.19.4.
CURLPROTO_IMAP (int) Verfügbar seit cURL 7.20.0.
CURLPROTO_IMAPS (int) Verfügbar seit cURL 7.20.0.
CURLPROTO_LDAP (int) Verfügbar seit cURL 7.19.4.
CURLPROTO_LDAPS (int) Verfügbar seit cURL 7.19.4.
CURLPROTO_MQTT (int) Verfügbar seit PHP 8.2.0 und cURL 7.71.0.
CURLPROTO_POP3 (int) Verfügbar seit cURL 7.20.0.
CURLPROTO_POP3S (int) Verfügbar seit cURL 7.20.0.
CURLPROTO_RTMP (int) Verfügbar seit cURL 7.21.0.
CURLPROTO_RTMPE (int) Verfügbar seit cURL 7.21.0.
CURLPROTO_RTMPS (int) Verfügbar seit cURL 7.21.0.
CURLPROTO_RTMPT (int) Verfügbar seit cURL 7.21.0.
CURLPROTO_RTMPTE (int) Verfügbar seit cURL 7.21.0.
CURLPROTO_RTMPTS (int) Verfügbar seit cURL 7.21.0.
CURLPROTO_RTSP (int) Verfügbar seit cURL 7.20.0.
CURLPROTO_SCP (int) Verfügbar seit cURL 7.19.4.
CURLPROTO_SFTP (int) Verfügbar seit cURL 7.19.4.
CURLPROTO_SMB (int) Verfügbar seit PHP 7.0.7 und cURL 7.40.0.
CURLPROTO_SMBS (int) Verfügbar seit PHP 7.0.7 und cURL 7.40.0.
CURLPROTO_SMTP (int) Verfügbar seit cURL 7.20.0.
CURLPROTO_SMTPS (int) Verfügbar seit cURL 7.20.0.
CURLPROTO_TELNET (int) Verfügbar seit cURL 7.19.4.
CURLPROTO_TFTP (int) Verfügbar seit cURL 7.19.4.
cURL error constants
Konstanten Beschreibung
CURLE_ABORTED_BY_CALLBACK (int) Abbruch durch Callback. Ein Callback hat "abort" an libcurl zurückgegeben.
CURLE_BAD_CALLING_ORDER (int)
CURLE_BAD_CONTENT_ENCODING (int) Nicht erkannte Kodierung der Übertragung.
CURLE_BAD_DOWNLOAD_RESUME (int) Der Download konnte nicht fortgesetzt werden, weil der angegebene Offset außerhalb der Dateigrenze lag.
CURLE_BAD_FUNCTION_ARGUMENT (int) Eine Funktion wurde mit einem fehlerhaften Parameter aufgerufen.
CURLE_BAD_PASSWORD_ENTERED (int)
CURLE_COULDNT_CONNECT (int) Es konnte keine Verbindung zum Host oder Proxy aufgebaut werden.
CURLE_COULDNT_RESOLVE_HOST (int) Der Host konnte nicht aufgelöst werden. Der angegebene Remote-Host konnte nicht aufgelöst werden.
CURLE_COULDNT_RESOLVE_PROXY (int) Der Proxy konnte nicht aufgelöst werden. Der angegebene Proxy-Host konnte nicht aufgelöst werden.
CURLE_FAILED_INIT (int) Ein frühzeitiger Fehler bei der Initialisierung. Dies ist wahrscheinlich auf interne Fehler oder Probleme zurückzuführen oder auf ein Ressourcenproblem, wodurch etwas Grundlegendes während der Initialisierung nicht erledigt werden konnte.
CURLE_FILESIZE_EXCEEDED (int) Die maximale Dateigröße wurde überschritten.
CURLE_FILE_COULDNT_READ_FILE (int) Eine mit FILE:// angegebene Datei konnte nicht geöffnet werden. Dies liegt wahrscheinlich daran, dass die im Pfad angegebene Datei nicht existiert oder dass die entsprechenden Berechtigungen für die Datei fehlen.
CURLE_FTP_ACCESS_DENIED (int)
CURLE_FTP_BAD_DOWNLOAD_RESUME (int)
CURLE_FTP_CANT_GET_HOST (int) Ein interner Fehler bei der Suche nach dem Host, der für die neue Verbindung verwendet werden soll.
CURLE_FTP_CANT_RECONNECT (int)
CURLE_FTP_COULDNT_GET_SIZE (int)
CURLE_FTP_COULDNT_RETR_FILE (int) Dies war entweder eine unerwartete Antwort auf einen 'RETR'-Befehl oder eine Null-Byte-Übertragung wurde abgeschlossen.
CURLE_FTP_COULDNT_SET_ASCII (int)
CURLE_FTP_COULDNT_SET_BINARY (int)
CURLE_FTP_COULDNT_STOR_FILE (int)
CURLE_FTP_COULDNT_USE_REST (int) Der FTP-Befehl REST gab einen Fehler zurück. Dies sollte nie passieren, wenn der Server in Ordnung ist.
CURLE_FTP_PARTIAL_FILE (int)
CURLE_FTP_PORT_FAILED (int) Der FTP-Befehl PORT gab einen Fehler zurück. Dies passiert normalerweise, wenn die angegebene Adresse für libcurl nicht ausreichend ist. Siehe CURLOPT_FTPPORT.
CURLE_FTP_QUOTE_ERROR (int)
CURLE_FTP_SSL_FAILED (int)
CURLE_FTP_USER_PASSWORD_INCORRECT (int)
CURLE_FTP_WEIRD_227_FORMAT (int) FTP-Server geben als Antwort auf einen PASV-Befehl die Zeile 227 zurück. Wenn libcurl diese Zeile beim Parsen nicht findet, wird dieser Rückgabewert zurückgegeben.
CURLE_FTP_WEIRD_PASS_REPLY (int) Nachdem das FTP-Passwort an den Server gesendet wurde, erwartet libcurl eine korrekte Antwort. Dieser Fehlercode zeigt an, dass ein unerwarteter Code zurückgegeben wurde.
CURLE_FTP_WEIRD_PASV_REPLY (int) libcurl hat als Antwort auf einen PASV- oder EPSV-Befehl kein vernünftiges Ergebnis vom Server erhalten. Der Server ist fehlerhaft.
CURLE_FTP_WEIRD_SERVER_REPLY (int) Der Server hat Daten gesendet, die libcurl nicht auswerten konnte. Dieser Fehlercode ist seit cURL 7.51.0 als CURLE_WEIRD_SERVER_REPLY bekannt.
CURLE_FTP_WEIRD_USER_REPLY (int)
CURLE_FTP_WRITE_ERROR (int)
CURLE_FUNCTION_NOT_FOUND (int) Funktion nicht gefunden. Eine benötigte zlib-Funktion wurde nicht gefunden.
CURLE_GOT_NOTHING (int) Es wurde nichts vom Server zurückgegeben, und unter den gegebenen Umständen wird das Ausbleiben einer Antwort als Fehler angesehen.
CURLE_HTTP_NOT_FOUND (int)
CURLE_HTTP_PORT_FAILED (int)
CURLE_HTTP_POST_ERROR (int) Dies ist ein ungewöhnlicher Fehler, der hauptsächlich aufgrund einer internen Verwechslung auftritt.
CURLE_HTTP_RANGE_ERROR (int)
CURLE_HTTP_RETURNED_ERROR (int) Dies wird zurückgegeben, wenn CURLOPT_FAILONERROR auf true gesetzt ist und der HTTP-Server einen Fehlercode größer oder gleich 400 zurückgibt.
CURLE_LDAP_CANNOT_BIND (int) LDAP kann keine Bindung herstellen. Der LDAP-Bindungsvorgang ist fehlgeschlagen.
CURLE_LDAP_INVALID_URL (int)
CURLE_LDAP_SEARCH_FAILED (int) Die LDAP-Suche ist fehlgeschlagen.
CURLE_LIBRARY_NOT_FOUND (int)
CURLE_MALFORMAT_USER (int)
CURLE_OBSOLETE (int)
CURLE_OK (int) Es ist alles in Ordnung. Wie gewohnt fortfahren.
CURLE_OPERATION_TIMEDOUT (int) Zeitüberschreitung des Vorgangs. Die angegebene Timeout-Zeit wurde entsprechend den Bedingungen erreicht.
CURLE_OPERATION_TIMEOUTED (int)
CURLE_OUT_OF_MEMORY (int) Die Anforderung einer Speicherzuweisung ist fehlgeschlagen.
CURLE_PARTIAL_FILE (int) Eine Dateiübertragung war kleiner oder größer als erwartet. Dies geschieht, wenn der Server zunächst eine zu erwartende Größe der Übertragung meldet und dann Daten liefert, die nicht der zuvor angegebenen Größe entsprechen.
CURLE_PROXY (int) Fehler beim Proxy-Handshake. CURLINFO_PROXY_ERROR liefert weitere Details zum spezifischen Problem. Verfügbar seit PHP 8.2.0 und cURL 7.73.0
CURLE_READ_ERROR (int) Beim Lesen einer lokalen Datei ist ein Problem aufgetreten oder der Lese-Callback hat einen Fehler zurückgegeben.
CURLE_RECV_ERROR (int) Der Empfang von Netzwerkdaten ist fehlgeschlagen.
CURLE_SEND_ERROR (int) Das Senden von Netzwerkdaten ist fehlgeschlagen.
CURLE_SHARE_IN_USE (int)
CURLE_SSH (int) Während der SSH-Session ist ein nicht spezifizierter Fehler aufgetreten. Verfügbar seit cURL 7.16.1.
CURLE_SSL_CACERT (int)
CURLE_SSL_CACERT_BADFILE (int) Beim Lesen des SSL-CA-Zertifikats ist ein Problem aufgetreten.
CURLE_SSL_CERTPROBLEM (int) Problem mit dem lokalen Client-Zertifikat.
CURLE_SSL_CIPHER (int) Die angegebene Chiffre konnte nicht verwendet werden.
CURLE_SSL_CONNECT_ERROR (int) Beim SSL/TLS-Handshake ist irgendwo ein Problem aufgetreten. Die Meldung im Fehlerpuffer liefert weitere Einzelheiten über das Problem. Es könnte sich um Zertifikate (Dateiformate, Pfade, Berechtigungen), Kennwörter und andere handeln.
CURLE_SSL_ENGINE_NOTFOUND (int) Die angegebene Krypto-Engine wurde nicht gefunden.
CURLE_SSL_ENGINE_SETFAILED (int) Die ausgewählte SSL-Krypto-Engine konnte nicht als Standard festgelegt werden.
CURLE_SSL_PEER_CERTIFICATE (int)
CURLE_SSL_PINNEDPUBKEYNOTMATCH (int) Der Abgleich mit dem in CURLOPT_PINNEDPUBLICKEY angegebenen festen (gepinnten) Schlüssel ist fehlgeschlagen.
CURLE_TELNET_OPTION_SYNTAX (int)
CURLE_TOO_MANY_REDIRECTS (int) Zu viele Weiterleitungen. Beim Verfolgen von Weiterleitungen hat libcurl die maximale Anzahl erreicht. Das Limit kann mit CURLOPT_MAXREDIRS festgelegt werden.
CURLE_UNKNOWN_TELNET_OPTION (int)
CURLE_UNSUPPORTED_PROTOCOL (int) Die an libcurl übergebene URL verwendet ein Protokoll, das libcurl nicht unterstützt. Dies könnte daran liegen, dass bei der Kompilierung eine Option nicht verwendet wurde, dass der Name des Protokolls falsch geschrieben wurde, oder einfach daran, dass libcurl für dieses Protokoll keinen Code hat.
CURLE_URL_MALFORMAT (int) Die URL hat nicht das korrekte Format.
CURLE_URL_MALFORMAT_USER (int)
CURLE_WEIRD_SERVER_REPLY (int) Der Server hat Daten gesendet, die libcurl nicht analysieren konnte. Dieser Fehlercode war vor cURL 7.51.0 als CURLE_FTP_WEIRD_SERVER_REPLY bekannt. Verfügbar seit PHP 7.3.0 und cURL 7.51.0
CURLE_WRITE_ERROR (int) Beim Schreiben der empfangenen Daten in eine lokale Datei ist ein Fehler aufgetreten oder ein Schreib-Callback hat einen Fehler an libcurl zurückgegeben.
curl_multi_* status constants
Konstanten Beschreibung
CURLM_ADDED_ALREADY (int) Es wurde versucht, ein einfaches Handle, das bereits zu einem Mehrfach-Handle hinzugefügt wurde, ein zweites Mal hinzuzufügen. Verfügbar seit cURL 7.32.1.
CURLM_BAD_EASY_HANDLE (int) Ein einfaches Handle war nicht gut/gültig. Dies könnte bedeuten, dass es sich gar nicht um ein einfaches Handle handelt, oder dass das Handle bereits von diesem Mehrfach-Handle oder einem anderen verwendet wird. Verfügbar seit cURL 7.9.6.
CURLM_BAD_HANDLE (int) Das übergebene Handle ist kein gültiges Mehrfach-Handle. Verfügbar seit cURL 7.9.6.
CURLM_CALL_MULTI_PERFORM (int) Seit cURL 7.20.0 wird diese Konstante nicht mehr verwendet. Vor cURL 7.20.0 konnte dieser Status von curl_multi_exec() zurückgegeben werden, wenn curl_multi_select() oder eine ähnliche Funktion aufgerufen wurde, bevor sie eine andere Konstante zurückgab. Verfügbar seit cURL 7.9.6.
CURLM_INTERNAL_ERROR (int) Interner libcurl-Fehler. Verfügbar seit cURL 7.9.6.
CURLM_OK (int) Keine Fehler. Verfügbar seit cURL 7.9.6.
CURLM_OUT_OF_MEMORY (int) Bei der Verarbeitung von Mehrfach-Handles war kein Speicher mehr verfügbar. Verfügbar seit cURL 7.9.6.
curl_pause()
Konstanten Beschreibung
CURLPAUSE_ALL (int) Unterbricht das Senden und Empfangen von Daten. Verfügbar seit cURL 7.18.0.
CURLPAUSE_CONT (int) Setzt das Senden und Empfangen von Daten fort. Verfügbar seit cURL 7.18.0.
CURLPAUSE_RECV (int) Unterbricht das Empfangen von Daten. Verfügbar seit cURL 7.18.0.
CURLPAUSE_RECV_CONT (int) Setzt das Empfangen von Daten fort. Verfügbar seit cURL 7.18.0.
CURLPAUSE_SEND (int) Unterbricht das Senden von Daten. Verfügbar seit cURL 7.18.0.
CURLPAUSE_SEND_CONT (int) Setzt das Senden von Daten fort. Verfügbar seit cURL 7.18.0.
add a note

User Contributed Notes 5 notes

up
30
nimasdj [AT] yahoo [DOT] com
9 years ago
I hope this would be useful to convert error codes:

<?php
$curl_errno
= array(
1 => "CURLE_UNSUPPORTED_PROTOCOL",
2 => "CURLE_FAILED_INIT",
3 => "CURLE_URL_MALFORMAT",
4 => "CURLE_URL_MALFORMAT_USER",
5 => "CURLE_COULDNT_RESOLVE_PROXY",
6 => "CURLE_COULDNT_RESOLVE_HOST",
7 => "CURLE_COULDNT_CONNECT",
8 => "CURLE_FTP_WEIRD_SERVER_REPLY",
9 => "CURLE_FTP_ACCESS_DENIED",
10 => "CURLE_FTP_USER_PASSWORD_INCORRECT",
11 => "CURLE_FTP_WEIRD_PASS_REPLY",
12 => "CURLE_FTP_WEIRD_USER_REPLY",
13 => "CURLE_FTP_WEIRD_PASV_REPLY",
14 => "CURLE_FTP_WEIRD_227_FORMAT",
15 => "CURLE_FTP_CANT_GET_HOST",
16 => "CURLE_FTP_CANT_RECONNECT",
17 => "CURLE_FTP_COULDNT_SET_BINARY",
18 => "CURLE_FTP_PARTIAL_FILE or CURLE_PARTIAL_FILE",
19 => "CURLE_FTP_COULDNT_RETR_FILE",
20 => "CURLE_FTP_WRITE_ERROR",
21 => "CURLE_FTP_QUOTE_ERROR",
22 => "CURLE_HTTP_NOT_FOUND or CURLE_HTTP_RETURNED_ERROR",
23 => "CURLE_WRITE_ERROR",
24 => "CURLE_MALFORMAT_USER",
25 => "CURLE_FTP_COULDNT_STOR_FILE",
26 => "CURLE_READ_ERROR",
27 => "CURLE_OUT_OF_MEMORY",
28 => "CURLE_OPERATION_TIMEDOUT or CURLE_OPERATION_TIMEOUTED",
29 => "CURLE_FTP_COULDNT_SET_ASCII",
30 => "CURLE_FTP_PORT_FAILED",
31 => "CURLE_FTP_COULDNT_USE_REST",
32 => "CURLE_FTP_COULDNT_GET_SIZE",
33 => "CURLE_HTTP_RANGE_ERROR",
34 => "CURLE_HTTP_POST_ERROR",
35 => "CURLE_SSL_CONNECT_ERROR",
36 => "CURLE_BAD_DOWNLOAD_RESUME or CURLE_FTP_BAD_DOWNLOAD_RESUME",
37 => "CURLE_FILE_COULDNT_READ_FILE",
38 => "CURLE_LDAP_CANNOT_BIND",
39 => "CURLE_LDAP_SEARCH_FAILED",
40 => "CURLE_LIBRARY_NOT_FOUND",
41 => "CURLE_FUNCTION_NOT_FOUND",
42 => "CURLE_ABORTED_BY_CALLBACK",
43 => "CURLE_BAD_FUNCTION_ARGUMENT",
44 => "CURLE_BAD_CALLING_ORDER",
45 => "CURLE_HTTP_PORT_FAILED",
46 => "CURLE_BAD_PASSWORD_ENTERED",
47 => "CURLE_TOO_MANY_REDIRECTS",
48 => "CURLE_UNKNOWN_TELNET_OPTION",
49 => "CURLE_TELNET_OPTION_SYNTAX",
50 => "CURLE_OBSOLETE",
51 => "CURLE_SSL_PEER_CERTIFICATE",
52 => "CURLE_GOT_NOTHING",
53 => "CURLE_SSL_ENGINE_NOTFOUND",
54 => "CURLE_SSL_ENGINE_SETFAILED",
55 => "CURLE_SEND_ERROR",
56 => "CURLE_RECV_ERROR",
57 => "CURLE_SHARE_IN_USE",
58 => "CURLE_SSL_CERTPROBLEM",
59 => "CURLE_SSL_CIPHER",
60 => "CURLE_SSL_CACERT",
61 => "CURLE_BAD_CONTENT_ENCODING",
62 => "CURLE_LDAP_INVALID_URL",
63 => "CURLE_FILESIZE_EXCEEDED",
64 => "CURLE_FTP_SSL_FAILED",
79 => "CURLE_SSH"
);
?>
up
17
s dot coletta at unidata dot it
15 years ago
Beware of CURLE_* constants!

On the official site:

http://curl.haxx.se/libcurl/c/libcurl-errors.html

some constants are different, some missing compared to the PHP implementation.

Some examples:

in PHP the curl error number 28 is called

CURLE_OPERATION_TIMEOUTED

while in the official site is:

CURLE_OPERATION_TIMEDOUT

So if you use the second, it won't march the error 28 because in PHP it is not defined that way.

The same is for these:

CURLE_HTTP_RETURNED_ERROR
CURLE_UPLOAD_FAILED
CURLE_INTERFACE_FAILED
CURLE_SSL_CERTPROBLEM
CURLE_SEND_FAIL_REWIND
CURLE_LOGIN_DENIED
CURLE_AGAIN

that are in someway named differently or missing from PHP.
up
8
uramihsayibok, gmail, com
9 years ago
Regarding CURLE_OPERATION_TIMEDOUT vs. CURLE_OPERATION_TIMEOUTED:

Originally cURL had the constant named TIMEOUTED (read: "timeout-ed"). This was changed[1] in 2007 and v7.17.0 to be TIMEDOUT (read: "timed out") and the old constant kept in place as an alias.

PHP started off using TIMEOUTED as well. The TIMEDOUT constant was added[2] in 2012 and v5.5.0 and the old constant was *kept in place*.

If you ask me, the TIMEDOUT constant reads more nicely (not to mention is technically the correct one to use) and as long as you're using PHP 5.5+ then it is available. If you have to support older versions then I suggest you keep using the new constant and add a polyfill like

<?php
if (version_compare(PHP_VERSION, "5.5.0", "<")) {
define("CURLE_OPERATION_TIMEDOUT", CURLE_OPERATION_TIMEOUTED);
}
?>

or

<?php
// PHP <5.5.0
defined("CURLE_OPERATION_TIMEDOUT") || define("CURLE_OPERATION_TIMEDOUT", CURLE_OPERATION_TIMEOUTED);
?>

to be removed once you stop supporting them.

[1] https://github.com/bagder/curl/commit/9f44a95522162c0f4a61093efe1bf1f58b087358#diff-d8c6cb80505e0f7d5e27fca2a682aa34L119
[2] https://github.com/php/php-src/commit/9ab45d3edbafa3ee751472c3f8d1fb3f51f38cf1#diff-ac978e3de205f1d14eb960e0eb15ef24R723
up
9
Ron
17 years ago
<?
/*
* Author: Ron
* Released: August 4, 2007
* Description: An example of the disguise_curl() function in order to grab contents from a website while remaining fully camouflaged by using a fake user agent and fake headers.
*/

$url = 'http://www.ericgiguere.com/tools/http-header-viewer.html';

// disguises the curl using fake headers and a fake user agent.
function disguise_curl($url)
{
$curl = curl_init();

// Setup headers - I used the same headers from Firefox version 2.0.0.6
// below was split up because php.net said the line was too long. :/
$header[0] = "Accept: text/xml,application/xml,application/xhtml+xml,";
$header[0] .= "text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5";
$header[] = "Cache-Control: max-age=0";
$header[] = "Connection: keep-alive";
$header[] = "Keep-Alive: 300";
$header[] = "Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7";
$header[] = "Accept-Language: en-us,en;q=0.5";
$header[] = "Pragma: "; // browsers keep this blank.

curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_USERAGENT, 'Googlebot/2.1 (+http://www.google.com/bot.html)');
curl_setopt($curl, CURLOPT_HTTPHEADER, $header);
curl_setopt($curl, CURLOPT_REFERER, 'http://www.google.com');
curl_setopt($curl, CURLOPT_ENCODING, 'gzip,deflate');
curl_setopt($curl, CURLOPT_AUTOREFERER, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_TIMEOUT, 10);

$html = curl_exec($curl); // execute the curl command
curl_close($curl); // close the connection

return $html; // and finally, return $html
}

// uses the function and displays the text off the website
$text = disguise_curl($url);
echo $text;
?>

~Ron
up
-1
jrschlosser
6 years ago
In PHP version 7.1.11 there is also constants for HTTP/2 :
CURL_VERSION_HTTP2 = 65536 (1 << 16)
CURL_HTTP_VERSION_2_0 = 3

I don't know the first version of PHP that defines it.
To Top