萬盛學電腦網

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

PHP end() 函數獲取數組最後一個元素:用法、陷阱與替代方案

函數簽名

end(array|object &$array): mixed
// 將內部指針移至最後一個元素並返回其值,數組為空返回 false

基本用法

<?php
$domains = ['baidu.com', 'haosou.com', 'sina.com', 'jb51.net'];
echo end($domains); // jb51.net

// 關聯數組
$user = ['id' => 1, 'name' => 'Tom', 'email' => 'tom@example.com'];
echo end($user); // tom@example.com (最後插入的值)

// 獲取最後一個鍵名
$lastKey = key($domains); // end() 後 key() 指向最後鍵
echo "Last key: $lastKey"; // 3

關鍵行為與陷阱

特性說明
副作用移動內部指針,後續 current()/key()/next()/prev() 受影響
引用參數必須傳遞變量,不能直接傳表達式:end(explode(',', 'a,b')) ❌ 報錯
空數組返回 false,需 === false 判斷
對象支援PHP 7+ 支持 Traversable 對象,但指針行為不可預期,不推薦
嚴格類型PHP 8.1+ 棄用傳遞非引用變量,必須是變量引用

常見錯誤示例

<?php
// ❌ 錯誤:臨時表達式不能引用
$last = end(explode(',', 'a,b,c')); // Fatal: Only variables can be passed by reference

// ✅ 正確:先賦值
$parts = explode(',', 'a,b,c');
$last = end($parts); // 'c'

// ❌ 錯誤:foreach 後指針在末尾,end() 無效
foreach ($arr as $v) { ... }
$last = end($arr); // 可能返回 false (指針已在末尾後)
// ✅ 重置指針
reset($arr);
$last = end($arr);

現代替代方案 (無副作用、更語義化)

1. array_key_last() + 數組訪問 (PHP 7.3+)

$lastKey = array_key_last($arr);
$lastVal = $arr[$lastKey] ?? null;
// 不移動指針、可直接用於表達式、語義明確

2. array_slice()

$lastVal = array_slice($arr, -1)[0] ?? null;
// 返回新數組,原數組不變,可鏈式調用

3. 解構賦值 (PHP 7.1+)

[..., $lastVal] = $arr; // 僅數值索引 0..n 連續數組
// 關聯數組不可用

4. 封裝工具函數 (推薦)

function array_last(array $array, $default = null) {
    return $array ? $array[array_key_last($array)] : $default;
}
// PHP 7.3+ 可用 array_key_last,舊版用 end/key 組合實現

性能對比 (100萬元素數組)

$arr = range(1, 1_000_000);

$t = microtime(true); $v = end($arr); echo "end: " . (microtime(true)-$t) . "s\n";     // ~0.00001s (移動指針 O(1))
$t = microtime(true); $v = $arr[array_key_last($arr)]; echo "key_last: " . (microtime(true)-$t) . "s\n"; // ~0.00001s
$t = microtime(true); $v = array_slice($arr, -1)[0]; echo "slice: " . (microtime(true)-$t) . "s\n";   // ~0.00005s (複製)

性能差異微乎其微,首選 array_key_last() 可讀性最好、無副作用。

總結

end() 是 PHP 早期內部指針 API 遺留,會移動指針、要求引用傳遞、空數組返回 false。現代代碼 (PHP 7.3+) 應使用 array_key_last() 獲取鍵名 + 直接訪問,或封裝 array_last() 工具函數。避免在循環中混用 foreach 和 end()/reset() 導致指針狀態混亂。

copyright © 萬盛學電腦網 all rights reserved