PrestaShop 1.7.6自定义分类字段模块数据库存储报错求助

看起来你遇到的核心问题是数据库主键冲突和Hook方法不匹配，咱们一步步来修正：

1. 先修正Hook方法的匹配问题 #

你在install()里注册的是actionAdminCategoriesControllerSaveAfter和actionAdminCategoriesFormModifier，但代码里写的是hookActionCategoryFormBuilderModifier、hookActionAfterCreateCategoryFormHandler这些不匹配的方法名，导致你的逻辑根本不会被触发，或者触发时参数不对。

推荐换成更适配Symfony模型的Object Hook（更符合PrestaShop 1.7的架构），同时修正方法名与注册Hook的对应关系：

修正后的Hook注册与表单修改方法 #

public function install() {
    if (!parent::install()
        || !$this->_installSql()
        // 注册更适合的Object Hook，对应分类新增/更新事件
        || !$this->registerHook('actionObjectCategoryAddAfter')
        || !$this->registerHook('actionObjectCategoryUpdateAfter')
        // 注册分类表单修改Hook
        || !$this->registerHook('actionAdminCategoriesFormModifier')
    ) {
        return false;
    }
    return true;
}

// 匹配注册的actionAdminCategoriesFormModifier Hook，负责添加自定义字段
public function hookActionAdminCategoriesFormModifier(array $params) {
    /** @var \Symfony\Component\Form\FormBuilder $formBuilder */
    $formBuilder = $params['form_builder'];
    $category = $params['object'];
    
    // 获取已有颜色值（编辑分类时显示已保存的内容）
    $existingColor = Db::getInstance()->getValue(
        'SELECT color FROM `'._DB_PREFIX_.'category_lang` WHERE id_category = '.(int)$category->id.' AND id_lang = '.(int)$this->context->language->id
    );

    $formBuilder->add('color', \Symfony\Component\Form\Extension\Core\Type\TextType::class, [
        'label' => $this->l('Color'),
        'required' => false,
        'constraints' => [
            new \Symfony\Component\Validator\Constraints\Length([
                'max' => 20,
                'maxMessage' => $this->l('Max characters allowed: 20'),
            ]),
        ],
        'data' => $existingColor ?: '' // 显示已有值或空字符串
    ]);
    // 不需要手动调用setData，FormBuilder会自动处理原有数据绑定
}

2. 修复数据库操作的主键冲突问题 #

你直接用insert()每次保存都会往ps_category_lang里插新记录，但这个表的主键是id_category + id_lang的联合主键，重复插入就会触发主键冲突错误。正确的做法是先判断是否已有该分类+语言的记录，有则更新，无则插入（也就是Upsert逻辑）。

修正后的保存逻辑方法 #

// 处理新增分类后的自定义字段保存
public function hookActionObjectCategoryAddAfter(array $params) {
    $category = $params['object'];
    $this->saveCustomColorField($category);
}

// 处理更新分类后的自定义字段保存
public function hookActionObjectCategoryUpdateAfter(array $params) {
    $category = $params['object'];
    $this->saveCustomColorField($category);
}

protected function saveCustomColorField($category) {
    // 从请求中获取表单提交的color值
    $color = Tools::getValue('color');
    $idLang = (int)$this->context->language->id;
    $idCategory = (int)$category->id;

    // 先检查是否已有该分类+语言的记录
    $recordExists = Db::getInstance()->getValue(
        'SELECT 1 FROM `'._DB_PREFIX_.'category_lang` WHERE id_category = '.(int)$idCategory.' AND id_lang = '.(int)$idLang
    );

    $data = ['color' => pSQL($color)];

    if ($recordExists) {
        // 已有记录，执行更新操作
        Db::getInstance()->update(
            'category_lang',
            $data,
            'id_category = '.(int)$idCategory.' AND id_lang = '.(int)$idLang
        );
    } else {
        // 无记录（仅极端场景，分类创建时ps_category_lang已自动生成记录），执行插入
        $data['id_category'] = $idCategory;
        $data['id_lang'] = $idLang;
        Db::getInstance()->insert('category_lang', $data);
    }
}

3. 额外注意事项 #

• SQL安装的正确性：确保你的_installSql()方法确实给ps_category_lang表添加了color字段，示例代码如下：

  protected function _installSql() {
      return Db::getInstance()->execute('
          ALTER TABLE `'._DB_PREFIX_.'category_lang` 
          ADD COLUMN `color` VARCHAR(20) NULL DEFAULT NULL AFTER `description`;
      ');
  }
  

• 参数安全：所有存入数据库的值都要用pSQL()过滤，防止SQL注入（上面的代码已经处理）。
• 表单数据获取：用Tools::getValue('color')比从$params['form_data']获取更可靠，在Object Hook中直接读取请求值更适配PrestaShop的请求流程。

这样修改后，就能避免主键冲突的错误，正确保存自定义字段的值了。

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