萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 陣列分組函數:依指定數量平均分割、支援餘數分配、多維陣列適用

核心函數 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) 會增加記憶體開銷。
copyright © 萬盛學電腦網 all rights reserved