(PHP 5 >= 5.3.0, PHP 7, PHP 8)
array_replace_recursive — Remplace récursivement dans le premier tableau les éléments des autres tableaux fournis
array_replace_recursive() remplace les valeurs du tableau array
avec les valeurs des mêmes clés issues des tableaux suivants. Si une clé du premier tableau existe dans un des tableaux suivants, sa valeur sera remplacée. Si la clé n'existe pas dans le premier tableau, elle sera créée. Si la clé n'existe que dans le premier tableau, elle sera laissée intacte. Si plusieurs tableaux sont passés comme arguments de remplacement, ils seront traités dans l'ordre.
array_replace_recursive() est récursive : si une valeur est un tableau, la même fonction de remplacement lui sera appliqué.
Si la valeur dans le premier tableau est scalaire, elle sera remplacée par la valeur du second tableau, que ce soit un scalaire ou un tableau. Si la valeur du premier et second tableau sont toutes les deux des tableaux, array_replace_recursive() remplacera les valeurs récursivement.
array
Le tableau dans lequel les éléments sont remplacés.
replacements
Tableaux depuis lesquels les éléments peuvent être extraits.
Retourne un tableau.
Exemple #1 Exemple avec array_replace_recursive()
<?php
$base = array('citrus' => array( "orange") , 'berries' => array("blackberry", "raspberry"), );
$replacements = array('citrus' => array('pineapple'), 'berries' => array('blueberry'));
$basket = array_replace_recursive($base, $replacements);
print_r($basket);
$basket = array_replace($base, $replacements);
print_r($basket);
?>
L'exemple ci-dessus va afficher :
Array ( [citrus] => Array ( [0] => pineapple ) [berries] => Array ( [0] => blueberry [1] => raspberry ) ) Array ( [citrus] => Array ( [0] => pineapple ) [berries] => Array ( [0] => blueberry ) )
Exemple #2 Exemple avec array_replace_recursive() et la récursivité
<?php
$base = array('citrus' => array("orange") , 'berries' => array("blackberry", "raspberry"), 'others' => 'banana' );
$replacements = array('citrus' => 'pineapple', 'berries' => array('blueberry'), 'others' => array('litchis'));
$replacements2 = array('citrus' => array('pineapple'), 'berries' => array('blueberry'), 'others' => 'litchis');
$basket = array_replace_recursive($base, $replacements, $replacements2);
print_r($basket);
?>
L'exemple ci-dessus va afficher :
Array ( [citrus] => Array ( [0] => pineapple ) [berries] => Array ( [0] => blueberry [1] => raspberry ) [others] => litchis )