PHP 5.5.17 is available

array_replace_recursive

(PHP 5 >= 5.3.0)

array_replace_recursiveReemplaza los elementos de los arrays pasados al primer array de forma recursiva

Descripción

array array_replace_recursive ( array $array1 , array $array2 [, array $... ] )

array_replace_recursive() reemplaza los valores de array1 con los mismos valores de todos los siguientes arrays. Si una clave del primer array existe en el segundo array, su valor será reemplazado por el valor del segundo array. Si la clave existe en el segundo array, y no en el primero, será creada en el primer array. Si una clave existe únicamente en el primer array, se dejará como está. Si se pasan varios arrays para el reemplazo, serán procesados en orden, el último array sobrescribiendo los valores anteriores.

array_replace_recursive() es recursiva: realizará la recursividad en los arrays y aplicará el mismo proceso al valor interno.

Cuando el valor de array1 es escalar, será reemplazado por el valor de array2, que puede ser escalar o un array. Cuando los valores de array1 y array2 son arrays, array_replace_recursive() reemplazará sus respectivos valores recursivamente.

Parámetros

array1

El array cuyos elementos son reemplazados.

array2

El array del cual se extraerán los elementos.

...

Opcional. Más arrays desde los cuales se extraerán los elementos.

Valores devueltos

Devuelve un array, o NULL en caso de error.

Ejemplos

Ejemplo #1 Ejemplo de array_replace_recursive()

<?php
$base 
= array('cítricos' => array( "naranja") , 'bayas' => array("mora""frambuesa"), );
$reemplazos = array('cítricos' => array('piña'), 'bayas' => array('arándano'));

$cesta array_replace_recursive($base$reemplazos);
print_r($cesta);

$cesta array_replace($base$reemplazos);
print_r($cesta);
?>

El resultado del ejemplo sería:

Array
(
    [cítricos] => Array
        (
            [0] => piña
        )

    [bayas] => Array
        (
            [0] => arándano
            [1] => frambuesa
        )

)
Array
(
    [cítricos] => Array
        (
            [0] => piña
        )

    [bayas] => Array
        (
            [0] => arándano
        )

)

Ejemplo #2 array_replace_recursive() y comportamiento recursivo

<?php
$base 
= array('cítricos' => array("naranja") , 'bayas' => array("mora""frambuesa"), 'otros' => 'banana' );
$reemplazos = array('cítricos' => 'piña''bayas' => array('arándano'), 'otros' => array('litchis'));
$reemplazos2 = array('cítricos' => array('piña'), 'bayas' => array('arándano'), 'otros' => 'litchis');

$cesta array_replace_recursive($base$reemplazos$reemplazos2);
print_r($cesta);

?>

El resultado del ejemplo sería:

Array
(
    [cítricos] => Array
        (
            [0] => piña
        )

    [bayas] => Array
        (
            [0] => arándano
            [1] => frambuesa
        )

    [otros] => litchis
)

Ver también

add a note add a note

User Contributed Notes 3 notes

up
2
msahagian at dotink dot org
2 years ago
This is a fairly concise version which does not rely on traditional recursion:

<?php
   
function array_replace_recursive($base, $replacements)
    {
        foreach (
array_slice(func_get_args(), 1) as $replacements) {
           
$bref_stack = array(&$base);
           
$head_stack = array($replacements);

            do {
               
end($bref_stack);

               
$bref = &$bref_stack[key($bref_stack)];
               
$head = array_pop($head_stack);

                unset(
$bref_stack[key($bref_stack)]);

                foreach (
array_keys($head) as $key) {
                    if (isset(
$key, $bref) && is_array($bref[$key]) && is_array($head[$key])) {
                       
$bref_stack[] = &$bref[$key];
                       
$head_stack[] = $head[$key];
                    } else {
                       
$bref[$key] = $head[$key];
                    }
                }
            } while(
count($head_stack));
        }

        return
$base;
    }
?>
up
1
Gregor at der-meyer dot de
5 years ago
Nice that this function finally found its was to the PHP core! If you want to use it also with older PHP versions before 5.3.0, you can define it this way:

<?php
if (!function_exists('array_replace_recursive'))
{
  function
array_replace_recursive($array, $array1)
  {
    function
recurse($array, $array1)
    {
      foreach (
$array1 as $key => $value)
      {
       
// create new key in $array, if it is empty or not an array
       
if (!isset($array[$key]) || (isset($array[$key]) && !is_array($array[$key])))
        {
         
$array[$key] = array();
        }
 
       
// overwrite the value in the base array
       
if (is_array($value))
        {
         
$value = recurse($array[$key], $value);
        }
       
$array[$key] = $value;
      }
      return
$array;
    }
 
   
// handle the arguments, merge one by one
   
$args = func_get_args();
   
$array = $args[0];
    if (!
is_array($array))
    {
      return
$array;
    }
    for (
$i = 1; $i < count($args); $i++)
    {
      if (
is_array($args[$i]))
      {
       
$array = recurse($array, $args[$i]);
      }
    }
    return
$array;
  }
}
?>

I called this function array_merge_recursive_overwrite() in my older projects, but array_replace_recursive() sounds quite better while they do the same.

If you implemented such a compatible function before and don't want to refactor all your code, you can update it with the following snippet to use the native (and hopefully faster) implementation of PHP 5.3.0, if available. Just start your function with these lines:

<?php
 
// as of PHP 5.3.0 array_replace_recursive() does the work for us
 
if (function_exists('array_replace_recursive'))
  {
    return
call_user_func_array('array_replace_recursive', func_get_args());
  }
?>
up
-1
kyle [dot] florence [@t] gmail [dot] com
5 years ago
This might help out people who don't have 5.3 running:

<?php

// Joins two or more arrays together recursively; key/value pairs of the first
// array are replaced with key/value pairs from the subsequent arrays.  Any
// key/value pair not present in the first array is added to the final array
function array_join()
{
   
// Get array arguments
   
$arrays = func_get_args();

   
// Define the original array
   
$original = array_shift($arrays);

   
// Loop through arrays
   
foreach ($arrays as $array)
    {
       
// Loop through array key/value pairs
       
foreach ($array as $key => $value)
        {
           
// Value is an array
           
if (is_array($value))
            {
               
// Traverse the array; replace or add result to original array
               
$original[$key] = array_join($original[$key], $array[$key]);
            }

           
// Value is not an array
           
else
            {
               
// Replace or add current value to original array
               
$original[$key] = $value;
            }
        }
    }

   
// Return the joined array
   
return $original;
}

?>
To Top