PrestaShop 1.7模块主PHP文件use语句失效问题求助

问题背景 #

修改PrestaShop 1.7后台订单页KPI区域时，创建的模块无法加载自定义KPI类，报错提示找不到对应命名空间下的类。

自定义KPI类代码 #

文件路径：modules/commissionemployee/src/Kpi/CmCustomKpi.php（替换为你的实际模块目录）

namespace PrestaShop\Module\CommissionEmployee\Kpi;

use Context;
use HelperKpi;
use PrestaShop\PrestaShop\Kpi\KpiInterface;

/**
* @internal
*/
final class CmCustomKpi implements KpiInterface
{
    /**
    * {@inheritdoc}
    */
    public function render()
    {
        $translator = Context::getContext()->getTranslator();

        $helper = new HelperKpi();
        $helper->id = 'box-total-user';
        $helper->icon = 'account_box';
        $helper->color = 'color1';
        $helper->title = $translator->trans('Total users', [], 'Admin.Global');
        $helper->subtitle = $translator->trans('30 days', [], 'Admin.Global');
        $helper->value = 20;
        return $helper->generate();
    }
}

模块主文件相关代码 #

// 顶部use语句
use PrestaShop\Module\CommissionEmployee\Kpi\CmCustomKpi;

// 钩子函数
public function hookActionOrdersKpiRowModifier(array $params)
{
    $params['kpis'][] = new CmCustomKpi();
}

错误信息 #

Attempted to load class "CmCustomKpi" from namespace "Prestashop\Module\CommissionEmployee\Kpi".
Did you forget a "use" statement for another namespace?

解决步骤 #

• 匹配命名空间与目录结构
  确保自定义类的命名空间PrestaShop\Module\CommissionEmployee\Kpi与实际文件路径完全对应：模块根目录为modules/commissionemployee/，类文件放在src/Kpi/CmCustomKpi.php下，同时注意命名空间中PrestaShop的大小写（首字母大写），模块目录名建议用小写（commissionemployee）。

• 配置自动加载
  在模块根目录创建composer.json文件，定义PSR-4自动加载规则：

  {
      "name": "prestashop/commissionemployee",
      "type": "prestashop-module",
      "autoload": {
          "psr-4": {
              "PrestaShop\\Module\\CommissionEmployee\\": "src/"
          }
      },
      "require": {
          "php": ">=7.1"
      }
  }
  

  执行composer dump-autoload生成自动加载文件，将vendor目录和composer相关文件一并包含在模块中。

• 修正use语句大小写
  确保use语句的命名空间与类文件中的完全一致，注意PrestaShop的大写：

  use PrestaShop\Module\CommissionEmployee\Kpi\CmCustomKpi;
  

• 确认钩子注册
  在模块安装方法中注册actionOrdersKpiRowModifier钩子：

  public function install()
  {
      return parent::install() && $this->registerHook('actionOrdersKpiRowModifier');
  }
  

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