PHP curl_setopt_array function

Like this blog? Consider exploring one of our sponsored banner ads...

curl_setopt_array

(PHP 5 CVS only)

curl_setopt_array — Set multiple options for a cURL transferDescriptionbool curl_setopt_array ( resource ch, array options )

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

Parameters

ch

A cURL handle returned by
curl_init().

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.

Examples

Example 1.
Initializing a new cURL session and fetching a web page

// 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);
 
// close cURL resource, and free up system resources
curl_close($ch);

Prior to PHP 5.1.4 you can simulate this function with:

Example 2. Our own implementation of curl_setopt_array()

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;
   }
}

See Also

curl_setopt()



About this entry