curl_setopt_array(3) [php man page]

CURL_SETOPT_ARRAY(3)							 1						      CURL_SETOPT_ARRAY(3)

curl_setopt_array - Set multiple options for a cURL transfer

SYNOPSIS

       bool curl_setopt_array (resource  $ch, array  $options)

DESCRIPTION

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

PARAMETERS

	      o $ch
		-A cURL handle returned by curl_init(3).

	      o $options
		- An array specifying which options to set and their values. The keys should be valid curl_setopt(3) 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

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

	      // close cURL resource, and free up system resources
	      curl_close($ch);
	      ?>

	Prior to PHP 5.1.3 this function can be simulated with:

       Example #2

	      Our own implementation of curl_setopt_array(3)

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

NOTES

       Note

	       As with curl_setopt(3), 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.

SEE ALSO

       curl_setopt(3).

PHP Documentation Group 												      CURL_SETOPT_ARRAY(3)

GETOPT(3)								 1								 GETOPT(3)

getopt - Gets options from the command line argument list

SYNOPSIS

       array getopt (string  $options, [array  $longopts])

DESCRIPTION

	Parses options passed to the script.

PARAMETERS

	      o $options
		- Each character in this string will be used as option characters and matched against options passed to the script starting with a
		single hyphen ( -).  For example, an option string "x" recognizes an option -x.  Only a-z, A-Z and 0-9 are allowed.

	      o $longopts
		- An array of options. Each element in this array will be used as option strings and matched against options passed to the  script
		starting with two hyphens ( --).  For example, an longopts element "opt" recognizes an option --opt.

	The $options parameter may contain the following elements:

	      oIndividual characters (do not accept values)

	      oCharacters followed by a colon (parameter requires value)

	      oCharacters followed by two colons (optional value)

	Option	values	are  the  first  argument after the string. If a value is required, it does not matter whether the value has leading white
       space or not. See note.

       Note

	       Optional values do not accept " " (space) as a separator.

       Note

	       The format for the $options and $longopts is almost the same, the only difference is that  $longopts  takes  an	array  of  options
	      (where each element is the option) whereas $options takes a string (where each character is the option).

RETURN VALUES

	This function will return an array of option / argument pairs or FALSE on failure.

       Note

	       The parsing of options will end at the first non-option found, anything that follows is discarded.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.0	|						    |
       |	|						    |
       |	|  Added  support for "=" as argument/value separa- |
       |	| tor.						    |
       |	|						    |
       | 5.3.0	|						    |
       |	|						    |
       |	|  Added support  for  optional  values  (specified |
       |	| with "::").					    |
       |	|						    |
       | 5.3.0	|						    |
       |	|						    |
       |	|  Parameter $longopts is available on all systems. |
       |	|						    |
       | 5.3.0	|						    |
       |	|						    |
       |	|  This function is no longer system dependent, and |
       |	| now works on Windows, too.			    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      getopt(3) example: The basics

	      <?php
	      // Script example.php
	      $options = getopt("f:hp:");
	      var_dump($options);
	      ?>

	      shell> php example.php -fvalue -h

	      The above example will output:

	      array(2) {
		["f"]=>
		string(5) "value"
		["h"]=>
		bool(false)
	      }

       Example #2

	      getopt(3) example: Introducing long options

	      <?php
	      // Script example.php
	      $shortopts  = "";
	      $shortopts .= "f:";  // Required value
	      $shortopts .= "v::"; // Optional value
	      $shortopts .= "abc"; // These options do not accept values

	      $longopts  = array(
		  "required:",	   // Required value
		  "optional::",    // Optional value
		  "option",	   // No value
		  "opt",	   // No value
	      );
	      $options = getopt($shortopts, $longopts);
	      var_dump($options);
	      ?>

	      shell> php example.php -f "value for f" -v -a --required value --optional="optional value" --option

	      The above example will output:

	      array(6) {
		["f"]=>
		string(11) "value for f"
		["v"]=>
		bool(false)
		["a"]=>
		bool(false)
		["required"]=>
		string(5) "value"
		["optional"]=>
		string(14) "optional value"
		["option"]=>
		bool(false)
	      }

       Example #3

	      getopt(3) example: Passing multiple options as one

	      <?php
	      // Script example.php
	      $options = getopt("abc");
	      var_dump($options);
	      ?>

	      shell> php example.php -aaac

	      The above example will output:

	      array(2) {
		["a"]=>
		array(3) {
		  [0]=>
		  bool(false)
		  [1]=>
		  bool(false)
		  [2]=>
		  bool(false)
		}
		["c"]=>
		bool(false)
	      }

SEE ALSO

       $argv.

PHP Documentation Group 														 GETOPT(3)