PHP array_fill() 函式完整指南：指定索引起始、數量與值的陣列快速建立

array_fill() 能以單一值快速產生指定長度、指定起始索引的數值索引陣列，是初始化預設值、建立查找表、測試資料生成的高效工具。

語法與參數

array_fill(int $startIndex, int $count, mixed $value): array

核心行為特徵

• 僅產生數值索引：索引從 $startIndex 開始遞增 1，不支援字串鍵名。
• 負數索引支援：array_fill(-2, 3, 'x') → [-2=>'x', -1=>'x', 0=>'x']。
• 值為引用複製：填充物件/陣列時，所有元素指向同一實體（淺拷貝），修改一處影響全體。
• 回傳新陣列：不修改任何現有變數。

實戰範例與輸出

範例 1：基本用法

<?php
$a = array_fill(2, 3, 'Dog');
print_r($a);
// 輸出：
// Array (
//     [2] => Dog
//     [3] => Dog
//     [4] => Dog
// )
?>

範例 2：負數起始索引

<?php
$b = array_fill(-3, 5, 'test');
print_r($b);
// 輸出：
// Array (
//     [-3] => test
//     [-2] => test
//     [-1] => test
//     [0] => test
//     [1] => test
// )
?>

範例 3：填充物件（淺拷貝陷阱）

<?php
class Counter { public $n = 0; }
$obj = new Counter();
$arr = array_fill(0, 3, $obj); // 三個元素指向同一物件
$arr[0]->n = 10;
print_r($arr[2]->n); // 輸出 10（非預期）

// 正確做法：使用匿名函式產生獨立實體
$arr = array_map(fn() => new Counter(), range(0, 2));
$arr[0]->n = 10;
print_r($arr[2]->n); // 輸出 0（獨立）
?>

範例 4：建立預設配置陣列

<?php
// 產生 10 個預設分頁大小為 20 的配置項
$pageConfigs = array_fill(1, 10, ['per_page' => 20, 'sort' => 'desc']);
// 注意：上述同樣面臨淺拷貝問題，實務上建議：
$pageConfigs = array_map(
    fn($i) => ['id' => $i, 'per_page' => 20, 'sort' => 'desc'],
    range(1, 10)
);
?>

常見錯誤與避坑

相關函式快速對照

array_fill() 以極簡語法解決固定值重複填充需求，配合 array_map() 可彈性處理物件獨立實體化，是陣列初始化工具箱中的核心成員。