Laravel表單欄位沒存到?分清fillable、驗證與直接賦值
會員編輯姓名的表單只露出一個輸入框,後端卻可能收到其他欄位。瀏覽器沒有顯示 is_admin,不代表請求裡不能加上它。另一種常見情況恰好相反:表單新增了電話,驗證也通過,儲存後電話卻消失。這兩個問題都值得沿著資料進入模型的路線查,不能只看畫面。 Laravel的 fillable 控制模型接受哪些大量賦值欄位;表單驗證控制輸入的內容與格式;授權則回答這個人能不能修改這筆資料。三者處理不同問題。本文以一般會員修改自己的公開姓名為例,說明欄位白名單怎麼寫,以及哪些寫法會繞過它。以下語法適用本文示範的Laravel 13 Eloquent模型,舊專案請先對照自己的框架版本。 先找出欄位從哪裡進入模型 看到 create()、模型實例的 update() 或 fill(),先看傳入的陣列由哪裡來。如果直接送入 $request->all(),任何請求欄位都會走到模型的大量賦值檢查,維護者必須知道哪些被接受、哪些被丟棄。表單畫面不能代替這份檢查。 class Profile extends Model { protected $fillable = ['name']; } $profile = new Profile; $profile->fill([ 'name' => 'Coffee', 'is_admin' => true, ]); 這個例子在模型屬性裡只留下 name。預設行為下,沒有列在白名單的 is_admin 被丟棄。這不表示使用者已經存進資料庫:fill() 只是填模型屬性,真正寫入仍需要儲存操作。要確認一個實際表單的結果,應在送出後重新讀取資料庫那筆資料,不能只用回傳訊息或記憶體中的物件作結論。 對既有專案,先搜尋模型名稱及它的寫入位置。相同模型可能被會員表單、管理後台與匯入工具共用;把某欄加到白名單會影響所有大量賦值入口。如果只有管理員可以修改會員等級,不應為了讓後台少寫一行程式,就把等級開放給所有送進該模型的陣列。 驗證完成後,只送需要的資料 會員修改姓名的入口可以先用驗證取得指定資料,再交給模型。白名單也保留,讓兩個邊界互相補足。下面假設 $profile 已經是目前登入會員有權修改的資料;查出哪筆資料及授權檢查,仍要在你的控制器或Policy裡處理。 $data = $request->validate([ 'name' => [ 'required', 'string', 'max:80', ], ]); $profile->fill($data); $profile->save(); 不要把驗證當作權限檢查。姓名格式正確,不表示送出的人能編輯其他會員;同樣,模型接受某欄,不代表該欄適合由這個表單修改。如果網站有巢狀資料,還要明確限制允許的陣列鍵,不能因為驗證了上層陣列就假設其中每個鍵都已逐項審核。 若新增電話欄位,至少沿四處核對:前端欄位名稱、驗證規則、送進模型的資料、模型白名單。最後確認資料表真有該欄,以及型別和長度能容納輸入。只改 fillable 不會新增資料庫欄位,反過來只加migration也不會讓表單自動接受資料。 直接指定屬性不受同一白名單限制 下面這段是另一條寫入路徑。它不是把整個輸入陣列交給大量賦值,因此不會因為 is_admin 沒列在 fillable 就被擋下。本文案例中,直接指定後的模型屬性包含 name 與 is_admin。 $profile->is_admin = true; $profile->save(); 這種寫法本身有合理用途,例如伺服器依已核准的管理操作更新狀態。問題是值從哪裡來,以及是否先做授權。如果把請求中的權限欄位直接接到這裡,白名單不能救回這條路徑。對照程式時,不能只搜尋 create() 而漏掉屬性指定、Query Builder更新或原始SQL。...
Laravel列表每頁都查很多次資料:找出關聯N+1
列表只有十幾筆資料,資料庫卻被查了幾十次。常見原因是先取得文章,再在每一列讀作者、分類或其他關聯;畫面看起來只是在印一個名稱,實際上卻可能每次都發出新的 SQL。 這類問題稱為 N+1:一次取得 N 筆主資料,接著為每筆再查一次關聯。先看相同 SQL 如何隨列表數量增加,再針對畫面真正使用的關聯預先載入。不要一看到查詢多,就把所有資料全部塞進快取。 先找出迴圈中讀取的關聯 假設列表顯示書名和作者名,Book 透過 belongsTo 對應作者。下面先取得書籍,再讀每筆的 author: $books = Book::orderBy('id')->get(); foreach ($books as $book) { echo $book->title; echo $book->author->name; } 若作者關聯尚未載入,讀取 $book->author 會觸發關聯查詢。Blade 模板、API Resource 或模型 accessor 中的讀取也可能造成同樣情況,不一定寫在控制器的那個迴圈裡。追到真正需要作者名稱的輸出位置,才能找到多出來的查詢。 還要分清關聯屬性與關聯方法。$book->author 取已載入的關聯,$book->author() 則提供可繼續建立查詢的關聯物件;如果每列都在後面呼叫查詢方法,原本的預先載入未必能省掉那一筆。先看實際程式,不只在控制器加一個 with 就結束。 把主查詢與關聯查詢分開數 在開發環境記錄這段取資料與輸出的查詢,保留 SQL 和必要的測試條件。Laravel 可用查詢事件監聽,也可以在有界限的測試區塊查看 query log。記錄範圍要一致,不能把第一次建立資料表的 SQL 算進修改前,修改後卻只算一次讀取。 重點看這類重複形態:先查一次 books,接著多次按作者 ID 查 authors。不同書籍即使共用作者,也可能各自觸發關聯查詢;不要假定同樣的 ID 曾查過,就會自動替每一個獨立模型省掉查詢。 正式站的日誌可能含私人資料和敏感參數,不要把完整 bindings 公開貼出。先在合成資料環境重現;需要正式觀察時,由維護者安排適當的記錄範圍與保留方式,不要永久開啟無界限的完整查詢記錄。 本例六筆資料,從七次變成兩次 我們用 Laravel 13 的 Eloquent 連到另建的合成 SQLite,放入六本書、三位作者。先清空這次查詢記錄,再取得書籍與顯示作者。未預先載入時,讀取 books 一次,六個模型分別查作者,共七次。 改成 Book::with('author') 後,再以相同排序取得和顯示。查 books 一次,再用作者 ID 集合查 authors 一次,共兩次;兩份輸出的六個書名和作者名稱完全相同。 未預先載入:1 次...
