PHP array_flatten() function. Convert a multi-dimensional array into a single-dimensional array.

array_flatten.php

<?php 

/**
 * Convert a multi-dimensional array into a single-dimensional array.
 * @author Sean Cannon, LitmusBox.com | seanc@litmusbox.com
 * @param  array $array The multi-dimensional array.
 * @return array
 */
function array_flatten($array) { 
  if (!is_array($array)) { 
    return false; 
  } 
  $result = array(); 
  foreach ($array as $key => $value) { 
    if (is_array($value)) { 
      $result = array_merge($result, array_flatten($value)); 
    } else { 
      $result = array_merge($result, array($key => $value));
    } 
  } 
  return $result; 
}

Thanks!

PHP 7.4

If you can use PHP 7.4, this version performs faster than @kamalkhan's suggestion.

Worth noting that @georgeholt's version out-performs the rest.

function array_flatten(array $items): array
{
  return array_reduce($items,
    fn($carry, $item) => is_array($item)
      ? [...$carry, ...array_flatten($item)]
      : [...$carry, $item]
    , []
  );
}

@ultrasamad The issue is line 18 of the function. It should actually read:

...
$result = array_merge($result, array($key => $value));
...

And for those who want a copy-pasta of the working function:

function array_flatten($array = null) {
    $result = array();

    if (!is_array($array)) {
        $array = func_get_args();
    }

    foreach ($array as $key => $value) {
        if (is_array($value)) {
            $result = array_merge($result, array_flatten($value));
        } else {
            $result = array_merge($result, array($key => $value));
        }
    }

    return $result;
}

Updated the gist, thanks for catching the bug!

@kamalkhan 👍

$data = ['a', ['bla' => 0], 'b', [0, 1], [0 => 7], [[['x'], 'y', 'z']], [['p']]];

function flatten($data, $result = [])
{
    foreach ($data as $flat) {
        if (is_array($flat)) {
            $result = flatten($flat, $result);
        } else {
            $result[] = $flat;
        }
    }

    return $result;
}

flatten($data);

@georgeholt @ultrasamad @cliffordp I made a slight alteration to George's array_flatten() function to support a $depth parameter. With this parameter, the function will only flatten to the depth specified, or to the default $depth value when the argument is not used.

For my example here, I am using a default $depth of 1, similar to JavaScript, however, you could change the default $depth to -1 which will work virtually the same as using array.flat(Infinity) in JavaScript, since negative values are truthy in PHP.

function array_flatten($array = null, $depth = 1) {
    $result = [];
    if (!is_array($array)) $array = func_get_args();
    foreach ($array as $key => $value) {
        if (is_array($value) && $depth) {
            $result = array_merge($result, array_flatten($value, $depth - 1));
        } else {
            $result = array_merge($result, [$key => $value]);
        }
    }
    return $result;
}

Here is an example using the sample array data Clifford posted earlier in this thread. I am using JSON encoding for returned values for readability:

$my_array = array('a', ['bla' => 0], 'b',[0,1], [0=>7], array(array(array('x'), 'y', 'z')), array(array('p'))); // sample data

$my_array; // the original array
// ["a",{"bla":0},"b",[0,1],[7],[[["x"],"y","z"]],[["p"]]]

array_flatten($my_array); // flatten only one layer by default
// {"0":"a","bla":0,"1":"b","2":0,"3":1,"4":7,"5":[["x"],"y","z"],"6":["p"]}

array_flatten($my_array, 2); // flatten two layers
// {"0":"a","bla":0,"1":"b","2":0,"3":1,"4":7,"5":["x"],"6":"y","7":"z","8":"p"}

array_flatten($my_array, -1); // flatten infinite number of layers
// {"0":"a","bla":0,"1":"b","2":0,"3":1,"4":7,"5":"x","6":"y","7":"z","8":"p"}

Here's a simpler example, using a non-associative array, returns again presented with JSON-encoded for readability.

$my_simple_array = [1,[2,3,[4,5,[6,7]]]]; // sample data

$my_array; // the original array
// [1,[2,3,[4,5,[6,7]]]]

array_flatten($my_array); // flatten only one layer by default
// [1,2,3,[4,5,[6,7]]]

array_flatten($my_array, 2); // flatten only one layer by default
// [1,2,3,4,5,[6,7]]

array_flatten($my_array, -1); // flatten infinite number of layers
// [1,2,3,4,5,6,7]

@brandonmcconnell Thanks! Your answer is exactly what i was looking for!

Working with associative arrays:

/**
    * flatten function
    *
    * @param array $multiDimArray
    * @return array
    */
