ترتيب المصفوفات في PHP: sort() وusort() وasort() وksort()

ترتّب sort($array) مصفوفة ترتيبًا تصاعديًا، في مكانها. تغيّر المتغير الذي تمرره وتعيد true، لذا تستدعيها في سطر مستقل ثم تستخدم المصفوفة. وترتّب rsort() ترتيبًا تنازليًا.

<?php
$numbers = [42, 7, 19, 3, 25];
sort($numbers);
print_r($numbers);

$fruits = ["pear", "apple", "fig", "banana"];
rsort($fruits);
print_r($fruits);

لدى PHP دالة ترتيب لكل تركيبة من «حسب القيمة أو حسب المفتاح» و«تصاعدي أو تنازلي» و«الاحتفاظ بالمفاتيح أو لا»:

ترتيب مصفوفة ترابطية حسب القيمة

ترمي sort() على مصفوفة ترابطية المفاتيح. استخدم asort() للترتيب حسب القيمة مع إبقاء كل مفتاح مع قيمته، أو arsort() للأعلى أولًا.

<?php
$scores = ["Ada" => 92, "Bob" => 67, "Cy" => 85, "Dee" => 74];

$copy = $scores;
sort($copy);
print_r($copy); // names are gone

arsort($scores);
print_r($scores); // highest first, names kept

echo "Winner: " . array_key_first($scores) . "\n";

ترتيب مصفوفة حسب المفتاح بـ ksort

ترتّب ksort() حسب المفتاح، وkrsort() حسب المفتاح عكسيًا. وهذا مفيد قبل طباعة الإعدادات أو بناء نص استعلام بترتيب ثابت.

<?php
$params = ["page" => 2, "category" => "books", "author" => "le guin", "sort" => "year"];

ksort($params);
print_r($params);

echo http_build_query($params), "\n";

ترتيب مخصص بـ usort وعامل المركبة الفضائية

تتيح لك usort($array, $callback) أن تقرر الترتيب. تتلقى دالة الاستدعاء عنصرين وتعيد عددًا سالبًا إذا كان يجب أن يأتي الأول أولًا، وعددًا موجبًا إذا كان يجب أن يأتي الثاني، و0 إذا كانا متساويين. ويعيد عامل المركبة الفضائية <=> هذا بالضبط.

<?php
$words = ["banana", "fig", "cherry", "kiwi", "apple"];

// Shortest first
usort($words, fn($a, $b) => strlen($a) <=> strlen($b));
print_r($words);

// Longest first: swap $a and $b
usort($words, fn($a, $b) => strlen($b) <=> strlen($a));
print_r($words);

لـ banana وcherry الطول نفسه، لذا تعيد دالة الاستدعاء 0 لهما ويبقيان بالترتيب الذي كانا عليه. الترتيب في PHP مستقر منذ PHP 8.0: العناصر المتساوية تحتفظ بترتيبها السابق.

ترتيب مصفوفة متعددة الأبعاد حسب قيمة

لترتيب قائمة من الصفوف حسب حقل واحد، قارن ذلك الحقل في usort. وللترتيب حسب حقلين، قارن مصفوفات: يقارنها <=> عنصرًا عنصرًا، فلا يحسم الحقل الثاني إلا التعادل في الأول.

<?php
$people = [
    ["name" => "Ada", "city" => "London", "age" => 36],
    ["name" => "Linus", "city" => "Helsinki", "age" => 28],
    ["name" => "Grace", "city" => "New York", "age" => 45],
    ["name" => "Alan", "city" => "London", "age" => 41],
];

// By age, youngest first
usort($people, fn($a, $b) => $a["age"] <=> $b["age"]);
echo implode(", ", array_column($people, "name")), "\n";

// By city, then oldest first within a city
usort($people, fn($a, $b) =>
    [$a["city"], $b["age"]] <=> [$b["city"], $a["age"]]
);
foreach ($people as $p) {
    echo "{$p['city']}: {$p['name']} ({$p['age']})\n";
}

تضع المقارنة الثانية $b["age"] في الطرف الأول و$a["age"] في الطرف الثاني، وهذا يعكس ترتيب العمر وحده. وتعطي array_multisort(array_column($people, 'city'), SORT_ASC, array_column($people, 'age'), SORT_DESC, $people) الترتيب نفسه دون دالة استدعاء: ترتّب حسب الأعمدة المستخرجة وتعيد ترتيب $people لتطابقها.

الترتيب الطبيعي وأعلام الترتيب

افتراضيًا تقارن PHP الأعداد أعدادًا والنصوص نصوصًا. وأسماء الملفات التي فيها أرقام تُرتَّب بطريقة لا يتوقعها الناس: يأتي img10 قبل img2، ويأتي كل اسم بأحرف كبيرة قبل كل اسم بأحرف صغيرة. تغيّر الأعلام طريقة مقارنة القيم.

<?php
$files = ["img12.png", "img10.png", "img2.png", "IMG1.png"];

$plain = $files;
sort($plain);
print_r($plain);

$natural = $files;
sort($natural, SORT_NATURAL | SORT_FLAG_CASE);
print_r($natural);

$mixed = ["10", "9", "2", "1"];
sort($mixed, SORT_STRING);
print_r($mixed);

يقرأ SORT_NATURAL سلاسل الأرقام أعدادًا، ويتجاهل SORT_FLAG_CASE الأحرف الكبيرة والصغيرة، ويفرض SORT_STRING مقارنة محرفًا محرفًا حتى للنصوص الرقمية. وnatsort() وnatcasesort() الفكرة نفسها لكنهما تحتفظان بالمفاتيح.

خطأ شائع: إسناد نتيجة sort

كل دالة ترتيب تعيد true وتغيّر المصفوفة التي تمررها. وإسناد القيمة المعادة يضيّع المصفوفة:

<?php
$list = [3, 1, 2];

$sorted = sort($list);
var_dump($sorted); // bool(true), not an array
print_r($list);    // this is the sorted array

إذا احتجت إلى نسخة مرتبة وأردت الاحتفاظ بالأصل، فانسخ المصفوفة إلى متغير جديد أولًا ورتّب النسخة، كما يفعل مثال asort أعلاه مع $copy.