CakeFest 2025 Madrid: The Official CakePHP Conference

    array_replace_recursive

    (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

    Description

    array_replace_recursive(array $array, array ...$replacements): array

    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.

    Liste de paramètres

    array

    Le tableau dans lequel les éléments sont remplacés.

    replacements

    Tableaux depuis lesquels les éléments peuvent être extraits.

    Valeurs de retour

    Retourne un tableau.

    Exemples

    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
)

    Voir aussi

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    9
    Pau Prat Torrella
    5 years ago
    Note that function will NOT replace a sub-tree from you $array1 if its value in $array2 is an empty array.
    Even tho the key for this dimension is technically 'set'.

    (I suppose it treats it as just another recursive level to dive in, finding no key to compare, backtracking while leaving this sub-tree alone)

    For example:

    $array1 = ['first' => ['second' => 'hello']];
    $array2 = ['first' => []];
    $result = array_replace_recursive($array1, $array2);

    $result is still: ['first' => ['second' => 'hello']].
    ＋add a note
    To Top