API原本回傳一個商品陣列,後端加了 filter 後,前端突然不能再用同樣的清單操作。回應內容看起來仍有兩件商品,最外層卻從方括號變成大括號,還多了 "0"、"2" 這些key。先查集合篩選後保留下來的索引,不必立刻修改前端把物件硬轉陣列。 Laravel的集合 filter()會保留原key。PHP把不連續的數字key編碼為JSON時,產生的是物件;如果API契約需要一份清單,在篩選後呼叫 values()重新排列索引,就能讓最外層保持陣列形狀。這裡的索引與資料本身的商品ID是不同東西。 刪掉第二項後,索引不是自動連續 用三筆合成資料重現即可。id是業務資料,active是本例的篩選條件,不接資料庫,也不假設你的商品表一定有同樣欄位。 $items = collect([ ['id' => 11, 'active' => true], ['id' => 12, 'active' => false], ['id' => 13, 'active' => true], ]); $filtered = $items->filter(fn ($row) => $row['active']); dump($filtered->keys()->all()); dump($filtered->toJson()); 留下來的是id11與id13,但外層key是0與2。這是因為篩選保留原本位置的key,沒有把2往前改成1。在PHP8.4.2、Laravel13.34.0的案例裡,toJson()輸出是下面這種形狀。 {"0":{"id":11,"active":true},"2":{"id":13,"active":true}} 這份JSON合法,伺服器沒有編碼失敗;只是它是以key索引的物件,而非前端期待的陣列。不要把JSON是否合法與是否符合API契約混在一起。回應200、能解析JSON,都不能代替檢查資料型別與欄位形狀。 用values重排外層,不改商品ID 如果這個回應是供 v-for、表格或一般清單使用,且API約定最外層是一個陣列,可在篩選之後整理索引。 $result = $items ->filter(fn ($row) => $row['active']) ->values(); dump($result->keys()->all()); dump($result->toJson()); 此時外層key變成0與1,JSON為陣列;兩件商品的id仍是11與13。values()整理的是集合索引,不是重新編號資料列,更不會替資料庫更新主鍵。 [{"id":11,"active":true},{"id":13,"active":true}] 同一組例子還檢查了全部被排除的情況:結果再呼叫 values()->toJson()得到 []。前端因此可以用同樣的陣列契約處理零筆、一筆、多筆,不必看到空結果時又改另一種分支。不過真實API若外面還有 data或分頁欄位,應檢查的是約定的清單位置,不是把整份回應都改成陣列。 在Laravel測試專案的Tinker可以直接執行上述三筆資料範例。比對時同時看 keys()、toJson()與 pluck('id'):前兩個確認形狀,最後一個確認業務ID沒變。只看前端畫面能顯示,可能漏掉回傳順序或ID被誤改的問題。 不是所有集合都應該values 如果資料本來就按明確的業務key索引,保留key可能是正確需求。例如回傳以語系代碼為key的設定,或以商品ID快速查找的映射,物件正好符合契約。這時一律 values()反而會丟掉原本有意義的key,讓呼叫端無法直接查找。 因此修正前先問「這是list,還是map」。list著重順序與項目;map著重key到value的對應。兩者都能包含相同資料,但存取方式不同。不要因為前端某個套件喜歡陣列,就在所有API輸出上加values,尤其既有客戶端可能已經依key存取。 如果一份回應既要清單順序,又需要穩定識別,可以把業務ID留在每個項目裡,外層維持清單。像範例的id欄位就做這件事。用陣列位置代替商品ID會讓篩選、排序、插入後的識別變動,並不是整理索引想解決的問題。 巢狀分組也要逐層判斷。外層用分類slug當key,內層才是項目陣列時,只整理需要當清單的內層;在最外層呼叫values,可能把分類key一起丟掉。不要把單層範例推成任意分組資料的通用改法,先看呼叫端需要哪一層是陣列。 原生JSON與API Resource可能有不同處理 本文比較的是普通Collection直接 toJson()的結果。若回應使用Eloquent API Resource collection,Laravel官方文件說明預設會重設集合的數字key,並提供 preserveKeys來保留key。這是資源層的行為,不能直接當成每個普通集合方法都會重排。 維護API時,先確認最後序列化的是普通集合、ResourceCollection、已轉成PHP陣列,還是自己呼叫...
2026-10-04 54 0
文尼先生 2026-10-04
顯示驗證碼
沒有帳號?註冊  忘記密碼?