Open Journal Systems  3.3.0
Data Fields
GuzzleHttp\RequestOptions Class Reference

Data Fields

const ALLOW_REDIRECTS = 'allow_redirects'
 
const AUTH = 'auth'
 
const BODY = 'body'
 
const CERT = 'cert'
 
const CONNECT_TIMEOUT = 'connect_timeout'
 
const COOKIES = 'cookies'
 
const DEBUG = 'debug'
 
const DECODE_CONTENT = 'decode_content'
 
const DELAY = 'delay'
 
const EXPECT = 'expect'
 
const FORCE_IP_RESOLVE = 'force_ip_resolve'
 
const FORM_PARAMS = 'form_params'
 
const HEADERS = 'headers'
 
const HTTP_ERRORS = 'http_errors'
 
const IDN_CONVERSION = 'idn_conversion'
 
const JSON = 'json'
 
const MULTIPART = 'multipart'
 
const ON_HEADERS = 'on_headers'
 
const ON_STATS = 'on_stats'
 
const PROGRESS = 'progress'
 
const PROXY = 'proxy'
 
const QUERY = 'query'
 
const READ_TIMEOUT = 'read_timeout'
 
const SINK = 'sink'
 
const SSL_KEY = 'ssl_key'
 
const STREAM = 'stream'
 
const SYNCHRONOUS = 'synchronous'
 
const TIMEOUT = 'timeout'
 
const VERIFY = 'verify'
 
const VERSION = 'version'
 

Detailed Description

This class contains a list of built-in Guzzle request options.

More documentation for each option can be found at http://guzzlephp.org/.

http://docs.guzzlephp.org/en/v6/request-options.html

Definition at line 11 of file RequestOptions.php.

Field Documentation

◆ ALLOW_REDIRECTS

const GuzzleHttp\RequestOptions::ALLOW_REDIRECTS = 'allow_redirects'

allow_redirects: (bool|array) Controls redirect behavior. Pass false to disable redirects, pass true to enable redirects, pass an associative to provide custom redirect settings. Defaults to "false". This option only works if your handler has the RedirectMiddleware. When passing an associative array, you can provide the following key value pairs:

  • max: (int, default=5) maximum number of allowed redirects.
  • strict: (bool, default=false) Set to true to use strict redirects meaning redirect POST requests with POST requests vs. doing what most browsers do which is redirect POST requests with GET requests
  • referer: (bool, default=false) Set to true to enable the Referer header.
  • protocols: (array, default=['http', 'https']) Allowed redirect protocols.
  • on_redirect: (callable) PHP callable that is invoked when a redirect is encountered. The callable is invoked with the request, the redirect response that was received, and the effective URI. Any return value from the on_redirect function is ignored.

Definition at line 34 of file RequestOptions.php.

◆ AUTH

const GuzzleHttp\RequestOptions::AUTH = 'auth'

auth: (array) Pass an array of HTTP authentication parameters to use with the request. The array must contain the username in index [0], the password in index [1], and you can optionally provide a built-in authentication type in index [2]. Pass null to disable authentication for a request.

Definition at line 43 of file RequestOptions.php.

◆ BODY

const GuzzleHttp\RequestOptions::BODY = 'body'

body: (resource|string|null|int|float|StreamInterface|callable|\Iterator) Body to send in the request.

Definition at line 49 of file RequestOptions.php.

◆ CERT

const GuzzleHttp\RequestOptions::CERT = 'cert'

cert: (string|array) Set to a string to specify the path to a file containing a PEM formatted SSL client side certificate. If a password is required, then set cert to an array containing the path to the PEM file in the first array element followed by the certificate password in the second array element.

Definition at line 58 of file RequestOptions.php.

◆ CONNECT_TIMEOUT

const GuzzleHttp\RequestOptions::CONNECT_TIMEOUT = 'connect_timeout'

connect_timeout: (float, default=0) Float describing the number of seconds to wait while trying to connect to a server. Use 0 to wait indefinitely (the default behavior).

Definition at line 74 of file RequestOptions.php.

◆ COOKIES

const GuzzleHttp\RequestOptions::COOKIES = 'cookies'

