Class FormData

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

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

Cake\Http\Client\FormData implements Countable
Namespace: Cake\Http\Client
Location: Http/Client/FormData.php

Properties summary

  • $_boundary protected
    string
    Boundary marker.
  • $_hasComplexPart protected
    boolean
    Whether or not this formdata object has a complex part.
  • $_hasFile protected
    boolean
    Whether or not this formdata object has attached files.
  • $_parts protected
    Cake\Http\Client\FormDataPart[]
    The parts in the form data.

Method Summary

  • __toString() public

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

  • add() public
    Add a new part to the data.
  • addFile() public

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

  • addMany() public
    Add multiple parts at once.
  • Recursively add data.
  • boundary() public
    Get the boundary marker
  • contentType() public
    Get the content type for this payload.
  • count() public
    Returns the count of parts inside this object.
  • hasFile() public

    Check whether or not the current payload has any files.

  • isMultipart() public

    Check whether or not the current payload is multipart.

  • newPart() public
    Method for creating new instances of Part

Method Detail

__toString()source public

__toString( )

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

Returns

string

add()source public

add( string|Cake\Http\Client\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\Http\Client\FormData $name

The name of the part to add, or the part data object.

mixed $value optional null
The value for the part.

Returns


$this

addFile()source 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\Http\Client\FormDataPart

addMany()source 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


$this

addRecursive()source public

addRecursive( string $name , mixed $value )

Recursively add data.

Parameters

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

boundary()source public

boundary( )

Get the boundary marker

Returns

string

contentType()source 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

count()source public

count( )

Returns the count of parts inside this object.

Returns

integer

Implementation of

Countable::count()

hasFile()source public

hasFile( )

Check whether or not the current payload has any files.

Returns

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

isMultipart()source 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.

newPart()source 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\Http\Client\FormDataPart

Properties detail

$_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 Cake\Http\Client\FormDataPart[]

The parts in the form data.

[]

© 2005–2017 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.
https://api.cakephp.org/3.4/class-Cake.Http.Client.FormData.html