Funktion array_multisort

Die Funktion array_multisort ermöglicht das gleichzeitige Sortieren mehrerer Arrays oder das Durchführen komplexer Sortierungen mehrdimensionaler Arrays nach einem oder mehreren Kriterien.

Syntax

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

Parameter sorting_order

Der Parameter sorting_order legt die Sortierrichtung fest. Hier sind seine Werte:

Parameter	Beschreibung
`SORT_ASC`	Aufsteigende Sortierung (Standardwert).
`SORT_DESC`	Absteigende Sortierung.

Parameter sorting_type

Der Parameter sorting_type legt den Vergleichstyp der Elemente fest. Hier sind seine Werte:

Parameter	Beschreibung
`SORT_REGULAR`	Normaler Elementvergleich (Standard).
`SORT_NUMERIC`	Numerischer Elementvergleich.
`SORT_STRING`	Zeichenkettenvergleich der Elemente.
`SORT_LOCALE_STRING`	Zeichenkettenvergleich unter Berücksichtigung des aktuellen Locale.
`SORT_NATURAL`	Natürliche Sortierung von Zeichenketten (wie im Explorer).
`SORT_FLAG_CASE`	Kombiniert mit SORT_STRING oder SORT_NATURAL für case-insensitive Sortierung.

Beispiel

Sortierung zweier Arrays mit Angabe der Parameter:

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

Ergebnis der Codeausführung:

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

Beispiel

Sortierung eines mehrdimensionalen Arrays nach einem bestimmten Feld:

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

Ergebnis der Codeausführung:

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

Beispiel

Sortierung eines mehrdimensionalen Arrays nach zwei bestimmten Feldern:

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

Ergebnis der Codeausführung:

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

Beispiel

Natürliche Sortierung von Zeichenketten:

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

Ergebnis der Codeausführung:

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

Beispiel

Case-insensitive Sortierung:

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

Ergebnis der Codeausführung:

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

Siehe auch

Funktion sort,
die nach aufsteigenden Elementen sortiert
Funktion rsort,
die nach absteigenden Elementen sortiert
Funktion ksort,
die nach aufsteigenden Schlüsseln sortiert
Funktion krsort,
die nach absteigenden Schlüsseln sortiert
Funktion asort,
die nach aufsteigenden Elementen mit Schlüsselerhalt sortiert
Funktion arsort,
die nach absteigenden Elementen mit Schlüsselerhalt sortiert
Funktion natsort,
die auf natürliche Weise sortiert
Funktion natcasesort,
die auf natürliche Weise ohne Berücksichtigung der Groß-/Kleinschreibung sortiert
Funktion usort,
die nach Callback sortiert
Funktion uksort,
die nach Callback nach Schlüsseln sortiert
Funktion uasort,
die nach Callback mit Schlüsselerhalt sortiert