cookies: (bool|GuzzleHttp\Cookie\CookieJarInterface, default=false) Specifies whether or not cookies are used in a request or what cookie jar to use or what cookies to send. This option only works if your handler has the cookie middleware. Valid values are false and an instance of {

See also
GuzzleHttp\Cookie\CookieJarInterface}.

Definition at line 67 of file RequestOptions.php.

◆ DEBUG

const GuzzleHttp\RequestOptions::DEBUG = 'debug'

debug: (bool|resource) Set to true or set to a PHP stream returned by fopen() enable debug output with the HTTP handler used to send a request.

Definition at line 81 of file RequestOptions.php.

◆ DECODE_CONTENT

const GuzzleHttp\RequestOptions::DECODE_CONTENT = 'decode_content'

decode_content: (bool, default=true) Specify whether or not Content-Encoding responses (gzip, deflate, etc.) are automatically decoded.

Definition at line 88 of file RequestOptions.php.

◆ DELAY

const GuzzleHttp\RequestOptions::DELAY = 'delay'

delay: (int) The amount of time to delay before sending in milliseconds.

Definition at line 93 of file RequestOptions.php.

◆ EXPECT

const GuzzleHttp\RequestOptions::EXPECT = 'expect'

expect: (bool|integer) Controls the behavior of the "Expect: 100-Continue" header.

Set to true to enable the "Expect: 100-Continue" header for all requests that sends a body. Set to false to disable the "Expect: 100-Continue" header for all requests. Set to a number so that the size of the payload must be greater than the number in order to send the Expect header. Setting to a number will send the Expect header for all requests in which the size of the payload cannot be determined or where the body is not rewindable.

By default, Guzzle will add the "Expect: 100-Continue" header when the size of the body of a request is greater than 1 MB and a request is using HTTP/1.1.

Definition at line 111 of file RequestOptions.php.

◆ FORCE_IP_RESOLVE

const GuzzleHttp\RequestOptions::FORCE_IP_RESOLVE = 'force_ip_resolve'

force_ip_resolve: (bool) Force client to use only ipv4 or ipv6 protocol

Definition at line 262 of file RequestOptions.php.

◆ FORM_PARAMS

const GuzzleHttp\RequestOptions::FORM_PARAMS = 'form_params'

form_params: (array) Associative array of form field names to values where each value is a string or array of strings. Sets the Content-Type header to application/x-www-form-urlencoded when no Content-Type header is already present.

Definition at line 119 of file RequestOptions.php.

◆ HEADERS

const GuzzleHttp\RequestOptions::HEADERS = 'headers'

headers: (array) Associative array of HTTP headers. Each value MUST be a string or array of strings.

Definition at line 125 of file RequestOptions.php.

◆ HTTP_ERRORS

const GuzzleHttp\RequestOptions::HTTP_ERRORS = 'http_errors'

http_errors: (bool, default=true) Set to false to disable exceptions when a non- successful HTTP response is received. By default, exceptions will be thrown for 4xx and 5xx responses. This option only works if your handler has the httpErrors middleware.

Definition at line 133 of file RequestOptions.php.

◆ IDN_CONVERSION

const GuzzleHttp\RequestOptions::IDN_CONVERSION = 'idn_conversion'

idn: (bool|int, default=true) A combination of IDNA_* constants for idn_to_ascii() PHP's function (see "options" parameter). Set to false to disable IDN support completely, or to true to use the default configuration (IDNA_DEFAULT constant).

Definition at line 141 of file RequestOptions.php.

◆ JSON

const GuzzleHttp\RequestOptions::JSON = 'json'

json: (mixed) Adds JSON data to a request. The provided value is JSON encoded and a Content-Type header of application/json will be added to the request if no Content-Type header is already present.

Definition at line 148 of file RequestOptions.php.

◆ MULTIPART

const GuzzleHttp\RequestOptions::MULTIPART = 'multipart'

multipart: (array) Array of associative arrays, each containing a required "name" key mapping to the form field, name, a required "contents" key mapping to a StreamInterface|resource|string, an optional "headers" associative array of custom headers, and an optional "filename" key mapping to a string to send as the filename in the part. If no "filename" key is present, then no "filename" attribute will be added to the part.

Definition at line 159 of file RequestOptions.php.

◆ ON_HEADERS

