本文详解 Yii2 框架中 deleteAll() 方法的正确用法，重点解决因条件数组嵌套格式错误导致的 strtoupper() expects parameter 1 to be string 报错问题，并提供规范的复合查询条件写法与安全实践建议。
本文详解 yii2 框架中 `deleteall()` 方法的正确用法，重点解决因条件数组嵌套格式错误导致的 `strtoupper() expects parameter 1 to be string` 报错问题，并提供规范的复合查询条件写法与安全实践建议。
在 Yii2 中，ActiveRecord::deleteAll() 是批量删除数据的高效方式，但其参数格式对条件表达式有严格要求：当需要组合多个逻辑条件（如 AND、NOT、IN 等）时，必须显式使用操作符作为首元素的数组结构，而不能将多个条件数组并列传入——否则框架底层 QueryBuilder 在解析时会误将数组当作字符串处理，从而抛出 strtoupper() expects parameter 1 to be string, array given 错误（常见于 vendor/yiisoft/yii2/db/QueryBuilder.php 第 1188 行）。
正确的复合条件写法应以逻辑操作符（如 "AND"、"OR"、"NOT"）为数组第一个元素，后续各元素为子条件（支持关联数组、嵌套表达式等）。例如，要删除满足以下全部条件的记录：
- plan_year_id 等于指定值
- column_type 属于 $allAdjustment 键名组成的数组（即 IN 语义）
- is_auto 等于指定布尔值
- 且 column_id 不等于 1
应采用如下结构：
AllAdjustments::deleteAll([
'AND',
['plan_year_id' => $plan_year_id],
['column_type' => array_keys($allAdjustment)],
['is_auto' => $is_auto],
['NOT', ['column_id' => 1]],
]);✅ 优势说明：
- 'AND' 明确声明逻辑关系，避免框架歧义；
- 每个条件独立成项，可读性强、易于维护；
- 支持嵌套（如 ['NOT', ['IN', 'column_type', [...]]]），扩展灵活。
⚠️ 注意事项：
- 切勿省略顶层操作符：deleteAll(['a'=>1, 'b'=>2]) 是合法的简单等值条件，但一旦混用 ['NOT', ...] 等复杂表达式，就必须升级为带操作符的数组格式；
- 避免直接拼接 SQL 字符串：虽可通过 deleteAll("plan_year_id = :pid AND ...", [':pid' => $plan_year_id]) 绕过语法限制，但牺牲了安全性与可移植性，不推荐；
- 执行前务必验证条件：建议先用 AllAdjustments::find()->where(...)->count() 预估影响行数；生产环境强烈建议配合事务封装：
$transaction = \Yii::$app->db->beginTransaction();
try {
$deleted = AllAdjustments::deleteAll([
'AND',
['plan_year_id' => $plan_year_id],
['column_type' => array_keys($allAdjustment)],
['is_auto' => $is_auto],
['NOT', ['column_id' => 1]],
]);
$transaction->commit();
\Yii::info("Deleted {$deleted} records.", __METHOD__);
} catch (\Exception $e) {
$transaction->rollBack();
throw $e;
}总结：deleteAll() 的强大依赖于对 Yii2 查询条件语法的精准理解。牢记“复合条件 = 操作符 + 条件列表”这一核心范式，即可规避常见解析错误，写出健壮、可维护的批量删除逻辑。
