array_slice() 從陣列中提取指定範圍的片段,回傳新陣列。是實作分頁、資料截取、陣列分段處理的核心函數。
array_slice(array $array, int $offset, int $length = null, bool $preserve_keys = false): array
| 參數 | 說明 |
|---|---|
$array | 必填,目標陣列 |
$offset | 必填,起始位置;0=第一個元素,負數=從末尾倒數 |
$length | 選填,提取長度;負數=從末尾倒數停止;省略=提取到結尾 |
$preserve_keys | 選填,true 保留原鍵名,false(預設)重新索引 |
<?php
$a = [0 => "Dog", 1 => "Cat", 2 => "Horse", 3 => "Bird"];
print_r(array_slice($a, 1, 2));
/*
Array ( [0] => Cat [1] => Horse )
*/
?>
<?php
$a = [0 => "Dog", 1 => "Cat", 2 => "Horse", 3 => "Bird"];
print_r(array_slice($a, -2, 1));
/*
Array ( [0] => Horse )
*/
?>
<?php
$a = ["a" => "Cat", "b" => "Dog", "c" => "Horse"];
print_r(array_slice($a, 1, 2, true));
/*
Array ( [b] => Dog [c] => Horse )
*/
?>
<?php
$page = isset($_GET['page']) ? max(1, (int)$_GET['page']) : 1;
$perPage = 15;
$offset = ($page - 1) * $perPage;
$allData = range(1, 100); // 模擬 100 筆資料
$pageData = array_slice($allData, $offset, $perPage);
echo "第 $page 頁資料: " . implode(", ", $pageData);
?>
$preserve_keys 僅影響數值索引。$offset 超出陣列長度回傳空陣列,不會報錯。| 函數 | 用途 |
|---|---|
array_slice() | 提取片段(不修改原陣列) |
array_splice() | 移除並可選插入元素(修改原陣列) |
array_chunk() | 等長分割為多個子陣列 |
掌握 array_slice() 是處理大量資料分頁、批次、截取的關鍵技能。