b-viguier / php-emoji

Php array functions… with Emojis 🙂

Do you know Php array functions? They are powerful, but sometimes tricky to handle… 😕

Here a cheat-sheet using Emoji, with some of my favorite tricks: Enjoy! 🎉

Cheat-sheet

array_chunk

array_chunk([🍎, 🍐, 🍊, 🍋, 🍌], 2);

[
    [🍎, 🍐], 
    [🍊, 🍋], 
    [🍌],
]

array_chunk with preserved keys

array_chunk([🍎, 🍐, 🍊, 🍋, 🍌], 2, true);

[
    [🍎, 🍐], 
    [2 => 🍊, 3 => 🍋], 
    [4 => 🍌],
]

array_column

array_column(
    [
        ['people' => 😀, 'fruit' => 🍎, 'animal' => 🐶],
        ['people' => 😎, 'fruit' => 🍐, 'animal' => 🐭],
        ['people' => 🥶, 'fruit' => 🍊, 'animal' => 🐰],
        ['people' => 🤡, 'fruit' => 🍋, 'animal' => 🦊],
        ['people' => 🤠, 'fruit' => 🍌, 'animal' => 🐯],
    ],
    'fruit'
);

[🍎, 🍐, 🍊, 🍋, 🍌]

array_column with an index

array_column(
    [
        ['people' => 😀, 'fruit' => 🍎, 'animal' => 🐶],
        ['people' => 😎, 'fruit' => 🍐, 'animal' => 🐭],
        ['people' => 🥶, 'fruit' => 🍊, 'animal' => 🐰],
        ['people' => 🤡, 'fruit' => 🍋, 'animal' => 🦊],
        ['people' => 🤠, 'fruit' => 🍌, 'animal' => 🐯],
    ],
    'fruit',
    'people'
);

[😀 => 🍎, 😎 => 🍐, 🥶 => 🍊, 🤡 => 🍋, 🤠 => 🍌]

array_column all columns with an index

array_column(
    [
        ['people' => 😀, 'fruit' => 🍎, 'animal' => 🐶],
        ['people' => 😎, 'fruit' => 🍐, 'animal' => 🐭],
        ['people' => 🥶, 'fruit' => 🍊, 'animal' => 🐰],
        ['people' => 🤡, 'fruit' => 🍋, 'animal' => 🦊],
        ['people' => 🤠, 'fruit' => 🍌, 'animal' => 🐯],
    ],
    null,
    'people'
);

[
    😀 => ['people' => 😀, 'fruit' => 🍎, 'animal' => 🐶], 
    😎 => ['people' => 😎, 'fruit' => 🍐, 'animal' => 🐭], 
    🥶 => ['people' => 🥶, 'fruit' => 🍊, 'animal' => 🐰], 
    🤡 => ['people' => 🤡, 'fruit' => 🍋, 'animal' => 🦊], 
    🤠 => ['people' => 🤠, 'fruit' => 🍌, 'animal' => 🐯],
]

array_combine

array_combine(
    [😀, 😎, 🥶, 🤡, 🤠],
    [🍎, 🍐, 🍊, 🍋, 🍌]
);

[😀 => 🍎, 😎 => 🍐, 🥶 => 🍊, 🤡 => 🍋, 🤠 => 🍌]

array_count_values

array_count_values([🍎, 🍎, 🍌, 🍌, 🍎]);

[🍎 => 3, 🍌 => 2]

array_diff

array_diff(
    [🍎, 🍐, 🍊, 🍋, 🍌],
    [❌, 🍐], [❌, 🍊], [❌, 🍋]
);

[0 => 🍎, 4 => 🍌]

array_diff_key

array_diff_key(
    [🐶 => 🍎, 🐭 => 🍐, 🐰 => 🍊, 🦊 => 🍋, 🐯 => 🍌],
    [🐶 => ❌, 🐭 => ❌], [🐰 => ❌]
);

[🦊 => 🍋, 🐯 => 🍌]

array_fill_keys

array_fill_keys([🍎, 🍐, 🍊, 🍋, 🍌], ✅);

[🍎 => ✅, 🍐 => ✅, 🍊 => ✅, 🍋 => ✅, 🍌 => ✅]

array_fill

array_fill(2, 3, 🍌);

[2 => 🍌, 3 => 🍌, 4 => 🍌]

array_filter

array_filter([🍎, 0, 🍐, false, 🍊, null, 🍋, '', 🍌]);

[0 => 🍎, 2 => 🍐, 4 => 🍊, 6 => 🍋, 8 => 🍌]

