PHP: полный мануал с примерами, функциями и ООП

PHP 4+ · standard

array(key => value, ...) → array; короткая форма: [key => value, ...]

Собрать несколько связанных значений в одно: список товаров или запись с именованными полями.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Это конструкция языка, а не обычная функция: её нельзя вызвать через строковое имя функции. array(...) и [...] — две записи одного значения; короткая форма доступна с PHP 5.4. = сохраняет массив в переменной, [0] справа читает элемент с ключом 0.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: ключ, значение и порядок массива.

<?php
$drinks = array('чай', 'кофе');
$firstDrink = $drinks[0];
$secondDrink = $drinks[1];
echo 'В заказе: ', $firstDrink, ' и ', $secondDrink, ".\n";
$drinks[1] = 'вода';
echo 'После изменения: ', $drinks[0], ' и ', $drinks[1], ".\n";

В заказе: чай и кофе.
После изменения: чай и вода.

<?php
$product = [
    'sku' => '0041',
    'stock' => 2,
    'stock' => 0,
];
echo $product['sku'], ':', $product['stock'], "\n";
$queue = [5 => 'paid', 'packed'];
echo json_encode($queue), "\n";

0041:0
{"5":"paid","6":"packed"}

Нюансы и выбор. Вложенный массив создаётся теми же скобками, но уровень вложенности не добавляет проверку схемы. Строка-ключ "8" обычно становится int 8; "08" сохраняет строковую форму. Не путайте максимальный числовой ключ с количеством элементов. Для отрицательных автоматических ключей есть изменение PHP 8.3; оно подробно разобрано в правилах ключей и добавления. Массивы из результата SQL или json_decode используют те же правила, что литерал.

Сравните: list, array_fill, range, count. Выбрать операцию по задаче.

• PHP: function.array

PHP 4+ · standard

list($first, $second, ...) = $array; также [$first, $second] = $array

Разложить строку отчёта в несколько понятных переменных одним присваиванием.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

list($sku, $stock) = $row; читает row[0] и row[1]. Запись в квадратных скобках — тот же разбор, не создание нового списка слева. Сначала убедитесь, что строка имеет нужную форму.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: ключ, значение и порядок массива.

<?php
$row = ['0041', 3];
list($sku, $quantity) = $row;
$label = 'Артикул ' . $sku . ': ' . $quantity . ' упаковки';
echo $label, "\n";
[$sameSku, $sameQuantity] = $row;
echo 'Короткая запись: ', $sameSku, ', ', $sameQuantity, "\n";

Артикул 0041: 3 упаковки
Короткая запись: 0041, 3

<?php
$row = ['stock' => 0, 'sku' => '0072'];
['sku' => $sku, 'stock' => $stock] = $row;
echo $sku, ':', $stock, "\n";
$slots = [4, 9];
[&$first] = $slots;
$first = 7;
unset($first);
echo json_encode($slots), "\n";

0072:0
[7,9]

<?php
set_error_handler(function ($severity, $message) {
    echo $severity === E_WARNING ? "Предупреждение\n" : "Другая диагностика\n";
    return true;
});
try {
    [$sku, $stock] = ['0041'];
    var_dump($stock);
} finally {
    restore_error_handler();
}

Предупреждение
NULL

Нюансы и выбор. Допускается вложенная распаковка и использование в foreach. Она выбирает значения, но не проверяет их типы и не ищет похожие имена. ArrayAccess означает специальный объект с договором чтения по ключу; обычный stdClass им не является. Ссылки и вложенность требуют внимательного владения данными; явные обращения $row["sku"] часто яснее для одной колонки. Не используйте трюки с порядком присваивания нескольким $array[] как переносимый договор между старыми версиями PHP.

Сравните: array, array_column, extract. Выбрать операцию по задаче.

• PHP: function.list

PHP 4+ · standard

range(string|int|float $start, string|int|float $end, int|float $step = 1): array

Создать ограниченную последовательность: номера страниц, интервалы измерения или ASCII-метки.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В range(1, 5, 2) числа означают начало 1, границу 5 и шаг 2. Функция сразу создаёт все элементы; цикл или генератор позволяет выдавать их постепенно.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
echo json_encode(range(1, 5, 2)), "\n";
echo json_encode(range(5, 1, 2)), "\n";
echo json_encode(range(1, 6, 2)), "\n";

[1,3,5]
[5,3,1]
[1,3,5]

<?php
$sections = range('A', 'C');
echo implode(',', $sections), "\n";
$pages = range(1, 3);
foreach ($pages as $page) {
    echo '/catalog?page=', $page, "\n";
}

A,B,C
/catalog?page=1
/catalog?page=2
/catalog?page=3

<?php
foreach ([0, -1] as $step) {
    try {
        range(1, 3, $step);
    } catch (ValueError) {
        echo "Неверный шаг\n";
    }
}
echo json_encode(range(3, 1, -1)), "\n";

Неверный шаг
Неверный шаг
[3,2,1]

<?php
echo json_encode(range('1', '3')), "\n";
echo json_encode(range('10', '12')), "\n";
echo json_encode(range(10, 12)), "\n";
try { range(1, 2, 3); }
catch (ValueError) { echo "Шаг больше диапазона\n"; }

["1","2","3"]
[10,11,12]
[10,11,12]
Шаг больше диапазона

Нюансы и выбор. Память растёт с количеством созданных элементов: не передавайте пользовательский верхний предел без ограничения. С PHP 8.3 изменены правила строковых границ; нельзя считать, что любые две строки всегда дадут тот же тип элементов. Для числовых данных сначала явно проверьте и задайте числовой тип. Пустая строка предупреждает и трактуется как 0; многобайтовая нечисловая граница, смесь числа с приводимой строкой и нечисловые строки с дробным шагом тоже могут предупреждать. Float-диапазон использует двоичную арифметику, поэтому денежные шаги лучше задавать целыми копейками.

Сравните: array_fill, array_fill_keys, array_map. Выбрать операцию по задаче.

• PHP: function.range

PHP 4.2+ · standard

array_fill(int $start_index, int $count, mixed $value): array

Заранее подготовить одинаковые начальные значения: например четыре свободных места в расписании.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$slots = array_fill(9, 3, 'свободно');
$slots[10] = 'записана Анна';
foreach ($slots as $hour => $state) {
    echo $hour, ':00 — ', $state, "\n";
}

9:00 — свободно
10:00 — записана Анна
11:00 — свободно

<?php
echo json_encode(array_fill(-2, 3, 0)), "\n";
echo json_encode(array_fill(0, 0, 'free')), "\n";
try {
    array_fill(0, -1, 'free');
} catch (ValueError) {
    echo "Количество не может быть отрицательным\n";
}

{"-2":0,"-1":0,"0":0}
[]
Количество не может быть отрицательным

<?php
$prototype = (object) ['stock' => 0];
$rows = array_fill(0, 2, $prototype);
$rows[0]->stock = 3;
echo $rows[1]->stock, "\n";

3

Нюансы и выбор. Для списков обычно начинайте с 0. Если передать один объект, его состояние будет общим; это не относится к простой замене строковых ячеек первого опыта. При большом числе строк разумнее создавать данные порциями по мере необходимости.

Сравните: array_fill_keys, range, array_pad. Выбрать операцию по задаче.

• PHP: function.array-fill

PHP 5.2+ · standard

array_fill_keys(array $keys, mixed $value): array

Подготовить словарь с известными ключами, например счётчики заказов по статусам.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$counts = array_fill_keys(['new', 'paid', 'sent'], 0);
$today = ['paid', 'new', 'paid'];
foreach ($today as $status) {
    $counts[$status]++;
}
foreach ($counts as $status => $quantity) {
    echo $status, ': ', $quantity, ' заказа', "\n";
}

new: 1 заказа
paid: 2 заказа
sent: 0 заказа

<?php
$allowed = array_fill_keys(['A', 'B', 'A'], true);
var_dump(isset($allowed['B']));
var_dump(isset($allowed['C']));
echo count($allowed), "\n";

bool(true)
bool(false)
2

Нюансы и выбор. Это не проверка типа ключей. Числовые строки могут преобразоваться в int и совпасть с числовым ключом. Набор для множества повторных проверок может быть удобнее повторного сканирования in_array, но требует отдельной памяти и согласованной политики ключей.

Сравните: array_fill, array_combine, array_key_exists, in_array. Выбрать операцию по задаче.

• PHP: function.array-fill-keys

PHP 5+ · standard

array_combine(array $keys, array $values): array

Связать заголовки и одну строку данных: превратить колонки CSV в именованные поля.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: параметры и результат вызова.

<?php
$headers = ['sku', 'quantity', 'priceKopecks'];
$cells = ['0041', 3, 150];
$row = array_combine($headers, $cells);
$lineTotal = $row['quantity'] * $row['priceKopecks'];
echo 'Товар ', $row['sku'], ': ', $row['quantity'], ' × ', $row['priceKopecks'], ' = ', $lineTotal, ' коп.', "\n";

Товар 0041: 3 × 150 = 450 коп.

<?php
function mapImportRow(array $headers, array $cells): array
{
    if (count($headers) !== count($cells)) {
        throw new UnexpectedValueException('Число колонок не совпало');
    }
    if (count(array_unique($headers)) !== count($headers)) {
        throw new UnexpectedValueException('Повтор заголовка');
    }
    return array_combine($headers, $cells);
}
try {
    mapImportRow(['sku', 'stock'], ['0041']);
} catch (UnexpectedValueException $error) {
    echo $error->getMessage(), "\n";
}
echo json_encode(array_combine(['sku', 'sku'], ['A', 'B'])), "\n";

Число колонок не совпало
{"sku":"B"}

Нюансы и выбор. Перед этой операцией проверьте допустимые имена колонок и их уникальность. После неё остаётся преобразование и проверка значений: текст из CSV не станет автоматически корректной ценой. Нельзя считать успешный combine доказательством полного совпадения формата поставщика.

Сравните: array_column, array_fill_keys, array_merge. Выбрать операцию по задаче.

• PHP: function.array-combine

PHP 4+ · standard

compact(array|string $var_name, array|string ...$var_names): array

Собрать уже существующие локальные переменные в массив для передачи шаблону.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

compact("title") получает имя, ищет локальную $title и создаёт поле title. В compact($title) содержимое title само стало бы искомым именем — это другая операция.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: параметры и результат вызова.

<?php
$title = 'Каталог';
$total = 2;
$view = compact('title', 'total');
echo $view['title'], ': найдено ', $view['total'], ' товара', "\n";
$title = 'Архив';
echo 'Сохранённый заголовок: ', $view['title'], "\n";

Каталог: найдено 2 товара
Сохранённый заголовок: Каталог

<?php
function viewData(): array
{
    $title = 'Orders';
    $notice = null;
    return compact(['title', ['notice']]);
}
echo json_encode(viewData()), "\n";

{"title":"Orders","notice":null}

Нюансы и выбор. Связь со строковыми именами менее заметна инструментам переименования, чем ["title" => $title]. Не передавайте произвольный список имён от посетителя: он не должен выбирать, какие локальные данные уйдут наружу. Особенность dynamic variable lookup внутри функций мешает использовать так имена суперглобальных массивов; явно выбирайте необходимые безопасные поля.

Сравните: extract, array, array_combine. Выбрать операцию по задаче.

• PHP: function.compact

PHP 4+ · standard

extract(array &$array, int $flags = EXTR_OVERWRITE, string $prefix = ""): int

Создать локальные переменные из заранее доверенного массива — в основном для границы старого шаблонизатора.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

extract изменяет текущую область переменных. Именно поэтому нельзя распаковывать им напрямую $_GET, $_POST или ответ чужого API. В новом коде явные обращения к полям или list с перечисленными ключами обычно делают зависимость понятнее.

<?php
$title = 'Каталог';
$view = ['title' => 'Склад', 'stock' => 0];
$created = extract($view, EXTR_SKIP);
echo 'Заголовок: ', $title, "\n";
echo 'Остаток: ', $stock, ' шт.', "\n";
echo 'Создано переменных: ', $created, "\n";

Заголовок: Каталог
Остаток: 0 шт.
Создано переменных: 1

<?php
$data = ['sku' => '0041', 0 => 'first'];
$created = extract($data, EXTR_PREFIX_ALL, 'view');
echo $view_sku, ':', $view_0, ':', $created, "\n";

0041:first:2

<?php
$data = ['stock' => 2];
extract($data, EXTR_PREFIX_ALL | EXTR_REFS, 'view');
$view_stock = 3;
unset($view_stock);
echo $data['stock'], "\n";

3

Нюансы и выбор. EXTR_IF_EXISTS не проверяет значение и может перезаписать важный локальный флаг. EXTR_SKIP тоже разрешает создание новых имён. Для шаблона ограничьте отдельной функцией область видимости, заранее сформируйте данные и перечислите разрешённые поля. Наличие этой функции в полном справочнике не означает рекомендацию массовой распаковки пользовательского ввода.

Сравните: compact, list, array_intersect_key. Выбрать операцию по задаче.

• PHP: function.extract

PHP 8.4+ · standard

array_all(array $array, callable $callback): bool

Для следующих четырёх функций нужен PHP 8.4+. Callback принимает значение и ключ и возвращает bool; all/any возвращают общий bool, find — выбранное значение, find_key — его ключ. Важно заранее решить, какая из этих четырёх форм результата нужна дальше.

Проверить, что каждый элемент подходит: например все выбранные товары доступны.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Callback — функция, переданная другой функции. Здесь PHP вызывает её для очередного элемента: первый параметр получает значение, второй — ключ. function ($stock, $sku) { return $stock > 0; } объявляет такую проверку; return отдаёт bool. Короткая fn(...) => выражение автоматически возвращает результат одного выражения.

Для этого примера: передача функции как значения.

<?php
$stocks = ['A' => 2, 'B' => 0, 'C' => 4];
$ready = array_all($stocks, function ($stock, $sku) {
    echo $sku, "\n";
    return $stock > 0;
});
var_dump($ready);

A
B
bool(false)

<?php
// PHP 8.4+.
$cart = [['sku' => 'A', 'quantity' => 1], ['sku' => 'B', 'quantity' => 2]];
$valid = $cart !== [] && array_all($cart, function ($row, $key) {
    return is_int($row['quantity']) && $row['quantity'] > 0;
});
if ($valid) {
    echo "Корзина принята\n";
    foreach ($cart as $row) {
        echo $row['sku'], ': ', $row['quantity'], ' шт.', "\n";
    }
}
$emptyPassesRule = array_all([], function ($value, $key) { return false; });
echo 'Правило каждого элемента для пустого массива: ', $emptyPassesRule ? 'выполнено' : 'нарушено', "\n";

