PHP curl_setopt Funktion
PHP curl_setopt Funktion
(PHP 4> = 4.0.2, PHP 5)
curl_setopt - ein cURL-Transfer-Optionen eingestellt.
Erklärung
bool curl_setopt ( resource $ch , int $option , mixed $value )
Da cURL Sitzungshandle gesetzt eine Option.
Parameter
ch
Durch die curl_init () gibt einen cURL-Handle.
Option
CURLOPT_XXX Optionen müssen festgelegt werden.
Wert
Stellen Sie den Wert der Option auf die Optionen.
Für die folgenden optionalen Parameter dieser Option Wert sollte auf einen Wert vom Typ bool eingestellt werden:
Optionen | Optional Wert Wert | Bemerkung |
---|---|---|
CURLOPT_AUTOREFERER | Wenn Standort nach: Umleitung automatisch Header in der Referer: Informationen. | |
CURLOPT_BINARYTRANSFER | CURLOPT_RETURNTRANSFER wenn sie aktiviert ist , kehren nativen (Raw) ausgegeben. | |
CURLOPT_COOKIESESSION | Wenn diese Funktion aktiviert curl wird nur eine Session-Cookie passieren, ignorieren Sie die anderen Cookie an den Server alle den Cookie wird wieder cURL Standardstatus. Session-Cookies sind diejenigen verwendet, um die Gültigkeit der serverseitige Session-Cookie vorhanden ist, um zu bestimmen. | |
CURLOPT_CRLF | Wenn aktivieren Sie den Unix-Newline in Wagenrücklauf. | |
CURLOPT_DNS_USE_GLOBAL_CACHE | eine globale DNS-Cache aktiviert aktiviert ist, aktivieren diese Thread-sicher und Standard. | |
CURLOPT_FAILONERROR | Anzeige HTTP-Statuscode, ist das Standardverhalten, die Zahl von 400 oder weniger HTTP Informationen zu ignorieren. | |
CURLOPT_FILETIME | Es wird versuchen Fern Informationen in dem Dokument zu modifizieren ermöglicht. Ergebnisse Informationen () CURLINFO_FILETIME Option Funktion liefert durch curl_getinfo. curl_getinfo (). | |
CURLOPT_FOLLOWLOCATION | Wenn der Server liefert der Server den "Location:" enable Kopfzeile auf der Rekursion zurück an den Server, können Sie CURLOPT_MAXREDIRS rekursiv Nummer zurück definiert verwenden. | |
CURLOPT_FORBID_REUSE | Zwangstrennung nach Abschluss der Interaktion kann nicht wieder verwendet werden. | |
CURLOPT_FRESH_CONNECT | Gezwungen, eine neue Verbindung zu erhalten, ersetzen Sie die Cache-Verbindung. | |
CURLOPT_FTP_USE_EPRT | Wenn FTP-Downloads aktiviert ist, verwenden EPRT (oder LPRT) Befehl. Deaktivieren Sie EPRT und LPRT wenn auf FALSE gesetzt, verwenden Sie nur den PORT - Befehl. | |
CURLOPT_FTP_USE_EPSV | Wenn diese Funktion aktiviert, Befehl die Antwort auf die PASV-Modus FTP-Transfer-Prozess vor dem ersten Versuch EPSV. Wenn auf FALSE gesetzt EPSV Befehl zu deaktivieren. | |
CURLOPT_FTPAPPEND | Zusätzliche Schreib- Datei statt Überschreiben freigegeben. | |
CURLOPT_FTPASCII | CURLOPT_TRANSFERTEXT alias. | |
CURLOPT_FTPLISTONLY | Liste nur der Name des FTP-Verzeichnis aktiviert ist. | |
CURLOPT_HEADER | Wenn Sie die Nachrichtenkopfzeile ermöglichen ausgegeben als Datenstrom sein. | |
CURLINFO_HEADER_OUT | Tracking aktiviert Griff Anfrage-String. | Verfügbar seit PHP 5.1.3. CURLINFO_ Präfix ist gewollt (absichtlich). |
CURLOPT_HTTPGET | Die Einstellung ermöglicht die HTTP-Methode ist GET, da dies die Standard ist, so verwenden Sie nur im Falle modifiziert. | |
CURLOPT_HTTPPROXYTUNNEL | Es wird der HTTP-Proxy übermittelt durch aktiviert ist. | |
CURLOPT_MUTE | Der Curl-Funktion werden alle Parameter geändert, um den Standardwert wiederherzustellen aktiviert ist. | |
CURLOPT_NETRC | Nachdem die Verbindung hergestellt ist, Zugang ~ / .netrc Datei für den Benutzernamen und das Kennwort an entfernten Standorten zu verbinden. | |
CURLOPT_NOBODY | Wird nicht Teil des HTML-BODY ausgegeben werden aktiviert ist. | |
CURLOPT_NOPROGRESS | Schließen curl Übertragungsfortschrittsbalken aktiviert ist, wird diese standardmäßig aktiviert.
| |
CURLOPT_NOSIGNAL | Ignoriere das gesamte Signal an die php curl geben wird aktiviert ausgeführt. Dies ist standardmäßig, wenn SAPI multithreaded Transfer aktiviert. | cURL 7.10, wenn hinzugefügt. |
CURLOPT_POST | Wenn sendet aktiviert eine normale POST - Anfrage, Typ: application / x-www-form -urlencoded, wie Formulareinreichung. | |
CURLOPT_PUT | Lassen Sie HTTP eine Datei senden können, müssen Sie CURLOPT_INFILE und CURLOPT_INFILESIZE gleichzeitig aktiviert. | |
CURLOPT_RETURNTRANSFER | Die curl_exec () gibt die Informationen in Form von Dateistrom erhalten wird, anstelle von ausgegeben wird. | |
CURLOPT_SSL_VERIFYPEER | Nach dem Deaktivieren cURL wird von dem Server beendet werden, um zu überprüfen. Verwenden CURLOPT_CAINFO Option Zertifikate CURLOPT_CAPATH Option Zertifikate Katalog Wenn CURLOPT_SSL_VERIFYPEER (2 Standardeinstellung) aktiviert ist, muss CURLOPT_SSL_VERIFYHOST auf TRUE gesetzt werden, andernfalls wird er auf FALSE gesetzt. | ROTATION 7.10 seit dem Beginn der Standardeinstellung ist TRUE. Von Anfang des Standard 7.10 cURL Bindung installieren. |
CURLOPT_TRANSFERTEXT | Verwenden Sie ASCII-Modus für FTP-Übertragungen aktiviert. Für LDAP, ruft er die Informationen im Klartext statt HTML. Auf Windows - Systemen wird das System nicht STDOUT Binär - Modus eingestellt. | |
CURLOPT_UNRESTRICTED_AUTH | CURLOPT_FOLLOWLOCATION erzeugt Header Mit mehreren Standorten kontinuierlich den Benutzernamen und das Kennwort anzuhängen, auch wenn der Domain - Name geändert wurde. | |
CURLOPT_UPLOAD | Wenn diese Funktion aktiviert ermöglicht das Hochladen von Dateien. | |
CURLOPT_VERBOSE | Berichten alle Informationen gespeichert in STDERR oder bezeichneten CURLOPT_STDERR gewählte in aktiviert. |
Für die folgenden optionalen Parameter dieser Option Wert sollte auf einen Wert von Integer-Typ festgelegt werden:
Optionen | Optional Wert Wert | Bemerkung |
---|---|---|
CURLOPT_BUFFERSIZE | Jeder erfassten Daten in den Cache-Größe lesen, aber nicht garantiert, dass der Wert jedes gefüllt wird. | Es wurde in cURL 7,10 zugegeben. |
CURLOPT_CLOSEPOLICY | Nicht CURLCLOSEPOLICY_LEAST_RECENTLY_USED ist CURLCLOSEPOLICY_OLDEST, gibt es drei weitere CURLCLOSEPOLICY, aber cURL wird noch nicht unterstützt. | |
CURLOPT_CONNECTTIMEOUT | Vor Einleitung des Verbindungswartezeit, wenn auf 0 gesetzt, dann auf unbestimmte Zeit warten. | |
CURLOPT_CONNECTTIMEOUT_MS | Versuchen Sie Zeit, um eine Verbindung zu warten, in Millisekunden. Wenn es auf 0 gesetzt ist, auf unbestimmte Zeit warten. | ROTATION 7.16.2 hinzugefügt wird in. Verfügbar seit PHP 5.2.3. |
CURLOPT_DNS_CACHE_TIMEOUT | Festlegen von DNS-Informationen in dem Speicher der Zeit gespeichert, ist die Standard-120 Sekunden. | |
CURLOPT_FTPSSLAUTH | FTP - Authentifizierung: CURLFTPAUTH_SSL (zunächst versuchen , SSL), CURLFTPAUTH_TLS (zunächst versuchen , TLS) oder CURLFTPAUTH_DEFAULT (let cURL automatisch ermittelt). | ROTATION 7.12.2 hinzugefügt wird in. |
CURLOPT_HTTP_VERSION | CURL_HTTP_VERSION_NONE (Standardwert, locke so selbst entscheiden , welche Version zu verwenden), CURL_HTTP_VERSION_1_0 (obligatorische Verwendung von HTTP / 1.0) oder CURL_HTTP_VERSION_1_1 (obligatorische Verwendung von HTTP / 1.1). | |
CURLOPT_INFILESIZE | Stellen Sie die Upload-Datei Größenbeschränkung von Bytes (Byte) Einheiten. | |
CURLOPT_LOW_SPEED_LIMIT | Wenn die Übertragungsrate geringer ist als CURLOPT_LOW_SPEED_LIMIT Zeit (Bytes / sec), PHP basierend CURLOPT_LOW_SPEED_TIME um zu bestimmen , ob die Übertragung wegen zu langsamer abgebrochen wurde. | |
CURLOPT_LOW_SPEED_TIME | Wenn die Übertragungsrate geringer ist als CURLOPT_LOW_SPEED_LIMIT Zeit (Bytes / sec), PHP basierend CURLOPT_LOW_SPEED_TIME um zu bestimmen , ob die Übertragung wegen zu langsamer abgebrochen wurde. | |
CURLOPT_MAXCONNECTS | Die maximale Anzahl von Verbindungen zu ermöglichen, durch CURLOPT_CLOSEPOLICY wird bestimmen , welche Verbindungen gestoppt werden sollte. | |
CURLOPT_MAXREDIRS | Gibt die maximale Anzahl von HTTP - Redirects und CURLOPT_FOLLOWLOCATION Diese Option zusammen verwendet wird. | |
CURLOPT_PORT | Es wird verwendet, um den Verbindungsanschluss zu spezifizieren. (Optional) | |
CURLOPT_PROTOCOLS | CURLPROTO_ * Bit - Feld bedeutet. Wenn diese Option aktiviert ist, wird das Bit Feldwert definiert werden, welche können Protokolle Libcurl dort während der Übertragung verwendet werden. Dies ermöglicht Ihnen, eine Reihe von Protokollen zu unterstützen, wenn Sie Libcurl kompilieren, aber Grenzen, außer sie erlaubt werden, um eine Teilmenge zu verwenden. Die Standard-libcurl alle seine unterstützten Protokolle verwenden. Siehe CURLOPT_REDIR_PROTOCOLS Protokolloptionen zur Verfügung: 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_ALL | ROTATION 7.19.4 hinzugefügt wird in. |
CURLOPT_PROTOCOLS | CURLPROTO_ * Bit - Feld bedeutet. Wenn diese Option aktiviert ist, wird das Bit Feldwert definiert werden, welche können Protokolle Libcurl dort während der Übertragung verwendet werden. Dies ermöglicht Ihnen, eine Reihe von Protokollen zu unterstützen, wenn Sie Libcurl kompilieren, aber Grenzen, außer sie erlaubt werden, um eine Teilmenge zu verwenden. Die Standard-libcurl alle seine unterstützten Protokolle verwenden. Siehe CURLOPT_REDIR_PROTOCOLS Protokolloptionen zur Verfügung: 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_ALL | ROTATION 7.19.4 hinzugefügt wird in. |
CURLOPT_PROXYAUTH | HTTP-Proxy-Authentifizierung Verbindung. Verwenden Sie CURLOPT_HTTPAUTH bitfield Flagge die entsprechenden Optionen zu setzen. Für die Proxy - Authentifizierung CURLAUTH_BASIC und CURLAUTH_NTLM nur unterstützt. | ROTATION 7.10.7 hinzugefügt wird in. |
CURLOPT_PROXYPORT | Proxy-Server-Port. Ports können auch in der CURLOPT_PROXY eingestellt werden. | |
CURLOPT_PROXYTYPE | Nicht CURLPROXY_HTTP (Standardwert) ist CURLPROXY_SOCKS5. | Es wurde in cURL 7,10 zugegeben. |
CURLOPT_REDIR_PROTOCOLS | * Das Bit Feldwert CURLPROTO_. Wenn diese Option aktiviert ist, wird die Berechtigung Bit - Feld Wert das Übertragungsprotokoll zu folgen , wenn ein Redirector - Thread , wenn CURLOPT_FOLLOWLOCATION wiederum verwendet werden kann. Dadurch werden Sie an die Grenze umleiten Übertragung Threads Protokolle Subset Standard Libcurl erlaubt sind, werden alle Protokolle mit Ausnahme von FILE und SCP ermöglichen. Diese Art von Pre-Release-Version 7.19.4 und bedingungslos folgen alle unterstützten Protokolle gibt es einige Unterschiede. Über Protokoll Konstanten, siehe CURLOPT_PROTOCOLS. | ROTATION 7.19.4 hinzugefügt wird in. |
CURLOPT_RESUME_FROM | Übergeben wird ein Byte-Offset, wenn die Übertragung der Wiederherstellung (für HTTP). | |
CURLOPT_SSL_VERIFYHOST | Ob es einen gemeinsamen Namen (common name) 1 den Server SSL-Zertifikat überprüfen. Anmerkung des Übersetzers: Common Name (Common Name) Im Allgemeinen werden Sie wollen, ist anzuwenden SSL-Zertifikat-Domäne (Domain) oder Sub-Domain (Sub-Domain) zu füllen. 2 Überprüfen Sie den gemeinsamen Namen vorhanden ist, und wenn es den Hostnamen versehen entspricht. | |
CURLOPT_SSLVERSION | Verwenden Sie die SSL-Version (2 oder 3). Standardmäßig wird PHP diesen Wert selbst erkennen, obwohl in einigen Fällen manuell einstellen müssen. | |
CURLOPT_TIMECONDITION | Wenn Sie in der Zukunft zu einem bestimmten Zeitpunkt CURLOPT_TIMEVALUE bearbeiten Auch CURL_TIMECOND_IFMODSINCE Rückkehr auf die Seite zu verwenden, wenn sie nicht geändert, und CURLOPT_HEADER ist wahr, es ist ein "304 nicht geändert" in der Kopfzeile zurückgibt, CURLOPT_HEADER falsch ist , dann CURL_TIMECOND_IFUNMODSINCE verwenden, Standard Wert CURL_TIMECOND_IFUNMODSINCE. | |
CURLOPT_TIMEOUT | Legen Sie die maximale Anzahl von Sekunden cURL zu ermöglichen, ausgeführt. | |
CURLOPT_TIMEOUT_MS | Einstellen cURL die maximale Anzahl von Millisekunden ausführen darf. | ROTATION 7.16.2 hinzugefügt wird in. Von PHP kann 5.2.3 weiter verwendet werden. |
CURLOPT_TIMEVALUE | Einstellen eines Zeitstempels CURLOPT_TIMECONDITION standardmäßig verwendet , mit CURL_TIMECOND_IFMODSINCE. |
Für die folgende Option dieser optionalen Parameter-Wert sollte auf den Wert eines String-Typ festgelegt werden:
Optionen | Optional Wert Wert | Bemerkung |
---|---|---|
CURLOPT_CAINFO | Es hält eine oder mehrere von dem Server zu erlauben Überprüfung des Zertifikats Dateiname verwendet. Dieser Parameter ist nur dann sinnvoll , wenn sie zusammen und CURLOPT_SSL_VERIFYPEER. . | |
CURLOPT_CAPATH | Hält eine Vielzahl von CA-Zertifikaten Verzeichnis. Diese Option wird zusammen mit CURLOPT_SSL_VERIFYPEER. | |
CURLOPT_COOKIE | Einstellung HTTP - Anforderung "Cookie:" Teil des Inhalts. Mehrere Cookie durch ein Semikolon mit einem Leerzeichen nach dem Semikolon getrennt (zB "Frucht = Apfel; color = red"). | |
CURLOPT_COOKIEFILE | Dateiname enthält das Cookie Datenformat Cookie-Datei in Netscape-Format sein kann, oder einfach nur HTTP-Header-Informationen in eine Datei. | |
CURLOPT_COOKIEJAR | Speichern Sie Cookie-Datei Informationen nach dem Ende der Verbindung. | |
CURLOPT_CUSTOMREQUEST | Verwenden Sie eine benutzerdefinierte Anforderungsinformation statt "GET" oder "HEAD" als HTTP - Anfrage. Dies ist die Umsetzung des "DELETE" oder andere Unbekannter HTTP - Anfragen. Gültige Werte wie "GET", "POST", "CONNECT" und so weiter. Mit anderen Worten, geben Sie hier nicht die gesamte HTTP-Anforderung. Geben Sie zum Beispiel "GET /index.html HTTP / 1.0 \ r \ n \ r \ n" ist nicht korrekt.
| |
CURLOPT_EGDSOCKET | Ähnliche CURLOPT_RANDOM_FILE, zusätzlich zu einer Buchse Entropy Gathering Daemon. | |
CURLOPT_ENCODING | HTTP - Request - Header "Accept-Encoding:" Wert. Unterstützte Codierung "Identität", "deflate" und "gzip". Wenn ein leerer String "", wird die erste Anforderung an alle unterstützten Codierungstypen gesendet werden. | Es wurde in cURL 7,10 zugegeben. |
CURLOPT_FTPPORT | Dieser Wert wird verwendet, um die IP-Adresse für den FTP "POST" Anweisung zu erhalten, benötigt. "POST" Anweisung teilt dem Remote-Server, zu der angegebenen IP-Adresse zu verbinden. Diese Zeichenfolge kann Klartext-IP-Adresse, Hostname, ein Netzwerkschnittstellennamen (UNIX unter) oder nur ein "-" Adresse der Standard-IP zu verwenden. | |
CURLOPT_INTERFACE | Net send Interface-Namen kann eine Schnittstelle Name, IP-Adresse oder einen Hostnamen sein. | |
CURLOPT_KRB4LEVEL | KRB4 (Kerberos 4) Sicherheitsstufe. Jede der folgenden Werte gelten (von niedrig bis hoch Reihenfolge): "klar", "sicher ", "vertraulich", "private" .. Wenn die Zeichenfolge nicht übereinstimmt und diese werden "private" verwendet werden. Diese Option wird auf NULL gesetzt wird KRB4 Sicherheitsbescheinigung deaktivieren. Derzeit KRB4 Zertifizierung Sicherheit kann nur für FTP-Übertragungen verwendet werden. | |
CURLOPT_POSTFIELDS | Alle Daten des HTTP-Protokolls in der "Post" Betrieb mit zu senden. Um eine Datei vor dem Dateinamen mit dem Präfix @ und verwenden Sie den vollständigen Pfad zu senden. Dieser Parameter kann durch Urlencoded Zeichenfolge nach 'para1 = val1 & para2 = val2 ähnlich sein und ... " oder mit einem Schlüssel Feldnamen, Felddaten Array - Werte. Wenn der Wert ein Array ist, wird Content-Type - Header gesetzt werden , um multipart / form-data. | |
CURLOPT_PROXY | HTTP-Proxy-Kanal. | |
CURLOPT_PROXYUSERPWD | Format - Strings: ein an den Proxy "[Kennwort] [Benutzername]" zu verbinden . | |
CURLOPT_RANDOM_FILE | SSL wird verwendet, um eine Zufallszahl Samen Dateinamen zu generieren. | |
CURLOPT_RANGE | In "XY" Form, wobei X und Y beide optionale Datenerfassungsbereich sind in Bytes. HTTP Übertragungsthreads unterstützt auch mehrere solcher Zwischen doppelte Einträge durch Kommas getrennt sind , wie zum Beispiel "XY, NM". | |
CURLOPT_REFERER | Inhalt: In dem HTTP - Header "Referer" Anfrage. | |
CURLOPT_SSL_CIPHER_LIST | Eine Liste der SSL-Verschlüsselungsalgorithmen. Wie RC4-SHA und TLSv1 sind die Liste der verfügbaren Verschlüsselungs. | |
CURLOPT_SSLCERT | Der Name einer Datei mit PEM-Format-Zertifikat. | |
CURLOPT_SSLCERTPASSWD | Passwörter CURLOPT_SSLCERT Verwendung eines solchen Zertifikats erforderlich. | |
CURLOPT_SSLCERTTYPE | Typ-Zertifikat. Unterstützte Formate sind "PEM" (Standardwert), "DER" und "ENG". | Registriert in der cURL 7.9.3. |
CURLOPT_SSLENGINE | In CURLOPT_SSLKEY verwendet , um die privaten SSL - Schlüssel - Verschlüsselungs - Engine - Variablen angeben. | |
CURLOPT_SSLENGINE_DEFAULT | Variablen für asymmetrische Verschlüsselungsoperationen verwendet. | |
CURLOPT_SSLKEY | Der Dateiname enthält SSL privaten Schlüssel. | |
CURLOPT_SSLKEYPASSWD | CURLOPT_SSLKEY Passwort im privaten SSL - Schlüssel angegeben.
| |
CURLOPT_SSLKEYTYPE | Private Key - Verschlüsselungstypen in CURLOPT_SSLKEY angegeben, Schlüsseltyp unterstützt wird "PEM" (Standardwert), "DER" und "ENG". | |
CURLOPT_URL | URL - Adresse benötigen , um angeordnet curl_init () Funktion. | |
CURLOPT_USERAGENT | In der HTTP - Anforderung enthält eine "User-Agent:" Header - String. | |
CURLOPT_USERPWD | eine Verbindung Passing erfordert einen Benutzernamen und Passwort in das Format: "[Benutzername]: [Passwort ]". |
Diese Option für die folgenden optionalen Parameter, Wert sollte als Array festgelegt werden:
Optionen | Optional Wert Wert | Bemerkung |
---|---|---|
CURLOPT_HTTP200ALIASES | 200 Antwortcode-Array, das Array der Antwort, die er die richtige Antwort betrachtet wird, ansonsten wird es als Fehler angesehen. | ROTATION 7.10.3 hinzugefügt wird in. |
CURLOPT_HTTPHEADER | Um ein Array von HTTP-Header-Felder gesetzt. Verwenden Sie ein Array aus den folgenden Einstellungen: array ( 'Content-type: text / plain "," Content-length: 100') | |
CURLOPT_POSTQUOTE | Nach der Ausführung abgeschlossen FTP-Anforderungen auf dem Server eine Reihe von FTP-Befehle auszuführen. | |
CURLOPT_QUOTE | Eine Reihe von FTP-Befehle auf dem Server vor dem FTP-Auftrag ausgeführt. |
Für die folgenden optionalen Parameter dieser Option Wert sollte auf einen Fluss von Ressourcen eingestellt werden (zum Beispiel unter Verwendung von fopen ()):
Optionen | Optional Wert Wert |
---|---|
CURLOPT_FILE | Setzen der Ausgabedatei, Wert ein Ressourcentyp ist, der Standard ist STDOUT (der Browser). |
CURLOPT_INFILE | Adressdatei beim Hochladen einer Datei zu lesen, um den Wert eines Ressourcentyp. |
CURLOPT_STDERR gewählte | Stellen Sie eine Fehlerausgabe Adresswert ist ein Ressourcentyp, anstelle des Standard - STDERR. |
CURLOPT_WRITEHEADER | Einstellen Schreibkopfteil des Inhalts der Adressdatei ist, Wert ein Ressourcentyp. |
Für die folgende Option dieser optionalen Parameter-Wert sollte auf eine Callback-Funktion Name eingestellt werden:
Optionen | Optional Wert Wert |
---|---|
CURLOPT_HEADERFUNCTION | Legen Sie eine Callback-Funktion auf, die zwei Argumente übernimmt, die erste ist die cURL-Resource-Griff, und der zweite Kopfdaten ausgegeben. Ausgabekopfdaten müssen von der Funktion ab, die die Größe der Daten zurückgibt geschrieben wurde. |
CURLOPT_PASSWDFUNCTION | Einrichten einer Callback-Funktion drei Argumente hat, die erste ist die cURL-Resource Handle ist, und das zweite ist eine Passwortabfrage, ist der dritte Parameter die maximal zulässige Kennwortlänge. Gibt den Wert des Passworts. |
CURLOPT_PROGRESSFUNCTION | eine Rückruffunktion Einstellung hat drei Argumente, die erste ist die cURL Ressourcenhandle ist, und die zweite ist eine Ressource-Datei-Deskriptoren, und die dritte ist die Länge. Es gibt die Daten, die er enthält. |
CURLOPT_READFUNCTION | Callback-Funktion Namen. Diese Funktion nimmt drei Parameter sein sollte. Die erste ist die cURL - Resource, der zweite ist die Option cURL CURLOPT_INFILE der Stream - Ressource zu übergeben; dritte Parameter ist die maximale Anzahl, die Daten gelesen werden können. Die Callback-Funktion muss einen String-Länge zurückzukehren kleiner oder gleich der Menge der angeforderten Daten (dritter Parameter). Allgemein lesen aus dem eingehenden Strom Ressource. Gibt eine leere Zeichenkette als EOF (Ende der Datei) Signale. |
CURLOPT_WRITEFUNCTION | Callback-Funktion Namen. Die Funktion sollte zwei Argumente akzeptieren. Die erste ist die cURL-Resource, der zweite eine Reihe von Daten geschrieben werden sollen. Daten müssen in der Funktion gespeichert werden. Die Funktion muss die genaue Anzahl von Bytes wieder in den ankommenden Daten geschrieben werden, ansonsten wird die Übertragung durch einen Fehler unterbrochen wird. |
Rückgabewert
Erfolgreiche Rückkehr TRUE, oder bei einem Fehler FALSCH.
Update-Log
Veröffentlichung | Erklärung |
---|---|
5.2.10 | Einführung in CURLOPT_PROTOCOLS und CURLOPT_REDIR_PROTOCOLS . |
5.1.0 | Einführung in CURLOPT_AUTOREFERER , CURLOPT_BINARYTRANSFER , CURLOPT_FTPSSLAUTH , CURLOPT_PROXYAUTH und CURLOPT_TIMECONDITION . |
5.0.0 | Einführung in CURLOPT_FTP_USE_EPRT , CURLOPT_NOSIGNAL , CURLOPT_UNRESTRICTED_AUTH , CURLOPT_BUFFERSIZE , CURLOPT_HTTPAUTH , CURLOPT_PROXYPORT , CURLOPT_PROXYTYPE , CURLOPT_SSLCERTTYPE und CURLOPT_HTTP200ALIASES . |
Beispiele
Initialisiert eine neue cURL-Session und eine Web-Seite zu erhalten
<?php // 创建一个新cURL资源 $ch = curl_init(); // 设置URL和相应的选项 curl_setopt($ch, CURLOPT_URL, "http://www.example.com/"); curl_setopt($ch, CURLOPT_HEADER, false); // 抓取URL并把它传递给浏览器 curl_exec($ch); //关闭cURL资源,并且释放系统资源 curl_close($ch); ?>
Hochladen einer Datei Beispiel:
<?php /* http://localhost/upload.php: print_r($_POST); print_r($_FILES); */ $ch = curl_init(); $data = array('name' => 'Foo', 'file' => '@/home/user/test.png'); curl_setopt($ch, CURLOPT_URL, 'http://localhost/upload.php'); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); curl_exec($ch); ?>
Beispiele für die obigen Ausgabeergebnisse sind wie folgt:
Array ( [name] => Foo ) Array ( [file] => Array ( [name] => test.png [type] => image/png [tmp_name] => /tmp/phpcpjNeQ [error] => 0 [size] => 279 ) )
Note
Ein Array CURLOPT_POSTFIELDS wird cURL Daten in multipart / form-data codiert werden, und dann eine URL-codierten Zeichenfolge übergeben, werden die Daten verschlüsselt als application / x-www-form-urlencoded.