Преобразование коллекции в PHP

Преобразование берёт коллекцию, например массив, и строит из неё новую коллекцию. Исходная при этом не меняется.

В PHP для массивов есть большое семейство готовых функций: array_map применяет функцию к каждому элементу, array_merge соединяет массивы, array_combine склеивает ключи со значениями, array_column выбирает одну позицию из каждой строки, а implode превращает массив в текст. Там, где готовой функции не находится, задачу решает короткий цикл foreach.

Один и тот же массив PHP работает и как список, и как хранилище ключ:значение. У простого списка ключи 0, 1, 2 и так далее; у ассоциативного массива ключи выбираете вы. И тот и другой хранят свои элементы в порядке добавления, и оба используются на этой странице.

Операция map применяет одну и ту же функцию к каждому элементу и собирает ответы в новый массив той же длины. Например, она может превратить 1, 2, 3 в 3, 6, 9.

В PHP именно это делает array_map: она принимает сначала функцию, а затем массив, и возвращает новый массив. Функцией часто служит короткая стрелочная функция вида fn($x) => $x * 3.

array_map никогда не меняет исходный массив. Она строит и возвращает новый, так что у вас остаются оба.

array_map вызывает стрелочную функцию для каждого элемента и возвращает новый массив. Здесь она умножает каждое число на 3, а implode выводит новый массив как 3, 6, 9.

Иногда важна и позиция элемента. foreach даёт и ключ, и значение, а в простом списке ключи — это позиции 0, 1, 2. Здесь каждое значение умножается на свой индекс, поэтому программа выводит 0, 2, 6.

Иногда часть результатов нужно отбросить. Верните для них null, а затем уберите значения null с помощью array_filter. Осторожно: array_filter сохраняет исходные ключи, поэтому у отфильтрованного массива остаются ключи 0 и 2, и json_encode выводит его как {"0":3,"2":9}. array_values переиндексирует его в аккуратный список: [3,9].

Чтобы изменить ключи ассоциативного массива, преобразуйте ключи и склейте их обратно со значениями. array_keys даёт все ключи, array_map('strtoupper', ...) переводит их в верхний регистр, а array_combine сопоставляет новые ключи со старыми значениями.

Чтобы изменить значения, сохраните ключи и вычислите новые значения. array_map умеет проходить по двум массивам одновременно — здесь по ключам и по значениям, — поэтому каждое новое значение равно старому значению плюс длина его ключа: 1 + strlen("key1") даёт 5.

Zip берёт два массива и сопоставляет их элементы по позиции: первый с первым, второй со вторым и так далее.

В PHP для этого есть классический приём: array_map(null, $a, $b). Когда обратный вызов равен null и передано несколько массивов, array_map строит массив пар. Обратите внимание, что она не останавливается на более коротком массиве — недостающие места заполняются значением null, — поэтому объединяйте массивы одинаковой длины или сначала обрежьте более длинный с помощью array_slice.

С null в качестве обратного вызова array_map сопоставляет два массива в массив двухэлементных массивов. json_encode показывает весь результат в одну строку.

Сами пары нужны не всегда. Передайте array_map настоящий обратный вызов и оба массива, и она вызовет функцию с одним элементом из каждого. ucfirst переводит первую букву названия животного в верхний регистр.

Unzip — обратная операция: один массив пар превращается в два массива. array_column собирает элемент с одной позиции из каждой пары: позиция 0 даёт слова, а позиция 1 — числа.

Associate строит ассоциативный массив из списка. Каждый элемент даёт один ключ и одно значение. Массив не может дважды содержать один и тот же ключ, поэтому, если два элемента дают одинаковый ключ, побеждает последний.

Приём — обычный цикл foreach: начните с пустого массива и для каждого элемента выполните присваивание $result[$key] = $value. PHP сохраняет элементы в том порядке, в котором они были добавлены.

Сам элемент становится ключом, а значение вычисляется из него. Здесь слова — ключи, а их длины — значения, поэтому программа выводит {"one":3,"two":3,"three":5}.

Элемент становится значением, а ключ вычисляется из него. Здесь ключ — первая буква в верхнем регистре, взятая через $word[0] и strtoupper. И two, и three начинаются с T, поэтому three заменяет two и в массиве остаётся только два элемента.

Из элемента можно вычислить и ключ, и значение. Здесь ключ — первая буква, а значение — длина слова. Снова побеждает более поздний элемент с ключом T.

Иногда один элемент несёт обе части. explode разбивает полное имя по пробелу в массив слов, а присваивание списку [$first, $last] = ... распаковывает его. Фамилия становится ключом, а имя — значением.

Flatten превращает вложенную коллекцию, например массив массивов, в один плоский массив со всеми элементами по порядку.

В PHP array_merge соединяет любое количество массивов, а три точки распаковывают внутренние массивы в вызов: array_merge(...$nested).

Три точки превращают array_merge(...$numberSets) в array_merge([1, 2, 3], [4, 5, 6]). Два внутренних массива по три числа становятся одним массивом из шести.

Flat map сначала берёт массив из каждого элемента, а затем соединяет все эти массивы вместе. array_map читает свойство $values каждого контейнера, а array_merge с тремя точками склеивает три массива в один.

Часто коллекцию нужно показать как читаемый текст, например с запятыми между элементами.

В PHP implode принимает разделитель и массив и возвращает одну строку. Числа превращаются в текст автоматически. Дополнения — префикс, постфикс, ограничение или преобразование — делаются конкатенацией строк, с помощью array_slice или array_map перед соединением.

implode ставит ", " между словами и возвращает одну строку.

Префикс и постфикс — это просто текст вокруг соединённого результата. В PHP их добавляют оператором ..

Для длинного массива может понадобиться показать только несколько первых элементов. range(1, 100) строит числа, array_slice($numbers, 0, 10) берёт первые 10, а "...>" добавляется в конец, чтобы показать, что остальные элементы отброшены. implode сам превращает числа в текст.

Чтобы изменить каждый элемент перед соединением, сначала преобразуйте массив с помощью array_map, а затем примените implode к результату. Здесь каждое слово становится "Element: " плюс само слово в верхнем регистре.