array_map() ב-PHP: הפעלת פונקציה על כל איבר

array_map($callback, $array) קוראת ל-$callback על כל איבר של $array ומחזירה מערך חדש עם התוצאות. ה-callback בא ראשון, המערך שני, והמערך המקורי נשאר ללא שינוי.

<?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 היא פונקציית חץ: פונקציה של ביטוי אחד שמחזירה את התוצאה שלו. כל callable עובד במקומה.

שימוש בפונקציה מובנית כ-callback

העבירו את השם של פונקציה מובנית כמחרוזת. זו הדרך הקצרה ביותר לנקות מערך שלם: להפעיל trim על כל ערך, להמיר מחרוזות למספרים שלמים או לשנות רישיות.

<?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', ...) היא הדרך הרגילה להפוך את המחרוזות מטופס או מ-explode() למספרים שלמים אמיתיים. אפשר גם לכתוב intval(...), תחביר ה-first-class callable מ-PHP 8.1, שהעורך שלכם יכול להשלים אוטומטית ולבדוק.

שימוש ב-closure עם משתנים מבחוץ

פונקציית חץ רואה את המשתנים שסביבה אוטומטית. function קלאסית צריכה use כדי להכניס אותם. שתיהן מוסברות בעמוד פונקציות אנונימיות.

<?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 עם מפתחות

עם מערך יחיד, array_map שומרת על המפתחות, כולל מפתחות מחרוזת. אבל ה-callback מקבל רק את הערך. כדי לקבל גם את המפתח, העבירו array_keys($array) כמערך שני: ה-callback נקרא אז עם איבר אחד מכל מערך.

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

שימו לב לתוצאה השנייה: ברגע שמעבירים יותר ממערך אחד, המפתחות מוחלפים ב-0, 1, 2. לכן השורה האחרונה משתמשת ב-array_combine() כדי לבנות אותם מחדש.

מיפוי של כמה מערכים בבת אחת

כל מערך נוסף הופך לארגומנט נוסף של ה-callback, לפי מיקום. אם למערכים יש אורכים שונים, הקצרים מושלמים ב-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));

העברה של null כ-callback מדלגת על הפונקציה ומצמידה את המערכים לזוגות:

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

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

array_map מול array_walk מול foreach

array_map בונה מערך חדש. array_walk משנה את המערך שמעבירים לה, דרך הפניה, ונותנת ל-callback את המפתח כארגומנט השני. foreach עושה כל אחד מהם ויכולה גם לדלג על איברים או לעצור מוקדם עם 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);

השתמשו ב-array_map כשכל איבר הופך לאיבר חדש אחד בדיוק. אם אתם צריכים גם להשמיט חלק מהאיברים, שלבו אותה עם array_filter, או כתבו foreach.

טעות נפוצה: סדר הארגומנטים

array_map מקבלת קודם את ה-callback ואחר כך את המערך. השכנה שלה array_filter מקבלת אותם בסדר ההפוך, וקל להתבלבל:

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

החלפה ביניהם גורמת ל-PHP 8 לזרוק TypeError, כי מערך רגיל אינו callback תקין:

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

PHP נעצרת עם:

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

החליפו את שני הארגומנטים בחזרה והבלוק ירוץ.