PHP array_slice(): pegar uma parte de um array

array_slice($array, $offset, $length) retorna um novo array com $length elementos a partir da posição $offset. O array original não é alterado. Deixe de fora $length para pegar tudo até o fim.

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

O offset é uma posição (0 é o primeiro elemento), não uma chave. Isso importa para arrays associativos e para arrays cujas chaves não são 0, 1, 2.

Pegar os N últimos elementos com um offset negativo

Um offset negativo conta a partir do fim: -1 é o último elemento, -3 começa três antes do fim. Um tamanho negativo para essa quantidade de elementos antes do fim.

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

Pedir mais elementos do que existem não tem problema: array_slice($log, 0, 100) retorna os cinco.

Manter as chaves originais com preserve_keys

As chaves inteiras são renumeradas a partir de 0, a menos que você passe true como quarto argumento. Chaves string sempre são mantidas.

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

Use true quando as chaves significam algo, como ids do banco de dados, e você vai procurar elementos por elas depois.

Paginar um array com array_slice

Mostrar a página $page de uma lista com $perPage itens por página é um único slice: o offset é ($page - 1) * $perPage. Este exemplo imprime uma lista HTML com links de página. Rode e clique num número de página: o mesmo script roda de novo com $_GET['page'] definido pelo link.

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

A linha max(1, min($pages, ...)) mantém um ?page=99 ou ?page=-1 digitado à mão dentro do intervalo válido. Com um banco de dados, você pediria só uma página com LIMIT e OFFSET em vez de carregar todas as linhas, mas para uma lista que já está na memória, o array_slice faz o trabalho inteiro.

array_slice ou array_splice

Os nomes diferem por uma letra e eles fazem coisas opostas com o original. O array_slice copia uma parte. O array_splice corta a parte do array que você passa, renumera e retorna os elementos removidos. Ele também pode inserir substitutos onde foi o corte.

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

Para mais jeitos de apagar elementos, veja remover elementos de um array.

Dividir um array em pedaços

Quando você precisa de todas as páginas de uma vez, por exemplo para dispor produtos em linhas de três, o array_chunk faz os slices repetidos para você.

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

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

Mude o 3 para 2 ou 4 e rode de novo. O último pedaço guarda o que sobrar.