| 424 | | * @param array $options Global and default options (see {@see Requests::request}) |
| 425 | | * @return array Responses (either Requests_Response or a Requests_Exception object) |
| | 424 | * @param array $options { |
| | 425 | * Global and default options (see {@see Requests::request}) |
| | 426 | * |
| | 427 | * @type float $timeout How long should we wait for a response? |
| | 428 | * Note: for cURL, a minimum of 1 second applies, as DNS resolution |
| | 429 | * operates at second-resolution only. |
| | 430 | * (float, seconds with a millisecond precision, default: 10, example: 0.01) |
| | 431 | * @type float $connect_timeout How long should we wait while trying to connect? |
| | 432 | * (float, seconds with a millisecond precision, default: 10, example: 0.01) |
| | 433 | * @type string $useragent Useragent to send to the server |
| | 434 | * (string, default: php-requests/$version) |
| | 435 | * @type string $follow_redirects Should we follow 3xx redirects? |
| | 436 | * (boolean, default: true) |
| | 437 | * @type integer $redirects How many times should we redirect before erroring? |
| | 438 | * (integer, default: 10) |
| | 439 | * @type integer $blocking Should we block processing on this request? |
| | 440 | * (boolean, default: true) |
| | 441 | * @type string|boolean $filename File to stream the body to instead. |
| | 442 | * (string|boolean, default: false) |
| | 443 | * @type Requests_Auth|array|boolean $auth Authentication handler or array of user/password details to use |
| | 444 | * for Basic authentication |
| | 445 | * (Requests_Auth|array|boolean, default: false) |
| | 446 | * @type Requests_Proxy|array|string|boolean $proxy Proxy details to use for proxy by-passing and authentication |
| | 447 | * (Requests_Proxy|array|string|boolean, default: false) |
| | 448 | * @type integer|boolean $max_bytes Limit for the response body size. |
| | 449 | * (integer|boolean, default: false) |
| | 450 | * @type boolean $idn Enable IDN parsing |
| | 451 | * (boolean, default: true) |
| | 452 | * @type string|Requests_Transport $transport Custom transport. Either a class name, or a |
| | 453 | * transport object. Defaults to the first working transport from |
| | 454 | * {@see getTransport()} |
| | 455 | * (string|Requests_Transport, default: {@see getTransport()}) |
| | 456 | * @type Requests_Hooker $hooks Hooks handler. |
| | 457 | * (Requests_Hooker, default: new Requests_Hooks()) |
| | 458 | * @type string|boolean $verify Should we verify SSL certificates? Allows passing in a custom |
| | 459 | * certificate file as a string. (Using true uses the system-wide root |
| | 460 | * certificate store instead, but this may have different behaviour |
| | 461 | * across transports.) |
| | 462 | * (string|boolean, default: library/Requests/Transport/cacert.pem) |
| | 463 | * @type boolean $verifyname Should we verify the common name in the SSL certificate? |
| | 464 | * (boolean: default, true) |
| | 465 | * @type string $data_format How should we send the `$data` parameter? |
| | 466 | * (string, one of 'query' or 'body', default: 'query' for |
| | 467 | * HEAD/GET/DELETE, 'body' for POST/PUT/OPTIONS/PATCH) |
| | 468 | * } |
| | 469 | * @return Requests_Response[]|Requests_Exception[] Responses (either Requests_Response or a Requests_Exception object) |
| | 470 | * @throws Requests_Exception |