class FileBag in Zircon Profile 8
Same name and namespace in other branches
- 8.0 vendor/symfony/http-foundation/FileBag.php \Symfony\Component\HttpFoundation\FileBag
FileBag is a container for uploaded files.
@author Fabien Potencier <fabien@symfony.com> @author Bulat Shakirzyanov <mallluhuct@gmail.com>
Hierarchy
- class \Symfony\Component\HttpFoundation\ParameterBag implements \Symfony\Component\HttpFoundation\IteratorAggregate, \Symfony\Component\HttpFoundation\Countable
- class \Symfony\Component\HttpFoundation\FileBag
Expanded class hierarchy of FileBag
2 files declare their use of FileBag
- FileBagTest.php in vendor/
symfony/ http-foundation/ Tests/ FileBagTest.php - FormBuilder.php in core/
lib/ Drupal/ Core/ Form/ FormBuilder.php - Contains \Drupal\Core\Form\FormBuilder.
File
- vendor/
symfony/ http-foundation/ FileBag.php, line 22
Namespace
Symfony\Component\HttpFoundationView source
class FileBag extends ParameterBag {
private static $fileKeys = array(
'error',
'name',
'size',
'tmp_name',
'type',
);
/**
* Constructor.
*
* @param array $parameters An array of HTTP files
*/
public function __construct(array $parameters = array()) {
$this
->replace($parameters);
}
/**
* {@inheritdoc}
*/
public function replace(array $files = array()) {
$this->parameters = array();
$this
->add($files);
}
/**
* {@inheritdoc}
*/
public function set($key, $value) {
if (!is_array($value) && !$value instanceof UploadedFile) {
throw new \InvalidArgumentException('An uploaded file must be an array or an instance of UploadedFile.');
}
parent::set($key, $this
->convertFileInformation($value));
}
/**
* {@inheritdoc}
*/
public function add(array $files = array()) {
foreach ($files as $key => $file) {
$this
->set($key, $file);
}
}
/**
* Converts uploaded files to UploadedFile instances.
*
* @param array|UploadedFile $file A (multi-dimensional) array of uploaded file information
*
* @return array A (multi-dimensional) array of UploadedFile instances
*/
protected function convertFileInformation($file) {
if ($file instanceof UploadedFile) {
return $file;
}
$file = $this
->fixPhpFilesArray($file);
if (is_array($file)) {
$keys = array_keys($file);
sort($keys);
if ($keys == self::$fileKeys) {
if (UPLOAD_ERR_NO_FILE == $file['error']) {
$file = null;
}
else {
$file = new UploadedFile($file['tmp_name'], $file['name'], $file['type'], $file['size'], $file['error']);
}
}
else {
$file = array_map(array(
$this,
'convertFileInformation',
), $file);
}
}
return $file;
}
/**
* Fixes a malformed PHP $_FILES array.
*
* PHP has a bug that the format of the $_FILES array differs, depending on
* whether the uploaded file fields had normal field names or array-like
* field names ("normal" vs. "parent[child]").
*
* This method fixes the array to look like the "normal" $_FILES array.
*
* It's safe to pass an already converted array, in which case this method
* just returns the original array unmodified.
*
* @param array $data
*
* @return array
*/
protected function fixPhpFilesArray($data) {
if (!is_array($data)) {
return $data;
}
$keys = array_keys($data);
sort($keys);
if (self::$fileKeys != $keys || !isset($data['name']) || !is_array($data['name'])) {
return $data;
}
$files = $data;
foreach (self::$fileKeys as $k) {
unset($files[$k]);
}
foreach ($data['name'] as $key => $name) {
$files[$key] = $this
->fixPhpFilesArray(array(
'error' => $data['error'][$key],
'name' => $name,
'type' => $data['type'][$key],
'tmp_name' => $data['tmp_name'][$key],
'size' => $data['size'][$key],
));
}
return $files;
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
FileBag:: |
private static | property | ||
FileBag:: |
public | function |
Adds parameters. Overrides ParameterBag:: |
|
FileBag:: |
protected | function | Converts uploaded files to UploadedFile instances. | |
FileBag:: |
protected | function | Fixes a malformed PHP $_FILES array. | |
FileBag:: |
public | function |
Replaces the current parameters by a new set. Overrides ParameterBag:: |
|
FileBag:: |
public | function |
Sets a parameter by name. Overrides ParameterBag:: |
|
FileBag:: |
public | function |
Constructor. Overrides ParameterBag:: |
|
ParameterBag:: |
protected | property | Parameter storage. | |
ParameterBag:: |
public | function | Returns the parameters. | |
ParameterBag:: |
public | function | Returns the number of parameters. | |
ParameterBag:: |
public | function | Filter key. | |
ParameterBag:: |
public | function | Returns a parameter by name. | |
ParameterBag:: |
public | function | Returns the alphabetic characters and digits of the parameter value. | |
ParameterBag:: |
public | function | Returns the alphabetic characters of the parameter value. | |
ParameterBag:: |
public | function | Returns the parameter value converted to boolean. | |
ParameterBag:: |
public | function | Returns the digits of the parameter value. | |
ParameterBag:: |
public | function | Returns the parameter value converted to integer. | |
ParameterBag:: |
public | function | Returns an iterator for parameters. | |
ParameterBag:: |
public | function | Returns true if the parameter is defined. | |
ParameterBag:: |
public | function | Returns the parameter keys. | |
ParameterBag:: |
public | function | Removes a parameter. |