PHP array_map(): применить функцию к каждому элементу

array_map($callback, $array) вызывает $callback для каждого элемента $array и возвращает новый массив с результатами. Сначала идёт колбэк, потом массив, а исходный массив остаётся без изменений.

<?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.

Встроенная функция в качестве колбэка

Передайте имя встроенной функции строкой. Это самый короткий способ привести в порядок весь массив: обрезать пробелы у каждого значения, превратить строки в целые числа или сменить регистр.

<?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, который редактор умеет автодополнять и проверять.

Замыкание с внешними переменными

Стрелочная функция видит окружающие переменные автоматически. Классической 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 сохраняет ключи, в том числе строковые. Но колбэк получает только значение. Чтобы получить и ключ, передайте array_keys($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));

Обратите внимание на второй результат: как только передано больше одного массива, ключи заменяются на 0, 1, 2. Поэтому последняя строка восстанавливает их через array_combine().

Несколько массивов сразу

Каждый дополнительный массив становится дополнительным аргументом колбэка, элементы сопоставляются по позиции. Если длины массивов разные, короткие дополняются значениями 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 вместо колбэка, функция не вызывается, а массивы склеиваются попарно:

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

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

array_map, array_walk и foreach

array_map строит новый массив. array_walk меняет переданный массив через ссылку и даёт колбэку ключ вторым аргументом. 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 принимает сначала колбэк, а потом массив. Её соседка array_filter принимает их в обратном порядке, и их легко перепутать:

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

Если поменять их местами, PHP 8 выбросит TypeError, потому что обычный массив не является допустимым колбэком:

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

Верните аргументы на место, и блок заработает.