array_slice 返回值不修改原數組的陷阱

gitbox 2025-05-26

在PHP開發中， array_slice函數是一個非常實用的數組操作函數，它能從一個數組中截取出指定的一段元素作為返回值。然而，很多初學者甚至中級程序員常常誤以為array_slice會直接修改原數組，導致代碼邏輯混亂和調試困難。本文將詳細解析array_slice的返回值特性，揭示其不修改原數組的原因，並舉例說明避免陷阱的方法。

一、array_slice函數簡介

array_slice的基本語法如下：

 array array_slice(array $array, int $offset, ?int $length = null, bool $preserve_keys = false)

$array ：原始數組。
$offset ：開始截取的位置，支持負數，表示從數組尾部倒數。
$ length ：截取的長度，默認為數組剩餘元素數。
$preserve_keys ：是否保留原數組的鍵名，默認false。

該函數返回的是截取後的新數組，而非對原數組的引用。

二、為什麼array_slice不會修改原數組？

array_slice返回的是一個“新數組”，它是從原數組複製指定區間元素構成的。 PHP中的數組複製是按值傳遞的（雖然底層實現有copy-on-write優化），函數內不會對傳入數組進行原地修改操作。換句話說， array_slice的設計初衷就是保持原數組的完整性和不可變性。

因此，你使用array_slice時，得到的是截取結果的新數組，原數組保持不變。

例子：

 $fruits = ['apple', 'banana', 'cherry', 'date'];
$sliced = array_slice($fruits, 1, 2);

print_r($sliced);
// 輸出:
// Array
// (
//     [0] => banana
//     [1] => cherry
// )

print_r($fruits);
// 輸出:
// Array
// (
//     [0] => apple
//     [1] => banana
//     [2] => cherry
//     [3] => date
// )

這裡$fruits數組未被修改， $sliced是截取出來的新數組。

三、常見誤區和陷阱

誤以為原數組被修改<br> 許多人使用array_slice後，再次打印原數組，發現原數組未改變，於是懷疑代碼邏輯出錯實際上， array_slice就是不改變原數組的。
試圖用array_slice直接修改數組<br> 有些人可能寫出如下代碼
```
$arr = [1,2,3,4,5];
$arr = array_slice($arr, 2);
```
這其實是把截取結果賦值回原數組變量，這時變量指向了新的數組，而原來的數組就丟棄了。如果想要“修改”數組，實際上是用新數組替代了原數組，而不是array_slice函數本身改變了數組。

期望鍵名保持不變，忘記傳入參數<br> 默認情況下， array_slice返回的數組會重建索引（0開始），除非設置第四個參數為tru e

 $arr = ['a' => 'apple', 'b' => 'banana', 'c' => 'cherry'];
$slice = array_slice($arr, 1, 2);
print_r($slice);
// 輸出：
// Array
// (
//     [0] => banana
//     [1] => cherry
// )

這裡鍵名變成了數字索引。如果想保留鍵名，應該傳入第四個參數：

 $slice = array_slice($arr, 1, 2, true);
print_r($slice);
// 輸出：
// Array
// (
//     [b] => banana
//     [c] => cherry
// )

四、如何正確使用array_slice避免問題？

明確array_slice是返回新數組，不會改變傳入數組本身。
如果想“更新”數組，需手動賦值給原變量或其它變量。
注意是否需要保留鍵名，傳入true以避免鍵名丟失。
避免和array_splice混淆，後者是會直接修改原數組的函數。

五、總結

array_slice作為PHP中截取數組的函數，設計上是純粹返回新數組，不修改原數組。這種設計避免了副作用，使代碼更安全和可維護。理解這一點，能幫助開發者避免誤解和陷阱，正確運用數組截取功能，提高代碼質量。

如果需要對原數組進行刪除、插入等修改操作，可以使用array_splice ，它才是直接改變原數組的函數。對於數組截取， array_slice則是不可變、返回新數組的首選工具。

array_slice