Yii2批量删除安全需满足三点:条件结构必须顶层为'AND'或'OR',变量须过滤校验(如类型断言、strval转换),且必须包裹事务并加二次确认与日志记录。

Yii2 批量删除要安全,核心是三点:条件写法规范、数据来源可控、操作过程可回滚。不满足任一环节,都可能误删全表或触发 SQL 注入。
条件结构必须显式用 AND 或 OR 包裹
deleteAll() 不接受混合格式的条件数组。比如把 ['column_id' => 1] 和 ['NOT', ['status' => 0]] 直接并列写在一个关联数组里,会直接报 strtoupper() expects parameter 1 to be string, array given 错误,且语义不清。
- ✅ 正确写法:顶层第一个元素必须是逻辑运算符,如
'AND'或'OR' - 每个子条件独立成项,支持键值对、运算符数组、标量值
- 例如同时满足多个等值条件 + 一个否定条件:
'AND',
['plan_year_id' => $plan_year_id],
['column_type' => array_keys($allAdjustment)],
['is_auto' => $is_auto],
['NOT', ['column_id' => 1]],
]);
变量必须做过滤或白名单校验
deleteAll() 虽自动参数化标量值(如整数、字符串),但不防护动态字段名、操作符或数组键名。若 $allAdjustment 来自用户输入且含非法键(如数字键或 SQL 关键字),可能引发类型错误或隐式行为异常。
- 对
array_keys($allAdjustment)做字符串强制转换:array_map('strval', array_keys($allAdjustment)) - 对
$plan_year_id、$is_auto使用类型断言或过滤函数,如(int)$plan_year_id、(bool)$is_auto - 禁止将用户输入拼接到条件键中,例如
[$user_input => 1]是高危写法
必须包裹事务并加确认机制
deleteAll() 绕过模型事件、验证和回调,执行后不可逆。线上环境绝不能裸调用。
- 用事务包裹,出错时自动回滚:
Yii::$app->db->transaction(function ($db) use ($condition) { AllAdjustments::deleteAll($condition); }); - 前端批量删除按钮需二次确认(JS
confirm()或 Modal) - 建议记录操作日志,包括操作人、时间、影响行数(可通过
createCommand()->delete()->execute()返回值获取)
替代方案:按需选择更稳妥的方式
如果业务需要触发模型逻辑(如级联删除、审计日志、权限检查),deleteAll() 就不合适。
- 小批量(百条以内):用
foreach+findOne()+delete(),确保事件触发 - 中批量(千条):先查 ID 列表,再分批 deleteAll,每批加 LIMIT 控制范围
- 敏感操作:改用原生 SQL + 手动预处理,字段和表名用白名单硬编码,避免任何动态拼接











