如何使用array_fill_keys 創建一個帶有初始狀態的遊戲狀態數組？

gitbox 2025-09-02

如何使用array_fill_keys 創建一個帶有初始狀態的遊戲狀態數組？

在遊戲開發中，維護和更新遊戲狀態是一個至關重要的任務。許多時候，遊戲的狀態信息會涉及多個不同的參數，例如角色的生命值、得分、關卡進度等。這些狀態信息通常需要一個初始值，而array_fill_keys函數是PHP 中一個非常有用的工具，可以幫助我們在初始化數組時給定一組鍵及其對應的默認值。

在本文中，我們將探討如何使用array_fill_keys來創建一個帶有初始狀態的遊戲狀態數組，並展示實際的代碼示例。

1. array_fill_keys函數簡介

array_fill_keys是PHP 中一個用於創建關聯數組的函數。它接受兩個參數：

keys ：一個包含數組鍵的數組。
value ：每個鍵的初始值。

該函數會返回一個新數組，其中的每個鍵都由傳入的keys數組提供，並且所有的鍵都會被賦予相同的初始值。

2. 遊戲狀態數組的應用場景

假設我們在開發一個簡單的角色扮演遊戲，每個玩家有多個狀態信息需要初始化，如生命值、經驗值、金幣等。我們希望在遊戲開始時，能夠為每個玩家的這些屬性賦予初始值。

例如，我們可能會為玩家定義以下狀態信息：

health （生命值）
experience （經驗值）
gold （金幣）
level （關卡）

這些信息的初始值可能如下：

生命值health ：100
經驗值experience ：0
金幣gold ：50
關卡level ：1

我們可以使用array_fill_keys來簡化這一初始化過程。

3. 使用array_fill_keys初始化遊戲狀態數組

以下是使用array_fill_keys創建一個初始狀態的遊戲狀態數組的PHP 代碼示例：

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 定義遊戲狀態的鍵</span></span><span>
</span><span><span class="hljs-variable">$gameKeys</span></span><span> = [</span><span><span class="hljs-string">'health'</span></span><span>, </span><span><span class="hljs-string">'experience'</span></span><span>, </span><span><span class="hljs-string">'gold'</span></span><span>, </span><span><span class="hljs-string">'level'</span></span><span>];

</span><span><span class="hljs-comment">// 定義每個鍵的初始值</span></span><span>
</span><span><span class="hljs-variable">$initialValue</span></span><span> = [
    </span><span><span class="hljs-string">'health'</span></span><span> =&gt; </span><span><span class="hljs-number">100</span></span><span>,
    </span><span><span class="hljs-string">'experience'</span></span><span> =&gt; </span><span><span class="hljs-number">0</span></span><span>,
    </span><span><span class="hljs-string">'gold'</span></span><span> =&gt; </span><span><span class="hljs-number">50</span></span><span>,
    </span><span><span class="hljs-string">'level'</span></span><span> =&gt; </span><span><span class="hljs-number">1</span></span><span>
];

</span><span><span class="hljs-comment">// 使用 array_fill_keys 初始化遊戲狀態</span></span><span>
</span><span><span class="hljs-variable">$gameState</span></span><span> = </span><span><span class="hljs-title function_ invoke__">array_fill_keys</span></span><span>(</span><span><span class="hljs-variable">$gameKeys</span></span><span>, </span><span><span class="hljs-literal">null</span></span><span>);

</span><span><span class="hljs-comment">// 將每個鍵賦予對應的初始值</span></span><span>
</span><span><span class="hljs-keyword">foreach</span></span><span> (</span><span><span class="hljs-variable">$gameState</span></span><span> </span><span><span class="hljs-keyword">as</span></span><span> </span><span><span class="hljs-variable">$key</span></span><span> =&gt; </span><span><span class="hljs-variable">$value</span></span><span>) {
    </span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-keyword">isset</span></span><span>(</span><span><span class="hljs-variable">$initialValue</span></span><span>[</span><span><span class="hljs-variable">$key</span></span><span>])) {
        </span><span><span class="hljs-variable">$gameState</span></span><span>[</span><span><span class="hljs-variable">$key</span></span><span>] = </span><span><span class="hljs-variable">$initialValue</span></span><span>[</span><span><span class="hljs-variable">$key</span></span><span>];
    }
}

