創建帶默認結構的配置數組模板

M66 2025-06-05

在實際開發中，尤其是在處理用戶配置或多項表單設置時，我們經常需要創建一個結構統一、內容相似的配置數組。為了避免重複編寫相同結構的代碼，PHP 的array_fill()函數就成為了一個非常實用的工具。

本文將介紹如何使用array_fill()創建一個帶有默認結構的配置數組模板，並通過一個實際案例加以演示。

什麼是array_fill() ？

array_fill()是PHP 的一個內置函數，用於用指定的值填充數組。

函數原型：

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

$start_index ：數組的起始索引。
$count ：要插入的元素數量。
$value ：每個元素的默認值。

創建一個配置模板的例子

假設我們正在開發一個用戶權限管理系統，需要為每個用戶角色生成一個權限配置數組，每個配置項都包含以下默認結構：

 [
    'read' => false,
    'write' => false,
    'delete' => false,
    'manage' => false,
    'callback_url' => 'https://m66.net/api/callback'
]

如果我們需要為5 個不同的角色初始化這樣的配置，使用array_fill()就會非常高效。

示例代碼

<?php

// 定義默認結構
$defaultPermission = [
    'read' => false,
    'write' => false,
    'delete' => false,
    'manage' => false,
    'callback_url' => 'https://m66.net/api/callback'
];

// 創建 5 個角色配置數組
$roles = array_fill(0, 5, $defaultPermission);

// 可選：為每個角色分配名字（例如 admin、editor 等）
$roleNames = ['admin', 'editor', 'author', 'subscriber', 'guest'];
$config = array_combine($roleNames, $roles);

// 打印結果以驗證
print_r($config);

輸出結果如下：

 Array
(
    [admin] => Array
        (
            [read] => 
            [write] => 
            [delete] => 
            [manage] => 
            [callback_url] => https://m66.net/api/callback
        )

    [editor] => Array
        (
            [read] => 
            [write] => 
            [delete] => 
            [manage] => 
            [callback_url] => https://m66.net/api/callback
        )

    ...
)

注意事項

引用問題：使用array_fill()填充的是同一個引用對象（對數組尤其重要）。如果你在後續修改其中一個角色的配置，其他角色也會受到影響。

為避免這個問題，可以使用array_map()搭配匿名函數：

 $roles = array_map(function () use ($defaultPermission) {
    return $defaultPermission;
}, range(1, 5));

結構一致性：這種方式適合用於結構一致、但數據內容暫未確定的初始化場景。