Корзина принята
A: 1 шт.
B: 2 шт.
Правило каждого элемента для пустого массива: выполнено

Нюансы и выбор. Для пустого массива результат true: нет элемента, нарушающего условие. Поэтому требование «корзина не пуста и каждая позиция корректна» состоит из двух проверок. Здесь форма строк уже известна; реальный API сначала проверяют на обязательные ключи. Для PHP 8.2/8.3 тот же договор выражается foreach с ранним return из функции; не стройте array_filter всех элементов, если нужен только первый ответ. Число вызовов callback зависит от места решающего элемента. Не меняйте проверяемый массив из callback и не прячьте в проверке отправку запросов.

Сравните: array_any, array_find, array_find_key, array_filter. Выбрать операцию по задаче.

• PHP: function.array-all

PHP 8.4+ · standard

array_any(array $array, callable $callback): bool

Узнать, есть ли хотя бы один подходящий элемент: например доступный склад.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Callback — функция, переданная другой функции. Здесь PHP вызывает её для очередного элемента: первый параметр получает значение, второй — ключ. function ($stock, $sku) { return $stock > 0; } объявляет такую проверку; return отдаёт bool. Короткая fn(...) => выражение автоматически возвращает результат одного выражения.

Для этого примера: передача функции как значения.

<?php
$stocks = ['north' => 0, 'south' => 2, 'west' => 5];
var_dump(array_any($stocks, function ($stock, $warehouse) {
    echo $warehouse, "\n";
    return $stock > 0;
}));

north
south
bool(true)

<?php
// PHP 8.4+.
$orders = [['id' => 41, 'late' => false], ['id' => 42, 'late' => true]];
$hasLate = array_any($orders, function ($order, $key) {
    return $order['late'] === true;
});
if ($hasLate) {
    echo "Показать предупреждение: есть просроченные заказы\n";
}
$hasInEmptyList = array_any([], function ($value, $key) { return true; });
if (!$hasInEmptyList) {
    echo "В пустом списке подходящих заказов нет\n";
}

Показать предупреждение: есть просроченные заказы
В пустом списке подходящих заказов нет

Нюансы и выбор. Пустой массив даёт false: подходящего элемента нет. Метод нужен для ответа да/нет; чтобы получить сам просроченный заказ, используйте array_find. Для PHP 8.2/8.3 тот же договор выражается foreach с ранним return из функции; не стройте array_filter всех элементов, если нужен только первый ответ. Число вызовов callback зависит от места решающего элемента. Не меняйте проверяемый массив из callback и не прячьте в проверке отправку запросов.

Сравните: array_all, array_find, array_find_key, array_filter. Выбрать операцию по задаче.

• PHP: function.array-any

PHP 8.4+ · standard

array_find(array $array, callable $callback): mixed

Получить первое подходящее значение, например товар с ненулевым остатком.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Callback — функция, переданная другой функции. Здесь PHP вызывает её для очередного элемента: первый параметр получает значение, второй — ключ. function ($stock, $sku) { return $stock > 0; } объявляет такую проверку; return отдаёт bool. Короткая fn(...) => выражение автоматически возвращает результат одного выражения.

Для этого примера: передача функции как значения.

<?php
$stocks = ['A' => 0, 'B' => 2, 'C' => 4];
$stock = array_find($stocks, fn($value, $key) => $value > 0);
var_dump($stock);

int(2)

<?php
// PHP 8.4+.
$products = [['sku' => 'A', 'stock' => 0], ['sku' => 'B', 'stock' => 3]];
$product = array_find($products, function ($row, $key) {
    return $row['stock'] > 0;
});
if ($product !== null) {
    echo 'Первый доступный товар: ', $product['sku'], "\n";
    echo 'Можно предложить: ', $product['stock'], ' шт.', "\n";
}
$nullValue = array_find(['A' => null], function ($value, $key) { return $key === 'A'; });
$absentValue = array_find([], function ($value, $key) { return true; });
echo 'Тип найденного null: ', get_debug_type($nullValue), "\n";
echo 'Тип результата отсутствующего совпадения: ', get_debug_type($absentValue), "\n";

Первый доступный товар: B
Можно предложить: 3 шт.
Тип найденного null: null
Тип результата отсутствующего совпадения: null

Нюансы и выбор. Последние два результата одинаковы: найденный null неотличим от отсутствия результата по одному возвращённому значению. Если null допустим в данных, найдите ключ через array_find_key. Форма строк products здесь заранее задана. Для PHP 8.2/8.3 тот же договор выражается foreach с ранним return из функции; не стройте array_filter всех элементов, если нужен только первый ответ. Число вызовов callback зависит от места решающего элемента. Не меняйте проверяемый массив из callback и не прячьте в проверке отправку запросов.

Сравните: array_all, array_any, array_find_key, array_filter. Выбрать операцию по задаче.

• PHP: function.array-find

PHP 8.4+ · standard

array_find_key(array $array, callable $callback): mixed

Найти ключ первого элемента по правилу, чтобы затем обратиться именно к нему.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Callback — функция, переданная другой функции. Здесь PHP вызывает её для очередного элемента: первый параметр получает значение, второй — ключ. function ($stock, $sku) { return $stock > 0; } объявляет такую проверку; return отдаёт bool. Короткая fn(...) => выражение автоматически возвращает результат одного выражения.

Для этого примера: передача функции как значения.

<?php
$stocks = ['A' => 0, 'B' => 2, 'C' => 4];
$sku = array_find_key($stocks, fn($value, $key) => $value > 0);
echo $sku, "\n";

B

<?php
// PHP 8.4+.
$values = [0 => null, 1 => 'ready'];
$key = array_find_key($values, function ($value, $key) {
    return $value === null;
});
if ($key !== null) {
    $values[$key] = 'waiting';
    echo 'Незаполненная позиция ', $key, ' получила статус ', $values[$key], "\n";
}
$missing = array_find_key([], function ($value, $key) { return true; });
if ($missing === null) {
    echo "В пустом списке нечего изменять\n";
}

Незаполненная позиция 0 получила статус waiting
В пустом списке нечего изменять

Нюансы и выбор. Проверка !== null сохраняет успешный ключ 0. У PHP-массива null не хранится как отдельный тип ключа: он преобразуется; поэтому null здесь пригоден как маркер отсутствия. Документированный тип результата mixed; фактический найденный ключ — int или string. Для PHP 8.2/8.3 тот же договор выражается foreach с ранним return из функции; не стройте array_filter всех элементов, если нужен только первый ответ. Число вызовов callback зависит от места решающего элемента. Не меняйте проверяемый массив из callback и не прячьте в проверке отправку запросов.

Сравните: array_all, array_any, array_find, array_filter. Выбрать операцию по задаче.

• PHP: function.array-find-key

PHP 7.3+ · standard

array_key_first(array $array): int|string|null

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

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

<?php
$stocks = ['B' => 2, 'A' => 0];
$sku = array_key_first($stocks);
if ($sku !== null) {
    echo "Товар ", $sku, ": ", $stocks[$sku], " шт.\n";
}

Товар B: 2 шт.

<?php
$stocks = ['B' => 2, 'A' => 0];
next($stocks);
array_key_first($stocks);
echo key($stocks), "\n";
var_dump(array_key_first([]));

A
NULL

Нюансы и выбор. Ключ 0 или пустая строка — успешный результат; проверяйте !== null, а не if($key). Не создавайте весь array_keys ради единственного граничного ключа. reset/end тоже дают граничное значение, но меняют указатель; array_shift/array_pop ещё и удаляют элемент.

Сравните: array_key_last, array_first, array_last, reset, end. Выбрать операцию по задаче.

• PHP: function.array-key-first

PHP 7.3+ · standard

array_key_last(array $array): int|string|null

Прочитать последний ключ в порядке массива, не удаляя элемент и не переставляя внутренний указатель.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

<?php
$stocks = ['B' => 2, 'A' => 0];
$sku = array_key_last($stocks);
if ($sku !== null) {
    echo "Товар ", $sku, ": ", $stocks[$sku], " шт.\n";
}

Товар A: 0 шт.

<?php
$stocks = ['B' => 2, 'A' => 0];
next($stocks);
array_key_last($stocks);
echo key($stocks), "\n";
var_dump(array_key_last([]));

A
NULL

Нюансы и выбор. Ключ 0 или пустая строка — успешный результат; проверяйте !== null, а не if($key). Не создавайте весь array_keys ради единственного граничного ключа. reset/end тоже дают граничное значение, но меняют указатель; array_shift/array_pop ещё и удаляют элемент.

Сравните: array_key_first, array_first, array_last, reset, end. Выбрать операцию по задаче.

• PHP: function.array-key-last

PHP 8.5+ · standard

array_first(array $array): mixed

Прочитать первое значение в порядке массива, не удаляя элемент и не переставляя внутренний указатель.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

<?php
$stocks = ['B' => 2, 'A' => 0];
$quantity = array_first($stocks);
echo "На границе списка: ", $quantity, " шт.\n";
if ($quantity === 0) { echo "Нужно пополнение\n"; }

На границе списка: 2 шт.

<?php
$stocks = ['B' => 2, 'A' => 0];
next($stocks);
array_first($stocks);
echo key($stocks), "\n";
var_dump(array_first([]));

A
NULL

Нюансы и выбор. Null может быть настоящим значением непустого массива. Если важно отличить его от пустоты, проверьте $array !== [] либо сначала получите соответствующий ключ. В PHP 8.2–8.4 значение можно прочитать по array_key_first, проверив ключ на null. reset/end тоже дают граничное значение, но меняют указатель; array_shift/array_pop ещё и удаляют элемент.

Сравните: array_key_first, array_key_last, array_last, reset, end. Выбрать операцию по задаче.

• PHP: function.array-first

PHP 8.5+ · standard

array_last(array $array): mixed

Прочитать последнее значение в порядке массива, не удаляя элемент и не переставляя внутренний указатель.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

<?php
$stocks = ['B' => 2, 'A' => 0];
$quantity = array_last($stocks);
echo "На границе списка: ", $quantity, " шт.\n";
if ($quantity === 0) { echo "Нужно пополнение\n"; }

На границе списка: 0 шт.
Нужно пополнение

<?php
$stocks = ['B' => 2, 'A' => 0];
next($stocks);
array_last($stocks);
echo key($stocks), "\n";
var_dump(array_last([]));

A
NULL

Нюансы и выбор. Null может быть настоящим значением непустого массива. Если важно отличить его от пустоты, проверьте $array !== [] либо сначала получите соответствующий ключ. В PHP 8.2–8.4 значение можно прочитать по array_key_last, проверив ключ на null. reset/end тоже дают граничное значение, но меняют указатель; array_shift/array_pop ещё и удаляют элемент.

Сравните: array_key_first, array_key_last, array_first, reset, end. Выбрать операцию по задаче.

• PHP: function.array-last

PHP 4.0.6+ · standard

key_exists(string|int|float|bool|resource|null $key, array $array): bool

Узнать псевдоним array_key_exists в старом коде: договор проверки ключа полностью тот же.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

<?php
$saved = ['comment' => 'Позвонить заранее'];
$patch = ['comment' => null];
if (key_exists('comment', $patch)) {
    $saved['comment'] = $patch['comment'];
}
echo 'Комментарий: ', $saved['comment'] ?? 'не указан', "\n";
$patch = [];
if (key_exists('comment', $patch)) {
    $saved['comment'] = $patch['comment'];
}
echo 'После пустой правки: ', $saved['comment'] ?? 'не указан', "\n";

Комментарий: не указан
После пустой правки: не указан

<?php
$payload = ['product' => ['stock' => 0]];
var_dump(key_exists('stock', $payload));
var_dump(key_exists('stock', $payload['product']));
echo $payload['product']['stock'], "\n";

bool(false)
bool(true)
0

Нюансы и выбор. Не заменяйте проверку наличия на empty: empty считает пустыми и 0, и "0", и false. Наличие поля не доказывает его тип и допустимость. В PHP 8.0 набор допустимых скалярных типов ключа расширен, но наиболее понятный контракт приложения — именованный строковый ключ или целочисленный индекс. В новом коде полное имя array_key_exists обычно читается яснее; иной производительности этот псевдоним не обещает.

Сравните: array_key_exists, in_array, array_keys. Выбрать операцию по задаче.

• PHP: function.key-exists

PHP 4+ · standard

array_count_values(array $array): array

Сосчитать частоту строковых кодов или целых значений, например заказы по статусам.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$statuses = ['new', 'paid', 'new'];
$counts = array_count_values($statuses);
foreach ($counts as $status => $quantity) {
    echo 'Статус ', $status, ': ', $quantity, "\n";
}
$waiting = $counts['new'] ?? 0;
echo 'Ожидают оплаты: ', $waiting, "\n";

Статус new: 2
Статус paid: 1
Ожидают оплаты: 2

<?php
echo json_encode(array_count_values([1, '1', '01'])), "\n";
$rows = [['status' => 'paid'], ['status' => 'new'], ['status' => 'paid']];
echo json_encode(array_count_values(array_column($rows, 'status'))), "\n";

{"1":2,"01":1}
{"paid":2,"new":1}

Нюансы и выбор. Для точного разделения разных типов задайте собственный ключ с меткой типа или используйте иной формат агрегации. Не приводите все входы к строке без договора: null и пустая строка могут начать означать одно и то же. Для сумм по категориям потребуется array_reduce или обычный foreach, а не подсчёт повторов.

Сравните: count, array_column, array_reduce, array_unique. Выбрать операцию по задаче.

• PHP: function.array-count-values

PHP 4+ · standard

array_flip(array $array): array

Поменять направление уникального соответствия: из ID→код получить код→ID.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$codes = [41 => 'A', 72 => 'B'];
$stockById = [41 => 0, 72 => 5];
$idByCode = array_flip($codes);
$requestedCode = 'B';
$id = $idByCode[$requestedCode];
echo 'Код ', $requestedCode, ' → ID ', $id, "\n";
echo 'Доступно: ', $stockById[$id], ' шт.', "\n";

Код B → ID 72
Доступно: 5 шт.

<?php
$codes = [41 => 'A', 72 => 'A'];
echo json_encode(array_flip($codes)), "\n";
echo json_encode(array_flip(array_flip($codes))), "\n";

