Home/ Manual/ curl / functions/ curl_setopt_array

curl_setopt_array

PHP function Edit on GitHub ✎

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

Set multiple options for a cURL transfer

Description

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

Sets multiple options for a cURL session. This function is useful for setting a large number of cURL options without repetitively calling curl_setopt().

Parameters

options: An array specifying which options to set and their values. The keys should be valid curl_setopt() constants or their integer equivalents.

Return Values

Returns true if all options were successfully set. If an option could not be successfully set, false is immediately returned, ignoring any future options in the options array.

Changelog

Version	Description

Examples

Initializing a new cURL session and fetching a web page

php

<?php
// create a new cURL resource
$ch = curl_init();

// set URL and other appropriate options
$options = array(CURLOPT_URL => 'http://www.example.com/',
                 CURLOPT_HEADER => false
                );

curl_setopt_array($ch, $options);

// grab URL and pass it to the browser
curl_exec($ch);
?>

Notes

Note

As with curl_setopt(), passing an array to CURLOPT_POST will encode the data as multipart/form-data, while passing a URL-encoded string will encode the data as application/x-www-form-urlencoded.