# 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

- curl_setopt() - Setzt eine Option für einen cURL-Transfer

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open