{"path":"1037589","ref":"修改器.md","title":"修改器","content":"## 修改器\n\n和获取器相反，修改器的主要作用是对模型设置的数据对象值进行处理。\n\n修改器方法的命名规范为：\n\n>[info] ### set`FieldName`Attr\n\n修改器的使用场景和读取器类似：\n\n*   时间日期字段的转换写入；\n*   集合或枚举类型的写入；\n*   数字状态字段的写入；\n*   某个字段涉及其它字段的条件或者组合写入；\n\n定义了修改器之后会在下列情况下触发：\n\n*   模型对象赋值；\n*   调用模型的`data`方法，并且第二个参数传入`true`；\n*   调用模型的`appendData`方法，并且第二个参数传入`true`；\n*   调用模型的`save`方法，并且传入数据；\n*   显式调用模型的`setAttr`方法；\n*   显式调用模型的`setAttrs`方法,效果与`appendData`并传入`true`的用法相同；\n\n例如：\n\n~~~\n<?php\nnamespace app\\model;\n\nuse think\\Model;\n\nclass User extends Model \n{\n    public function setNameAttr($value)\n    {\n        return strtolower($value);\n    }\n}\n~~~\n\n如下代码实际保存到数据库中的时候会转为小写\n~~~\n$user = new User();\n$user->name = 'THINKPHP';\n$user->save();\necho $user->name; \/\/ thinkphp\n~~~\n\n也可以进行序列化字段的组装：\n~~~\nnamespace app\\model;\n\nuse think\\Model;\n\nclass User extends Model \n{\n    public function setSerializeAttr($value,$data)\n    {\n        return serialize($data);\n    }\n}\n~~~\n\n> 修改器方法的第二个参数会自动传入当前的所有数据数组。\n\n如果你需要在修改器中修改其它数据，可以使用\n\n~~~\n<?php\nnamespace app\\model;\n\nuse think\\Model;\n\nclass User extends Model \n{\n    public function setTestFieldAttr($value, $data)\n    {\n        $this->set('other_field', $data['some_field']);\n    }\n}\n~~~\n\n上面的例子，在`test_field`字段的修改器中修改了`other_field`字段数据，并且没有返回值（表示不对`test_field`字段做任何修改）。\n\n## 批量修改\n\n除了赋值的方式可以触发修改器外，还可以用下面的方法批量触发修改器：\n~~~\n$user = new User();\n$data['name'] = 'THINKPHP';\n$data['email'] = 'thinkphp@qq.com';\n$user->data($data, true);\n$user->save();\necho $user->name; \/\/ thinkphp\n~~~\n如果为`name`和`email`字段都定义了修改器的话，都会进行处理。\n\n或者直接使用save方法触发，例如：\n~~~\n$user = new User();\n$data['name'] = 'THINKPHP';\n$data['email'] = 'thinkphp@qq.com';\n$user->save($data);\necho $user->name; \/\/ thinkphp\n~~~\n\n>[danger] 修改器方法仅对模型的写入方法有效，调用数据库的写入方法写入无效，例如下面的方式修改器无效。\n~~~php\n$user = new User();\n$data['name'] = 'THINKPHP';\n$data['email'] = 'thinkphp@qq.com';\n$user->insert($data);\n~~~"}