yii2中修改json字段名映射应重写attributes()方法，如返回['user_name' => 'username']，使load()自动完成键名到属性的转换，验证规则仍需使用属性名（如'username'）。
Yii2 表单验证中，JSON 字段名映射默认使用模型属性名（如 data），但实际提交的 JSON 数据可能用的是下划线命名（如 user_name）或驼峰（如 userName），导致验证失败或赋值异常。要修改 JSON 字段名映射，核心是控制「表单字段名 → 模型属性名」的转换逻辑，主要在两个环节调整：
1. 重写 formName() 或使用 attributeLabels() 不起作用？
注意：formName() 控制整个表单前缀（如 UserForm[data]），attributeLabels() 只影响提示文本，**不改变字段名映射**。真正影响 JSON 解析和验证的是属性赋值过程。
2. 在模型中覆盖 attributes() 方法（推荐）
当 JSON 数据键名与模型属性名不一致时，可重写 attributes() 返回自定义映射关系，让 Yii 知道哪些外部字段对应哪些内部属性：
- 例如前端传
{"user_name": "Alice", "is_active": true}，而模型属性是$userName和$isActive - 在模型中添加：
public function attributes()
{
return [
'user_name' => 'userName',
'is_active' => 'isActive',
// 其他映射...
] + parent::attributes();
}
这样调用 $model->load($post) 或 $model->load(Yii::$app->request->getBodyParams()) 时，Yii 会自动将 user_name 赋给 $userName，验证规则也能正常触发。
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
3. 配合 scenarios() 和验证规则使用
确保验证规则中的 attribute 名与模型属性名一致（即 userName），而非 JSON 键名：
- 在
rules()中写：['userName', 'required']，不是['user_name', 'required'] - 若需对原始 JSON 键做特殊验证（如检查
user_name是否为空字符串），可用filter或自定义验证器，在验证前先从$_POST或原始数据中提取
4. 处理嵌套 JSON 或动态字段（进阶）
如果 JSON 结构复杂（如 {"profile": {"first_name": "A"}} ），建议：
- 用
SafeValidator配合extraFields()或自定义 setter（如setProfile($value)）预处理 - 或在控制器中手动解包再赋值：
$model->userName = $data['profile']['first_name'] ?? '';，绕过自动映射 - 避免直接修改
$_POST全局数组——不安全且不可维护
关键点：Yii2 的字段映射本质是「外部输入键 → 内部属性」的映射，改 attributes() 是最直接、兼容性最好的方式，无需改动核心框架或请求解析流程。
