CakePHP3：实体FLOAT字段需存储为INTEGER的技术问题

看起来你遇到的是ORM类型推断和实际需求不匹配的问题——数据库里price字段是integer(11)，但应用层需要以Float类型展示。之前用beforeSave、beforeMarshal没达到预期，大概率是因为ORM会优先根据数据库schema推断字段类型，手动的@property注释优先级不够。下面给你几个精准的解决方案：

1. 用实体存取器（Accessor）处理读取转换 #

在你的实体类里，添加一个属性获取方法，专门把数据库返回的整数转换成浮点数：

protected function _getPrice($value)
{
    // 这里根据你的业务逻辑调整，比如如果存的是分就除以100得到元
    return (float)$value;
}

当你通过$entity->price读取字段时，这个方法会自动触发，返回的就是Float类型了，完全不需要额外手动转换。

2. 用实体修改器（Mutator）处理保存转换 #

如果需要在保存时把Float转成Integer存入数据库，再给实体加一个属性设置方法：

protected function _setPrice($value)
{
    // 比如把元转成分，乘以100后取整
    return (int)round($value * 100);
}

这样当你给$entity->price赋值Float时，会自动转换成Integer存入数据库，比beforeSave更优雅，也更贴合框架的实体设计思路。

3. 显式覆盖Table类的字段类型映射 #

如果ORM还是顽固地把字段识别成Integer，在Table类的initialize方法里，强制指定字段的PHP类型：

public function initialize(array $config): void
{
    parent::initialize($config);
    
    $this->setTable('your_table_name');
    // 其他初始化代码...
    
    // 把price字段的PHP类型设为float
    $this->getSchema()->setColumnType('price', 'float');
}

这会告诉ORM：不管数据库里是什么类型，应用层处理这个字段时就按Float来。

4. 修正@property注释的位置 #

确保你的@property注释是正确放在实体类的文档块里，而不是随便写在某个地方：

/**
 * @property int $id
 * @property float $price
 * @property \Cake\I18n\FrozenTime $created
 * // 其他属性...
 */
class Product extends Entity
{
    // 实体代码...
}

这个主要是给IDE提示用的，不影响运行时，但正确的注释能让开发更顺畅。

为啥之前的beforeSave/beforeMarshal没生效？ #

beforeMarshal只在请求数据转实体的时候触发，从数据库读实体时不会跑这个钩子；beforeSave是保存前处理数据，管不了读取时的类型转换。而存取器（Accessor）是专门处理属性读取的，刚好匹配你的需求。

内容的提问来源于stack exchange，提问作者Lurker