add ArraySort

Author: MartkCz

src/ArraySort.php

@@ -0,0 +1,38 @@
+<?php declare(strict_types = 1);
+
+namespace Utilitte\Php;
+
+final class ArraySort
+{
+
+	/**
+	 * @param mixed[] $sortBy
+	 * @param mixed[] $values
+	 * @return mixed[]
+	 */
+	public static function byGivenValues(array $sortBy, array $values, callable $idGetter): array
+	{
+		$valuesById = [];
+
+		foreach ($values as $value) {
+			$valuesById[$idGetter($value)] = $value;
+		}
+
+		$sorted = [];
+
+		foreach ($sortBy as $id) {
+			if (isset($valuesById[$id])) {
+				$sorted[] = $valuesById[$id];
+
+				unset($valuesById[$id]);
+			}
+		}
+
+		foreach ($valuesById as $value) {
+			$sorted[] = $value;
+		}
+
+		return $sorted;
+	}
+
+}

tests/cases/arraySort.byGivenValues.phpt

@@ -0,0 +1,20 @@
+<?php declare(strict_types = 1);
+
+use Tester\Assert;
+use Utilitte\Php\ArraySort;
+
+require __DIR__ . '/../bootstrap.php';
+
+Assert::same([
+	['id' => 5],
+	['id' => 1],
+	['id' => 3],
+], ArraySort::byGivenValues(
+	[5, 1, 3],
+	[
+		['id' => 1],
+		['id' => 3],
+		['id' => 5],
+	],
+	fn (array $value) => $value['id'],
+));