class FileBag extends ParameterBag

FileBag is a container for uploaded files.

Methods

__construct(array $parameters = array())

Constructor.

array
all()

Returns the parameters.

array
keys()

Returns the parameter keys.

replace(array $files = array())

Replaces the current parameters by a new set.

add(array $files = array())

Adds parameters.

mixed
get(string $key, mixed $default = null, bool $deep = false)

Returns a parameter by name.

set(string $key, mixed $value)

Sets a parameter by name.

bool
has(string $key)

Returns true if the parameter is defined.

remove(string $key)

Removes a parameter.

string
getAlpha(string $key, string $default = '', bool $deep = false)

Returns the alphabetic characters of the parameter value.

string
getAlnum(string $key, string $default = '', bool $deep = false)

Returns the alphabetic characters and digits of the parameter value.

string
getDigits(string $key, string $default = '', bool $deep = false)

Returns the digits of the parameter value.

int
getInt(string $key, int $default, bool $deep = false)

Returns the parameter value converted to integer.

bool
getBoolean(string $key, mixed $default = false, bool $deep = false)

Returns the parameter value converted to boolean.

mixed
filter(string $key, mixed $default = null, int $filter = FILTER_DEFAULT, mixed $options = array(), bool $deep = false)

Filter key.

getIterator()

Returns an iterator for parameters.

int
count()

Returns the number of parameters.

Details

at line line 31
__construct(array $parameters = array())

Constructor.

Parameters

array $parameters An array of parameters

in ParameterBag at line line 43
array all()

Returns the parameters.

Return Value

array An array of parameters

in ParameterBag at line line 53
array keys()

Returns the parameter keys.

Return Value

array An array of parameter keys

at line line 39
replace(array $files = array())

Replaces the current parameters by a new set.

Parameters

array $files

at line line 60
add(array $files = array())

Adds parameters.

Parameters

array $files

in ParameterBag at line line 91
mixed get(string $key, mixed $default = null, bool $deep = false)

Returns a parameter by name.

Note: Finding deep items is deprecated since version 2.8, to be removed in 3.0.

Parameters

string $key The key
mixed $default The default value if the parameter key does not exist
bool $deep If true, a path like foo[bar] will find deeper items

Return Value

mixed

Exceptions

InvalidArgumentException

at line line 48
set(string $key, mixed $value)

Sets a parameter by name.

Parameters

string $key The key
mixed $value The value

in ParameterBag at line line 162
bool has(string $key)

Returns true if the parameter is defined.

Parameters

string $key The key

Return Value

bool true if the parameter exists, false otherwise

in ParameterBag at line line 172
remove(string $key)

Removes a parameter.

Parameters

string $key The key

in ParameterBag at line line 186
string getAlpha(string $key, string $default = '', bool $deep = false)

Returns the alphabetic characters of the parameter value.

Parameters

string $key The parameter key
string $default The default value if the parameter key does not exist
bool $deep If true, a path like foo[bar] will find deeper items

Return Value

string The filtered value

in ParameterBag at line line 200
string getAlnum(string $key, string $default = '', bool $deep = false)

Returns the alphabetic characters and digits of the parameter value.

Parameters

string $key The parameter key
string $default The default value if the parameter key does not exist
bool $deep If true, a path like foo[bar] will find deeper items

Return Value

string The filtered value

in ParameterBag at line line 214
string getDigits(string $key, string $default = '', bool $deep = false)

Returns the digits of the parameter value.

Parameters

string $key The parameter key
string $default The default value if the parameter key does not exist
bool $deep If true, a path like foo[bar] will find deeper items

Return Value

string The filtered value

in ParameterBag at line line 229
int getInt(string $key, int $default, bool $deep = false)

Returns the parameter value converted to integer.

Parameters

string $key The parameter key
int $default The default value if the parameter key does not exist
bool $deep If true, a path like foo[bar] will find deeper items

Return Value

int The filtered value

in ParameterBag at line line 243
bool getBoolean(string $key, mixed $default = false, bool $deep = false)

Returns the parameter value converted to boolean.

Parameters

string $key The parameter key
mixed $default The default value if the parameter key does not exist
bool $deep If true, a path like foo[bar] will find deeper items

Return Value

bool The filtered value

in ParameterBag at line line 261
mixed filter(string $key, mixed $default = null, int $filter = FILTER_DEFAULT, mixed $options = array(), bool $deep = false)

Filter key.

Parameters

string $key Key.
mixed $default Default = null.
int $filter FILTER_* constant.
mixed $options Filter options.
bool $deep Default = false.

Return Value

mixed

See also

http://php.net/manual/en/function.filter-var.php

in ParameterBag at line line 298
ArrayIterator getIterator()

Returns an iterator for parameters.

Return Value

ArrayIterator An \ArrayIterator instance

in ParameterBag at line line 308
int count()

Returns the number of parameters.

Return Value

int The number of parameters