本文详解 Yii2 框架中 ActiveRecord::deleteAll() 方法的正确语法结构，重点解决因条件数组嵌套不当导致的 strtoupper() expects parameter 1 to be string 错误，并提供可直接复用的安全写法与实践建议。
本文详解 yii2 框架中 `activerecord::deleteall()` 方法的正确语法结构，重点解决因条件数组嵌套不当导致的 `strtoupper() expects parameter 1 to be string` 错误，并提供可直接复用的安全写法与实践建议。
在 Yii2 中，deleteAll() 是 ActiveRecord 提供的高效批量删除方法，它绕过实例化模型、不触发事件和验证，直接生成并执行 SQL DELETE 语句。但其查询条件参数对格式极为敏感——必须严格遵循 Yii 的查询构建器规范，否则极易抛出类似 strtoupper() expects parameter 1 to be string, array given 的致命错误。
该错误的根本原因在于：deleteAll() 内部调用 QueryBuilder 处理条件时，会尝试对每个条件键（如 'plan_year_id'）调用 strtoupper() 进行标准化处理；而当传入的条件结构为多层嵌套且未以逻辑操作符（如 "AND"、"OR"）显式包裹时，框架会将整个数组误判为“字段名”，从而向 strtoupper() 传入数组类型参数，触发类型错误。
✅ 正确写法需显式声明复合条件的逻辑关系。例如，要同时满足：
- plan_year_id 等于指定值
- column_type 在某个键名数组中
- is_auto 等于指定布尔值
- 且 column_id 不等于 1
应使用 "AND" 逻辑操作符统一封装所有子条件：
AllAdjustments::deleteAll([
'AND',
[
'plan_year_id' => $plan_year_id,
'column_type' => array_keys($allAdjustment),
'is_auto' => $is_auto,
],
['NOT', ['column_id' => 1]]
]);⚠️ 注意事项：
- 不可省略 "AND"：即使所有条件均为 AND 关系，也必须显式声明，否则框架无法解析嵌套结构；
- array_keys($allAdjustment) 安全性：确保 $allAdjustment 是关联数组，否则 array_keys() 可能返回非字符串键（如数字），导致 SQL 类型不匹配；建议添加类型校验或使用 array_map('strval', array_keys(...)) 强制转为字符串；
- SQL 注入防护：deleteAll() 自动参数化所有标量值（如 $plan_year_id, 1），但不支持动态字段名或操作符，切勿拼接用户输入到条件键或逻辑符中；
- 事务保障：批量删除不可逆，强烈建议在业务逻辑中包裹 Yii::$app->db->transaction()，便于异常回滚；
- 替代方案考量：若需触发模型事件（如 beforeDelete）、验证或级联操作，请改用循环 + Model::findOne()->delete()，尽管性能较低，但语义更安全。
总结：Yii2 的 deleteAll() 是性能利器，但其条件语法是“强契约式”的——必须以逻辑操作符为根节点组织条件树。掌握这一范式，既能规避底层类型错误，又能写出清晰、健壮、符合框架设计哲学的数据操作代码。
