PHP 實用陣列工具函數：除錯輸出、移除空值、分組分頁

1. 除錯輸出 dump()

支援 HTML/CLI 環境自動切換，可選擇回傳字串而非直接輸出。

function dump($vars, $label = '', $return = false) {
    if (ini_get('html_errors')) {
        $out = "<pre>\n";
        if ($label) $out .= "<strong>$label :</strong>\n";
        $out .= htmlspecialchars(print_r($vars, true));
        $out .= "\n</pre>\n";
    } else {
        $out = $label . " :\n" . print_r($vars, true);
    }
    if ($return) return $out;
    echo $out;
    return null;
}

// 用法
dump($_POST, 'POST Data');
$log = dump($bigArray, 'Debug', true); // 寫入日誌檔
file_put_contents('debug.log', $log, FILE_APPEND);

2. 遞迴移除空值 array_remove_empty()

預設同時 trim() 非空字串，可關閉。

function array_remove_empty(array &$arr, $trim = true) {
    foreach ($arr as $key => &$val) {
        if (is_array($val)) {
            array_remove_empty($val, $trim);
            if (empty($val)) unset($arr[$key]); // 遞迴後若成空陣列也移除
        } else {
            $val = trim($val);
            if ($val === '') {
                unset($arr[$key]);
            } elseif ($trim) {
                $arr[$key] = $val;
            }
        }
    }
}

// 用法
$data = ['a' => '  ', 'b' => 'val', 'c' => ['x' => '', 'y' => '  ok  ']];
array_remove_empty($data);
// 結果：['b' => 'val', 'c' => ['y' => 'ok']]

3. 陣列分組 array_chunk() (內建)

$items = range(1, 21);          // 1~20
$pages = array_chunk($items, 5); // 每 5 個一組
/* 結果：
[
    [1,2,3,4,5],
    [6,7,8,9,10],
    [11,12,13,14,15],
    [16,17,18,19,20]
]
*/

// 分頁顯示
$page = isset($_GET['p']) ? max(1, (int)$_GET['p']) : 1;
$perPage = 5;
$paged = $pages[$page - 1] ?? [];

進階：鍵值保持分組 array_chunk_assoc()

function array_chunk_assoc(array $arr, $size, $preserveKeys = true) {
    $chunks = [];
    $i = 0;
    foreach ($arr as $k => $v) {
        $chunks[floor($i / $size)][$k] = $v;
        $i++;
    }
    return $chunks;
}

常見陣列操作速查