الدالة array_slice() في PHP: أخذ جزء من مصفوفة

تعيد array_slice($array, $offset, $length) مصفوفة جديدة فيها $length من العناصر بدءًا من الموضع $offset. ولا تتغير المصفوفة الأصلية. احذف $length لتأخذ كل شيء حتى النهاية.

<?php
$letters = ["a", "b", "c", "d", "e", "f"];

print_r(array_slice($letters, 0, 3)); // first three
print_r(array_slice($letters, 2));    // from position 2 to the end
print_r($letters);                    // unchanged

الإزاحة موضع (0 هو العنصر الأول)، لا مفتاح. وهذا مهم للمصفوفات الترابطية وللمصفوفات التي ليست مفاتيحها 0, 1, 2.

الحصول على آخر N عنصر بإزاحة سالبة

الإزاحة السالبة تُعدّ من النهاية: -1 هو العنصر الأخير، و-3 تبدأ من الثالث قبل النهاية. والطول السالب يتوقف قبل النهاية بذلك العدد من العناصر.

<?php
$log = ["boot", "login", "upload", "resize", "logout"];

print_r(array_slice($log, -2));     // last two
print_r(array_slice($log, 1, -1));  // drop the first and the last
print_r(array_slice($log, -3, 2));  // two, starting three from the end

طلب عناصر أكثر مما يوجد لا مشكلة فيه: تعيد array_slice($log, 0, 100) العناصر الخمسة كلها.

الاحتفاظ بالمفاتيح الأصلية بـ preserve_keys

يُعاد ترقيم المفاتيح الصحيحة من 0 ما لم تمرر true وسيطًا رابعًا. أما المفاتيح النصية فتُحفظ دائمًا.

<?php
$ranked = [10 => "gold", 20 => "silver", 30 => "bronze", 40 => "fourth"];

print_r(array_slice($ranked, 1, 2));
print_r(array_slice($ranked, 1, 2, true));

$prices = ["tea" => 3, "coffee" => 4, "juice" => 5, "water" => 1];
print_r(array_slice($prices, 1, 2)); // string keys kept anyway

استخدم true عندما يكون للمفاتيح معنى، مثل معرّفات قاعدة البيانات، وستبحث عن العناصر بها لاحقًا.

تقسيم مصفوفة إلى صفحات بـ array_slice

عرض الصفحة $page من قائمة فيها $perPage عنصرًا في كل صفحة هو اقتطاع واحد: الإزاحة هي ($page - 1) * $perPage. يطبع هذا المثال قائمة HTML مع روابط للصفحات. شغّله وانقر على رقم صفحة: يعمل السكربت نفسه مرة أخرى مع ضبط $_GET['page'] من الرابط.

<?php
$items = [];
for ($i = 1; $i <= 23; $i++) {
    $items[] = "Item $i";
}

$perPage = 5;
$pages = (int) ceil(count($items) / $perPage);
$page = max(1, min($pages, (int) ($_GET['page'] ?? 1)));

$visible = array_slice($items, ($page - 1) * $perPage, $perPage);

echo "<p>Page $page of $pages</p>\n<ul>\n";
foreach ($visible as $item) {
    echo "  <li>$item</li>\n";
}
echo "</ul>\n<p>";
for ($p = 1; $p <= $pages; $p++) {
    echo $p === $page ? " <strong>$p</strong>" : " <a href=\"?page=$p\">$p</a>";
}
echo "</p>\n";

يُبقي السطر max(1, min($pages, ...)) قيمة مكتوبة يدويًا مثل ?page=99 أو ?page=-1 ضمن النطاق الصحيح. مع قاعدة بيانات ستطلب صفحة واحدة فقط بـ LIMIT وOFFSET بدل تحميل كل الصفوف، لكن لقائمة موجودة في الذاكرة أصلًا، تؤدي array_slice المهمة كلها.

array_slice مقابل array_splice

يختلف الاسمان بحرف واحد ويفعلان بالأصل شيئين متعاكسين. تنسخ array_slice جزءًا إلى الخارج. وتقتطع array_splice الجزء من المصفوفة التي تمررها، وتعيد ترقيمها، وتعيد العناصر المحذوفة. وتستطيع أيضًا إدراج بدائل مكان القطع.

<?php
$a = ["mon", "tue", "wed", "thu", "fri"];
$copy = array_slice($a, 1, 2);
echo "slice returned: " . implode(", ", $copy) . "\n";
echo "original now:   " . implode(", ", $a) . "\n\n";

$b = ["mon", "tue", "wed", "thu", "fri"];
$cut = array_splice($b, 1, 2);
echo "splice returned: " . implode(", ", $cut) . "\n";
echo "original now:    " . implode(", ", $b) . "\n\n";

$c = ["mon", "tue", "wed", "thu", "fri"];
array_splice($c, 1, 2, ["TUE", "WED", "extra"]);
echo "replaced: " . implode(", ", $c) . "\n";

لطرق أخرى لحذف العناصر، راجع حذف العناصر من مصفوفة.

تقسيم مصفوفة إلى أجزاء

عندما تحتاج إلى كل الصفحات معًا، مثلًا لعرض المنتجات في صفوف من ثلاثة، تقوم array_chunk بالاقتطاع المتكرر نيابة عنك.

<?php
$products = ["Lamp", "Desk", "Chair", "Shelf", "Rug", "Mirror", "Clock"];

foreach (array_chunk($products, 3) as $i => $row) {
    echo "Row " . ($i + 1) . ": " . implode(" | ", $row) . "\n";
}

غيّر 3 إلى 2 أو 4 وشغّله مرة أخرى. ويحمل الجزء الأخير ما تبقى.