本文详解如何在移除 Product 模型中冗余的 price 数据库字段后，通过属性访问器（getter/setter）和生命周期事件，透明地读写其关联模型 ProductProperties 的 price 字段，实现逻辑解耦与代码简洁。
本文详解如何在移除 `product` 模型中冗余的 `price` 数据库字段后，通过属性访问器（getter/setter）和生命周期事件，透明地读写其关联模型 `productproperties` 的 price 字段，实现逻辑解耦与代码简洁。
在 Yii 2 应用开发中，随着业务演进，常需将原属主模型的字段（如 Product::price）迁移至独立的扩展表（如 product_properties），以支持更灵活的属性管理。此时，若直接删除数据库列并废弃旧属性，前端、API 层及业务逻辑中大量对 $product->price 的引用将全部失效。理想方案是保持接口不变，底层自动桥接至关联模型——Yii 2 提供了优雅且符合框架约定的实现路径。
✅ 推荐方案：使用访问器（Getter）实现只读代理
最轻量、安全且符合 Yii 2 最佳实践的方式是定义一个 getPrice() 访问器：
class Product extends ActiveRecord
{
// 已定义的关联关系
public function getProductProperties()
{
return $this->hasOne(ProductProperties::class, ['product_id' => 'id']);
}
// 新增：透明代理 price 字段
public function getPrice()
{
// 自动加载关联，避免 N+1；若关联不存在则返回 null 或抛异常
return $this->productProperties?->price;
}
}
✅ 使用方式完全无感：
$product = Product::findOne(1);
echo $product->price; // 输出 ProductProperties.price，无需修改调用方代码
echo $product->getAttribute('price'); // 同样生效（因 price 是虚拟属性）
? 优势：零侵入、无额外数据库查询（productProperties 会在首次访问时惰性加载）、天然支持 toArray() 和 RESTful API 序列化（配合 fields()）。
⚙️ 进阶方案：支持读写双向同步（含验证与持久化）
若业务要求支持 $product->price = 999 并自动保存到 ProductProperties，需引入临时属性 + 生命周期钩子：
class Product extends ActiveRecord
{
public $price; // 声明为临时属性（非数据库字段）
public function rules()
{
return [
[['price'], 'integer', 'min' => 0],
// 其他原有规则...
];
}
// 读取：从关联模型加载初始值
public function afterFind()
{
parent::afterFind();
$this->price = $this->productProperties?->price ?? 0;
}
// 写入：保存时同步到关联模型
public function afterSave($insert, $changedAttributes)
{
parent::afterSave($insert, $changedAttributes);
if (isset($changedAttributes['price'])) {
// 确保关联模型存在（可自动创建）
if ($this->productProperties === null) {
$this->productProperties = new ProductProperties(['product_id' => $this->id]);
}
$this->productProperties->price = $this->price;
$this->productProperties->save(false); // 跳过验证（若已校验过）
}
}
public function getProductProperties()
{
return $this->hasOne(ProductProperties::class, ['product_id' => 'id']);
}
}
⚠️ 关键注意事项：
- afterSave() 中调用 save(false) 需谨慎，建议在 ProductProperties 中单独定义验证规则，并在此处显式调用 $this->productProperties->validate()；
- 若 ProductProperties 记录可能不存在，应在 afterFind() 和 afterSave() 中补充创建逻辑（如使用 findOrNew() 模式）；
- 大批量操作（如 updateAll()）不触发 afterSave，此类场景需改用事务手动同步。
? 总结与建议
| 场景 | 推荐方式 | 说明 |
|---|---|---|
| 仅需读取 | getPrice() 访问器 | 简洁、高效、零副作用，首选方案 |
| 需读写 + 表单绑定 | 临时属性 + afterFind/afterSave | 支持 load()、validate() 和视图赋值，适合 CRUD 场景 |
| 高并发/强一致性 | 在 Service 层统一处理价格更新 | 避免模型层过度耦合，提升可测试性 |
最终，删除 products.price 列后，只需两步即可平滑过渡：① 添加访问器或临时属性逻辑；② 更新数据库迁移脚本。整个过程对现有业务代码几乎零影响，真正实现“重构无感，演进无忧”。
