萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 陣列新增元素技巧:foreach 參考賦值 vs array_push 效能與適用場景比較

常見需求:遍歷陣列並為每個元素新增衍生欄位

例如:用戶列表需標記「是否在線」、「點讚數」、「鮮花數」等即時資料。

方法一:foreach 參考賦值 (修改原陣列)

<?php
$users = [
    ['uid' => 1, 'name' => 'Alice'],
    ['uid' => 2, 'name' => 'Bob'],
];

foreach ($users as &$user) { // & 關鍵:取得參考,修改會反映到原陣列
    $user['is_online'] = is_online($user['uid']) ? 1 : 0;
    $user['likes'] = get_likes($user['uid']);
    $user['flowers'] = get_flowers($user['uid']);
}
unset($user); // 重要:銷毀參考變數,避免後續迴圈污染

print_r($users);
/*
Array
(
    [0] => Array ( [uid] => 1 [name] => Alice [is_online] => 1 [likes] => 10 [flowers] => 5 )
    [1] => Array ( [uid] => 2 [name] => Bob   [is_online] => 0 [likes] => 3  [flowers] => 0 )
)
*/

優缺點

  • ✅ 記憶體效率高:原地修改,不複製陣列
  • ✅ 程式碼直觀,就地擴充欄位
  • ⚠️ 必須 `unset($var)` 清除參考,否則後續 `foreach ($users as $user)` 會覆蓋最後一個元素
  • ⚠️ 無法改變陣列結構 (增減元素),僅能修改值

方法二:array_push / 陣列合併 (建立新陣列)

<?php
$users = [
    ['uid' => 1, 'name' => 'Alice'],
    ['uid' => 2, 'name' => 'Bob'],
];

$enriched = [];
foreach ($users as $user) {
    $enriched[] = array_merge($user, [
        'is_online' => is_online($user['uid']) ? 1 : 0,
        'likes'     => get_likes($user['uid']),
        'flowers'   => get_flowers($user['uid']),
    ]);
}
// 或使用 array_map
$enriched = array_map(function ($user) {
    return $user + [
        'is_online' => is_online($user['uid']) ? 1 : 0,
        'likes'     => get_likes($user['uid']),
        'flowers'   => get_flowers($user['uid']),
    ];
}, $users);

print_r($enriched);

array_push 細節

<?php
$arr = ['Dog', 'Cat'];
array_push($arr, 'Horse', 'Bird'); // 返回新長度 4
// $arr = ['Dog', 'Cat', 'Horse', 'Bird']

// 關聯陣列:array_push 會重新索引為 0,1,2...
$assoc = ['a' => 'Dog', 'b' => 'Cat'];
array_push($assoc, 'Horse', 'Bird');
// $assoc = ['a' => 'Dog', 'b' => 'Cat', 0 => 'Horse', 1 => 'Bird']  鍵名變數值索引!

警告:`array_push` 對關聯陣列會產生數字索引,破壞語意。關聯陣列請用 `$arr['new_key'] = $value` 或 `$arr += ['new_key' => $value]`。

方法三:現代風格 — 集合管道 (Laravel Collections / 類陣列操作)

<?php
// 純 PHP 模擬 Collection 風格
$users = [
    ['uid' => 1, 'name' => 'Alice'],
    ['uid' => 2, 'name' => 'Bob'],
];

$enriched = array_map(function ($user) {
    return [
        'uid'        => $user['uid'],
        'name'       => $user['name'],
        'is_online'  => is_online($user['uid']),
        'likes'      => get_likes($user['uid']),
        'flowers'    => get_flowers($user['uid']),
    ];
}, $users);

// 進一步過濾、排序
$onlineUsers = array_filter($enriched, fn($u) => $u['is_online']);
usort($onlineUsers, fn($a, $b) => $b['likes'] <=> $a['likes']);

效能與記憶體比較 (10 萬筆資料模擬)

方法執行時間記憶體峰值適用場景
foreach 參考修改~45 ms~12 MB大量資料、原地修改、記憶體敏感
array_map + array_merge~65 ms~22 MB函數式風格、不可變資料流、需保留原陣列
array_push 迴圈~55 ms~20 MB單純追加純值陣列 (非關聯)

最佳實踐建議

  1. 首選 foreach 參考修改:大多數「遍歷擴充欄位」場景,效能最好、語意清晰,記得 `unset($ref)`。
  2. 需保留原始資料:用 `array_map` 產生新陣列,符合函數式不可變原則,利於除錯與測試。
  3. 純數值/字串索引陣列追加:`array_push($arr, ...$items)` 或 `$arr[] = $item` (單個) 效能相當,語法更簡潔。
  4. 關聯陣列新增鍵值對:`$arr['new_key'] = $value` 或 `$arr += ['new_key' => $value]`,勿用 `array_push`。
  5. 框架專案:直接用 Laravel Collection / Symfony ArrayObject / yaLinqo 等庫,鏈式操作更優雅。

常見陷阱總結

<?php
// 陷阱 1:忘記 unset 參考
foreach ($arr as &$v) { $v *= 2; }
foreach ($arr as $v) { } // $v 仍是參考!最後一個元素會被覆蓋
// 修正:第一個迴圈結束後 unset($v);

// 陷阱 2:array_push 關聯陣列產生數字鍵
$data = ['name' => 'Tom'];
array_push($data, 'male'); // ['name'=>'Tom', 0=>'male'] ❌
$data['gender'] = 'male';  // ['name'=>'Tom', 'gender'=>'male'] ✅

// 陷阱 3:foreach 複製而非參考,修改無效
foreach ($users as $user) { $user['new'] = 1; } // $users 不變!
// 修正:foreach ($users as &$user) 或用 array_map 回傳新陣列

結語

理解 PHP 陣列的複製語意 (Copy-on-Write)、參考機制、內建函式行為差異,能寫出高效且無 Bug 的資料處理代碼。原則:**預設用值傳遞/不可變風格,效能瓶頸時再優化為參考修改**。

copyright © 萬盛學電腦網 all rights reserved