Yii 框架刪除資料：推薦使用 deleteByAttributes / deleteAll，慎用 DAO delete

在 Yii 1.x 中，直接使用 DAO 的 delete() 方法極易因條件組裝錯誤導致「全表刪除」災難。本文說明風險所在，並推薦使用 ActiveRecord 的 deleteByAttributes()、deleteAll() 等更安全的方法，附帶多種條件寫法範例。

DAO delete 的致命風險

// 危險寫法：若條件組裝失敗，$condition 為空字串或陣列
Yii::app()->db->createCommand()
    ->delete('mw_user', $condition); // 可能產生 DELETE FROM mw_user （無 WHERE）

當條件變數為 null、空陣列、或組裝邏輯出錯時，DAO 不會拋出異常，而是生成無 WHERE 子句的 SQL，導致整張表資料清空。這類事故在生產環境極難恢復。

推薦：ActiveRecord 靜態方法

ActiveRecord 內建參數繫結與條件檢查，相對安全且可讀性高。

1. deleteAllByAttributes() —— 以陣列指定欄位精確匹配

// 刪除 phone_number 等於 $phoneNumber 的所有記錄
MyClass::model()->deleteAllByAttributes(array(
    'phone_number' => $phoneNumber,
));

2. deleteAllByAttributes() 搭配自訂 SQL 條件片段

// 第一參數為空陣列，第二參數用參數繫結寫條件
MyClass::model()->deleteAllByAttributes(array(), '`phone_number` = :phone_number', array(
    ':phone_number' => $phoneNumber,
));

3. deleteAll() —— 直接寫 SQL 條件字串

MyClass::model()->deleteAll('`phone_number` = :phone_number', array(
    ':phone_number' => $phoneNumber,
));

4. 使用 CDbCriteria 處理複雜條件（含 IN）

$criteria = new CDbCriteria();
$criteria->addCondition('status = :status');
$criteria->params = array(':status' => 1);
$criteria->addInCondition('user_id', array(100111, 100221, 100331));

User::model()->deleteAll($criteria);

若必須用 DAO，請加上防呆檢查

$condition = array('and', 'user_id = :user_id', array('in', 'position_id', array(1,2,3)));
$params = array(':user_id' => 121111);

// 防呆：確保條件非空
if (empty($condition)) {
    throw new Exception('刪除條件不得為空');
}

Yii::app()->db->createCommand()
    ->delete('mw_user', $condition, $params);

最佳實踐總結

結語

「慎用 DAO delete」不僅是口號，更是防止誤刪生產資料的鐵律。優先選用 ActiveRecord 封裝方法，把條件組裝交給框架，才能睡個安穩覺。