CKTIS / PHP
array_map : transformer les valeurs d'un tableau
array_map construit un tableau des résultats d'une fonction de rappel appliquée aux valeurs successives. Avec un tableau d'entrée, les clés sont conservées ; avec plusieurs, les clés numériques sont consécutives.
Version : PHP 8.4
Syntaxe
array_map(?callable $callback, array $array, array ...$arrays): arrayLa fonction de rappel doit renvoyer une nouvelle valeur. fn(int $value): int => $value * 2 double un nombre. Un simple echo dans cette fonction affiche du texte sans remplacer le retour d'un résultat. La transformation ordinaire de scalaires ne modifie pas le tableau source.
Avec un tableau, les clés textuelles et numériques sont conservées. Avec plusieurs, les valeurs sont associées par position dans l'ordre d'itération, pas par égalité des clés. Les tableaux plus courts sont complétés avec null ; tiens-en compte dans les types et la logique de la fonction.
Une fonction de rappel null avec plusieurs tableaux construit des tableaux de valeurs correspondantes. Avec un seul, elle renvoie ce tableau. L'exemple montre la conservation des clés puis cette combinaison de deux tableaux de longueurs différentes.
array_map ne filtre pas les éléments : un null renvoyé devient lui aussi une valeur du résultat. Utilise array_filter pour sélectionner les éléments. Ne considère pas cette transformation comme une copie profonde des objets ; la fonction peut modifier un objet reçu ou produire d'autres effets de bord.
Exemples
<?php
declare(strict_types=1);
$values = ["a" => 2, "b" => 3];
$mapped = array_map(fn(int $value): int => $value * 2, $values);
echo json_encode($mapped, JSON_THROW_ON_ERROR), "\n";
$paired = array_map(null, [1, 2], [10]);
echo json_encode($paired, JSON_THROW_ON_ERROR), "\n";
Résultat
{"a":4,"b":6}
[[1,10],[2,null]]