137

Is it possible to prepend an associative array with literal key=>value pairs? I know that array_unshift() works with numerical keys, but I'm hoping for something that will work with literal keys.

As an example I'd like to do the following:

$array1 = array('fruit3'=>'apple', 'fruit4'=>'orange');
$array2 = array('fruit1'=>'cherry', 'fruit2'=>'blueberry');

// prepend magic

$resulting_array = ('fruit1'=>'cherry', 
                    'fruit2'=>'blueberry', 
                    'fruit3'=>'apple', 
                    'fruit4'=>'orange');
1

6 Answers 6

257

Can't you just do:

$resulting_array = $array2 + $array1;

?

4
  • 16
    See also array_merge() and its difference from using the + operator: br.php.net/manual/en/function.array-merge.php#92602
    – Havenard
    Commented Sep 3, 2009 at 1:33
  • 2
    @cletus: Sheesh. Yeah, I can. Not sure what made me think I couldn't or what wasn't working before. Thanks for the response. Commented Sep 3, 2009 at 1:36
  • It is worth noting the difference but that difference is relevant for preserving numeric keys and this array is a "pure" associative array with string keys.
    – cletus
    Commented Sep 3, 2009 at 1:37
  • it should be noted that the + operator only seems a good idea if you are sure that the keys (including iterative keys) are always different.
    – Charliexyx
    Commented Oct 11, 2023 at 22:30
43

You cannot directly prepend an associative array with a key-value pair.

However, you can create a new array that contains the new key-value pair at the beginning of the array with the union operator +. The outcome is an entirely new array though and creating the new array has O(n) complexity.

The syntax is below.

$new_array = array('new_key' => 'value') + $original_array;

Note: Do not use array_merge(). array_merge() overwrites keys and does not preserve numeric keys.

1
  • "overwrites keys and does not preserve numeric keys"... a) how does the union operator ("+") handle "duplicate" keys? re: not preserve numeric keys : likely desired
    – Brad Kent
    Commented May 28, 2019 at 2:35
20

In your situation, you want to use array_merge():

array_merge(array('fruit1'=>'cherry', 'fruit2'=>'blueberry'), array('fruit3'=>'apple', 'fruit4'=>'orange'));

To prepend a single value, for an associative array, instead of array_unshift(), again use array_merge():

array_merge(array($key => $value), $myarray);
6

Using the same method as @mvpetrovich, you can use the shorthand version of an array to shorten the syntax.

$_array = array_merge(["key1" => "key_value"], $_old_array);

References:

PHP: array_merge()

PHP: Arrays - Manual

As of PHP 5.4 you can also use the short array syntax, which replaces array() with [].

5

@Cletus is spot on. Just to add, if the ordering of the elements in the input arrays are ambiguous, and you need the final array to be sorted, you might want to ksort:

$resulting_array = $array1 + $array2;
ksort($resulting_array);
1
  • 4
    As a late note, ksort returns boolean, so the above needs to be done as two statements not one, e.g. $a = $array1 + $array2; ksort($a);, otherwise $resulting_array will be a boolean value not the array you were expecting.
    – El Yobo
    Commented Oct 17, 2011 at 22:39
1

If using Laravel, you can use prepend on a collection instance

 collect(['b' => 'b', 'c' => 'c'])->prepend('a','a');

// ['a'=>'a', 'b' => 'b', 'c' => 'c']

https://laravel.com/docs/9.x/collections#method-prepend

1
  • Nicely done. I wish more users would find canonicals to post modern techniques on. This question is asking how to prepend more than one associative element to the array. Does this approach have the capacity to prepend multiple associative elements to the array/collection or do you have to call the prepend() method n times? Commented Nov 10, 2022 at 22:50

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.