CakePHP 4 如何保存Categories与Products关联连接表记录

问题核心原因 #

连接表不写入、添加连接表关联报未定义错误，本质是多对多（BelongsToMany）关联的传参格式、关联配置逻辑不符合CakePHP ORM规则，和数据库结构、bake生成的代码基础逻辑无关。

正确操作步骤 #

• 第一步：校验模型关联定义
  多对多关联不需要直接挂载连接表模型，连接表由ORM自动托管。先确认两个主表的关联配置正确：
  在src/Model/Table/ProductsTable.php的initialize方法中，关联配置应如下：

  $this->belongsToMany('Categories', [
      'joinTable' => 'categories_products',
      'foreignKey' => 'product_id', // 当前表(Products)在连接表的外键
      'targetForeignKey' => 'category_id', // 目标表(Categories)在连接表的外键
  ]);
  

  对应src/Model/Table/CategoriesTable.php的反向多对多关联配置也要对应，bake生成的代码默认会带这部分配置，重点检查两个外键有没有写反即可。
• 第二步：修正请求传参结构
  当前传入categories_products属性的写法完全错误，多对多关联保存时，传参的键名必须和关联别名一致，也就是用Categories对应的下划线形式categories作为键名，参数结构调整为：

  [
      // 商品自身字段，如名称、价格等
      'name' => '示例商品',
      'price' => 100,
      'categories' => [
          ['id' => 传入你要绑定的分类ID值x],
          // 绑定多个分类就追加多个带id的数组元素
      ]
  ]
  

  不需要手动拼接连接表的category_id、product_id结构，ORM保存商品拿到自增生成的product_id后，会自动组装两个外键数据写入categories_products表。

• 第三步：修正保存时的关联配置
  原来写的['associated' => ['Categories']]配置本身是正确的，之前报关系未定义错误，是因为错误把CategoriesProducts加到了associated数组中——普通双外键的多对多连接场景，只需要声明关联的目标模型（即Categories）即可，不需要手动声明连接表模型。
• 第四步：检查实体可访问配置
  如果改完上述配置还是不写入，打开src/Model/Entity/Product.php，检查$_accessible数组中是否开启了categories字段的批量赋值权限：

  protected $_accessible = [
      // 其他字段配置...
      'categories' => true,
  ];
  

  配置为true后，传入的categories参数才不会被实体过滤掉。

额外说明 #

如果categories_products连接表除了两个外键还有其他自定义字段（比如排序值、关联状态），才需要在关联配置中通过through指定连接表模型，在传参时追加_joinData字段写入中间表自定义内容，纯外键的连接表不需要额外配置。

内容的提问来源于stack exchange，提问作者Robin.v