PHP array_slice() : extraire une partie d'un tableau

array_slice($array, $offset, $length) renvoie un nouveau tableau avec $length éléments à partir de la position $offset. Le tableau d'origine n'est pas modifié. Omettez $length pour tout prendre jusqu'à la fin.

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

La position est un rang (0 est le premier élément), pas une clé. Cela compte pour les tableaux associatifs et pour les tableaux dont les clés ne sont pas 0, 1, 2.

Obtenir les N derniers éléments avec une position négative

Une position négative compte depuis la fin : -1 est le dernier élément, -3 commence trois éléments avant la fin. Une longueur négative s'arrête autant d'éléments avant la fin.

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

Demander plus d'éléments qu'il n'en existe ne pose pas de problème : array_slice($log, 0, 100) renvoie les cinq.

Garder les clés d'origine avec preserve_keys

Les clés entières sont renumérotées depuis 0 sauf si vous passez true en quatrième argument. Les clés de type chaîne sont toujours gardées.

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

Utilisez true quand les clés ont un sens, comme des identifiants de base de données, et que vous chercherez ensuite des éléments par elles.

Paginer un tableau avec array_slice

Afficher la page $page d'une liste avec $perPage éléments par page tient en une découpe : la position vaut ($page - 1) * $perPage. Cet exemple affiche une liste HTML avec des liens de pages. Exécutez-le et cliquez sur un numéro de page : le même script s'exécute à nouveau avec $_GET['page'] défini par le lien.

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

La ligne max(1, min($pages, ...)) garde un ?page=99 ou ?page=-1 tapé à la main dans la plage valide. Avec une base de données, vous ne demanderiez qu'une page avec LIMIT et OFFSET au lieu de charger toutes les lignes, mais pour une liste déjà en mémoire, array_slice fait tout le travail.

array_slice ou array_splice

Les noms diffèrent d'une lettre et ils font l'inverse l'un de l'autre sur l'original. array_slice copie une partie. array_splice découpe la partie dans le tableau que vous passez, le renumérote et renvoie les éléments retirés. Elle peut aussi insérer des remplacements à l'endroit de la découpe.

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

Pour d'autres façons de supprimer des éléments, voir supprimer des éléments d'un tableau.

Découper un tableau en morceaux

Quand vous avez besoin de toutes les pages à la fois, par exemple pour disposer des produits en rangées de trois, array_chunk fait les découpes répétées pour vous.

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

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

Remplacez le 3 par 2 ou 4 et relancez. Le dernier morceau contient ce qui reste.