array_filter with callback

array_filter([🍎, 🍐, 🍎, 🍋, 🍌], fn($❓) => $❓ === 🍎);

[0 => 🍎, 2 => 🍎]

array_flip

array_flip([🐶 => 🍎, 🐭 => 🍐, 🐰 => 🍎, 🦊 => 🍋, 🐯 => 🍌]);

[🍎 => 🐰, 🍐 => 🐭, 🍋 => 🦊, 🍌 => 🐯]

array_intersect

array_intersect(
    [🍎, 🍐, 🍊, 🍋, 🍌],
    [❌, 🍊, 🍐], [🍊, 🍌]
);

[2 => 🍊]

array_intersect_key

array_intersect_key(
    [🐶 => 🍎, 🐭 => 🍐, 🐰 => 🍊, 🦊 => 🍋, 🐯 => 🍌],
    [🐶 => ❌, 🦊 => ✅], [🦊 => ✅, 🐯 => ❌]
);

[🦊 => 🍋]

array_keys

array_keys(
    [🐶 => 🍎, 🐭 => 🍐, 🐰 => 🍊, 🦊 => 🍋, 🐯 => 🍌]
);

[🐶, 🐭, 🐰, 🦊, 🐯]

array_map

array_map(
    fn($👤, $🍽) => "$👤 ❤️ $🍽",
    [😀, 😎, 🥶, 🤡],
    [🍎, 🍐, 🍊, 🍋, 🍌]
);

['😀 ❤️ 🍎', '😎 ❤️ 🍐', '🥶 ❤️ 🍊', '🤡 ❤️ 🍋', ' ❤️ 🍌']

array_map with null callback

array_map(
    null,
    [😀, 😎, 🥶, 🤡, 🤠],
    [🍎, 🍐, 🍊, 🍋],
    [🐶, 🐭, 🐰, 🦊, 🐯]
);

[
    [😀, 🍎, 🐶], 
    [😎, 🍐, 🐭], 
    [🥶, 🍊, 🐰], 
    [🤡, 🍋, 🦊], 
    [🤠, null, 🐯],
]

array_merge

array_merge(
    [🐶 => 🍎, 🐭 => 🍐, 🐰 => ❌],
    [🐰 => 🍊, 🦊 => ❌, 🐯 => 🍌],
    [🦊 => 🍋],
);

[🐶 => 🍎, 🐭 => 🍐, 🐰 => 🍊, 🦊 => 🍋, 🐯 => 🍌]

Union operator

[🐶 => 🍎, 🐭 => 🍐, 🐰 => 🍊] +
    [🐰 => ❌, 🦊 => 🍋, 🐯 => 🍌] +
    [🦊 => ❌];

[🐶 => 🍎, 🐭 => 🍐, 🐰 => 🍊, 🦊 => 🍋, 🐯 => 🍌]

array_merge with integer keys

array_merge([🍎, 🍐], [🍊, 🍌], [🍋]);

[🍎, 🍐, 🍊, 🍌, 🍋]

Union operator with integer keys

[🍎, 🍐] + [🍊, 🍌] + [🍋];

[🍎, 🍐]

array_pad

array_pad([🍎, 🍐], 5, 🍌);

[🍎, 🍐, 🍌, 🍌, 🍌]

array_reverse

array_reverse([🍎, 🍐, 🍊, 🍋, 🍌]);

[🍌, 🍋, 🍊, 🍐, 🍎]

array_reverse with preserved keys

array_reverse([🍎, 🍐, 🍊, 🍋, 🍌], true);

[4 => 🍌, 3 => 🍋, 2 => 🍊, 1 => 🍐, 0 => 🍎]

array_slice

array_slice([🍎, 🍌, 🍌, 🍌, 🍎], 1, 3);

[🍌, 🍌, 🍌]

array_slice with preserved keys

array_slice([🍎, 🍌, 🍌, 🍌, 🍎], 1, 3, true);

[1 => 🍌, 2 => 🍌, 3 => 🍌]

array_unique

array_unique([🍎, 🍎, 🍌, 🍌, 🍎]);

[0 => 🍎, 2 => 🍌]

array_values

array_values(
    [🐶 => 🍎, 🐭 => 🍐, 🐰 => 🍊, 🦊 => 🍋, 🐯 => 🍌]
);

[🍎, 🍐, 🍊, 🍋, 🍌]

Advanced usage

These are what I call array tips©:

• Single statement
• No anonymous function (but short arrow functions are allowed 😉)
• 🤯

⚠️ Do not use it in production, unless ALL your team understand it! 😅

