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);
$lastKey = array_key_last($arr);
$lastVal = $arr[$lastKey] ?? null;
// 不移動指針、可直接用於表達式、語義明確
$lastVal = array_slice($arr, -1)[0] ?? null;
// 返回新數組,原數組不變,可鏈式調用
[..., $lastVal] = $arr; // 僅數值索引 0..n 連續數組
// 關聯數組不可用
function array_last(array $array, $default = null) {
return $array ? $array[array_key_last($array)] : $default;
}
// PHP 7.3+ 可用 array_key_last,舊版用 end/key 組合實現
$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() 導致指針狀態混亂。