Interface EntityEnclosingRequestInterface
HTTP request that sends an entity-body in the request message (POST, PUT)
- Guzzle\Http\Message\EntityEnclosingRequestInterface implements Guzzle\Http\Message\RequestInterface
Direct known implementers
Methods summary
-
publicsetBody ( string|resource|EntityBodyInterface $body, string $contentType = null )Set the body of the request
-
publicgetBody ( )Get the body of the request if set
-
publicgetPostField ( string $field )Get a POST field from the request
-
publicgetPostFields ( )Get the post fields that will be used in the request
-
publicsetPostField ( string $key, string $value )Set a POST field value
-
publicaddPostFields ( QueryString|array $fields )Add POST fields to use in the request
-
publicremovePostField ( string $field )Remove a POST field or file by name
-
publicgetPostFiles ( )Returns an associative array of POST field names to PostFileInterface objects
-
publicgetPostFile ( string $fieldName )Get a POST file from the request
-
publicremovePostFile ( string $fieldName )Remove a POST file from the request
-
publicaddPostFile ( string $field, string $filename = null, string $contentType = null, string $postname = null )Add a POST file to the upload
-
publicaddPostFiles ( array $files )Add POST files to use in the upload
-
publicconfigureRedirects ( bool $strict = false, int $maxRedirects = 5 )Configure how redirects are handled for the request
Methods detail
public
Guzzle\Http\Message\EntityEnclosingRequestInterface
setBody( string|resource|Guzzle\Http\EntityBodyInterface $body, string $contentType = null )
Set the body of the request
Parameters
- $body
string|resource|Guzzle\Http\EntityBodyInterface
$body Body to use in the entity body of the request- $contentType
string
$contentType Content-Type to set. Leave null to use an existing Content-Type or to guess the Content-Type
Returns
Throws
Guzzle\Http\Exception\RequestExceptionif the protocol is < 1.1 and Content-Length can not be determined
Get a POST field from the request
Parameters
- $field
string
$field Field to retrieve
Returns
mixed|null
public
Guzzle\Http\Message\EntityEnclosingRequestInterface
setPostField( string $key, string $value )
Set a POST field value
Parameters
- $key
string
$key Key to set- $value
string
$value Value to set
Returns
public
Guzzle\Http\Message\EntityEnclosingRequestInterface
addPostFields( Guzzle\Http\QueryString|array $fields )
Add POST fields to use in the request
Parameters
- $fields
Guzzle\Http\QueryString|array
$fields POST fields
Returns
Remove a POST field or file by name
Parameters
- $field
string
$field Name of the POST field or file to remove
Returns
Returns an associative array of POST field names to PostFileInterface objects
Returns
arrayGet a POST file from the request
Parameters
- $fieldName
string
$fieldName POST fields to retrieve
Returns
array|nullReturns an array wrapping an array of PostFileInterface objects
Remove a POST file from the request
Parameters
- $fieldName
string
$fieldName POST file field name to remove
Returns
public
Guzzle\Http\Message\EntityEnclosingRequestInterface
addPostFile( string $field, string $filename = null, string $contentType = null, string $postname = null )
Add a POST file to the upload
Parameters
- $field
string
$field POST field to use (e.g. file). Used to reference content from the server.- $filename
string
$filename Full path to the file. Do not include the @ symbol.- $contentType
string
$contentType Optional Content-Type to add to the Content-Disposition. Default behavior is to guess. Set to false to not specify.- $postname
string
$postname The name of the file, when posted. (e.g. rename the file)
Returns
Add POST files to use in the upload
Parameters
- $files
array
$files An array of POST fields => filenames where filename can be a string or PostFileInterface
Returns
public
Guzzle\Http\Message\EntityEnclosingRequestInterface
configureRedirects( boolean $strict = false, integer $maxRedirects = 5 )
Configure how redirects are handled for the request
Parameters
- $strict
boolean
$strict Set to true to follow strict RFC compliance when redirecting POST requests. Most browsers with follow a 301-302 redirect for a POST request with a GET request. This is the default behavior of Guzzle. Enable strict redirects to redirect these responses with a POST rather than a GET request.- $maxRedirects
integer
$maxRedirects Specify the maximum number of allowed redirects. Set to 0 to disable redirects.
Returns
Methods inherited from Guzzle\Http\Message\RequestInterface
__toString(),
addCookie(),
getClient(),
getCookie(),
getCookies(),
getCurlOptions(),
getHost(),
getMethod(),
getPassword(),
getPath(),
getPort(),
getProtocolVersion(),
getQuery(),
getResource(),
getResponse(),
getResponseBody(),
getScheme(),
getState(),
getUrl(),
getUsername(),
removeCookie(),
send(),
setAuth(),
setClient(),
setHost(),
setPath(),
setPort(),
setProtocolVersion(),
setResponse(),
setResponseBody(),
setScheme(),
setState(),
setUrl(),
startResponse()
Methods inherited from Guzzle\Common\HasDispatcherInterface
addSubscriber(),
dispatch(),
getAllEvents(),
getEventDispatcher(),
setEventDispatcher()
Methods inherited from Guzzle\Http\Message\MessageInterface
addHeader(),
addHeaders(),
getHeader(),
getHeaderLines(),
getHeaders(),
getParams(),
getRawHeaders(),
hasHeader(),
removeHeader(),
setHeader(),
setHeaders()
Magic methods summary
Constants summary
string |
URL_ENCODED |
'application/x-www-form-urlencoded; charset=utf-8' |
|
string |
MULTIPART |
'multipart/form-data' |
Constants inherited from Guzzle\Http\Message\RequestInterface
CONNECT,
DELETE,
GET,
HEAD,
OPTIONS,
PATCH,
POST,
PUT,
STATE_COMPLETE,
STATE_ERROR,
STATE_NEW,
STATE_TRANSFER,
TRACE