{"A":72}
{"72":"A"}

Нюансы и выбор. Это не универсальное преобразование множества и не операция без потерь. Числовые строки могут стать целочисленными ключами; объекты, массивы, bool и null не являются допустимыми значениями для такого разворота. Для проверки принадлежности набору часто яснее array_fill_keys с фиксированным true.

Сравните: array_fill_keys, array_search, array_combine, array_unique. Выбрать операцию по задаче.

• PHP: function.array-flip

PHP 4+ · standard

sizeof(Countable|array $value, int $mode = COUNT_NORMAL): int

Прочитать псевдоним count: sizeof считает элементы, а не размер массива в байтах.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

<?php
$cart = ['A' => 3, 'B' => 1];
$lineCount = sizeof($cart);
$packageCount = array_sum($cart);
echo 'Разных позиций: ', $lineCount, "\n";
echo 'Упаковок к сборке: ', $packageCount, "\n";
if ($lineCount === 0) { echo "Корзина пуста\n"; }

Разных позиций: 2
Упаковок к сборке: 4

<?php
$groups = [['A', 'B'], ['C']];
echo sizeof($groups), "\n";
echo sizeof($groups, COUNT_RECURSIVE), "\n";
try {
    sizeof(null);
} catch (TypeError) {
    echo "Ожидался массив или Countable\n";
}

2
5
Ожидался массив или Countable

Нюансы и выбор. Обычный размер массива хранится в его структуре; не объявляйте count линейным обходом каждого элемента. Рекурсивный режим действительно обходит вложенные массивы, а пользовательский Countable может выполнять произвольную работу. Последний числовой ключ не равен количеству. Ссылки на собственный массив не превращают COUNT_RECURSIVE в безопасный универсальный обход графа. Название count обычно яснее: sizeof не измеряет память.

Сравните: count, array_sum, array_key_last. Выбрать операцию по задаче.

• PHP: function.sizeof

PHP 4.2+ · standard

array_change_key_case(array $array, int $case = CASE_LOWER): array

Нормализовать регистр строковых ключей, не меняя значения.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$received = ['Host' => 'mail.local', 'PORT' => 587, 7 => 'служебная отметка'];
$settings = array_change_key_case($received, CASE_LOWER);
echo 'Сервер: ', $settings['host'], ':', $settings['port'], "\n";
echo 'Числовой ключ 7: ', $settings[7], "\n";
echo 'Исходное имя Host: ', $received['Host'], "\n";

Сервер: mail.local:587
Числовой ключ 7: служебная отметка
Исходное имя Host: mail.local

<?php
$incoming = ['Token' => 'first', 'TOKEN' => 'second'];
$normalized = array_change_key_case($incoming, CASE_LOWER);
if (count($incoming) !== count($normalized)) {
    echo "Конфликт имён: требуется решение
";
}
echo json_encode(array_change_key_case(['mode' => 'test'], CASE_UPPER)), "
";

Конфликт имён: требуется решение
{"MODE":"test"}

Нюансы и выбор. Это не Unicode-преобразование русских ключей и не переименование вложенных полей. Предварительно решите, допустимы ли дубликаты без учёта регистра.

Сравните: array_keys, array_combine, array_replace. Выбрать операцию по задаче.

• PHP: function.array-change-key-case

PHP 4+ · standard

array_walk(array|object &$array, callable $callback, mixed $arg = null): true

Задача и маршрут результата. Нужно изменить каждую цену в существующем прайсе. Callback получает связь с элементом через &$price; += пишет в массив. Возврат самой array_walk — статус true, полезные цены остаются в prices.

Выполнить действие над каждым элементом или изменить его значение на месте.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Знак & перед первым параметром в справочной сигнатуре означает изменение переданного массива. В самом вызове & не пишут: передают переменную, а не временное выражение. Запись function ($value) { return ...; } создаёт функцию, которую операция вызывает для каждого элемента; return передаёт ей результат. В объявлении function (&$value, $key) ссылка относится к значению элемента; ключ остаётся данными для чтения.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: передача функции как значения; что означает ссылка &.

<?php
$labels = ['a' => 'red', 'b' => 'blue'];
$ok = array_walk($labels, function ($value, $key) {
    echo $key, '=', $value, "
";
});
var_dump($ok);

a=red
b=blue
bool(true)

<?php
$prices = ['p1' => 100, 'p2' => 250];
$status = array_walk($prices, function (&$price, $key, $fee) {
    $price += $fee;
}, 20);
if ($status) {
    echo "Упаковка включена в каждую цену\n";
}
foreach ($prices as $id => $price) {
    echo $id, ': ', $price, ' коп.', "\n";
}

Упаковка включена в каждую цену
p1: 120 коп.
p2: 270 коп.

Нюансы и выбор. Нельзя напрямую передать strtolower: walk передаёт также ключ, а многие встроенные функции отвергают лишние аргументы. Оберните нужный вызов в собственную функцию с подходящими параметрами. Возвращённый false не прекращает обход.

Сравните: array_map, array_walk_recursive, array_filter. Выбрать операцию по задаче.

• PHP: function.array-walk

PHP 5+ · standard

array_walk_recursive(array|object &$array, callable $callback, mixed $arg = null): true

Пройти листья вложенных массивов, например обработать текстовые поля разобранного JSON.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Знак & перед первым параметром в справочной сигнатуре означает изменение переданного массива. В самом вызове & не пишут: передают переменную, а не временное выражение. Запись function ($value) { return ...; } создаёт функцию, которую операция вызывает для каждого элемента; return передаёт ей результат. Лист — значение, которое уже не является массивом. use (&$sum) ниже даёт функции доступ к внешнему накопителю по ссылке.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: передача функции как значения; рекурсивный обход и путь.

<?php
$tree = ['left' => ['qty' => 2], 'right' => ['qty' => 3]];
array_walk_recursive($tree, function ($value, $key) {
    echo $key, '=', $value, "
";
});

qty=2
qty=3

Сначала выше показан каждый локальный ключ листа. Теперь меняем только строковые значения. &$value связывает параметр с листом; is_string проверяет тип, trim возвращает очищенную строку. Ни callback, ни его return не возвращают новое дерево.

<?php
$payload = ['customer' => ['name' => ' Анна '], 'items' => [['code' => ' p1 ', 'qty' => 2]]];
$status = array_walk_recursive($payload, function (&$value, $key) {
    if (is_string($value)) {
        $value = trim($value);
    }
});
echo 'Получатель: [', $payload['customer']['name'], "]\n";
echo 'Артикул: [', $payload['items'][0]['code'], "]\n";
echo 'Количество: ', $payload['items'][0]['qty'], "\n";
if ($status) { echo "Обход завершён\n"; }

Получатель: [Анна]
Артикул: [p1]
Количество: 2
Обход завершён

<?php
$sum = 0;
$rows = [['qty' => 2], ['qty' => 3]];
array_walk_recursive($rows, function ($value, $key) use (&$sum) {
    if ($key === 'qty') { $sum += $value; }
});
echo $sum, "
";

5

Нюансы и выбор. Повторяющийся ключ name в разных ветках не идентифицирует одно поле. Нельзя восстановить родительский путь из одного callback(value,key); передавайте путь в своей рекурсии. Глубина и размер недоверенного JSON ограничиваются ещё при приёме.

Сравните: array_walk, array_map, array_reduce. Выбрать операцию по задаче.

• PHP: function.array-walk-recursive

PHP 4.0.1+ · standard

array_merge_recursive(array ...$arrays): array

Собрать несколько значений одноимённых полей в общее дерево.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$firstSource = ['tag' => 'red'];
$secondSource = ['tag' => 'blue'];
$combined = array_merge_recursive($firstSource, $secondSource);
foreach ($combined['tag'] as $tag) {
    echo 'Предложенная метка: ', $tag, "\n";
}
echo 'Первый источник всё ещё: ', $firstSource['tag'], "\n";

Предложенная метка: red
Предложенная метка: blue
Первый источник всё ещё: red

<?php
$base = ['mail' => ['host' => 'local', 'port' => 25]];
$patch = ['mail' => ['port' => 587]];
echo json_encode(array_merge_recursive($base, $patch)), "\n";
echo json_encode(array_replace_recursive($base, $patch)), "\n";

{"mail":{"host":"local","port":[25,587]}}
{"mail":{"host":"local","port":587}}

Нюансы и выбор. Функция не удаляет дубликаты. Для объединения уникальных меток нужен отдельный шаг на известном уровне; для правки настроек обычно replace_recursive.

Сравните: array_merge, array_replace, array_replace_recursive. Выбрать операцию по задаче.

• PHP: function.array-merge-recursive

PHP 5.3+ · standard

array_replace_recursive(array $array, array ...$replacements): array

Применить частичный патч к вложенному словарю.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$base = ['mail' => ['host' => 'mail.local', 'port' => 25]];
$patch = ['mail' => ['port' => 587]];
$settings = array_replace_recursive($base, $patch);
echo 'Адрес для подключения: ', $settings['mail']['host'], ':', $settings['mail']['port'], "\n";
echo 'Исходный порт: ', $base['mail']['port'], "\n";

Адрес для подключения: mail.local:587
Исходный порт: 25

<?php
$base = ['roles' => ['reader','editor'], 'cache' => ['ttl' => 60]];
$patch = ['roles' => ['admin'], 'cache' => false];
echo json_encode(array_replace_recursive($base, $patch)), "\n";

{"roles":["admin","editor"],"cache":false}

Нюансы и выбор. Это не стандарт JSON Merge Patch: null не означает удаление, а числовые ключи списков обновляются по индексам. Для удаления и атомарных списков нужен явно описанный договор.

Сравните: array_merge, array_merge_recursive, array_replace. Выбрать операцию по задаче.

• PHP: function.array-replace-recursive

PHP 4+ · standard

array_splice(array &$array, int $offset, ?int $length = null, mixed $replacement = []): array

Задача и маршрут результата. Нужно заменить шаг процесса и отдельно сообщить, какой шаг удалён. Функция изменяет steps, а возвращает только удалённое; два результата должны быть прочитаны из разных мест.

Заменить участок списка и отдельно получить удалённые элементы.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Знак & перед первым параметром в справочной сигнатуре означает изменение переданного массива. В самом вызове & не пишут: передают переменную, а не временное выражение.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$steps = ['draft', 'review', 'done'];
$removed = array_splice($steps, 1, 1, ['approve']);
foreach ($removed as $step) {
    echo 'Удалённый шаг: ', $step, "\n";
}
echo "Текущий маршрут\n";
foreach ($steps as $position => $step) {
    echo $position + 1, '. ', $step, "\n";
}

Удалённый шаг: review
Текущий маршрут
1. draft
2. approve
3. done

<?php
$cells = ['id','name'];
array_splice($cells, 1, 0, [null]);
echo json_encode($cells), "
";
array_splice($cells, -1, null, [['label' => 'title']]);
echo json_encode($cells), "
";

["id",null,"name"]
["id",null,{"label":"title"}]

Нюансы и выбор. Не используйте splice как удаление по ID: offset означает позицию. Для словаря точнее unset($array[$id]); для неизменяющего среза — slice.

Сравните: array_slice, array_push, array_shift. Выбрать операцию по задаче.

• PHP: function.array-splice

PHP 4+ · standard

array_reverse(array $array, bool $preserve_keys = false): array

Получить обратный порядок элементов, не сортируя их значения.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$items = [10 => 'A', 20 => 'B'];
echo json_encode(array_reverse($items)), "
";
echo json_encode(array_reverse($items, true)), "
";

["B","A"]
{"20":"B","10":"A"}

<?php
$log = ['evt-1' => 'open', 'evt-2' => 'save', 'evt-3' => 'close'];
foreach (array_reverse($log) as $id => $event) {
    echo $id, ':', $event, "
";
}

evt-3:close
evt-2:save
evt-1:open

Нюансы и выбор. Для настоящего убывания по значениям нужна rsort/arsort. Reverse не выполняет сравнения.

Сравните: rsort, arsort, array_slice. Выбрать операцию по задаче.

• PHP: function.array-reverse

PHP 4+ · standard

array_pad(array $array, int $length, mixed $value): array

Дополнить короткий ряд до нужного размера заданным значением.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
echo json_encode(array_pad([7,9], 4, 0)), "
";
echo json_encode(array_pad([7,9], -4, 0)), "
";
echo json_encode(array_pad([7,9], 1, 0)), "
";

[7,9,0,0]
[0,0,7,9]
[7,9]

