PHP array_map(): Menerapkan Fungsi ke Setiap Elemen

array_map($callback, $array) memanggil $callback pada setiap elemen $array dan mengembalikan array baru berisi hasilnya. Callback ditulis lebih dulu, array kedua, dan array aslinya tidak berubah.

<?php
$prices = [10, 25, 40];

$withTax = array_map(fn($p) => $p * 1.2, $prices);

print_r($withTax);
print_r($prices); // unchanged

fn($p) => $p * 1.2 adalah arrow function: fungsi berisi satu ekspresi yang langsung mengembalikan hasilnya. Callable apa pun bisa dipakai di tempatnya.

Memakai fungsi bawaan sebagai callback

Berikan nama fungsi bawaan sebagai string. Ini cara terpendek untuk merapikan seluruh array: memangkas spasi setiap nilai, mengubah string menjadi integer, atau mengubah huruf besar kecil.

<?php
$raw = ["  apple ", "Banana  ", " cherry"];
print_r(array_map('trim', $raw));

$ids = ["4", "15", "42"];
var_dump(array_map('intval', $ids));

$names = ["ada", "grace", "linus"];
print_r(array_map('ucfirst', $names));

array_map('intval', ...) adalah cara biasa untuk mengubah string dari formulir atau explode() menjadi integer sungguhan. Kamu juga bisa menulis intval(...), sintaks first-class callable dari PHP 8.1, yang bisa dilengkapi otomatis dan diperiksa oleh editormu.

Memakai closure dengan variabel dari luar

Arrow function otomatis melihat variabel di sekitarnya. function klasik butuh use untuk membawanya masuk. Keduanya dijelaskan di halaman fungsi anonim.

<?php
$rate = 0.15;
$amounts = [100, 250, 80];

// Arrow function: $rate is captured automatically
$tips = array_map(fn($a) => round($a * $rate, 2), $amounts);
print_r($tips);

// Classic closure: $rate must be listed in use()
$tips2 = array_map(function ($a) use ($rate) {
    return round($a * $rate, 2);
}, $amounts);
print_r($tips2);

array_map dengan key

Dengan satu array, array_map mempertahankan key-nya, termasuk key string. Tetapi callback hanya menerima nilainya. Untuk mendapatkan key juga, berikan array_keys($array) sebagai array kedua: callback lalu dipanggil dengan satu elemen dari setiap array.

<?php
$stock = ["apples" => 12, "pears" => 0, "plums" => 7];

// Keys are kept
print_r(array_map(fn($n) => $n * 2, $stock));

// Key and value in the callback
$lines = array_map(
    fn($name, $count) => "$name: $count",
    array_keys($stock),
    $stock
);
print_r($lines);

// Same, with the original keys put back
print_r(array_combine(array_keys($stock), $lines));

Perhatikan hasil kedua: begitu kamu memberikan lebih dari satu array, key-nya diganti dengan 0, 1, 2. Karena itulah baris terakhir memakai array_combine() untuk menyusunnya kembali.

Memetakan beberapa array sekaligus

Setiap array tambahan menjadi argumen tambahan untuk callback, dipasangkan menurut posisinya. Kalau panjang array-nya berbeda, array yang lebih pendek diisi dengan null.

<?php
$first = ["Ada", "Grace", "Linus"];
$last  = ["Lovelace", "Hopper", "Torvalds"];

print_r(array_map(fn($f, $l) => "$f $l", $first, $last));

// Different lengths: missing values arrive as null
$a = [1, 2, 3];
$b = [10, 20];
print_r(array_map(fn($x, $y) => $x + ($y ?? 0), $a, $b));

Memberikan null sebagai callback akan melewati fungsinya dan menggabungkan array-array itu menjadi pasangan:

<?php
$names = ["Ada", "Grace"];
$years = [1815, 1906];

print_r(array_map(null, $names, $years));

array_map vs array_walk vs foreach

array_map membuat array baru. array_walk mengubah array yang kamu berikan, lewat referensi, dan memberi callback key sebagai argumen keduanya. foreach bisa melakukan keduanya, dan juga bisa melewati elemen atau berhenti lebih awal dengan break.

<?php
$tags = [" php ", " arrays", "map "];

// New array, input untouched
$clean = array_map('trim', $tags);

// Change in place: note the & before $value
array_walk($tags, function (&$value, $key) {
    $value = "#$key " . trim($value);
});

print_r($clean);
print_r($tags);

Pakai array_map saat setiap elemen berubah menjadi tepat satu elemen baru. Kalau kamu juga perlu membuang sebagian elemen, gabungkan dengan array_filter, atau tulis foreach.

Kesalahan umum: urutan argumen

array_map menerima callback lebih dulu dan array kedua. Tetangganya, array_filter, menerima keduanya dengan urutan terbalik, sehingga mudah tertukar:

array_map($callback, $array);     // callback first
array_filter($array, $callback);  // array first

Kalau keduanya ditukar, PHP 8 melempar TypeError, karena array biasa bukan callback yang valid:

<?php
// This throws a TypeError on purpose: the arguments are swapped
$numbers = [1, 2, 3];
$doubled = array_map($numbers, fn($n) => $n * 2);

PHP berhenti dengan:

PHP Fatal error:  Uncaught TypeError: array_map(): Argument #1 ($callback) must be a valid callback or null, array callback must have exactly two members in /home/index.php:4

Tukar kembali kedua argumennya, dan blok itu akan berjalan.