</span><span><span class="hljs-comment">// 輸出遊戲狀態數組</span></span><span>
</span><span><span class="hljs-title function_ invoke__">print_r</span></span><span>(</span><span><span class="hljs-variable">$gameState</span></span><span>);
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

輸出結果：

 <span><span><span class="hljs-title function_ invoke__">Array</span></span><span>
(
    [health] =&gt; </span><span><span class="hljs-number">100</span></span><span>
    [experience] =&gt; </span><span><span class="hljs-number">0</span></span><span>
    [gold] =&gt; </span><span><span class="hljs-number">50</span></span><span>
    [level] =&gt; </span><span><span class="hljs-number">1</span></span><span>
)
</span></span>

4. array_fill_keys的工作原理

第一步：我們首先定義了一個包含遊戲狀態屬性名的數組$gameKeys ，這些屬性名將作為關聯數組的鍵。
第二步：我們定義了一個關聯數組$initialValue ，該數組包含了每個狀態屬性的初始值。
第三步：通過array_fill_keys函數，我們初始化了一個所有值為null的數組$gameState ，其中的鍵來自$gameKeys數組。
第四步：我們使用foreach循環遍歷$gameState數組，將每個鍵的值替換為$initialValue中對應的初始值。

5. 優化：直接初始化

為了避免使用循環，也可以直接在array_fill_keys中設置每個鍵的初始值。以下是另一種方法，直接使用數組合併（ +運算符）來初始化值：

 <span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$gameKeys</span></span><span> = [</span><span><span class="hljs-string">'health'</span></span><span>, </span><span><span class="hljs-string">'experience'</span></span><span>, </span><span><span class="hljs-string">'gold'</span></span><span>, </span><span><span class="hljs-string">'level'</span></span><span>];
</span><span><span class="hljs-variable">$initialValue</span></span><span> = [
    </span><span><span class="hljs-string">'health'</span></span><span> =&gt; </span><span><span class="hljs-number">100</span></span><span>,
    </span><span><span class="hljs-string">'experience'</span></span><span> =&gt; </span><span><span class="hljs-number">0</span></span><span>,
    </span><span><span class="hljs-string">'gold'</span></span><span> =&gt; </span><span><span class="hljs-number">50</span></span><span>,
    </span><span><span class="hljs-string">'level'</span></span><span> =&gt; </span><span><span class="hljs-number">1</span></span><span>
];

</span><span><span class="hljs-comment">// 使用 array_fill_keys 創建基礎數組，並與初始值合併</span></span><span>
</span><span><span class="hljs-variable">$gameState</span></span><span> = </span><span><span class="hljs-title function_ invoke__">array_fill_keys</span></span><span>(</span><span><span class="hljs-variable">$gameKeys</span></span><span>, </span><span><span class="hljs-literal">null</span></span><span>) + </span><span><span class="hljs-variable">$initialValue</span></span><span>;

</span><span><span class="hljs-title function_ invoke__">print_r</span></span><span>(</span><span><span class="hljs-variable">$gameState</span></span><span>);
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

這種方式通過數組合併操作簡化了代碼，避免了顯式的循環。

輸出結果：

 <span><span><span class="hljs-title function_ invoke__">Array</span></span><span>
(
    [health] =&gt; </span><span><span class="hljs-number">100</span></span><span>
    [experience] =&gt; </span><span><span class="hljs-number">0</span></span><span>
    [gold] =&gt; </span><span><span class="hljs-number">50</span></span><span>
    [level] =&gt; </span><span><span class="hljs-number">1</span></span><span>
)
</span></span>

6. 結論

array_fill_keys函數是PHP 中非常有用的一個工具，可以幫助我們快速創建具有初始值的關聯數組。通過這個函數，我們能夠方便地為遊戲狀態或其他場景初始化一個帶有默認值的數組，並能根據實際需求進一步修改這些值。無論是用默認值初始化所有鍵，還是利用合併操作進一步精細化初始狀態， array_fill_keys都是一個高效的選擇。

array_fill_keys