yii2中数组字段需显式声明属性类型、避免直接用load()处理嵌套数组，应使用loadmultiple()批量加载或手动提取验证，同时注意过滤空数据、类型转换及json字段的safe规则。
Yii2中数组字段提交后无法自动赋值到模型
Yii2默认不支持直接将 $_POST 中的嵌套数组（如 Post[tags][0]、Post[images][1][url]）映射到模型属性，除非你显式声明该属性为数组或使用场景化处理。常见表现是：表单提交了多组数据，但 $model->load($post) 后，$model->tags 仍是空或报错。
根本原因是 Yii2 的 load() 方法只做一级键名匹配，不会递归解析方括号语法；而 HTML 表单生成的数组键（如 name="Post[tags][0]"）在 PHP 中被解析为多维数组，但模型没定义对应结构时，框架跳过赋值。
- 确保模型中声明对应属性为 public，且类型注释明确（如
/** @var array */ public $tags;），否则 ActiveRecord 可能因属性不存在而静默忽略 - 若字段是关联数据（如多对多标签），别依赖
load()直接写入，应拆解后调用$model->link()或手动同步 - 避免在
rules()中对数组字段用'required'，它只校验是否存在，不校验子项；改用自定义验证器或each规则
用 loadMultiple() 处理多行同结构子表单（如商品 SKU 列表）
当表单提交的是多个同结构对象（例如 ProductSku[0][price]、ProductSku[1][stock]），应放弃单个模型的 load()，改用 Model::loadMultiple() —— 它专为批量实例设计，能正确识别带数字索引的嵌套键。
典型流程是先创建空模型数组，再一次性加载：
$skus = [new ProductSku(), new ProductSku()];
if (Model::loadMultiple($skus, Yii::$app->request->post())) {
foreach ($skus as $sku) {
$sku->product_id = $product->id;
if (!$sku->validate()) {
// 错误会按索引分组在 $sku->errors 中
}
}
}
- 必须传入已初始化的模型实例数组，不能传类名或空数组；否则
loadMultiple()无处绑定数据 - 注意 CSRF 验证：如果表单未包含
_csrf字段，loadMultiple()仍会执行，但后续save()可能因验证失败静默退出 - 前端 name 属性必须严格匹配模型类名（区分大小写），例如
name="ProductSku[0][price]"，不能写成product_sku或Productsku
手动提取并验证数组字段（如动态表单、非标准嵌套）
当表单结构不规则（如 name="options[colors][]" 或 name="meta[custom][field1]"），又不想引入额外组件时，绕过 load() 直接从 Yii::$app->request->post() 提取更可控。
关键点在于：先取原始数据，再做清理和验证，最后赋值给模型属性：
$post = Yii::$app->request->post('Post', []);
$model->tags = ArrayHelper::getColumn($post['tags'], 'name', []); // 提取所有 tags[i][name]
$model->images = [];
foreach ($post['images'] as $img) {
if (!empty($img['url']) && filter_var($img['url'], FILTER_VALIDATE_URL)) {
$model->images[] = $img;
}
}
- 永远用
ArrayHelper::getColumn()或array_column()（PHP ≥7.4）代替foreach手动遍历，减少出错概率 - 对用户输入的数组字段，务必做长度限制（如
count($arr) ），防止恶意提交超大数组导致内存溢出 - 不要在
beforeSave()中反向解析 POST 数据——此时请求已结束，Yii::$app->request->post()不再可用
保存前清除非法数组键或空子项
用户可能提交空行（如 Post[items][2][name]=""）、缺失必填键（如只有 url 没有 alt），直接保存会导致脏数据或数据库约束失败。
推荐在 afterValidate() 或保存前统一过滤：
public function afterValidate()
{
parent::afterValidate();
// 清除 items 中任意字段全为空的项
$this->items = array_filter($this->items, function ($item) {
return !empty(array_filter($item)); // 过滤掉所有值都为空的子数组
});
}
- 慎用
array_map('trim', $arr)处理字符串数组——它无法递归作用于多维结构，容易漏掉深层空格 - 对关联 ID 数组（如
category_ids），用array_map('intval', $ids)强转，避免 SQL 注入风险（即使用了 ActiveRecord，原始数组也可能绕过 type casting） - 数据库字段为 JSON 类型时，记得在
rules()中加['json_data', 'safe']，否则load()会跳过该字段
数组字段真正麻烦的不是怎么存，而是怎么让前端传得干净、后端判得清楚、错误提示能准确定位到第几行哪个字段——这三步缺一不可。
