用array_combine 實現數組重建映射

M66 2025-06-07

在PHP 中，數組的操作是非常常見的任務，尤其是在需要根據某些條件重新組織數組時。 array_combine函數是PHP 提供的一個非常有用的工具，它允許你根據兩個數組生成一個新的關聯數組。具體來說， array_combine將第一個數組作為鍵，第二個數組作為值，創建一個新的關聯數組。

1. array_combine函數的基本用法

array_combine函數的基本語法如下：

 array_combine(array $keys, array $values): array|false

$keys ：將作為新數組鍵的數組。
$values ：將作為新數組值的數組。

該函數會將$keys數組中的每一個元素作為新數組的鍵，將$values數組中的每個元素作為新數組的值。如果兩個數組的元素數量不同，它將返回false 。

2. 使用示例

我們來看一個簡單的例子，假設我們有兩個數組：一個是包含水果名稱的數組，另一個是這些水果的價格數組，我們希望將這兩個數組合併為一個關聯數組，鍵是水果名稱，值是水果價格。

 <?php
// 定義水果名稱數組
$fruits = ['apple', 'banana', 'orange'];

// 定義水果價格數組
$prices = [1.2, 0.5, 0.8];

// 使用 array_combine 合併這兩個數組
$fruitPrices = array_combine($fruits, $prices);

// 打印結果
print_r($fruitPrices);
?>

輸出結果：

 Array
(
    [apple] => 1.2
    [banana] => 0.5
    [orange] => 0.8
)

在這個例子中，我們成功地將水果名稱作為鍵，水果價格作為值，生成了一個新的關聯數組。

3. 注意事項

數組長度相同： array_combine要求兩個數組的長度必須相同。如果它們的長度不一樣，函數將返回false 。
示例：
```
 $keys = ['a', 'b', 'c'];
$values = [1, 2];
$result = array_combine($keys, $values); // 返回 false，因為數組長度不同
```
鍵名不能重複：如果$keys數組中有重複的元素， array_combine會根據最後一個出現的鍵值來賦值，之前的鍵值會被覆蓋。
示例：
```
 $keys = ['a', 'b', 'a'];
$values = [1, 2, 3];
$result = array_combine($keys, $values); // 返回 ['a' => 3, 'b' => 2]
```

4. 應用場景

array_combine適用於以下幾種常見場景：

數據格式轉換：將索引數組轉換為關聯數組。比如你有一組數據，想要將它們按照某些特定的鍵值進行組織。
例如，假設你從數據庫中查詢了一個用戶信息數組，你想把每個字段名稱作為數組的鍵：
```
 $keys = ['name', 'age', 'email'];
$values = ['John Doe', 25, 'john@example.com'];
$user = array_combine($keys, $values);

print_r($user);
```
輸出：
```
 Array
(
    [name] => John Doe
    [age] => 25
    [email] => john@example.com
)
```
重新映射數組：假設你有一組舊的數據結構，想要通過array_combine重新映射成新的結構，以便後續處理更方便。

5. 錯誤處理與調試

如果在使用array_combine時傳入的數組長度不匹配，函數將返回false 。為了避免錯誤，可以通過if判斷返回值，並做相應的錯誤處理：

 <?php
$keys = ['id', 'name'];
$values = [101];

$result = array_combine($keys, $values);

if ($result === false) {
    echo "數組長度不匹配，無法合併！";
} else {
    print_r($result);
}
?>

6. 總結

array_combine是一個非常強大的函數，尤其適用於將兩個數組結合成一個關聯數組。它的用法簡單直接，但需要注意兩個數組的長度必須一致，否則會返回false 。通過合理使用該函數，我們可以更方便地重建數組映射，提升開發效率。

相關文章<br> 更多關於PHP 數組的操作，可以參考以下鏈接
PHP array_combine函數文檔
 PHP數組函數大全

array_combine