本文详解 Yii2 框架中 deleteAll() 方法的条件组合写法，重点解决因错误嵌套数组导致的 strtoupper() expects parameter 1 to be string 报错问题，并提供规范、安全、可扩展的条件构造示例。
本文详解 yii2 框架中 `deleteall()` 方法的条件组合写法，重点解决因错误嵌套数组导致的 `strtoupper() expects parameter 1 to be string` 报错问题，并提供规范、安全、可扩展的条件构造示例。
在 Yii2 中，ActiveRecord::deleteAll() 是执行无回调、无事件触发的高效批量删除操作的核心方法。但其条件参数（$condition）对格式极为敏感：它不接受多层自由嵌套的数组结构，而要求显式声明逻辑运算符（如 "AND"、"OR"）作为顶层键。否则，框架底层 QueryBuilder 在解析字段名时会将数组误传给 strtoupper()，从而抛出 “expects parameter 1 to be string, array given” 的致命错误——这正是原始代码的问题根源。
原始写法错误地将 ['NOT', ['column_id'=>1]] 与其他键值对并列置于同一关联数组中：
// ❌ 错误：混合键值与表达式，破坏 condition 结构
AllAdjustments::deleteAll([
'plan_year_id' => $plan_year_id,
'column_type' => array_keys($allAdjustment),
'is_auto' => $is_auto,
['NOT', ['column_id' => 1]], // ← 此处非法：数组元素无法与字符串键共存
]);Yii2 的 deleteAll() 要求所有复杂条件必须通过 运算符前缀数组 显式组织。正确方式是将全部条件统一包裹在 "AND"（或 "OR"）逻辑组中：
// ✅ 正确：使用标准运算符数组结构
AllAdjustments::deleteAll([
'AND',
[
'plan_year_id' => $plan_year_id,
'column_type' => array_keys($allAdjustment),
'is_auto' => $is_auto,
],
['NOT', ['column_id' => 1]],
]);该结构清晰表达了「同时满足三个等值条件，且 column_id ≠ 1」的语义。其中：
- 'AND' 为必需的首元素，声明逻辑关系；
- 后续每个元素均为独立子条件（支持关联数组、运算符数组、标量值等）；
- ['NOT', [...]] 是 Yii2 内置的标准否定表达式，安全可靠。
⚠️ 重要注意事项：
- 永远校验变量安全性：$plan_year_id、$is_auto 和 $allAdjustment（及其 array_keys() 结果）应确保已过滤或来自可信上下文，避免 SQL 注入风险（尽管 Yii2 自动参数化，但极端情况下恶意键名仍可能引发异常）；
- 慎用 deleteAll()：该操作绕过模型事件（beforeDelete/afterDelete）和验证，不触发关联删除。若业务需审计日志、级联清理或权限检查，请改用循环 + delete() 或事务封装；
-
测试先行：建议搭配 createCommand()->getRawSql() 预览生成的 SQL：
$sql = \Yii::$app->db->createCommand()->delete( 'all_adjustments', ['AND', ['plan_year_id' => 2024], ['NOT', ['column_id' => 1]]] )->getRawSql(); \Yii::info("Delete SQL: {$sql}");
总结：deleteAll() 的条件不是“任意 PHP 数组”，而是遵循 Yii2 特定 DSL 的结构化表达式。掌握 "AND"/"OR" 顶层封装原则，合理使用 ['IN', 'column', $values]、['BETWEEN', 'date', $start, $end] 等内置格式，即可写出健壮、可读、无报错的批量删除逻辑。
