Skip to content

Latest commit

 

History

History
405 lines (364 loc) · 10.3 KB

README.md

File metadata and controls

405 lines (364 loc) · 10.3 KB
Raw

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(
    [🐶 => 🍎, 🐭 => 🍐, 🐰 => ❌],
    [🐰 => 🍊, 🦊 => ❌, 🐯 => 🍌],
    [🦊 => 🍋],
);
[🐶 => 🍎, 🐭 => 🍐, 🐰 => 🍊, 🦊 => 🍋, 🐯 => 🍌]

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]

How To

Requires at least php 7.4.

php README.php > README.md