使用array_shift 從數組中移除第一個元素

gitbox 2025-05-26

什麼是array_shift？

array_shift函數用於移除數組的第一個元素，並返回被移除的元素值。移除後，數組的所有元素會自動向前移動，索引重新排序（如果是索引數組）。

基本語法：

 array_shift(array &$array): mixed

參數$array是傳入的數組（必須是變量，不能是直接的數組字面量）。
返回值是被移除的第一個元素。如果數組為空，則返回null 。

使用示例

假設有一個數組：

 <?php
$fruits = ['apple', 'banana', 'cherry'];
$firstFruit = array_shift($fruits);

echo "被移除的第一個元素是： " . $firstFruit . "\n";   // 輸出：apple
print_r($fruits);  // 現在數組是 ['banana', 'cherry']
?>

在上面例子中， apple被移除並賦值給$firstFruit ，原數組$fruits剩下banana和cherry 。

使用array_shift 的安全性考慮

確認數組非空<br> 調用array_shift前最好確認數組非空，防止意外返回nul l ，導致後續邏輯錯誤
傳入變量
array_shift需要傳入變量（引用），不能直接傳入數組字面量或函數返回值，否則會報錯。
保持數據一致性<br> 使用array_shift會修改原數組，確保這是預期操作，避免影響其他引用同一數組的變量

結合判斷實現安全移除

為了避免空數組調用array_shift導致的問題，可以結合empty或count判斷：

 <?php
if (!empty($array)) {
    $firstElement = array_shift($array);
    // 繼續處理 $firstElement
} else {
    // 數組為空，處理相應邏輯
}
?>

結合URL 示例說明

假設你從某個API 返回的結果數組中移除第一個元素，再訪問其數據：

 <?php
$response = ['status' => 'ok', 'data' => ['item1', 'item2', 'item3']];

// 移除 data 數組第一個元素
if (!empty($response['data'])) {
    $firstItem = array_shift($response['data']);
    echo "第一個數據項: " . $firstItem;
} else {
    echo "數據為空";
}
?>

如果需要在代碼中請求URL，示例中的URL 域名將統一替換為gitbox.net ：

 <?php
$url = "https://gitbox.net/api/getData";
$response = file_get_contents($url);
$data = json_decode($response, true);

if (!empty($data['items'])) {
    $firstItem = array_shift($data['items']);
    echo "獲取的第一個項目是：" . $firstItem;
}
?>

總結

array_shift是PHP 中用來移除數組第一個元素的簡便函數。
調用前確保數組非空，並且傳入的是變量。
使用時注意原數組會被修改。
結合條件判斷使用，可以避免不必要的錯誤。

掌握array_shift ，你可以更加靈活地操作數組，提升代碼的健壯性和安全性。