<?php
$measurements = [12];
$cells = array_pad($measurements, 3, null);
foreach ($cells as $value) { echo $value === null ? "нет
" : $value . "
"; }

12
нет
нет

Нюансы и выбор. Не передавайте произвольный размер из запроса без верхнего ограничения. Для создания массива с нуля подходит fill, для обрезки slice.

Сравните: array_fill, array_slice, array_merge. Выбрать операцию по задаче.

• PHP: function.array-pad

PHP 4+ · standard

array_push(array &$array, mixed ...$values): int

Добавить несколько значений в конец списка.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Знак & перед первым параметром в справочной сигнатуре означает изменение переданного массива. В самом вызове & не пишут: передают переменную, а не временное выражение.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$tasks = [10 => 'выписать накладную'];
$size = array_push($tasks, 'проверить адрес', 'подготовить упаковку');
echo 'Заданий после добавления: ', $size, "\n";
foreach ($tasks as $position => $task) {
    echo $position, ': ', $task, "\n";
}

Заданий после добавления: 3
10: выписать накладную
11: проверить адрес
12: подготовить упаковку

<?php
$queue = ["report"];
$new = ["mail", "export"];
array_push($queue, ...$new);
echo implode(",", $queue), "\n";
echo array_push($queue), "\n";

report,mail,export
3

Нюансы и выбор. Для одного значения обычное $array[] = $value проще и не требует вызова функции. Для вложенного массива без ... добавится один вложенный элемент.

Сравните: array_unshift, array_pop, array_shift, array_splice. Выбрать операцию по задаче.

• PHP: function.array-push

PHP 4+ · standard

array_unshift(array &$array, mixed ...$values): int

Добавить несколько значений в начало списка.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Знак & перед первым параметром в справочной сигнатуре означает изменение переданного массива. В самом вызове & не пишут: передают переменную, а не временное выражение.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$tasks = [10 => 'выписать накладную'];
$size = array_unshift($tasks, 'проверить адрес', 'подготовить упаковку');
echo 'Заданий после добавления: ', $size, "\n";
foreach ($tasks as $position => $task) {
    echo $position, ': ', $task, "\n";
}

Заданий после добавления: 3
0: проверить адрес
1: подготовить упаковку
2: выписать накладную

<?php
$queue = ["report"];
$new = ["mail", "export"];
array_unshift($queue, ...$new);
echo implode(",", $queue), "\n";
echo array_unshift($queue), "\n";

mail,export,report
3

Нюансы и выбор. Частые вставки в начало требуют перемещения/перенумерации числовых элементов. Для большой очереди рассмотрите SplQueue или иной специализированный контейнер.

Сравните: array_push, array_pop, array_shift, array_splice. Выбрать операцию по задаче.

• PHP: function.array-unshift

PHP 4+ · standard

array_pop(array &$array): mixed

Извлечь и удалить последний элемент стека.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Знак & перед первым параметром в справочной сигнатуре означает изменение переданного массива. В самом вызове & не пишут: передают переменную, а не временное выражение.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$tasks = [10 => 'адрес', 20 => 'упаковка', 30 => 'накладная'];
$task = array_pop($tasks);
echo 'Получено задание: ', $task, "\n";
echo "Осталось:\n";
foreach ($tasks as $position => $remaining) {
    echo $position, ': ', $remaining, "\n";
}

Получено задание: накладная
Осталось:
10: адрес
20: упаковка

<?php
$items = [null];
while ($items !== []) {
    $value = array_pop($items);
    echo $value === null ? "Получен null\n" : "Получено значение\n";
}
var_dump(array_pop($items));

Получен null
NULL

Нюансы и выбор. Для чтения без удаления используйте array_last в PHP 8.5+ или array_key_last и чтение по ключу в прежних версиях.

Сравните: array_shift, array_first, array_last. Выбрать операцию по задаче.

• PHP: function.array-pop

PHP 4+ · standard

array_shift(array &$array): mixed

Извлечь и удалить первый элемент очереди.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Знак & перед первым параметром в справочной сигнатуре означает изменение переданного массива. В самом вызове & не пишут: передают переменную, а не временное выражение.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$tasks = [10 => 'адрес', 20 => 'упаковка', 30 => 'накладная'];
$task = array_shift($tasks);
echo 'Получено задание: ', $task, "\n";
echo "Осталось:\n";
foreach ($tasks as $position => $remaining) {
    echo $position, ': ', $remaining, "\n";
}

Получено задание: адрес
Осталось:
0: упаковка
1: накладная

<?php
$items = [null];
while ($items !== []) {
    $value = array_shift($items);
    echo $value === null ? "Получен null\n" : "Получено значение\n";
}
var_dump(array_shift($items));

Получен null
NULL

Нюансы и выбор. Повторный shift для большой очереди может быть дорогим из-за перенумерации. Если удаление не нужно, используйте foreach; для очереди — SplQueue.

Сравните: array_pop, array_first, array_last. Выбрать операцию по задаче.

• PHP: function.array-shift

PHP 4.0.4+ · standard

array_sum(array $array): int|float

Сложить числовые значения, например суммы уже проверенных строк заказа.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

<?php
echo array_sum([2,3,4]), "\n";
echo array_sum([]), "\n";

9
0

<?php
$lineTotals = ['p1' => 19900, 'p2' => 4500];
$itemsTotalKopecks = array_sum($lineTotals);
$deliveryKopecks = 30000;
$payableKopecks = $itemsTotalKopecks + $deliveryKopecks;
echo 'Товары: ', $itemsTotalKopecks, ' коп.', "\n";
echo 'С доставкой: ', $payableKopecks, ' коп.', "\n";

Товары: 24400 коп.
С доставкой: 54400 коп.

Нюансы и выбор. Функция не спускается рекурсивно по строкам заказа. Сначала извлеките/рассчитайте нужные числа. Float имеет погрешность, а превышение целочисленного диапазона может изменить тип результата; для точных больших денежных расчётов нужна подходящая числовая модель.

Сравните: array_product, array_reduce, array_column. Выбрать операцию по задаче.

• PHP: function.array-sum

PHP 5.1+ · standard

array_product(array $array): int|float

Перемножить числовые значения, например количества вариантов комплектации.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

<?php
echo array_product([2,3,4]), "\n";
echo array_product([]), "\n";

24
1

<?php
$choices = ['colors' => 3, 'sizes' => 4, 'packs' => 2];
$variants = array_product($choices);
echo 'Доступно сочетаний: ', $variants, "\n";
$choices['sizes'] = 0;
$variants = array_product($choices);
if ($variants === 0) {
    echo "Конструктор недоступен: нет размеров\n";
}

Доступно сочетаний: 24
Конструктор недоступен: нет размеров

Нюансы и выбор. Функция не спускается рекурсивно по строкам заказа. Сначала извлеките/рассчитайте нужные числа. Float имеет погрешность, а превышение целочисленного диапазона может изменить тип результата; для точных больших денежных расчётов нужна подходящая числовая модель.

Сравните: array_sum, array_reduce, array_column. Выбрать операцию по задаче.

• PHP: function.array-product

PHP 4.3+ · standard

array_diff_assoc(array $array, array ...$arrays): array

Разность массивов: оставить пары первого входа, для которых совпадение не найдено ни в одном из остальных массивов. Ключ и значение одновременно.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$a = ["a" => 10, "b" => 20, "c" => 10];
$b = ["a" => "10", "b" => 30, "z" => 10];
echo json_encode(array_diff_assoc($a, $b)), "\n";

{"b":20,"c":10}

Теперь применим правило первого опыта к данным задачи. Первый массив задаёт, какие значения и ключи можно вернуть. Следующие массивы служат только для сравнения; они не дополняют результат новыми записями.

<?php
$new = ['host' => 'mail.local', 'port' => 587, 'tls' => 'on'];
$old = ['host' => 'mail.local', 'port' => 25];
$selected = array_diff_assoc($new, $old);
foreach ($selected as $setting => $value) {
    echo "Изменённая или новая настройка: ", $setting, " = ", $value, "\n";
}

Изменённая или новая настройка: port = 587
Изменённая или новая настройка: tls = on

Нюансы и выбор. Проверяется один уровень. Для вложенной записи выберите конкретное поле или собственный компаратор; не подменяйте структуру строкой "Array". Если нужна JSON-последовательность, явный array_values допустим только когда исходные ключи не несут смысла.

Сравните: array_diff, array_diff_key, array_udiff, array_unique. Выбрать операцию по задаче.

• PHP: function.array-diff-assoc

PHP 5.1+ · standard

array_diff_key(array $array, array ...$arrays): array

Разность массивов: оставить пары первого входа, для которых совпадение не найдено ни в одном из остальных массивов. Только ключи; значения не сравниваются.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$a = ["name" => "Ada", "price" => 9];
$b = ["name" => null];
echo json_encode(array_diff_key($a, $b)), "\n";

{"price":9}

Теперь применим правило первого опыта к данным задачи. Первый массив задаёт, какие значения и ключи можно вернуть. Следующие массивы служат только для сравнения; они не дополняют результат новыми записями.

<?php
$incoming = ['name' => 'Анна', 'note' => 'Позвонить', 'role' => 'admin'];
$fields = ['name' => true, 'note' => true];
$selected = array_diff_key($incoming, $fields);
foreach ($selected as $field => $value) {
    echo "Неизвестное поле: ", $field, " = ", $value, "\n";
}

Неизвестное поле: role = admin

Нюансы и выбор. Проверяется один уровень. Для вложенной записи выберите конкретное поле или собственный компаратор; не подменяйте структуру строкой "Array". Если нужна JSON-последовательность, явный array_values допустим только когда исходные ключи не несут смысла.

Сравните: array_diff, array_diff_assoc, array_udiff, array_unique. Выбрать операцию по задаче.

• PHP: function.array-diff-key

PHP 5+ · standard

array_diff_uassoc(array $array, array ...$arrays, callable $key_compare_func): array

Разность массивов: оставить пары первого входа, для которых совпадение не найдено ни в одном из остальных массивов. Ключ и значение одновременно.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Компаратор — функция сравнения двух элементов. Она возвращает целое число: отрицательное — первый раньше, 0 — равны по выбранному признаку, положительное — первый позже. $a <=> $b даёт -1, 0 или 1. Это не проверка true/false; разность дробей нельзя возвращать вместо целого результата. function ($a, $b) { return ...; } передаёт правило операции, а не вызывает его немедленно. strcasecmp — встроенное сравнение двух строк без учёта ASCII-регистра.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: передача функции как значения.

<?php
$a = ["A" => 10, "B" => 20, "C" => 10];
$b = ["a" => "10", "b" => 30, "z" => 10];
echo json_encode(array_diff_uassoc($a, $b, "strcasecmp")), "\n";

{"B":20,"C":10}

Теперь применим правило первого опыта к данным задачи. Первый массив задаёт, какие значения и ключи можно вернуть. Следующие массивы служат только для сравнения; они не дополняют результат новыми записями.

<?php
$new = ['host' => 'mail.local', 'port' => 587, 'tls' => 'on'];
$old = ['HOST' => 'mail.local', 'PORT' => 25];
$selected = array_diff_uassoc($new, $old, "strcasecmp");
foreach ($selected as $setting => $value) {
    echo "Изменённая или новая настройка: ", $setting, " = ", $value, "\n";
}

Изменённая или новая настройка: port = 587
Изменённая или новая настройка: tls = on

Нюансы и выбор. Проверяется один уровень. Для вложенной записи выберите конкретное поле или собственный компаратор; не подменяйте структуру строкой "Array". Порядок callback не фиксирован; не рассчитывайте на вызов строго слева направо по исходному списку. Если нужна JSON-последовательность, явный array_values допустим только когда исходные ключи не несут смысла.

Сравните: array_diff, array_diff_assoc, array_diff_key, array_udiff, array_unique. Выбрать операцию по задаче.

• PHP: function.array-diff-uassoc

PHP 5.1+ · standard

array_diff_ukey(array $array, array ...$arrays, callable $key_compare_func): array

Разность массивов: оставить пары первого входа, для которых совпадение не найдено ни в одном из остальных массивов. Только ключи; значения не сравниваются.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Компаратор — функция сравнения двух элементов. Она возвращает целое число: отрицательное — первый раньше, 0 — равны по выбранному признаку, положительное — первый позже. $a <=> $b даёт -1, 0 или 1. Это не проверка true/false; разность дробей нельзя возвращать вместо целого результата. function ($a, $b) { return ...; } передаёт правило операции, а не вызывает его немедленно. strcasecmp — встроенное сравнение двух строк без учёта ASCII-регистра.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: передача функции как значения.

<?php
$a = ["Name" => "Ada", "Price" => 9];
$b = ["name" => null];
echo json_encode(array_diff_ukey($a, $b, "strcasecmp")), "\n";

{"Price":9}

Теперь применим правило первого опыта к данным задачи. Первый массив задаёт, какие значения и ключи можно вернуть. Следующие массивы служат только для сравнения; они не дополняют результат новыми записями.

<?php
$incoming = ['name' => 'Анна', 'note' => 'Позвонить', 'role' => 'admin'];
$fields = ['NAME' => true, 'NOTE' => true];
$selected = array_diff_ukey($incoming, $fields, "strcasecmp");
foreach ($selected as $field => $value) {
    echo "Неизвестное поле: ", $field, " = ", $value, "\n";
}

Неизвестное поле: role = admin

Нюансы и выбор. Проверяется один уровень. Для вложенной записи выберите конкретное поле или собственный компаратор; не подменяйте структуру строкой "Array". Порядок callback не фиксирован; не рассчитывайте на вызов строго слева направо по исходному списку. Если нужна JSON-последовательность, явный array_values допустим только когда исходные ключи не несут смысла.

Сравните: array_diff, array_diff_assoc, array_diff_key, array_udiff, array_unique. Выбрать операцию по задаче.

• PHP: function.array-diff-ukey

PHP 5+ · standard

array_udiff(array $array, array ...$arrays, callable $value_compare_func): array

Вычислить разность по собственному правилу значений.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Компаратор — функция сравнения двух элементов. Она возвращает целое число: отрицательное — первый раньше, 0 — равны по выбранному признаку, положительное — первый позже. $a <=> $b даёт -1, 0 или 1. Это не проверка true/false; разность дробей нельзя возвращать вместо целого результата. function ($a, $b) { return ...; } передаёт правило операции, а не вызывает его немедленно. abs возвращает модуль числа: -3 и 3 дают одинаковое значение 3.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: передача функции как значения.

<?php
$a = ["a" => -3, "b" => 8, "c" => 3];
$b = ["other" => 3];
$compare = function ($a, $b) { return abs($a) <=> abs($b); };
echo json_encode(array_udiff($a, $b, $compare)), "\n";

{"b":8}

Первый опыт уже показал три исхода компаратора: меньше, равно, больше. Теперь параметрами будут записи-массивы. Форма каждой записи проверена заранее; нельзя предполагать, что left всегда из local, а right всегда из remote.

<?php
$local = [['id' => 12, 'name' => 'Локальная карточка'], ['id' => 25, 'name' => 'Новый товар']];
$remote = [['id' => 12, 'name' => 'Иное название']];
$compareId = function ($left, $right) {
    return $left["id"] <=> $right["id"];
};
$selected = array_udiff($local, $remote, $compareId);
foreach ($selected as $record) {
    echo "ID ", $record["id"], ": ", $record["name"], "\n";
}

ID 25: Новый товар

Нюансы и выбор. Внутри сравнения массивы могут предварительно сортироваться, поэтому нельзя предполагать: $a всегда из local, $b всегда из remote. Нужен согласованный полный порядок (транзитивность, противоположные знаки при обмене аргументов), не функция «похож/не похож». Обход одноуровневый; callback сам выбирает поля вложенных значений. Для больших наборов с точным уникальным ID явный индекс нередко проще повторных сравнений.

Сравните: array_diff, array_diff_assoc, array_udiff_assoc, array_udiff_uassoc. Выбрать операцию по задаче.

Реальная причина ошибки из вопроса о пропавших элементах: callback отдавал только 0/1 и не задавал согласованного порядка двух аргументов. Для отбора по одному признаку нужен array_filter; компаратор здесь обязан сравнить оба входа. Ответы обсуждения не служат нормативным правилом; договор проверен по PHP Manual.

• PHP: function.array-udiff

PHP 5+ · standard

array_udiff_assoc(array $array, array ...$arrays, callable $value_compare_func): array

Вычислить разность по собственному правилу значений с проверкой ключа.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Компаратор — функция сравнения двух элементов. Она возвращает целое число: отрицательное — первый раньше, 0 — равны по выбранному признаку, положительное — первый позже. $a <=> $b даёт -1, 0 или 1. Это не проверка true/false; разность дробей нельзя возвращать вместо целого результата. function ($a, $b) { return ...; } передаёт правило операции, а не вызывает его немедленно. abs возвращает модуль числа: -3 и 3 дают одинаковое значение 3.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: передача функции как значения.

<?php
$a = ["a" => -3, "b" => 8, "c" => 3];
$b = ["a" => 3];
$compare = function ($a, $b) { return abs($a) <=> abs($b); };
echo json_encode(array_udiff_assoc($a, $b, $compare)), "\n";

{"b":8,"c":3}

Первый опыт уже показал три исхода компаратора: меньше, равно, больше. Теперь параметрами будут записи-массивы. Форма каждой записи проверена заранее; нельзя предполагать, что left всегда из local, а right всегда из remote.

<?php
$local = ['sku-a' => ['revision' => 2, 'label' => 'Карточка A'], 'sku-b' => ['revision' => 3, 'label' => 'Карточка B']];
$remote = ['sku-a' => ['revision' => 2, 'label' => 'Другое название A'], 'sku-b' => ['revision' => 1, 'label' => 'Старое название B']];
$compareRevision = function ($left, $right) {
    return $left["revision"] <=> $right["revision"];
};
$selected = array_udiff_assoc($local, $remote, $compareRevision);
foreach ($selected as $sku => $record) {
    echo $sku, ": ", $record["label"], ", версия ", $record["revision"], "\n";
}

sku-b: Карточка B, версия 3

Нюансы и выбор. Внутри сравнения массивы могут предварительно сортироваться, поэтому нельзя предполагать: $a всегда из local, $b всегда из remote. Нужен согласованный полный порядок (транзитивность, противоположные знаки при обмене аргументов), не функция «похож/не похож». Обход одноуровневый; callback сам выбирает поля вложенных значений. Для больших наборов с точным уникальным ID явный индекс нередко проще повторных сравнений.

Сравните: array_diff, array_diff_assoc, array_udiff, array_udiff_uassoc. Выбрать операцию по задаче.

Реальная причина ошибки из вопроса о пропавших элементах: callback отдавал только 0/1 и не задавал согласованного порядка двух аргументов. Для отбора по одному признаку нужен array_filter; компаратор здесь обязан сравнить оба входа. Ответы обсуждения не служат нормативным правилом; договор проверен по PHP Manual.

• PHP: function.array-udiff-assoc

PHP 5+ · standard

array_udiff_uassoc(array $array, array ...$arrays, callable $value_compare_func, callable $key_compare_func): array

Вычислить разность по собственному правилу значений с проверкой ключа.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Компаратор — функция сравнения двух элементов. Она возвращает целое число: отрицательное — первый раньше, 0 — равны по выбранному признаку, положительное — первый позже. $a <=> $b даёт -1, 0 или 1. Это не проверка true/false; разность дробей нельзя возвращать вместо целого результата. function ($a, $b) { return ...; } передаёт правило операции, а не вызывает его немедленно. abs возвращает модуль числа: -3 и 3 дают одинаковое значение 3. strcasecmp во втором callback сравнивает ключи без учёта ASCII-регистра.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: передача функции как значения.

<?php
$a = ["A" => -3, "B" => 8, "C" => 3];
$b = ["a" => 3];
$compare = function ($a, $b) { return abs($a) <=> abs($b); };
echo json_encode(array_udiff_uassoc($a, $b, $compare, "strcasecmp")), "\n";

{"B":8,"C":3}

Первый опыт уже показал три исхода компаратора: меньше, равно, больше. Теперь параметрами будут записи-массивы. Форма каждой записи проверена заранее; нельзя предполагать, что left всегда из local, а right всегда из remote.

<?php
$local = ['SKU-A' => ['revision' => 2, 'label' => 'Карточка A'], 'SKU-B' => ['revision' => 3, 'label' => 'Карточка B']];
$remote = ['sku-a' => ['revision' => 2, 'label' => 'Другое название A'], 'sku-b' => ['revision' => 1, 'label' => 'Старое название B']];
$compareRevision = function ($left, $right) {
    return $left["revision"] <=> $right["revision"];
};
$selected = array_udiff_uassoc($local, $remote, $compareRevision, "strcasecmp");
foreach ($selected as $sku => $record) {
    echo $sku, ": ", $record["label"], ", версия ", $record["revision"], "\n";
}

SKU-B: Карточка B, версия 3

Нюансы и выбор. Внутри сравнения массивы могут предварительно сортироваться, поэтому нельзя предполагать: $a всегда из local, $b всегда из remote. Нужен согласованный полный порядок (транзитивность, противоположные знаки при обмене аргументов), не функция «похож/не похож». Обход одноуровневый; callback сам выбирает поля вложенных значений. Для больших наборов с точным уникальным ID явный индекс нередко проще повторных сравнений.

Сравните: array_diff, array_diff_assoc, array_udiff, array_udiff_assoc. Выбрать операцию по задаче.

Реальная причина ошибки из вопроса о пропавших элементах: callback отдавал только 0/1 и не задавал согласованного порядка двух аргументов. Для отбора по одному признаку нужен array_filter; компаратор здесь обязан сравнить оба входа. Ответы обсуждения не служат нормативным правилом; договор проверен по PHP Manual.

• PHP: function.array-udiff-uassoc

PHP 4.3+ · standard

array_intersect_assoc(array $array, array ...$arrays): array

Пересечение массивов: оставить пары первого входа, для которых совпадение найдено в каждом из остальных массивов. Ключ и значение одновременно.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$a = ["a" => 10, "b" => 20, "c" => 10];
$b = ["a" => "10", "b" => 30, "z" => 10];
echo json_encode(array_intersect_assoc($a, $b)), "\n";

{"a":10}

Теперь применим правило первого опыта к данным задачи. Первый массив задаёт, какие значения и ключи можно вернуть. Следующие массивы служат только для сравнения; они не дополняют результат новыми записями.

<?php
$new = ['host' => 'mail.local', 'port' => 587, 'tls' => 'on'];
$old = ['host' => 'mail.local', 'port' => 25];
$selected = array_intersect_assoc($new, $old);
foreach ($selected as $setting => $value) {
    echo "Неизменившаяся настройка: ", $setting, " = ", $value, "\n";
}

Неизменившаяся настройка: host = mail.local

Нюансы и выбор. Проверяется один уровень. Для вложенной записи выберите конкретное поле или собственный компаратор; не подменяйте структуру строкой "Array". Если нужна JSON-последовательность, явный array_values допустим только когда исходные ключи не несут смысла.

Сравните: array_intersect, array_intersect_key, array_uintersect, array_unique. Выбрать операцию по задаче.

• PHP: function.array-intersect-assoc

PHP 5.1+ · standard

array_intersect_key(array $array, array ...$arrays): array

Пересечение массивов: оставить пары первого входа, для которых совпадение найдено в каждом из остальных массивов. Только ключи; значения не сравниваются.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$a = ["name" => "Ada", "price" => 9];
$b = ["name" => null];
echo json_encode(array_intersect_key($a, $b)), "\n";

{"name":"Ada"}

Теперь применим правило первого опыта к данным задачи. Первый массив задаёт, какие значения и ключи можно вернуть. Следующие массивы служат только для сравнения; они не дополняют результат новыми записями.

<?php
$incoming = ['name' => 'Анна', 'note' => 'Позвонить', 'role' => 'admin'];
$fields = ['name' => true, 'note' => true];
$selected = array_intersect_key($incoming, $fields);
foreach ($selected as $field => $value) {
    echo "Разрешённое поле: ", $field, " = ", $value, "\n";
}

Разрешённое поле: name = Анна
Разрешённое поле: note = Позвонить

Нюансы и выбор. Проверяется один уровень. Для вложенной записи выберите конкретное поле или собственный компаратор; не подменяйте структуру строкой "Array". Если нужна JSON-последовательность, явный array_values допустим только когда исходные ключи не несут смысла.

Сравните: array_intersect, array_intersect_assoc, array_uintersect, array_unique. Выбрать операцию по задаче.

• PHP: function.array-intersect-key

PHP 5+ · standard

array_intersect_uassoc(array $array, array ...$arrays, callable $key_compare_func): array

Пересечение массивов: оставить пары первого входа, для которых совпадение найдено в каждом из остальных массивов. Ключ и значение одновременно.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Компаратор — функция сравнения двух элементов. Она возвращает целое число: отрицательное — первый раньше, 0 — равны по выбранному признаку, положительное — первый позже. $a <=> $b даёт -1, 0 или 1. Это не проверка true/false; разность дробей нельзя возвращать вместо целого результата. function ($a, $b) { return ...; } передаёт правило операции, а не вызывает его немедленно. strcasecmp — встроенное сравнение двух строк без учёта ASCII-регистра.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: передача функции как значения.

<?php
$a = ["A" => 10, "B" => 20, "C" => 10];
$b = ["a" => "10", "b" => 30, "z" => 10];
echo json_encode(array_intersect_uassoc($a, $b, "strcasecmp")), "\n";

{"A":10}

Теперь применим правило первого опыта к данным задачи. Первый массив задаёт, какие значения и ключи можно вернуть. Следующие массивы служат только для сравнения; они не дополняют результат новыми записями.

<?php
$new = ['host' => 'mail.local', 'port' => 587, 'tls' => 'on'];
$old = ['HOST' => 'mail.local', 'PORT' => 25];
$selected = array_intersect_uassoc($new, $old, "strcasecmp");
foreach ($selected as $setting => $value) {
    echo "Неизменившаяся настройка: ", $setting, " = ", $value, "\n";
}

Неизменившаяся настройка: host = mail.local

Нюансы и выбор. Проверяется один уровень. Для вложенной записи выберите конкретное поле или собственный компаратор; не подменяйте структуру строкой "Array". Порядок callback не фиксирован; не рассчитывайте на вызов строго слева направо по исходному списку. Если нужна JSON-последовательность, явный array_values допустим только когда исходные ключи не несут смысла.

Сравните: array_intersect, array_intersect_assoc, array_intersect_key, array_uintersect, array_unique. Выбрать операцию по задаче.

• PHP: function.array-intersect-uassoc

PHP 5.1+ · standard

array_intersect_ukey(array $array, array ...$arrays, callable $key_compare_func): array

Пересечение массивов: оставить пары первого входа, для которых совпадение найдено в каждом из остальных массивов. Только ключи; значения не сравниваются.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Компаратор — функция сравнения двух элементов. Она возвращает целое число: отрицательное — первый раньше, 0 — равны по выбранному признаку, положительное — первый позже. $a <=> $b даёт -1, 0 или 1. Это не проверка true/false; разность дробей нельзя возвращать вместо целого результата. function ($a, $b) { return ...; } передаёт правило операции, а не вызывает его немедленно. strcasecmp — встроенное сравнение двух строк без учёта ASCII-регистра.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: передача функции как значения.

<?php
$a = ["Name" => "Ada", "Price" => 9];
$b = ["name" => null];
echo json_encode(array_intersect_ukey($a, $b, "strcasecmp")), "\n";

{"Name":"Ada"}

Теперь применим правило первого опыта к данным задачи. Первый массив задаёт, какие значения и ключи можно вернуть. Следующие массивы служат только для сравнения; они не дополняют результат новыми записями.

<?php
$incoming = ['name' => 'Анна', 'note' => 'Позвонить', 'role' => 'admin'];
$fields = ['NAME' => true, 'NOTE' => true];
$selected = array_intersect_ukey($incoming, $fields, "strcasecmp");
foreach ($selected as $field => $value) {
    echo "Разрешённое поле: ", $field, " = ", $value, "\n";
}

Разрешённое поле: name = Анна
Разрешённое поле: note = Позвонить

Нюансы и выбор. Проверяется один уровень. Для вложенной записи выберите конкретное поле или собственный компаратор; не подменяйте структуру строкой "Array". Порядок callback не фиксирован; не рассчитывайте на вызов строго слева направо по исходному списку. Если нужна JSON-последовательность, явный array_values допустим только когда исходные ключи не несут смысла.

Сравните: array_intersect, array_intersect_assoc, array_intersect_key, array_uintersect, array_unique. Выбрать операцию по задаче.

• PHP: function.array-intersect-ukey

PHP 5+ · standard

array_uintersect(array $array, array ...$arrays, callable $value_compare_func): array

Вычислить пересечение по собственному правилу значений.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Компаратор — функция сравнения двух элементов. Она возвращает целое число: отрицательное — первый раньше, 0 — равны по выбранному признаку, положительное — первый позже. $a <=> $b даёт -1, 0 или 1. Это не проверка true/false; разность дробей нельзя возвращать вместо целого результата. function ($a, $b) { return ...; } передаёт правило операции, а не вызывает его немедленно. abs возвращает модуль числа: -3 и 3 дают одинаковое значение 3.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: передача функции как значения.

<?php
$a = ["a" => -3, "b" => 8, "c" => 3];
$b = ["other" => 3];
$compare = function ($a, $b) { return abs($a) <=> abs($b); };
echo json_encode(array_uintersect($a, $b, $compare)), "\n";

{"a":-3,"c":3}

Первый опыт уже показал три исхода компаратора: меньше, равно, больше. Теперь параметрами будут записи-массивы. Форма каждой записи проверена заранее; нельзя предполагать, что left всегда из local, а right всегда из remote.

<?php
$local = [['id' => 12, 'name' => 'Локальная карточка'], ['id' => 25, 'name' => 'Новый товар']];
$remote = [['id' => 12, 'name' => 'Иное название']];
$compareId = function ($left, $right) {
    return $left["id"] <=> $right["id"];
};
$selected = array_uintersect($local, $remote, $compareId);
foreach ($selected as $record) {
    echo "ID ", $record["id"], ": ", $record["name"], "\n";
}

ID 12: Локальная карточка

Нюансы и выбор. Внутри сравнения массивы могут предварительно сортироваться, поэтому нельзя предполагать: $a всегда из local, $b всегда из remote. Нужен согласованный полный порядок (транзитивность, противоположные знаки при обмене аргументов), не функция «похож/не похож». Обход одноуровневый; callback сам выбирает поля вложенных значений. Для больших наборов с точным уникальным ID явный индекс нередко проще повторных сравнений.

Сравните: array_intersect, array_intersect_assoc, array_uintersect_assoc, array_uintersect_uassoc. Выбрать операцию по задаче.

Реальная причина ошибки из вопроса о пропавших элементах: callback отдавал только 0/1 и не задавал согласованного порядка двух аргументов. Для отбора по одному признаку нужен array_filter; компаратор здесь обязан сравнить оба входа. Ответы обсуждения не служат нормативным правилом; договор проверен по PHP Manual.

• PHP: function.array-uintersect

PHP 5+ · standard

array_uintersect_assoc(array $array, array ...$arrays, callable $value_compare_func): array

Вычислить пересечение по собственному правилу значений с проверкой ключа.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Компаратор — функция сравнения двух элементов. Она возвращает целое число: отрицательное — первый раньше, 0 — равны по выбранному признаку, положительное — первый позже. $a <=> $b даёт -1, 0 или 1. Это не проверка true/false; разность дробей нельзя возвращать вместо целого результата. function ($a, $b) { return ...; } передаёт правило операции, а не вызывает его немедленно. abs возвращает модуль числа: -3 и 3 дают одинаковое значение 3.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: передача функции как значения.

<?php
$a = ["a" => -3, "b" => 8, "c" => 3];
$b = ["a" => 3];
$compare = function ($a, $b) { return abs($a) <=> abs($b); };
echo json_encode(array_uintersect_assoc($a, $b, $compare)), "\n";

{"a":-3}

Первый опыт уже показал три исхода компаратора: меньше, равно, больше. Теперь параметрами будут записи-массивы. Форма каждой записи проверена заранее; нельзя предполагать, что left всегда из local, а right всегда из remote.

<?php
$local = ['sku-a' => ['revision' => 2, 'label' => 'Карточка A'], 'sku-b' => ['revision' => 3, 'label' => 'Карточка B']];
$remote = ['sku-a' => ['revision' => 2, 'label' => 'Другое название A'], 'sku-b' => ['revision' => 1, 'label' => 'Старое название B']];
$compareRevision = function ($left, $right) {
    return $left["revision"] <=> $right["revision"];
};
$selected = array_uintersect_assoc($local, $remote, $compareRevision);
foreach ($selected as $sku => $record) {
    echo $sku, ": ", $record["label"], ", версия ", $record["revision"], "\n";
}

sku-a: Карточка A, версия 2

Нюансы и выбор. Внутри сравнения массивы могут предварительно сортироваться, поэтому нельзя предполагать: $a всегда из local, $b всегда из remote. Нужен согласованный полный порядок (транзитивность, противоположные знаки при обмене аргументов), не функция «похож/не похож». Обход одноуровневый; callback сам выбирает поля вложенных значений. Для больших наборов с точным уникальным ID явный индекс нередко проще повторных сравнений.

Сравните: array_intersect, array_intersect_assoc, array_uintersect, array_uintersect_uassoc. Выбрать операцию по задаче.

Реальная причина ошибки из вопроса о пропавших элементах: callback отдавал только 0/1 и не задавал согласованного порядка двух аргументов. Для отбора по одному признаку нужен array_filter; компаратор здесь обязан сравнить оба входа. Ответы обсуждения не служат нормативным правилом; договор проверен по PHP Manual.

• PHP: function.array-uintersect-assoc

PHP 5+ · standard

array_uintersect_uassoc(array $array1, array ...$arrays, callable $value_compare_func, callable $key_compare_func): array

Вычислить пересечение по собственному правилу значений с проверкой ключа.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Компаратор — функция сравнения двух элементов. Она возвращает целое число: отрицательное — первый раньше, 0 — равны по выбранному признаку, положительное — первый позже. $a <=> $b даёт -1, 0 или 1. Это не проверка true/false; разность дробей нельзя возвращать вместо целого результата. function ($a, $b) { return ...; } передаёт правило операции, а не вызывает его немедленно. abs возвращает модуль числа: -3 и 3 дают одинаковое значение 3. strcasecmp во втором callback сравнивает ключи без учёта ASCII-регистра.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: передача функции как значения.

<?php
$a = ["A" => -3, "B" => 8, "C" => 3];
$b = ["a" => 3];
$compare = function ($a, $b) { return abs($a) <=> abs($b); };
echo json_encode(array_uintersect_uassoc($a, $b, $compare, "strcasecmp")), "\n";

{"A":-3}

Первый опыт уже показал три исхода компаратора: меньше, равно, больше. Теперь параметрами будут записи-массивы. Форма каждой записи проверена заранее; нельзя предполагать, что left всегда из local, а right всегда из remote.

<?php
$local = ['SKU-A' => ['revision' => 2, 'label' => 'Карточка A'], 'SKU-B' => ['revision' => 3, 'label' => 'Карточка B']];
$remote = ['sku-a' => ['revision' => 2, 'label' => 'Другое название A'], 'sku-b' => ['revision' => 1, 'label' => 'Старое название B']];
$compareRevision = function ($left, $right) {
    return $left["revision"] <=> $right["revision"];
};
$selected = array_uintersect_uassoc($local, $remote, $compareRevision, "strcasecmp");
foreach ($selected as $sku => $record) {
    echo $sku, ": ", $record["label"], ", версия ", $record["revision"], "\n";
}

SKU-A: Карточка A, версия 2

Нюансы и выбор. Внутри сравнения массивы могут предварительно сортироваться, поэтому нельзя предполагать: $a всегда из local, $b всегда из remote. Нужен согласованный полный порядок (транзитивность, противоположные знаки при обмене аргументов), не функция «похож/не похож». Обход одноуровневый; callback сам выбирает поля вложенных значений. Для больших наборов с точным уникальным ID явный индекс нередко проще повторных сравнений.

Сравните: array_intersect, array_intersect_assoc, array_uintersect, array_uintersect_assoc. Выбрать операцию по задаче.

Реальная причина ошибки из вопроса о пропавших элементах: callback отдавал только 0/1 и не задавал согласованного порядка двух аргументов. Для отбора по одному признаку нужен array_filter; компаратор здесь обязан сравнить оба входа. Ответы обсуждения не служат нормативным правилом; договор проверен по PHP Manual.

• PHP: function.array-uintersect-uassoc

PHP 4+ · standard

sort(array &$array, int $flags = SORT_REGULAR): true

Упорядочить значения по возрастанию, заменив все ключи индексами 0, 1….

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Все равные по правилу сравнения элементы сохраняют взаимный порядок с PHP 8.0; раньше он не гарантировался. Указатель массива сбрасывается на первый элемент. Массив меняется на месте: true — статус, не отсортированные данные. В сигнатуре & означает передачу изменяемой переменной; в вызове знак & не ставится.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$prices = ['A' => 300, 'B' => 100, 'C' => 200];
$status = sort($prices, SORT_NUMERIC);
if ($status) { echo "Цены упорядочены\n"; }
foreach ($prices as $key => $price) { echo "Позиция ", $key, ": ", $price, " коп.\n"; }

Цены упорядочены
Позиция 0: 100 коп.
Позиция 1: 200 коп.
Позиция 2: 300 коп.

<?php
$files = ["ten" => "part10", "two" => "part2", "one" => "Part1"];
sort($files, SORT_NATURAL | SORT_FLAG_CASE);
echo json_encode($files), "\n";

["Part1","part2","part10"]

Нюансы и выбор. Для русских названий и языковых правил нужна подходящая locale/Collator, а не обещание универсального «алфавита». Не полагайтесь на конкретный алгоритм, число сравнений или скорость на любом входе. До сортировки нормализуйте сравниваемый тип; чтение БД уже в нужном порядке может быть выгоднее сортировки огромного PHP-массива.

Сравните: asort, ksort, usort, array_multisort. Выбрать операцию по задаче.

• PHP: function.sort
• PHP: array.sorting
• PHP: array.constants

PHP 4+ · standard

rsort(array &$array, int $flags = SORT_REGULAR): true

Упорядочить значения по убыванию, заменив все ключи индексами 0, 1….

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Все равные по правилу сравнения элементы сохраняют взаимный порядок с PHP 8.0; раньше он не гарантировался. Указатель массива сбрасывается на первый элемент. Массив меняется на месте: true — статус, не отсортированные данные. В сигнатуре & означает передачу изменяемой переменной; в вызове знак & не ставится.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$prices = ['A' => 300, 'B' => 100, 'C' => 200];
$status = rsort($prices, SORT_NUMERIC);
if ($status) { echo "Цены упорядочены\n"; }
foreach ($prices as $key => $price) { echo "Позиция ", $key, ": ", $price, " коп.\n"; }

Цены упорядочены
Позиция 0: 300 коп.
Позиция 1: 200 коп.
Позиция 2: 100 коп.

<?php
$files = ["ten" => "part10", "two" => "part2", "one" => "Part1"];
rsort($files, SORT_NATURAL | SORT_FLAG_CASE);
echo json_encode($files), "\n";

["part10","part2","Part1"]

Нюансы и выбор. Для русских названий и языковых правил нужна подходящая locale/Collator, а не обещание универсального «алфавита». Не полагайтесь на конкретный алгоритм, число сравнений или скорость на любом входе. До сортировки нормализуйте сравниваемый тип; чтение БД уже в нужном порядке может быть выгоднее сортировки огромного PHP-массива.

Сравните: sort, asort, ksort, usort, array_multisort. Выбрать операцию по задаче.

• PHP: function.rsort
• PHP: array.sorting
• PHP: array.constants

PHP 4+ · standard

asort(array &$array, int $flags = SORT_REGULAR): true

Упорядочить значения по возрастанию, сохранив связь ключей и значений.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Все равные по правилу сравнения элементы сохраняют взаимный порядок с PHP 8.0; раньше он не гарантировался. Указатель массива сбрасывается на первый элемент. Массив меняется на месте: true — статус, не отсортированные данные. В сигнатуре & означает передачу изменяемой переменной; в вызове знак & не ставится.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$prices = ['A' => 300, 'B' => 100, 'C' => 200];
$status = asort($prices, SORT_NUMERIC);
if ($status) { echo "Цены упорядочены\n"; }
foreach ($prices as $key => $price) { echo "Артикул ", $key, ": ", $price, " коп.\n"; }

Цены упорядочены
Артикул B: 100 коп.
Артикул C: 200 коп.
Артикул A: 300 коп.

<?php
$files = ["ten" => "part10", "two" => "part2", "one" => "Part1"];
asort($files, SORT_NATURAL | SORT_FLAG_CASE);
echo json_encode($files), "\n";

{"one":"Part1","two":"part2","ten":"part10"}

Нюансы и выбор. Для русских названий и языковых правил нужна подходящая locale/Collator, а не обещание универсального «алфавита». Не полагайтесь на конкретный алгоритм, число сравнений или скорость на любом входе. До сортировки нормализуйте сравниваемый тип; чтение БД уже в нужном порядке может быть выгоднее сортировки огромного PHP-массива.

Сравните: sort, ksort, usort, array_multisort. Выбрать операцию по задаче.

• PHP: function.asort
• PHP: array.sorting
• PHP: array.constants

PHP 4+ · standard

arsort(array &$array, int $flags = SORT_REGULAR): true

Упорядочить значения по убыванию, сохранив связь ключей и значений.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Все равные по правилу сравнения элементы сохраняют взаимный порядок с PHP 8.0; раньше он не гарантировался. Указатель массива сбрасывается на первый элемент. Массив меняется на месте: true — статус, не отсортированные данные. В сигнатуре & означает передачу изменяемой переменной; в вызове знак & не ставится.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$prices = ['A' => 300, 'B' => 100, 'C' => 200];
$status = arsort($prices, SORT_NUMERIC);
if ($status) { echo "Цены упорядочены\n"; }
foreach ($prices as $key => $price) { echo "Артикул ", $key, ": ", $price, " коп.\n"; }

Цены упорядочены
Артикул A: 300 коп.
Артикул C: 200 коп.
Артикул B: 100 коп.

<?php
$files = ["ten" => "part10", "two" => "part2", "one" => "Part1"];
arsort($files, SORT_NATURAL | SORT_FLAG_CASE);
echo json_encode($files), "\n";

{"ten":"part10","two":"part2","one":"Part1"}

Нюансы и выбор. Для русских названий и языковых правил нужна подходящая locale/Collator, а не обещание универсального «алфавита». Не полагайтесь на конкретный алгоритм, число сравнений или скорость на любом входе. До сортировки нормализуйте сравниваемый тип; чтение БД уже в нужном порядке может быть выгоднее сортировки огромного PHP-массива.

Сравните: sort, asort, ksort, usort, array_multisort. Выбрать операцию по задаче.

• PHP: function.arsort
• PHP: array.sorting
• PHP: array.constants

PHP 4+ · standard

krsort(array &$array, int $flags = SORT_REGULAR): true

Упорядочить ключи по убыванию, сохранив связь ключей и значений.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Все равные по правилу сравнения элементы сохраняют взаимный порядок с PHP 8.0; раньше он не гарантировался. Указатель массива сбрасывается на первый элемент. Массив меняется на месте: true — статус, не отсортированные данные. В сигнатуре & означает передачу изменяемой переменной; в вызове знак & не ставится. В PHP 8.2 сравнение числовых строковых ключей SORT_REGULAR приведено к стандартным правилам PHP 8.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$invoices = [30 => 'накладная C', 10 => 'накладная A', 20 => 'накладная B'];
$status = krsort($invoices, SORT_NUMERIC);
if ($status) { echo "Накладные упорядочены\n"; }
foreach ($invoices as $id => $title) { echo "ID ", $id, ": ", $title, "\n"; }

Накладные упорядочены
ID 30: накладная C
ID 20: накладная B
ID 10: накладная A

<?php
$files = ["part10" => "ten", "part2" => "two", "Part1" => "one"];
krsort($files, SORT_NATURAL | SORT_FLAG_CASE);
echo json_encode($files), "\n";

{"part10":"ten","part2":"two","Part1":"one"}

Нюансы и выбор. Для русских названий и языковых правил нужна подходящая locale/Collator, а не обещание универсального «алфавита». Не полагайтесь на конкретный алгоритм, число сравнений или скорость на любом входе. До сортировки нормализуйте сравниваемый тип; чтение БД уже в нужном порядке может быть выгоднее сортировки огромного PHP-массива.

Сравните: sort, asort, ksort, usort, array_multisort. Выбрать операцию по задаче.

• PHP: function.krsort
• PHP: array.sorting
• PHP: array.constants

PHP 4+ · standard

natsort(array &$array): true

Отсортировать числовые части строк естественным порядком, учитывая регистр.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Все равные по правилу сравнения элементы сохраняют взаимный порядок с PHP 8.0; раньше он не гарантировался. Указатель массива сбрасывается на первый элемент. Массив меняется на месте: true — статус, не отсортированные данные. В сигнатуре & означает передачу изменяемой переменной; в вызове знак & не ставится.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$pages = ['ten' => 'part10', 'two' => 'part2', 'one' => 'part1'];
natsort($pages);
foreach ($pages as $id => $file) {
    echo 'Раздел ', $id, ': ', $file, ".txt\n";
}

Раздел one: part1.txt
Раздел two: part2.txt
Раздел ten: part10.txt

<?php
$sensitive = ['x2', 'X10', 'x1'];
$insensitive = $sensitive;
natsort($sensitive);
natcasesort($insensitive);
echo json_encode(array_values($sensitive)), "
";
echo json_encode(array_values($insensitive)), "
";

["X10","x1","x2"]
["x1","x2","X10"]

Нюансы и выбор. «Естественный» не означает понимание версий, дат, дробей или всех языков. Ведущие нули и формат чисел важны; для SemVer нужен его собственный договор сравнения. Для обратного результата можно array_reverse(..., true), если хотите сохранить ключи; это также перевернёт порядок равных элементов.

Сравните: natcasesort, asort, array_reverse. Выбрать операцию по задаче.

• PHP: function.natsort

PHP 4+ · standard

natcasesort(array &$array): true

Отсортировать числовые части строк естественным порядком без учёта ASCII-регистра.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Все равные по правилу сравнения элементы сохраняют взаимный порядок с PHP 8.0; раньше он не гарантировался. Указатель массива сбрасывается на первый элемент. Массив меняется на месте: true — статус, не отсортированные данные. В сигнатуре & означает передачу изменяемой переменной; в вызове знак & не ставится.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$pages = ['ten' => 'part10', 'two' => 'part2', 'one' => 'part1'];
natcasesort($pages);
foreach ($pages as $id => $file) {
    echo 'Раздел ', $id, ': ', $file, ".txt\n";
}

Раздел one: part1.txt
Раздел two: part2.txt
Раздел ten: part10.txt

<?php
$sensitive = ['x2', 'X10', 'x1'];
$insensitive = $sensitive;
natsort($sensitive);
natcasesort($insensitive);
echo json_encode(array_values($sensitive)), "
";
echo json_encode(array_values($insensitive)), "
";

["X10","x1","x2"]
["x1","x2","X10"]

Нюансы и выбор. «Естественный» не означает понимание версий, дат, дробей или всех языков. Ведущие нули и формат чисел важны; для SemVer нужен его собственный договор сравнения. Для обратного результата можно array_reverse(..., true), если хотите сохранить ключи; это также перевернёт порядок равных элементов.

Сравните: natsort, asort, array_reverse. Выбрать операцию по задаче.

• PHP: function.natcasesort

PHP 4+ · standard

uasort(array &$array, callable $callback): true

Задать своё правило порядка значений, сохранив исходные ключи.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Все равные по правилу сравнения элементы сохраняют взаимный порядок с PHP 8.0; раньше он не гарантировался. Указатель массива сбрасывается на первый элемент. Массив меняется на месте: true — статус, не отсортированные данные. В сигнатуре & означает передачу изменяемой переменной; в вызове знак & не ставится. Компаратор — функция сравнения двух элементов. Она возвращает целое число: отрицательное — первый раньше, 0 — равны по выбранному признаку, положительное — первый позже. $a <=> $b даёт -1, 0 или 1. Это не проверка true/false; разность дробей нельзя возвращать вместо целого результата. function ($a, $b) { return ...; } передаёт правило операции, а не вызывает его немедленно.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: передача функции как значения; оператор <=> и условный выбор.

<?php
$weights = ['large' => 2.7, 'small' => 2.1, 'middle' => 2.4];
uasort($weights, function ($left, $right) {
    return $left <=> $right;
});
foreach ($weights as $key => $weight) {
    echo 'Упаковка ', $key, ': ', $weight, " кг\n";
}

Упаковка small: 2.1 кг
Упаковка middle: 2.4 кг
Упаковка large: 2.7 кг

<?php
$orders = ["c" => ["priority" => 2, "id" => 30], "a" => ["priority" => 1, "id" => 20], "b" => ["priority" => 1, "id" => 10]];
uasort($orders, function ($a, $b) {
    $byPriority = $a["priority"] <=> $b["priority"];
    return $byPriority !== 0 ? $byPriority : $a["id"] <=> $b["id"];
});
echo json_encode(array_column($orders, "id")), "\n";
echo json_encode(array_keys($orders)), "\n";

[10,20,30]
["b","a","c"]

Нюансы и выбор. Компаратор должен задавать согласованный порядок, а не решать «эти похожи»: нарушенная транзитивность делает результат ненадёжным. Не выполняйте внутри каждого сравнения сетевой запрос или дорогое преобразование; предварительно вычислите сортировочные поля. Два поля с равным критерием сохраняют исходный порядок в PHP 8, но порядок исходного ответа БД сам по себе может быть не определён без ORDER BY.

Сравните: usort, uksort, sort, array_multisort. Выбрать операцию по задаче.

• PHP: function.uasort
• PHP: array.sorting

PHP 4+ · standard

uksort(array &$array, callable $callback): true

Задать своё правило порядка ключей, сохранив исходные ключи.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Все равные по правилу сравнения элементы сохраняют взаимный порядок с PHP 8.0; раньше он не гарантировался. Указатель массива сбрасывается на первый элемент. Массив меняется на месте: true — статус, не отсортированные данные. В сигнатуре & означает передачу изменяемой переменной; в вызове знак & не ставится. Компаратор — функция сравнения двух элементов. Она возвращает целое число: отрицательное — первый раньше, 0 — равны по выбранному признаку, положительное — первый позже. $a <=> $b даёт -1, 0 или 1. Это не проверка true/false; разность дробей нельзя возвращать вместо целого результата. function ($a, $b) { return ...; } передаёт правило операции, а не вызывает его немедленно.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

Для этого примера: передача функции как значения; оператор <=> и условный выбор.

<?php
$sections = ['footer' => 'Подпись', 'main' => 'Текст', 'header' => 'Заголовок'];
$rank = ['header' => 0, 'main' => 1, 'footer' => 2];
uksort($sections, function ($left, $right) use ($rank) {
    return $rank[$left] <=> $rank[$right];
});
foreach ($sections as $name => $text) {
    echo $name, ': ', $text, "\n";
}

header: Заголовок
main: Текст
footer: Подпись

<?php
$sections = ['footer' => 'F', 'main' => 'M', 'header' => 'H'];
$rank = ['header' => 0, 'main' => 1, 'footer' => 2];
uksort($sections, function ($a, $b) use ($rank) {
    return ($rank[$a] ?? 99) <=> ($rank[$b] ?? 99);
});
echo implode(',', array_keys($sections)), "
";

header,main,footer

Нюансы и выбор. Компаратор должен задавать согласованный порядок, а не решать «эти похожи»: нарушенная транзитивность делает результат ненадёжным. Не выполняйте внутри каждого сравнения сетевой запрос или дорогое преобразование; предварительно вычислите сортировочные поля. Здесь значения callback не передаются; захватывайте отдельную проверенную таблицу через use, если порядок ключей зависит от неё.

Сравните: usort, uasort, sort, array_multisort. Выбрать операцию по задаче.

• PHP: function.uksort
• PHP: array.sorting

PHP 4+ · standard

array_multisort(array &$array1, mixed $array1_sort_order = SORT_ASC, mixed $array1_sort_flags = SORT_REGULAR, mixed ...$rest): true

Синхронно переставить несколько колонок, применяя следующие как дополнительные критерии.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Все равные по правилу сравнения элементы сохраняют взаимный порядок с PHP 8.0; раньше он не гарантировался. Указатель массива сбрасывается на первый элемент. Массив меняется на месте: true — статус, не отсортированные данные. В сигнатуре & означает передачу изменяемой переменной; в вызове знак & не ставится. Колонки соединяются по позиции. Они должны описывать одни и те же строки до сортировки, а не просто иметь одинаковую длину.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
$scores = [90, 90, 70];
$ids = [20, 10, 30];
array_multisort($scores, SORT_DESC, SORT_NUMERIC, $ids, SORT_ASC, SORT_NUMERIC);
foreach ($ids as $position => $id) {
    echo 'Место ', $position + 1, ': ID ', $id, ' — ', $scores[$position], ' баллов', "\n";
}

Место 1: ID 10 — 90 баллов
Место 2: ID 20 — 90 баллов
Место 3: ID 30 — 70 баллов

<?php
$rows = [['id' => 20, 'price' => 100], ['id' => 10, 'price' => 100], ['id' => 30, 'price' => 50]];
$prices = array_column($rows, 'price');
$positions = array_keys($rows);
array_multisort($prices, SORT_ASC, SORT_NUMERIC, $positions, SORT_ASC, SORT_NUMERIC, $rows);
echo json_encode(array_column($rows, 'id')), "
";

[30,20,10]

<?php
$prices = [100, 200];
$ids = [10];
try { array_multisort($prices, $ids); }
catch (ValueError $error) { echo "Разная длина колонок
"; }

Разная длина колонок

Нюансы и выбор. Для небольшого массива записей usort с явным callback может быть понятнее параллельных колонок. Стабильность PHP 8 относится к равенству по всем переданным критериям, а не только первому. Не теряйте числовые ID, используя их как ключи сортируемого массива без отдельного поля.

Сравните: usort, uasort, array_column, array_map. Выбрать операцию по задаче.

• PHP: function.array-multisort
• PHP: array.sorting
• PHP: array.constants

PHP 4+ · standard

current(array|object $array): mixed

прочитать текущее значение без перемещения указателя.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Внутренний указатель — сохранённая позиция внутри массива, а не его числовой ключ. Изначально он указывает на первый добавленный элемент. current/pos и key читают позицию, next/prev/reset/end её меняют. foreach имеет собственный механизм обхода и обычно понятнее для обычного списка.

<?php
$steps = ['address' => 'Проверить адрес', 'pack' => 'Упаковать'];
$caption = current($steps);
echo 'Сейчас: ', $caption, "\n";
echo 'Повторное чтение: ', current($steps), "\n";
next($steps);
echo 'После перехода: ', current($steps), "\n";

Сейчас: Проверить адрес
Повторное чтение: Проверить адрес
После перехода: Упаковать

<?php
$states = ["ready" => false, "count" => 0];
while (key($states) !== null) {
    echo key($states), "=";
    var_dump(current($states));
    next($states);
}
var_dump(current($states));

ready=bool(false)
count=int(0)
bool(false)

Нюансы и выбор. Вызовы этих функций на объектах устарели с PHP 8.1. Для свойств объекта сначала явно выберите представление массива, например get_mangled_object_vars; для Iterator используйте его методы. С PHP 7.4 SPL-объекты здесь рассматриваются как объекты без свойств, а не как команда вызвать одноимённый метод Iterator. Не передавайте результат current в if как единственный признак наличия элемента. Для первого значения без влияния чужих перемещений есть array_first в PHP 8.5+.

Сравните: pos, key, next, reset, array_first. Выбрать операцию по задаче.

• PHP: function.current

PHP 4+ · standard

pos(array|object $array): mixed

Псевдоним current: прочитать текущее значение без перемещения указателя.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Внутренний указатель — сохранённая позиция внутри массива, а не его числовой ключ. Изначально он указывает на первый добавленный элемент. current/pos и key читают позицию, next/prev/reset/end её меняют. foreach имеет собственный механизм обхода и обычно понятнее для обычного списка.

<?php
$steps = ['address' => 'Проверить адрес', 'pack' => 'Упаковать'];
$caption = pos($steps);
echo 'Сейчас: ', $caption, "\n";
echo 'Повторное чтение: ', pos($steps), "\n";
next($steps);
echo 'После перехода: ', pos($steps), "\n";

Сейчас: Проверить адрес
Повторное чтение: Проверить адрес
После перехода: Упаковать

<?php
$states = ["ready" => false, "count" => 0];
while (key($states) !== null) {
    echo key($states), "=";
    var_dump(pos($states));
    next($states);
}
var_dump(pos($states));

ready=bool(false)
count=int(0)
bool(false)

Нюансы и выбор. Вызовы этих функций на объектах устарели с PHP 8.1. Для свойств объекта сначала явно выберите представление массива, например get_mangled_object_vars; для Iterator используйте его методы. С PHP 7.4 SPL-объекты здесь рассматриваются как объекты без свойств, а не как команда вызвать одноимённый метод Iterator. Не передавайте результат current в if как единственный признак наличия элемента. Для первого значения без влияния чужих перемещений есть array_first в PHP 8.5+.

Сравните: current, key, next, reset, array_first. Выбрать операцию по задаче.

• PHP: function.pos
• PHP: function.current

PHP 4+ · standard

key(array|object $array): int|string|null

Прочитать ключ в текущей позиции; null показывает отсутствие позиции.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Внутренний указатель — сохранённая позиция внутри массива, а не его числовой ключ. Изначально он указывает на первый добавленный элемент. current/pos и key читают позицию, next/prev/reset/end её меняют. foreach имеет собственный механизм обхода и обычно понятнее для обычного списка.

<?php
$documents = [10 => 'Накладная A', 50 => 'Накладная B'];
$id = key($documents);
if ($id !== null) { echo 'Выбрано ID ', $id, ': ', $documents[$id], "\n"; }
next($documents);
$id = key($documents);
if ($id !== null) { echo 'Выбрано ID ', $id, ': ', $documents[$id], "\n"; }
next($documents);
if (key($documents) === null) { echo "Больше накладных нет\n"; }

Выбрано ID 10: Накладная A
Выбрано ID 50: Накладная B
Больше накладных нет

<?php
$fields = ['' => 'empty-name', 0 => 'zero'];
while (key($fields) !== null) {
    echo '[', key($fields), ']=', current($fields), "
";
    next($fields);
}

[]=empty-name
[0]=zero

Нюансы и выбор. Вызовы этих функций на объектах устарели с PHP 8.1. Для свойств объекта сначала явно выберите представление массива, например get_mangled_object_vars; для Iterator используйте его методы. С PHP 7.4 SPL-объекты здесь рассматриваются как объекты без свойств, а не как команда вызвать одноимённый метод Iterator. Это ключ внутреннего указателя, не переменная $key из отдельно выполняемого foreach. Для края без перемещения используйте array_key_first/last.

Сравните: current, next, array_key_first, array_key_last. Выбрать операцию по задаче.

• PHP: function.key

PHP 4+ · standard

next(array|object &$array): mixed

Переместить внутренний указатель вперёд на один элемент и прочитать новое значение.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Внутренний указатель — сохранённая позиция внутри массива, а не его числовой ключ. Изначально он указывает на первый добавленный элемент. current/pos и key читают позицию, next/prev/reset/end её меняют. foreach имеет собственный механизм обхода и обычно понятнее для обычного списка. Знак & в сигнатуре обозначает изменяемый аргумент, а не необходимость писать & в вызове.

<?php
$documents = [10 => 'Накладная A', 50 => 'Накладная B', 90 => 'Накладная C'];
$title = next($documents);
if (key($documents) !== null) {
    echo "Текущий документ ID ", key($documents), ": ", $title, "\n";
}
echo "Все документы сохранены:\n";
foreach ($documents as $id => $item) { echo $id, ": ", $item, "\n"; }

Текущий документ ID 50: Накладная B
Все документы сохранены:
10: Накладная A
50: Накладная B
90: Накладная C

<?php
$states = ["start" => 1, "present" => false];
next($states);
var_dump(current($states));
echo key($states) !== null ? "Элемент существует\n" : "Нет позиции\n";
$empty = [];
var_dump(next($empty));

bool(false)
Элемент существует
bool(false)

Нюансы и выбор. Вызовы этих функций на объектах устарели с PHP 8.1. Для свойств объекта сначала явно выберите представление массива, например get_mangled_object_vars; для Iterator используйте его методы. С PHP 7.4 SPL-объекты здесь рассматриваются как объекты без свойств, а не как команда вызвать одноимённый метод Iterator. Для обычного обхода foreach проще ручного управления позицией. Если массив меняется структурно в процессе, пересмотрите договор обхода.

Сравните: prev, reset, end, current, key. Выбрать операцию по задаче.

• PHP: function.next

PHP 4+ · standard

prev(array|object &$array): mixed

Переместить внутренний указатель назад на один элемент и прочитать новое значение.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Внутренний указатель — сохранённая позиция внутри массива, а не его числовой ключ. Изначально он указывает на первый добавленный элемент. current/pos и key читают позицию, next/prev/reset/end её меняют. foreach имеет собственный механизм обхода и обычно понятнее для обычного списка. Знак & в сигнатуре обозначает изменяемый аргумент, а не необходимость писать & в вызове.

<?php
$documents = [10 => 'Накладная A', 50 => 'Накладная B', 90 => 'Накладная C'];
end($documents);
$title = prev($documents);
if (key($documents) !== null) {
    echo "Текущий документ ID ", key($documents), ": ", $title, "\n";
}
echo "Все документы сохранены:\n";
foreach ($documents as $id => $item) { echo $id, ": ", $item, "\n"; }

Текущий документ ID 50: Накладная B
Все документы сохранены:
10: Накладная A
50: Накладная B
90: Накладная C

<?php
$states = ["present" => false, "end" => 1];
end($states);
prev($states);
var_dump(current($states));
echo key($states) !== null ? "Элемент существует\n" : "Нет позиции\n";
$empty = [];
var_dump(prev($empty));

bool(false)
Элемент существует
bool(false)

Нюансы и выбор. Вызовы этих функций на объектах устарели с PHP 8.1. Для свойств объекта сначала явно выберите представление массива, например get_mangled_object_vars; для Iterator используйте его методы. С PHP 7.4 SPL-объекты здесь рассматриваются как объекты без свойств, а не как команда вызвать одноимённый метод Iterator. Для обычного обхода foreach проще ручного управления позицией. Если массив меняется структурно в процессе, пересмотрите договор обхода.

Сравните: next, reset, end, current, key. Выбрать операцию по задаче.

• PHP: function.prev

PHP 4+ · standard

reset(array|object &$array): mixed

Переместить внутренний указатель на первый элемент и прочитать новое значение.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Внутренний указатель — сохранённая позиция внутри массива, а не его числовой ключ. Изначально он указывает на первый добавленный элемент. current/pos и key читают позицию, next/prev/reset/end её меняют. foreach имеет собственный механизм обхода и обычно понятнее для обычного списка. Знак & в сигнатуре обозначает изменяемый аргумент, а не необходимость писать & в вызове.

<?php
$documents = [10 => 'Накладная A', 50 => 'Накладная B', 90 => 'Накладная C'];
end($documents);
$title = reset($documents);
if (key($documents) !== null) {
    echo "Текущий документ ID ", key($documents), ": ", $title, "\n";
}
echo "Все документы сохранены:\n";
foreach ($documents as $id => $item) { echo $id, ": ", $item, "\n"; }

Текущий документ ID 10: Накладная A
Все документы сохранены:
10: Накладная A
50: Накладная B
90: Накладная C

<?php
$states = ["present" => false, "end" => 1];
end($states);
reset($states);
var_dump(current($states));
echo key($states) !== null ? "Элемент существует\n" : "Нет позиции\n";
$empty = [];
var_dump(reset($empty));

bool(false)
Элемент существует
bool(false)

Нюансы и выбор. Вызовы этих функций на объектах устарели с PHP 8.1. Для свойств объекта сначала явно выберите представление массива, например get_mangled_object_vars; для Iterator используйте его методы. С PHP 7.4 SPL-объекты здесь рассматриваются как объекты без свойств, а не как команда вызвать одноимённый метод Iterator. Для безопасного начала повторного обхода явно reset; не рассчитывайте, что копирование массива обязано переместить чужой указатель.

Сравните: next, prev, end, current, key. Выбрать операцию по задаче.

• PHP: function.reset

PHP 4+ · standard

end(array|object &$array): mixed

Переместить внутренний указатель на последний элемент и прочитать новое значение.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Внутренний указатель — сохранённая позиция внутри массива, а не его числовой ключ. Изначально он указывает на первый добавленный элемент. current/pos и key читают позицию, next/prev/reset/end её меняют. foreach имеет собственный механизм обхода и обычно понятнее для обычного списка. Знак & в сигнатуре обозначает изменяемый аргумент, а не необходимость писать & в вызове.

<?php
$documents = [10 => 'Накладная A', 50 => 'Накладная B', 90 => 'Накладная C'];
$title = end($documents);
if (key($documents) !== null) {
    echo "Текущий документ ID ", key($documents), ": ", $title, "\n";
}
echo "Все документы сохранены:\n";
foreach ($documents as $id => $item) { echo $id, ": ", $item, "\n"; }

Текущий документ ID 90: Накладная C
Все документы сохранены:
10: Накладная A
50: Накладная B
90: Накладная C

<?php
$states = ["start" => 1, "present" => false];
end($states);
var_dump(current($states));
echo key($states) !== null ? "Элемент существует\n" : "Нет позиции\n";
$empty = [];
var_dump(end($empty));

bool(false)
Элемент существует
bool(false)

Нюансы и выбор. Вызовы этих функций на объектах устарели с PHP 8.1. Для свойств объекта сначала явно выберите представление массива, например get_mangled_object_vars; для Iterator используйте его методы. С PHP 7.4 SPL-объекты здесь рассматриваются как объекты без свойств, а не как команда вызвать одноимённый метод Iterator. Если нужно только крайнее значение без изменения позиции, используйте array_first/last в PHP 8.5+ либо чтение по array_key_first/last в прежних версиях.

Сравните: next, prev, reset, current, key. Выбрать операцию по задаче.

• PHP: function.end

PHP 4–7; deprecated 7.2, removed 8.0 · standard

Исторически each(array|object &$array): array|false; в PHP 8 отсутствует

Историческая функция чтения пары и перемещения указателя: удалена из PHP 8; нужна для понимания и миграции старого кода.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

Внутренний указатель — сохранённая позиция внутри массива, а не его числовой ключ. Изначально он указывает на первый добавленный элемент. current/pos и key читают позицию, next/prev/reset/end её меняют. foreach имеет собственный механизм обхода и обычно понятнее для обычного списка. Ниже сначала виден старый шаблон, затем два самостоятельных способа переноса. Исторические предупреждения о копировании массива относятся к старому коду each, не являются обещанием современных правил копирования.

<?php
$items = ['x' => 4, 'y' => 9];
while (list($key, $value) = each($items)) {
    echo $key, '=', $value, "
";
}

<?php
$items = ['x' => 4, 'y' => 9];
foreach ($items as $key => $value) { echo $key, '=', $value, "
"; }

x=4
y=9

<?php
$items = ['x' => 4, 'y' => 9, 'z' => 12];
next($items);
while (key($items) !== null) {
    $key = key($items);
    $value = current($items);
    next($items);
    echo $key, '=', $value, "
";
}

y=9
z=12

Нюансы и выбор. При миграции найдите, зависело ли тело от позиции после each, изменяло ли массив, прерывало ли обход и продолжало позднее. Историческое присваивание массива в цикле могло сбрасывать указатель и зацикливать each; нельзя механически обещать эквивалентность для всех таких программ.

Сравните: current, key, next, reset, list. Выбрать операцию по задаче.

• PHP: function.each

PHP 4+ · standard

array_rand(array $array, int $num = 1): int|string|array

Выбрать один или несколько случайных ключей, сохранив исходный массив.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

array_rand и shuffle используют общую глобальную Mt19937-последовательность (с PHP 7.1 вместо libc rand); вызовы других функций с тем же генератором сдвигают её независимо от области видимости. mt_srand/srand с фиксированным seed делают последовательность повторяемой, но не защищённой. Для нового кода PHP Manual рекомендует Random\Randomizer; для непредсказуемости нужен Random\Engine\Secure, а простые безопасные альтернативы — random_int/random_bytes. Это не алгоритм выдачи секретных токенов. Ниже показаны сами выбранные карточки. Фиксированный seed относится только к самостоятельному учебному запуску на указанной версии.

Здесь нужен видимый выбранный текст. Для проверяемого учебного результата мы явно фиксируем начальное состояние генератора через mt_srand(12345). В самостоятельном файле показанный вывод воспроизведён на PHP 8.5.11; в реальной случайной выдаче фиксированное начальное состояние не задают.

<?php
mt_srand(12345);
$cards = ['a' => 'Руководство', 'b' => 'Пример'];
$key = array_rand($cards);
$title = $cards[$key];
echo 'Выбран ключ: ', $key, "\n";
echo 'Карточка дня: ', $title, "\n";

Выбран ключ: a
Карточка дня: Руководство

<?php
mt_srand(12345);
$cards = ['a' => 'Руководство', 'b' => 'Практика', 'c' => 'Задача'];
$keys = array_rand($cards, 2);
foreach ($keys as $key) {
    echo 'Карточка ', $key, ': ', $cards[$key], "\n";
}
try { array_rand($cards, 4); }
catch (ValueError $error) { echo "Нельзя выбрать четыре из трёх\n"; }

Карточка b: Практика
Карточка c: Задача
Нельзя выбрать четыре из трёх

Нюансы и выбор. Выбор рекламной карточки может допускать такой генератор, токен восстановления — нет. Seed не гарантирует одинаковые последовательности между любыми версиями PHP/алгоритмами. Для перемешанного порядка выбранной группы нужна отдельная операция или Randomizer с явным договором.

Сравните: shuffle, array_keys, array_intersect_key. Выбрать операцию по задаче.

• PHP: function.array-rand

PHP 4+ · standard

shuffle(array &$array): true

Перемешать значения на месте, заменив все ключи числовыми индексами.

Обозначения перед первым опытом: ключ, значение и чтение через [ ]; вызов, параметры и результат. var_dump показывает тип и значение; echo выводит текст, а "\n" переносит строку. try/catch в опытах с отказом отделяют успешный результат от исключения: разбор обработки ошибок.

array_rand и shuffle используют общую глобальную Mt19937-последовательность (с PHP 7.1 вместо libc rand); вызовы других функций с тем же генератором сдвигают её независимо от области видимости. mt_srand/srand с фиксированным seed делают последовательность повторяемой, но не защищённой. Для нового кода PHP Manual рекомендует Random\Randomizer; для непредсказуемости нужен Random\Engine\Secure, а простые безопасные альтернативы — random_int/random_bytes. Это не алгоритм выдачи секретных токенов. Знак & в сигнатуре означает изменение переданной переменной. Учебный seed позволяет увидеть точный порядок в самостоятельном запуске; без такого условия единственного заранее известного порядка нет.

В выводе примеров json_encode только показывает форму результата: [...] — список, {...} — именованные поля. Это отдельное преобразование в текст; как читать такой вывод.

<?php
mt_srand(12345);
$tasks = ['a' => 'Адрес', 'b' => 'Упаковка', 'c' => 'Накладная'];
$status = shuffle($tasks);
if ($status) { echo "Порядок подготовлен\n"; }
foreach ($tasks as $position => $task) {
    echo 'Позиция ', $position, ': ', $task, "\n";
}

Порядок подготовлен
Позиция 0: Накладная
Позиция 1: Упаковка
Позиция 2: Адрес

<?php
mt_srand(12345);
$questions = [['id' => 40, 'text' => 'Что такое переменная?'], ['id' => 70, 'text' => 'Что возвращает функция?']];
shuffle($questions);
foreach ($questions as $position => $question) {
    echo 'Вопрос ', $position + 1, ' [ID ', $question['id'], ']: ', $question['text'], "\n";
}
$empty = [];
shuffle($empty);
if ($empty === []) { echo "Пустая подборка осталась пустой\n"; }

Вопрос 1 [ID 70]: Что возвращает функция?
Вопрос 2 [ID 40]: Что такое переменная?
Пустая подборка осталась пустой

Нюансы и выбор. Не присваивайте $items = shuffle($items): получите true вместо списка. Для сохранения внешних ключей можно перемешать отдельный список ключей и читать исходный словарь по нему. Randomizer удобен для отдельного экземпляра генератора без скрытого общего состояния.

Сравните: array_rand, array_keys, array_values. Выбрать операцию по задаче.

• PHP: function.shuffle