curl_setopt_array
(PHP 5 >= 5.1.3, PHP 7, PHP 8)
curl_setopt_array — Mehrere Optionen für einen cURL-Transfer setzen
Beschreibung
Setzt mehrere Optionen für eine cURL-Session. Diese Funktion ist nützlich, um eine große Anzahl an Optionen zu setzen, ohne wiederholt curl_setopt() aufrufen zu müssen.
Parameter-Liste
-
handle
-
Ein von curl_init() zurückgegebenes cURL-Handle.
-
options
-
Ein array das die zu setzenden Optionen und die entsprechenden Werte enthält. Die Array-Schlüssel sollten gültige curl_setopt()-Konstanten resp. deren Integer- Equivalent sein.
Rückgabewerte
Gibt true
zurück, wenn alle Optionen erfolgreich gesetzt werden konnten.
Konnte eine Option nicht gesetzt werden wird unmittelbar false
zurückgegeben und alle folgenden Optionen im Parameter
options
werden ignoriert.
Changelog
Version | Beschreibung |
---|---|
8.0.0 |
handle erwartet nun eine
CurlHandle-Instanz; vorher wurde eine
Ressource erwartet.
|
Beispiele
Beispiel #1 Initialisierung einer cURL-Session und holen einer Webseite
<?php
// neues cURL-Handle erstellen
$ch = curl_init();
// URL und andere Optionen setzen
$options = array(CURLOPT_URL => 'http://www.example.com/',
CURLOPT_HEADER => false
);
curl_setopt_array($ch, $options);
// URL holen und an der Browser weitergeben
curl_exec($ch);
// cURL-Handle schließen und Systemresourcen freigeben
curl_close($ch);
?>
Anmerkungen
Hinweis:
Analog zu curl_setopt() wird ein für
CURLOPT_POST
übergebenes Array als multipart/form-data, ein URL-kodierter String als application/x-www-form-urlencoded kodiert.