CakePHP 3 添加表单中保存hasMany关联的问题

嗨，我正好碰到过类似的场景，给你一步步说怎么解决这个shop_id缺失的问题：

1. 先确认模型关联配置是否正确 #

首先得确保Shop和Offer的关联关系配置到位，这是自动填充shop_id的基础：

Shop模型（Shop.php） #

public function initialize(): void
{
    parent::initialize();
    $this->hasMany('Offers', [
        'foreignKey' => 'shop_id',
        'dependent' => true, // 可选，删除店铺时自动删除关联优惠
    ]);
}

Offer模型（Offer.php） #

public function initialize(): void
{
    parent::initialize();
    $this->belongsTo('Shops', [
        'foreignKey' => 'shop_id',
    ]);
}

2. 调整Offer模型的验证规则 #

因为新创建的Offer还没有对应的shop_id（这个ID是Shop保存后才生成的），所以要在Offer的验证规则里允许create场景下shop_id为空：

public function validationDefault(Validator $validator): Validator
{
    $validator
        ->integer('shop_id')
        ->allowEmptyString('shop_id', 'create'); // 关键：创建时允许为空，CakePHP会自动填充

    // 其他字段的验证规则，比如name、description等
    $validator
        ->scalar('name')
        ->maxLength('name', 255)
        ->requirePresence('name', 'create')
        ->notEmptyString('name');

    return $validator;
}

3. 控制器中正确处理关联数据保存 #

在ShopsController的add方法里，需要告诉CakePHP要处理关联的Offers数据，重点是patchEntity时加上associated选项：

public function add()
{
    $shop = $this->Shops->newEmptyEntity();
    
    if ($this->request->is('post')) {
        // 核心：指定要关联的Offers模型，让CakePHP自动处理关联保存
        $shop = $this->Shops->patchEntity($shop, $this->request->getData(), [
            'associated' => ['Offers']
        ]);
        
        if ($this->Shops->save($shop)) {
            $this->Flash->success(__('店铺和所有关联优惠都保存成功啦！'));
            return $this->redirect(['action' => 'index']);
        }
        $this->Flash->error(__('保存失败，请检查表单内容后重试。'));
    }
    
    $this->set(compact('shop'));
}

4. 表单字段写法保持正确 #

你之前的表单字段写法是没问题的，继续用offers.N.field的格式就能让CakePHP识别到关联数据。比如可以手动添加多个Offer字段：

// src/Template/Shops/add.php
echo $this->Form->create($shop);

// 店铺基本信息字段
echo $this->Form->control('name', ['label' => '店铺名称']);
echo $this->Form->control('address', ['label' => '店铺地址']);

// 第一个优惠
echo '<h4>优惠1</h4>';
echo $this->Form->control('offers.0.name', ['label' => '优惠名称']);
echo $this->Form->control('offers.0.description', ['label' => '优惠描述']);

// 第二个优惠
echo '<h4>优惠2</h4>';
echo $this->Form->control('offers.1.name', ['label' => '优惠名称']);
echo $this->Form->control('offers.1.description', ['label' => '优惠描述']);

echo $this->Form->button(__('保存店铺和优惠'));
echo $this->Form->end();

这样操作之后，当你提交表单时，CakePHP会先保存Shop生成新的shop_id，然后自动把这个ID填充到所有关联的Offer记录中，再批量保存Offer，就不会出现shop_id缺失的错误啦。

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