CakePHP 2.x 模型資料刪除完整指南：delete 與 deleteAll 差異解析

前言

CakePHP 模型提供多種刪除資料的方法，理解 delete() 與 deleteAll() 的差異、級聯刪除機制與回呼函數，對於資料完整性與應用邏輯至關重要。

delete()：單筆刪除與級聯控制

方法簽名

delete(int $id = null, boolean $cascade = true)

參數說明

• $id：目標記錄主鍵值
• $cascade：是否啟用級聯刪除，預設 true

級聯刪除行為

當模型定義 hasMany 或 hasAndBelongsToMany 關聯，且關聯模型設定 'dependent' => true 時：

• $cascade = true：同時刪除所有相依記錄（如 User 刪除時連同其 Recipes）
• $cascade = false：僅刪除主記錄，保留關聯資料

資料庫外鍵優先級

若資料庫層面已定義 ON DELETE CASCADE 外鍵約束，資料庫引擎會優先處理，CakePHP 級聯邏輯將不會觸發。

回呼函數支援

使用 delete() 可觸發模型與行為的回呼：

• beforeDelete：刪除前執行，回傳 false 可取消操作
• afterDelete：刪除後執行

$this->Comment->delete($this->request->data('Comment.id'));

deleteAll()：批次條件刪除

方法簽名

deleteAll(mixed $conditions, $cascade = true, $callbacks = false)

參數說明

• $conditions：SQL 片段或陣列條件，格式同 find()
• $cascade：是否級聯刪除相依記錄
• $callbacks：是否執行回呼函數（預設 false，效能較佳）

回傳值

• 成功：true
• 失敗：false
• 注意：條件執行成功但無符合記錄時，仍回傳 true

範例：刪除所有垃圾留言

// 不觸發回呼、不級聯
$this->Comment->deleteAll(array('Comment.spam' => true), false);

效能考量

啟用 $callbacks 或 $cascade 時，CakePHP 會先查找符合條件的記錄再逐筆刪除，可能產生多條查詢，大量資料時需評估效能影響。

最佳實踐建議