Class FormData

Provides an interface for building multipart/form-encoded message bodies.

Used by Http\Client to upload POST/PUT data and files.

Cake\Network\Http\FormData implements Countable
Namespace: Cake\Network\Http
Located at Network/Http/FormData.php

Method Detail

__toStringsource public

__toString( )

Converts the FormData and its parts into a string suitable for use in an HTTP request.

Returns

string
string

addsource public

add( string|Cake\Network\Http\FormData $name , mixed $value null )

Add a new part to the data.

The value for a part can be a string, array, int, float, filehandle, or object implementing __toString()

If the $value is an array, multiple parts will be added. Files will be read from their current position and saved in memory.

Parameters

string|Cake\Network\Http\FormData $name
The name of the part to add, or the part data object.
mixed $value optional null
The value for the part.

Returns

mixed
$this

addFilesource public

addFile( string $name , mixed $value )

Add either a file reference (string starting with @) or a file handle.

Parameters

string $name
The name to use.
mixed $value
Either a string filename, or a filehandle.

Returns

Cake\Network\Http\FormData\Part
\Cake\Network\Http\FormData\Part

addManysource public

addMany( array $data )

Add multiple parts at once.

Iterates the parameter and adds all the key/values.

Parameters

array $data
Array of data to add.

Returns

mixed
$this

addRecursivesource public

addRecursive( string $name , mixed $value )

Recursively add data.

Parameters

string $name
The name to use.
mixed $value
The value to add.

boundarysource public

boundary( )

Get the boundary marker

Returns

string
string

contentTypesource public

contentType( )

Get the content type for this payload.

If this object contains files, multipart/form-data will be used, otherwise application/x-www-form-urlencoded will be used.

Returns

string
string

countsource public

count( )

Returns the count of parts inside this object.

Returns

integer
int

Implementation of

Countable::count()

hasFilesource public

hasFile( )

Check whether or not the current payload has any files.

Returns

boolean
Whether or not there is a file in this payload.

isMultipartsource public

isMultipart( )

Check whether or not the current payload is multipart.

A payload will become multipart when you add files or use add() with a Part instance.

Returns

boolean
Whether or not the payload is multipart.

newPartsource public

newPart( string $name , string $value )

Method for creating new instances of Part

Parameters

string $name
The name of the part.
string $value
The value to add.

Returns

Cake\Network\Http\FormData\Part
\Cake\Network\Http\FormData\Part

Properties summary

$_boundarysource

protected string

Boundary marker.

$_hasComplexPartsource

protected boolean

Whether or not this formdata object has a complex part.

false

$_hasFilesource

protected boolean

Whether or not this formdata object has attached files.

false

$_partssource

protected array

The parts in the form data.

[]

© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
http://api.cakephp.org/3.1/class-Cake.Network.Http.FormData.html