const GuzzleHttp\RequestOptions::ON_HEADERS = 'on_headers'

on_headers: (callable) A callable that is invoked when the HTTP headers of the response have been received but the body has not yet begun to download.

Definition at line 166 of file RequestOptions.php.

◆ ON_STATS

const GuzzleHttp\RequestOptions::ON_STATS = 'on_stats'

on_stats: (callable) allows you to get access to transfer statistics of a request and access the lower level transfer details of the handler associated with your client. on_stats is a callable that is invoked when a handler has finished sending a request. The callback is invoked with transfer statistics about the request, the response received, or the error encountered. Included in the data is the total amount of time taken to send the request.

Definition at line 177 of file RequestOptions.php.

◆ PROGRESS

const GuzzleHttp\RequestOptions::PROGRESS = 'progress'

progress: (callable) Defines a function to invoke when transfer progress is made. The function accepts the following positional arguments: the total number of bytes expected to be downloaded, the number of bytes downloaded so far, the number of bytes expected to be uploaded, the number of bytes uploaded so far.

Definition at line 186 of file RequestOptions.php.

◆ PROXY

const GuzzleHttp\RequestOptions::PROXY = 'proxy'

proxy: (string|array) Pass a string to specify an HTTP proxy, or an array to specify different proxies for different protocols (where the key is the protocol and the value is a proxy string).

Definition at line 193 of file RequestOptions.php.

◆ QUERY

const GuzzleHttp\RequestOptions::QUERY = 'query'

query: (array|string) Associative array of query string values to add to the request. This option uses PHP's http_build_query() to create the string representation. Pass a string value if you need more control than what this method provides

Definition at line 201 of file RequestOptions.php.

◆ READ_TIMEOUT

const GuzzleHttp\RequestOptions::READ_TIMEOUT = 'read_timeout'

read_timeout: (float, default=default_socket_timeout ini setting) Float describing the body read timeout, for stream requests.

Definition at line 252 of file RequestOptions.php.

◆ SINK

const GuzzleHttp\RequestOptions::SINK = 'sink'

sink: (resource|string|StreamInterface) Where the data of the response is written to. Defaults to a PHP temp stream. Providing a string will write data to a file by the given name.

Definition at line 208 of file RequestOptions.php.

◆ SSL_KEY

const GuzzleHttp\RequestOptions::SSL_KEY = 'ssl_key'

ssl_key: (array|string) Specify the path to a file containing a private SSL key in PEM format. If a password is required, then set to an array containing the path to the SSL key in the first array element followed by the password required for the certificate in the second element.

Definition at line 224 of file RequestOptions.php.

◆ STREAM

const GuzzleHttp\RequestOptions::STREAM = 'stream'

stream: Set to true to attempt to stream a response rather than download it all up-front.

Definition at line 230 of file RequestOptions.php.

◆ SYNCHRONOUS

const GuzzleHttp\RequestOptions::SYNCHRONOUS = 'synchronous'

synchronous: (bool) Set to true to inform HTTP handlers that you intend on waiting on the response. This can be useful for optimizations. Note that a promise is still returned if you are using one of the async client methods.

Definition at line 216 of file RequestOptions.php.

Referenced by GuzzleHttp\Handler\Proxy\wrapSync().

◆ TIMEOUT

const GuzzleHttp\RequestOptions::TIMEOUT = 'timeout'

timeout: (float, default=0) Float describing the timeout of the request in seconds. Use 0 to wait indefinitely (the default behavior).

Definition at line 246 of file RequestOptions.php.

◆ VERIFY

const GuzzleHttp\RequestOptions::VERIFY = 'verify'

verify: (bool|string, default=true) Describes the SSL certificate verification behavior of a request. Set to true to enable SSL certificate verification using the system CA bundle when available (the default). Set to false to disable certificate verification (this is insecure!). Set to a string to provide the path to a CA bundle on disk to enable verification using a custom certificate.

Definition at line 240 of file RequestOptions.php.

◆ VERSION

const GuzzleHttp\RequestOptions::VERSION = 'version'

version: (float) Specifies the HTTP protocol version to attempt to use.

Definition at line 257 of file RequestOptions.php.

The documentation for this class was generated from the following file: