array_map() trong PHP: áp dụng hàm cho mọi phần tử

array_map($callback, $array) gọi $callback trên mọi phần tử của $array và trả về một mảng mới chứa kết quả. Callback đứng trước, mảng đứng sau, và mảng gốc giữ nguyên.

<?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 là một arrow function: hàm chỉ có một biểu thức và trả về kết quả của biểu thức đó. Bất kỳ callable nào cũng dùng được ở vị trí này.

Dùng hàm có sẵn làm callback

Truyền tên một hàm có sẵn dưới dạng chuỗi. Đây là cách ngắn nhất để dọn dẹp cả một mảng: trim mọi giá trị, chuyển chuỗi thành số nguyên hoặc đổi chữ hoa chữ thường.

<?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', ...) là cách thường dùng để biến các chuỗi từ biểu mẫu hay từ explode() thành số nguyên thật. Bạn cũng có thể viết intval(...), cú pháp first-class callable từ PHP 8.1, mà trình soạn thảo có thể tự gợi ý và kiểm tra.

Dùng closure với biến bên ngoài

Arrow function tự động nhìn thấy các biến xung quanh nó. Một function kiểu cũ cần use để đưa chúng vào. Cả hai đều được giải thích ở trang hàm ẩn danh.

<?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 kèm khóa

Với một mảng duy nhất, array_map giữ nguyên khóa, kể cả khóa chuỗi. Nhưng callback chỉ nhận được giá trị. Để nhận cả khóa, hãy truyền array_keys($array) làm mảng thứ hai: khi đó callback được gọi với một phần tử từ mỗi mảng.

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

Hãy để ý kết quả thứ hai: ngay khi bạn truyền nhiều hơn một mảng, các khóa bị thay bằng 0, 1, 2. Đó là lý do dòng cuối dùng array_combine() để dựng lại chúng.

Map nhiều mảng cùng lúc

Mỗi mảng thêm vào trở thành một đối số thêm cho callback, được ghép theo vị trí. Nếu các mảng có độ dài khác nhau, mảng ngắn hơn được bù bằng 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));

Truyền null làm callback sẽ bỏ qua bước gọi hàm và ghép các mảng thành từng cặp:

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

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

array_map vs array_walk vs foreach

array_map tạo một mảng mới. array_walk thay đổi chính mảng bạn truyền vào thông qua tham chiếu, và đưa khóa cho callback làm đối số thứ hai. Một foreach làm được cả hai việc, lại còn có thể bỏ qua phần tử hoặc dừng sớm bằng 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);

Dùng array_map khi mỗi phần tử biến thành đúng một phần tử mới. Nếu bạn còn cần bỏ bớt một số phần tử, hãy kết hợp với array_filter, hoặc viết một vòng lặp foreach.

Lỗi thường gặp: thứ tự đối số

array_map nhận callback trước và mảng sau. Hàm anh em của nó là array_filter lại nhận theo thứ tự ngược lại, nên rất dễ nhầm:

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

Đảo thứ tự hai đối số khiến PHP 8 ném ra TypeError, vì một mảng bình thường không phải callback hợp lệ:

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

PHP dừng với thông báo:

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

Đổi lại thứ tự hai đối số là khối code chạy được.