patch.php

<?php

namespace arrays;

/**
 * Patches array by xpath.
 *
 * **Usage**
 *
 * ```php
 * __::patch(
 *     [
 *         'addr' => [
 *             'country' => 'US',
 *             'zip' => 12345
 *         ]
 *     ],
 *     [
 *         '/addr/country' => 'CA',
 *         '/addr/zip' => 54321
 *     ]
 * );
 * ```
 *
 * **Result**
 *
 * ```
 * ['addr' => ['country' => 'CA', 'zip' => 54321]]
 * ```
 *
 * @param array  $array   The array to patch
 * @param array  $patches List of new xpath-value pairs
 * @param string $parent
 *
 * @return array Returns patched array
 */
function patch($array, $patches, $parent = '')
{
    $parent .= '/';
    foreach ($array as $key => &$value) {
        $z = $parent . $key;

        if (isset($patches[$z])) {
            $value = $patches[$z];
            unset($patches[$z]);

            if (!count($patches)) {
                break;
            }
        }

        if (\is_array($value)) {
            $value = patch($array[$key], $patches, $z);
        }
    }

    return $array;
}