核心函數 splitArray()
<?php
/**
* 將陣列按指定組數平均分割
* @param array $array 要分割的陣列
* @param int $groupNum 分組數量
* @param bool $preserveKeys 是否保留原鍵名 (預設 false,重新索引)
* @return array 分組後的二維陣列
*/
function splitArray(array $array, int $groupNum, bool $preserveKeys = false): array {
if (empty($array) || $groupNum <= 0) return [];
$total = count($array);
$groupNum = min($groupNum, $total); // 組數不超過總數
// 每組基礎大小
$baseSize = (int)floor($total / $groupNum);
$remainder = $total % $groupNum; // 餘數分配給前幾組
$result = [];
$offset = 0;
for ($i = 0; $i < $groupNum; $i++) {
// 前 $remainder 組多分 1 個
$size = $baseSize + ($i < $remainder ? 1 : 0);
if ($preserveKeys) {
$result[] = array_slice($array, $offset, $size, true);
} else {
$result[] = array_values(array_slice($array, $offset, $size));
}
$offset += $size;
}
return $result;
}
// 測試
$data = range(1, 17); // 17 個元素
print_r(splitArray($data, 5));
/*
結果:5 組,大小分布 4,4,3,3,3
Array
(
[0] => Array ( [0]=>1 [1]=>2 [2]=>3 [3]=>4 )
[1] => Array ( [0]=>5 [1]=>6 [2]=>7 [3]=>8 )
[2] => Array ( [0]=>9 [1]=>10 [2]=>11 )
[3] => Array ( [0]=>12 [1]=>13 [2]=>14 )
[4] => Array ( [0]=>15 [1]=>16 [2]=>17 )
)
*/
?>
進階版:支援多種分割策略
<?php
class ArrayChunker {
public const STRATEGY_EVEN = 'even'; // 盡量平均 (預設)
public const STRATEGY_FILL_FIRST = 'fill_first'; // 前面組滿
public const STRATEGY_FILL_LAST = 'fill_last'; // 後面組滿
public const STRATEGY_FIXED_SIZE = 'fixed_size'; // 固定大小 (最後一組可能較小)
/**
* @param array $array
* @param int $groupsOrSize 組數 (STRATEGY_EVEN/FILL_FIRST/FILL_LAST) 或 每組大小 (FIXED_SIZE)
* @param string $strategy
* @param bool $preserveKeys
* @return array
*/
public static function chunk(
array $array,
int $groupsOrSize,
string $strategy = self::STRATEGY_EVEN,
bool $preserveKeys = false
): array {
if (empty($array) || $groupsOrSize <= 0) return [];
$total = count($array);
switch ($strategy) {
case self::STRATEGY_FIXED_SIZE:
$chunkSize = $groupsOrSize;
return array_chunk($array, $chunkSize, $preserveKeys);
case self::STRATEGY_FILL_FIRST:
$groupNum = min($groupsOrSize, $total);
$baseSize = (int)ceil($total / $groupNum);
return self::chunkBySize($array, $groupNum, $baseSize, $preserveKeys);
case self::STRATEGY_FILL_LAST:
$groupNum = min($groupsOrSize, $total);
$baseSize = (int)floor($total / $groupNum);
return self::chunkBySize($array, $groupNum, $baseSize, $preserveKeys, true);
case self::STRATEGY_EVEN:
default:
return self::chunkEven($array, min($groupsOrSize, $total), $preserveKeys);
}
}
private static function chunkEven(array $array, int $groups, bool $preserveKeys): array {
$total = count($array);
$baseSize = (int)floor($total / $groups);
$remainder = $total % $groups;
$result = [];
$offset = 0;
for ($i = 0; $i < $groups; $i++) {
$size = $baseSize + ($i < $remainder ? 1 : 0);
$result[] = $preserveKeys
? array_slice($array, $offset, $size, true)
: array_values(array_slice($array, $offset, $size));
$offset += $size;
}
return $result;
}
private static function chunkBySize(array $array, int $groups, int $baseSize, bool $preserveKeys, bool $fillLast = false): array {
$result = [];
$offset = 0;
for ($i = 0; $i < $groups; $i++) {
$isLast = ($i === $groups - 1);
$size = $isLast && $fillLast
? count($array) - $offset
: min($baseSize, count($array) - $offset);
if ($size <= 0) break;
$result[] = $preserveKeys
? array_slice($array, $offset, $size, true)
: array_values(array_slice($array, $offset, $size));
$offset += $size;
}
return $result;
}
}
// 使用範例
$data = range('A', 'Z'); // 26 個元素
echo "平均分 5 組:\n";
print_r(ArrayChunker::chunk($data, 5, ArrayChunker::STRATEGY_EVEN));
echo "\n固定每組 6 個:\n";
print_r(ArrayChunker::chunk($data, 6, ArrayChunker::STRATEGY_FIXED_SIZE));
echo "\n前面組滿 (5組):\n";
print_r(ArrayChunker::chunk($data, 5, ArrayChunker::STRATEGY_FILL_FIRST));
echo "\n後面組滿 (5組):\n";
print_r(ArrayChunker::chunk($data, 5, ArrayChunker::STRATEGY_FILL_LAST));
?>
內建函數 array_chunk() 快速參考
<?php
$arr = [1,2,3,4,5,6,7];
// 固定大小分塊
array_chunk($arr, 3);
// [[1,2,3], [4,5,6], [7]]
// 保留鍵名
array_chunk($arr, 3, true);
// [[0=>1,1=>2,2=>3], [3=>4,4=>5,5=>6], [6=>7]]
?>
應用場景
- 平行處理:將大量任務分派給多個 Worker 進程/佇列。
- 分頁顯示:二維陣列直接對應頁碼。
- 批次資料庫操作:大量 INSERT/UPDATE 分批執行,避免超時或鎖表。
- 前端網格佈局:每行 N 欄,資料分組輸出。
- CSV/Excel 分檔匯出:大量資料分多檔案。
效能提示
array_slice 會複製陣列片段,大陣列分割會佔用記憶體。
- 超大陣列 (10萬+) 建議使用 Generator 逐塊產生,而非一次建立完整二維陣列。
- 保留鍵名 (
preserveKeys=true) 會增加記憶體開銷。