(PHP 5 >= 5.1.3)
curl_setopt_array — Mehrere Optionen für einen cURL-Transfer setzen
$ch
, array $options
)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.
ch
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.
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.
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);
?>
Für PHP-Versionen vor PHP 5.1.3 kann diese Funktion simuliert werden durch:
Beispiel #2 Eine eigene Implementierung von curl_setopt_array()
<?php
if (!function_exists('curl_setopt_array')) {
function curl_setopt_array(&$ch, $curl_options)
{
foreach ($curl_options as $option => $value) {
if (!curl_setopt($ch, $option, $value)) {
return false;
}
}
return true;
}
}
?>
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.