(PHP 5 >= 5.3.0, PHP 7)
array_replace_recursive — Рекурсивно заменяет элементы первого массива элементами переданных массивов
$array1
[, array $...
] ) : array
array_replace_recursive() заменяет значения массива
array1 на соответствующие по ключам
значения из всех следующих массивов.
Если ключ из первого массива есть во втором, его значение будет заменено
на значение из второго массива. Если ключ есть во втором массиве, но отсутствует в первом,
он будет создан в первом массиве. Если ключ есть только в первом массиве, то он остается как есть.
Если передано несколько массивов, они будут обработаны по порядку, последующие перезаписывают
предыдущие значения.
array_replace_recursive() - рекурсивная функция: она будет рекурсивно углубляться в массивы и применять к всем внутренним значениям один и тот же процесс.
Если значение, переданное в первый массив является скалярным, оно будет заменено значением во втором массиве, которое может быть скалярным значением или массивом. Если оба значения, переданные в первый массив и во второй массив - массивы, array_replace_recursive() будет заменять их значения рекурсивно.
array1Массив, элементы которого будут заменены.
...Необязательно. Массивы, из которых будут браться элементы для замены.
Возвращает массив (array) или NULL, если произошла ошибка.
Пример #1 Пример использования 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);
?>
Результат выполнения данного примера:
Array
(
[citrus] => Array
(
[0] => pineapple
)
[berries] => Array
(
[0] => blueberry
[1] => raspberry
)
)
Array
(
[citrus] => Array
(
[0] => pineapple
)
[berries] => Array
(
[0] => blueberry
)
)
Пример #2 array_replace_recursive() и рекурсивное поведение
<?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);
?>
Результат выполнения данного примера:
Array
(
[citrus] => Array
(
[0] => pineapple
)
[berries] => Array
(
[0] => blueberry
[1] => raspberry
)
[others] => litchis
)