array_multisort: sort multidimensional array

!(
    ($data = [
        ['people' => 😀, 'fruit' => 🍎, 'score' => 2],
        ['people' => 😎, 'fruit' => 🍐, 'score' => 4],
        ['people' => 🥶, 'fruit' => 🍊, 'score' => 3],
        ['people' => 🤡, 'fruit' => 🍋, 'score' => 1],
        ['people' => 🤠, 'fruit' => 🍌, 'score' => 5],
    ]) && array_multisort(
        array_column($data, 'score'),
        $data
    )
) ?: $data;

[
    ['people' => 🤡, 'fruit' => 🍋, 'score' => 1], 
    ['people' => 😀, 'fruit' => 🍎, 'score' => 2], 
    ['people' => 🥶, 'fruit' => 🍊, 'score' => 3], 
    ['people' => 😎, 'fruit' => 🍐, 'score' => 4], 
    ['people' => 🤠, 'fruit' => 🍌, 'score' => 5],
]

array_column: search last element

!($data = [
    ['people' => 😀, 'fruit' => 🍎, 'animal' => 🐶],
    ['people' => 😎, 'fruit' => 🍐, 'animal' => 🐭],
    ['people' => 🥶, 'fruit' => 🍊, 'animal' => 🐰],
    ['people' => 🤡, 'fruit' => 🍋, 'animal' => 🦊],
    ['people' => 🤠, 'fruit' => 🍊, 'animal' => 🐯],
]) ?: array_column($data, null, 'fruit')[🍊] ?? null;

['people' => 🤠, 'fruit' => 🍊, 'animal' => 🐯]

array_intersect: filtering elements

!($data = [
    ['people' => 😀, 'fruit' => 🍎, 'animal' => 🐶],
    ['people' => 😎, 'fruit' => 🍐, 'animal' => 🐭],
    ['people' => 🥶, 'fruit' => 🍊, 'animal' => 🐰],
    ['people' => 🤡, 'fruit' => 🍋, 'animal' => 🦊],
    ['people' => 🤠, 'fruit' => 🍊, 'animal' => 🐯],
]) ?: array_values(
    array_intersect_key(
        $data,
        array_intersect(
            array_column($data, 'fruit'),
            [🍊, 🍎]
        )
    )
);

[
    ['people' => 😀, 'fruit' => 🍎, 'animal' => 🐶], 
    ['people' => 🥶, 'fruit' => 🍊, 'animal' => 🐰], 
    ['people' => 🤠, 'fruit' => 🍊, 'animal' => 🐯],
]

array_map: numerical statistics

!($data = [1, 2, 3, 4, 5, 6]) ?: [
    'count' => $count = count($data),
    'average' => $avg = array_sum($data) / $count,
    'variance' => array_sum(
            array_map(
                array_product(...),
                array_map(null, $data, $data)
            )
        ) / $count - $avg ** 2,
];

['count' => 6, 'average' => 3.5, 'variance' => 2.9166666666667]

array_map: matrix transposition

array_map(
        null,
    ...[
        [😀, 🍎, 🐶],
        [😎, 🍐, 🐭],
        [🥶, 🍊, 🐰],
        [🤡, 🍋, 🦊],
        [🤠, 🍊, 🐯],
    ]
);

[
    [😀, 😎, 🥶, 🤡, 🤠], 
    [🍎, 🍐, 🍊, 🍋, 🍊], 
    [🐶, 🐭, 🐰, 🦊, 🐯],
]

array_intersect_key: recursive filtering by keys

($func = function ($input, $filter) use (&$func) {
    return \is_array($input)
        ? \array_combine(
            \array_keys($filteredInput = \array_intersect_key($input, $filter)),
            \array_map(
                $func,
                $filteredInput,
                \array_intersect_key($filter, $input),
            ),
        ) : $input;
})(
    [
        😀 => ✅,
        🤠 => ❌,
        😎 => [
            🍎 => ✅,
            🍐 => ❌,
        ],
        🤡 => [
            🍎 => [
                🐶 => ✅,
                🐰 => ❌,
            ],
        ],
    ],
    [
        😀 => 1,
        🥶 => 1,
        😎 => [
            🍎 => 1,
            🍋 => 1,
        ],
        🤡 => [
            🍎 => [
                🐶 => 1,
                🐯 => 1,
            ],
        ],
    ],
);

[
    😀 => ✅,
    😎 => [🍎 => ✅],
    🤡 => [🍎 => [🐶 => ✅]],
]
    

How To

Requires at least php 7.4.

php README.php > README.md