PHP array_map(): Her Elemana Bir Fonksiyon Uygulama

array_map($callback, $array) $array dizisinin her elemanında $callback çağırır ve sonuçlarla yeni bir dizi döndürür. Önce geri çağırma fonksiyonu, sonra dizi gelir ve orijinal dizi değişmeden kalır.

<?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 bir ok fonksiyonudur: sonucunu döndüren tek ifadelik bir fonksiyon. Yerine herhangi bir çağrılabilir (callable) kullanılabilir.

Geri çağırma olarak yerleşik bir fonksiyon kullanma

Yerleşik bir fonksiyonun adını dizge olarak verin. Bu, bütün bir diziyi temizlemenin en kısa yoludur: her değeri kırpın, dizgeleri tam sayıya çevirin ya da büyük küçük harfi değiştirin.

<?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', ...) bir formdan veya explode() çıktısından gelen dizgeleri gerçek tam sayılara çevirmenin olağan yoludur. PHP 8.1'deki birinci sınıf çağrılabilir söz dizimi olan intval(...) da yazabilirsiniz; editörünüz bunu otomatik tamamlayıp kontrol edebilir.

Dış değişkenlerle closure kullanma

Bir ok fonksiyonu etrafındaki değişkenleri otomatik olarak görür. Klasik bir function ise onları içeri almak için use ister. İkisi de anonim fonksiyonlar sayfasında açıklanıyor.

<?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);

Anahtarlarla array_map

Tek bir diziyle array_map dizge anahtarlar dahil anahtarları korur. Ama geri çağırma fonksiyonu yalnızca değeri alır. Anahtarı da almak için ikinci bir dizi olarak array_keys($array) verin: geri çağırma o zaman her diziden birer elemanla çağrılır.

<?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));

İkinci sonuca dikkat edin: birden fazla dizi verdiğiniz anda anahtarlar 0, 1, 2 ile değiştirilir. Son satırın onları yeniden oluşturmak için array_combine() kullanmasının nedeni budur.

Aynı anda birden çok diziyi eşleme

Her ek dizi geri çağırma fonksiyonuna konumla eşleşen ek bir argüman olur. Dizilerin uzunlukları farklıysa kısa olanlar null ile doldurulur.

<?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));

Geri çağırma olarak null vermek fonksiyonu atlar ve dizileri çiftler halinde birleştirir:

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

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

array_map, array_walk ve foreach karşılaştırması

array_map yeni bir dizi oluşturur. array_walk verdiğiniz diziyi bir referans üzerinden değiştirir ve geri çağırma fonksiyonuna ikinci argüman olarak anahtarı verir. Bir foreach ikisini de yapabilir, ayrıca elemanları atlayabilir veya break ile erken durabilir.

<?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);

Her eleman tam olarak bir yeni elemana dönüştüğünde array_map kullanın. Bazı elemanları atmanız da gerekiyorsa onu array_filter ile birleştirin ya da bir foreach yazın.

Sık yapılan hata: argüman sırası

array_map önce geri çağırma fonksiyonunu, sonra diziyi alır. Komşusu array_filter ise onları ters sırada alır ve bunları karıştırmak kolaydır:

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

Yerlerini değiştirmek PHP 8'in bir TypeError fırlatmasına yol açar, çünkü düz bir dizi geçerli bir geri çağırma değildir:

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

PHP şununla durur:

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

İki argümanın yerini geri değiştirin, blok çalışır.