array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.curl-setopt-array.php', 1 => 'curl_setopt_array', 2 => 'Mehrere Optionen für einen cURL-Transfer setzen', ), 'up' => array ( 0 => 'ref.curl.php', 1 => 'cURL Funktionen', ), 'prev' => array ( 0 => 'function.curl-setopt.php', 1 => 'curl_setopt', ), 'next' => array ( 0 => 'function.curl-share-close.php', 1 => 'curl_share_close', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/curl/functions/curl-setopt-array.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

curl_setopt_array

(PHP 5 >= 5.1.3, PHP 7, PHP 8)

curl_setopt_array — Mehrere Optionen für einen cURL-Transfer setzen

Beschreibung

curl_setopt_array(CurlHandle $handle, array $options): bool

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);
?>

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.

Siehe auch