{"id":77,"date":"2013-10-21T21:37:28","date_gmt":"2013-10-21T20:37:28","guid":{"rendered":"http:\/\/louis.hatier.me\/blog\/?p=77"},"modified":"2015-08-12T17:42:20","modified_gmt":"2015-08-12T16:42:20","slug":"php-5-5-array_column-superglobale-files","status":"publish","type":"post","link":"https:\/\/louis.hatier.me\/blog\/php-5-5-array_column-superglobale-files\/","title":{"rendered":"array_column : utilisation avec $_FILES"},"content":{"rendered":"

\"PHP<\/a>La sortie de PHP 5.5, actuellement en version 5.5.5, a amen\u00e9e plusieurs nouveaut\u00e9s. Nous allons nous attarder ici sur une des nouvelles fonctions int\u00e9gr\u00e9es : array_column<\/strong>, et l’appliquer \u00e0 l’upload multiple.<\/p>\n

Pour comprendre ce que fait cette fonction un exemple sera plus parlant que des mots :<\/p>\n

 <\/p>\n

 <\/p>\n

<\/p>\n

$records = array(\r\n    array(\r\n        'id' => 2135,\r\n        'first_name' => 'John',\r\n        'last_name' => 'Doe',\r\n    ),\r\n    array(\r\n        'id' => 3245,\r\n        'first_name' => 'Sally',\r\n        'last_name' => 'Smith',\r\n    ),\r\n    array(\r\n        'id' => 5342,\r\n        'first_name' => 'Jane',\r\n        'last_name' => 'Jones',\r\n    ),\r\n    array(\r\n        'id' => 5623,\r\n        'first_name' => 'Peter',\r\n        'last_name' => 'Doe',\r\n    )\r\n);\r\n\r\n$first_names = array_column($records, 'first_name');\r\nprint_r($first_names);\r\n<\/code><\/pre>\n
array (size=4)\r\n  0 => string 'John' (length=4)\r\n  1 => string 'Sally' (length=5)\r\n  2 => string 'Jane' (length=4)\r\n  3 => string 'Peter' (length=5)\r\n<\/code><\/pre>\n
Dans un tableau \u00e0 2 dimensions vous pouvez donc pr\u00e9ciser une clef de tableau et obtenir ainsi les valeurs de chaque tableaux poss\u00e9dant cette clef.<\/p>\n
 <\/p>\n
Tableaux de plusieurs fichiers $_FILES avec array_column<\/h2>\n
Si vous avez d\u00e9j\u00e0 utilis\u00e9 l’upload de plusieurs fichiers simultan\u00e9ment, vous \u00eates surement tomb\u00e9 sur un probl\u00e8me : la fa\u00e7on dont la variable superglobale $_FILES<\/code> renvoie les \u00e9l\u00e9ments.<\/p>\n
Voici un exemple ci-dessous du dump de $_FILES<\/code> avec 2 fichiers envoy\u00e9s :<\/p>\n
<form action=\"\" method=\"post\" enctype=\"multipart\/form-data\">\r\n    <input type=\"file\" name=\"documents[]\" multiple>\r\n    <input type=\"submit\" value=\"Envoyer\">\r\n<\/form>\r\n<\/code><\/pre>\n
array (size=5)\r\n  'name' => \r\n    array (size=2)\r\n      0 => string 'photo1.png' (length=12)\r\n      1 => string 'photo2.png' (length=8)\r\n  'type' => \r\n    array (size=2)\r\n      0 => string 'image\/png' (length=9)\r\n      1 => string 'image\/png' (length=9)\r\n  'tmp_name' => \r\n    array (size=2)\r\n      0 => string '\/tmp\/phpGZa2ya' (length=14)\r\n      1 => string '\/tmp\/php52dYdV' (length=14)\r\n  'error' => \r\n    array (size=2)\r\n      0 => int 0\r\n      1 => int 0\r\n  'size' => \r\n    array (size=2)\r\n      0 => int 246369\r\n      1 => int 510519\r\n<\/code><\/pre>\n
C’est un tableau \u00e0 2 dimensions group\u00e9 par name<\/em>, type<\/em> etc. On ne peut donc pas boucler dessus pour avoir chaque fichier envoy\u00e9.<\/p>\n
On peut s’en sortir gr\u00e2ce \u00e0 une fonction du style :<\/p>\n
function multiFileFormat(array $arrFiles)\r\n{\r\n    $files = array();\r\n    $fdata = $arrFiles;\r\n    if (is_array($fdata['name'])) {\r\n        for ($i = 0 ; $i < count($fdata['name']) ; $i++) {\r\n            $files[] = array(\r\n                'name'     => $fdata['name'][$i],\r\n                'type'     => $fdata['type'][$i],\r\n                'tmp_name' => $fdata['tmp_name'][$i],\r\n                'error'    => $fdata['error'][$i],\r\n                'size'     => $fdata['size'][$i]\r\n            );\r\n        }\r\n    } else {\r\n        $files[] = $fdata;\r\n    }\r\n    return $files;\r\n}\r\n<\/code><\/pre>\n
Grace \u00e0 la nouvelle fonction array_column<\/em>, nous allons pouvoir faire sensiblement la m\u00eame chose avec moins de lignes :<\/p>\n
$i = 0;\r\n$documents = array();\r\nwhile (!empty(array_column($_FILES['documents'], $i))) {\r\n    $documents[] = array_column($_FILES['documents'], $i);\r\n    $i++;\r\n}\r\n<\/code><\/pre>\n
Petite explication de ces quelques lignes de codes : je boucle sur les index en partant de 0, ce qui permet de r\u00e9cup\u00e9rer dans un tableau les 5 \u00e9l\u00e9ments du m\u00eame index : name<\/em>, type<\/em>, tmp_name<\/em>, error<\/em> et size<\/em>. Voila ce que donne le dump de la variable $documents<\/code>.<\/p>\n
array (size=2)\r\n  0 => \r\n    array (size=5)\r\n      0 => string 'photo1.png' (length=12)\r\n      1 => string 'image\/png' (length=9)\r\n      2 => string '\/tmp\/phpGZa2ya' (length=14)\r\n      3 => int 0\r\n      4 => int 246369\r\n  1 => \r\n    array (size=5)\r\n      0 => string 'photo2.png' (length=8)\r\n      1 => string 'image\/png' (length=9)\r\n      2 => string '\/tmp\/php52dYdV' (length=14)\r\n      3 => int 0\r\n      4 => int 510519\r\n<\/code><\/pre>\n
L’inconv\u00e9nient de cette technique comparer \u00e0 la fonction multiFileFormat<\/em> est que les index name<\/em>, type<\/em> etc. sont remplac\u00e9s par des num\u00e9riques.<\/p>\n
Si on veut am\u00e9liorer \u00e7a et g\u00e9rer nos fichiers fa\u00e7on objet<\/em>, on peut utiliser une classe UploadedFile<\/em> qui va nous rendre la vie plus facile pour g\u00e9rer ces \u00e9l\u00e9ments par la suite.<\/p>\n
$i = 0;\r\n$documents = array();\r\nwhile (!empty(array_column($_FILES['documents'], $i))) {\r\n    list($name, $type, $tmp_name, $error, $size) = array_column($_FILES['documents'], $i);\r\n    $documents[] = new UploadedFile($name, $type, $tmp_name, $error, $size);\r\n    $i++;\r\n}<\/code><\/pre>\n
Cette classe nous permet par la suite de g\u00e9rer un objet $file<\/strong> (instance de UploadedFile<\/em>) comme ceci :<\/p>\n
echo $file->getSize(UploadedFile::SIZE_KO) . '<br>'; \/\/ affiche le poid en Ko\r\nif ($file->hasError()) {\r\n    echo $file->getErrorMessage() . '<br>'; \/\/ affiche \u00e9ventuellement un message d'erreur\r\n}\r\necho $file->getExtension() . '<br>'; \/\/ affiche l'extension\r\necho $file->getType() . '<br>'; \/\/ affiche le type de fichier\r\n$file->move('\/var\/www\/monsite\/media\/'); \/\/ enregistre le fichier o\u00f9 vous voulez\r\n<\/code><\/pre>\n
Pour aller voir le contenu de la classe UploadedFile<\/strong> direction le\u00a0repository GitHub<\/a>.<\/p>\n
Ceci est une fa\u00e7on d’appliquer la fonction array_column <\/strong>pour se faciliter les choses. Le passage par la classe UploadedFile<\/em> n’est pas obligatoire, c’est juste un moyen de pouvoir manipuler par la suite son fichier comme un objet et d’avoir acc\u00e8s \u00e0 quelques fonctions pratiques pour r\u00e9cup\u00e9rer un message d’erreur explicite, l’extension du fichier etc.<\/p>\n
Si vous avez une version ant\u00e9rieur \u00e0 PHP 5.5 et que vous \u00eates sur une Debian, vous pouvez consulter\u00a0cet article<\/a> pour savoir comment mettre \u00e0 jour PHP et ainsi profiter des derni\u00e8res am\u00e9liorations apport\u00e9es \u00e0 cette mouture.<\/p>\n
Pour information la version 5.5 est stable et il n’y a aucunes raisons de s’en priver !<\/p>\n
\"Share<\/a>