CakePHP4.4中Block实体val数组属性始终为null的问题求助

环境信息 #

• PHP: 8.1
• CakePHP: 4.4.x
• PostgreSQL: 13

问题描述 #

创建Block实体并设置val属性（对应PostgreSQL的integer[]数组字段）后，该属性始终被设为null。排查发现Cake\ORM\Marshaller的_buildPropertyMap方法错误地将val列类型识别为string，导致传入的数组值被过滤为空。

表定义 #

create table blocks
(
    id         integer generated always as identity,
    val        integer[]
);

注：原SQL中id行末尾缺少逗号，已修正以保证语法正确性。

代码实现 #

Block实体仅继承Cake\ORM\Entity，无自定义逻辑；BlocksTable代码如下：

class BlocksTable extends Table {
    public function initialize(array $config): void {
        $this->setTable('blocks');
        $this->setEntityClass('App\Model\Entity\Block');
    }

    public function createNewBlock(int ...$val): Block {
        return $this->newEntity([
            'val' => $val
        ]);
    }
}

执行结果 #

App\Model\Entity\Block Object
(
    [val] => 
)

预期val为传入的整数数组，实际始终为空。

方案1：手动指定Table字段类型（推荐） #

在BlocksTable的initialize方法中，通过setSchema手动声明val字段的类型为array，覆盖自动识别的错误类型：

public function initialize(array $config): void {
    $this->setTable('blocks');
    $this->setEntityClass('App\Model\Entity\Block');
    
    // 手动定义字段类型，修正数组字段的识别问题
    $this->setSchema([
        'id' => 'integer',
        'val' => 'array'
    ]);
}

方案2：在实体中添加字段转换逻辑 #

在Block实体类中添加_setVal方法，强制将传入值转换为数组，确保数据被正确保留：

class Block extends Entity {
    // 允许字段赋值（根据需求调整权限）
    protected $_accessible = [
        'val' => true,
        'id' => false
    ];

    /**
     * 处理val字段的赋值逻辑
     */
    protected function _setVal($value) {
        return is_array($value) ? $value : [];
    }
}

方案3：临时关闭类型检查（应急用） #

在创建实体时，通过marshalOptions关闭类型检查，跳过错误的类型验证：

public function createNewBlock(int ...$val): Block {
    return $this->newEntity(
        ['val' => $val],
        [
            'marshalOptions' => ['checkTypes' => false]
        ]
    );
}

警告：此方法会跳过所有字段的类型验证，可能引入非法数据，仅建议临时测试或应急使用。

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