Функция array_multisort

Функция array_multisort позволяет сортировать несколько массивов одновременно или производить сложную сортировку многомерных массивов по одному или нескольким критериям.

Синтаксис

array_multisort(
	array1, 
	[sorting_order = SORT_ASC], 
	[sorting_type = SORT_REGULAR], 
	array2, 
	array3, 
	...
);

Параметр sorting_order

Параметр sorting_order задает направление сортировки. Вот его значения:

Параметр	Описание
`SORT_ASC`	Сортировка по возрастанию (значение по умолчанию).
`SORT_DESC`	Сортировка по убыванию.

Параметр sorting_type

Параметр sorting_type задает тип сравнения элементов. Вот его значения:

Параметр	Описание
`SORT_REGULAR`	Обычное сравнение элементов (по умолчанию).
`SORT_NUMERIC`	Числовое сравнение элементов.
`SORT_STRING`	Строковое сравнение элементов.
`SORT_LOCALE_STRING`	Строковое сравнение с учетом текущей локали.
`SORT_NATURAL`	Естественная сортировка строк (как в проводнике).
`SORT_FLAG_CASE`	Комбинируется с SORT_STRING или SORT_NATURAL для регистронезависимой сортировки.

Пример

Сортировка двух массивов с указанием параметров:

<?php
	$numbers = [10, 2, 15, 4];
	$letters = ['b', 'a', 'd', 'c'];
	array_multisort(
		$numbers, SORT_DESC, SORT_NUMERIC,
		$letters, SORT_ASC, SORT_STRING
	);
	print_r($numbers);
	print_r($letters);
?>

Результат выполнения кода:

[15, 10, 4, 2]
['d', 'b', 'c', 'a']

Пример

Сортировка многомерного массива по заданному полю:

<?php
	$data = [
		['name' => 'John', 'age' => 25],
		['name' => 'Alice', 'age' => 22],
		['name' => 'Bob', 'age' => 30]
	];
	
	$ages = array_column($data, 'age');
	array_multisort($ages, SORT_ASC, $data);
	print_r($data);
?>

Результат выполнения кода:

[
	['name' => 'Alice', 'age' => 22],
	['name' => 'John', 'age' => 25],
	['name' => 'Bob', 'age' => 30]
]

Пример

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

<?php
	$data = [
		['name' => 'John', 'age' => 25],
		['name' => 'alice', 'age' => 22],
		['name' => 'Bob', 'age' => 30]
	];
	
	$names = array_column($data, 'name');
	$ages = array_column($data, 'age');
	array_multisort(
		$names, SORT_ASC, SORT_STRING | SORT_FLAG_CASE,
		$ages, SORT_DESC,
		$data
	);
	print_r($data);
?>

Результат выполнения кода:

[
	['name' => 'alice', 'age' => 22],
	['name' => 'Bob', 'age' => 30],
	['name' => 'John', 'age' => 25]
]

Пример

Естественная сортировка строк:

<?php
	$files = ['file1.txt', 'file10.txt', 'file2.txt'];
	array_multisort($files, SORT_ASC, SORT_NATURAL);
	print_r($files);
?>

Результат выполнения кода:

['file1.txt', 'file2.txt', 'file10.txt']

Пример

Регистронезависимая сортировка:

<?php
	$words = ['Apple', 'banana', 'cherry', 'apricot'];
	array_multisort($words, SORT_ASC, SORT_STRING | SORT_FLAG_CASE);
	print_r($words);
?>

Результат выполнения кода:

['Apple', 'apricot', 'banana', 'cherry']

Смотрите также

функцию sort,
которая сортирует по возрастанию элементов
функцию rsort,
которая сортирует по убыванию элементов
функцию ksort,
которая сортирует по возрастанию ключей
функцию krsort,
которая сортирует по убыванию ключей
функцию asort,
которая сортирует по возрастанию элементов с сохранением ключей
функцию arsort,
которая сортирует по убыванию элементов с сохранением ключей
функцию natsort,
которая сортирует натуральным образом
функцию natcasesort,
которая сортирует натуральным образом без регистра
функцию usort,
которая сортирует по коллбэку
функцию uksort,
которая сортирует по коллбэку по ключам
функцию uasort,
которая сортирует по коллбэку с сохранением ключей