function flatten(array $multiDimArray): array
{
    $localFlatten = [];

    foreach ($multiDimArray as $key => $value) {
        if (\is_array($value)) {
            foreach (flatten($value) as $subKey => $subValue) {
                $localFlatten[$subKey] = $subValue;
            }
            continue;
        }

        $localFlatten[$key] = $value;
    }

    return $localFlatten;
}

Using

flatten([['abc' => 123, 'a' => 1, 'abc'], [2 => 'zxc']]);
  // Result:
  [
    "abc" => 123,
    "a" => 1,
    0 => "abc",
    2 => "zxc",
  ]

Here is what I was looking for:

function true_flatten(array $array, array $parents = [])
{
    $return = [];
    foreach ($array as $k => $value) {
        $p = empty($parents) ? [$k] : [...$parents, $k];
        if (is_array($value)) {
            $return = [...$return, ...true_flatten($value, $p)];
        } else {
            $return[implode('_', $p)] = $value;
        }
    }

    return $return;
}

Sample array:

$r = [
    'a' => 'value1',
    'b' => [
        'c' => 'value1.1',
        'd' => 'value1.2',
    ],
    'e' => 'value2',
    'f' => [
        'j' => [
            'k' => 'value2.1',
            'm' => 'value2.2',
            'n' => 'value2.3',
        ],
    ],
    'o' => 'value3',
    'p' => [
        'some' => [
            'very' => [
                'deep' => [
                    'item' => [
                        'first',
                        'second',
                    ]
                ]
            ]
        ]
    ],
    'q' => 'value5',
]; // sample data

Output:

{
    "a": "value1",
    "b_c": "value1.1",
    "b_d": "value1.2",
    "e": "value2",
    "f_j_k": "value2.1",
    "f_j_m": "value2.2",
    "f_j_n": "value2.3",
    "o": "value3",
    "p_some_very_deep_item_0": "first",
    "p_some_very_deep_item_1": "second",
    "q": "value5"
}

Nice @graceman9, but it doesn't work in PHP 7, as unpacking arrays with string keys was only implemented in PHP 8.

Fatal error: Uncaught Error: Cannot unpack array with string keys

Ref: https://wiki.php.net/rfc/array_unpacking_string_keys

I just changed ... with array_merge to make your code compatible with older versions of PHP.

function true_flatten(array $array, array $parents = [])
{
    $return = [];
    foreach ($array as $k => $value) {
        $p = empty($parents) ? [$k] : array_merge($parents, [$k]);
        if (is_array($value)) {
            $return = array_merge($return, true_flatten($value, $p));
        } else {
            $return[implode('_', $p)] = $value;
        }
    }

    return $return;
}

Output:

Array
(
    [a] => value1
    [b_c] => value1.1
    [b_d] => value1.2
    [e] => value2
    [f_j_k] => value2.1
    [f_j_m] => value2.2
    [f_j_n] => value2.3
    [o] => value3
    [p_some_very_deep_item_0] => first
    [p_some_very_deep_item_1] => second
    [q] => value5
)

Tested in PHP 7.4.9

@sayhicoelho Have you tried my approach above? It should work with associative and non-associative arrays, and be compatible with PHP 7+.

It also supports a depth parameter, so you can easily flatten only the top layer, the first N layers, or infinitely.

@brandonmcconnell Using my sample data it gives not what I expected.
By the way, how to use it with unlimited $depth? array_flatten($r, 999) doesn't look good for me
Despite of that your function does the job of flattening, no doubt :) maybe flatten is not the right word because of ambiguity?

@sayhicoelho thanks for 7.x support!

echo json_encode(array_flatten($r, 9));

{
    "a": "value1",
    "c": "value1.1",
    "d": "value1.2",
    "e": "value2",
    "k": "value2.1",
    "m": "value2.2",
    "n": "value2.3",
    "o": "value3",
    "0": "first",
    "1": "second",
    "q": "value5"
}

@graceman9 What data produces an unexpected result?

For infinite depth, just use -1

@brandonmcconnell Have you noticed the difference?

{
    "a": "value1",
    "b_c": "value1.1",
}

and

{
    "a": "value1",
    "c": "value1.1",
}

@graceman9 Oh you want the keys to be concatenated, so every key keeps the log of its original path. Yeah, you are correct that my version does not do that. I tried to follow the approach common in other languages. 🙂

For a simple 2D array:

$multiDimArray = [[1, 2], [3, 4], [5, 6]];
$flatArray = array_reduce($multiDimArray, 'array_merge', []);