如何为PrestaShop 1.6.x模块创建自定义端点（不覆盖核心文件）

嘿，这个需求太常见了！在PrestaShop里给你的模块加自定义端点，完全不用碰核心文件，用官方提供的模块路由机制就能搞定，我给你一步步拆解：

这是PrestaShop官方推荐的模块路由注册方式，完全不需要修改任何核心文件。

首先，在你的模块主文件（比如mymodule.php）里，确保安装时注册这个钩子：

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

然后实现这个钩子方法，返回你的端点路由配置：

public function hookModuleRoutes()
{
    return [
        // 注册端点
        'module-mymodule-register' => [
            'controller' => 'register',
            'rule' => 'mymodule/register', // 前端访问的URL路径
            'keywords' => [],
            'params' => [
                'fc' => 'module',
                'module' => 'mymodule',
                'controller' => 'register'
            ]
        ],
        // 登录端点
        'module-mymodule-login' => [
            'controller' => 'login',
            'rule' => 'mymodule/login',
            'keywords' => [],
            'params' => [
                'fc' => 'module',
                'module' => 'mymodule',
                'controller' => 'login'
            ]
        ],
        // 设置端点
        'module-mymodule-settings' => [
            'controller' => 'settings',
            'rule' => 'mymodule/settings',
            'keywords' => [],
            'params' => [
                'fc' => 'module',
                'module' => 'mymodule',
                'controller' => 'settings'
            ]
        ]
    ];
}

接下来在模块目录下创建控制器文件，每个端点对应一个控制器：

比如注册端点的控制器mymodule/controllers/front/register.php：

class MyModuleRegisterModuleFrontController extends ModuleFrontController
{
    public function initContent()
    {
        parent::initContent();

        // 处理AJAX请求（Vue前端调用）
        if ($this->ajax) {
            $result = $this->handleRegistration();
            $this->ajaxDie(json_encode($result));
        }

        // 如果是加载Vue视图页面，渲染模板并传递Vue资源路径
        $this->context->smarty->assign([
            'vue_app_js' => $this->module->getPathUri() . 'views/js/register-app.js'
        ]);
        $this->setTemplate('module:mymodule/views/templates/front/register.tpl');
    }

    private function handleRegistration()
    {
        // 这里写你的注册逻辑：获取POST数据、验证、调用PrestaShop的Customer类创建用户等
        $postData = Tools::getAllValues();
        
        // 示例逻辑
        if (!empty($postData['email']) && !empty($postData['password'])) {
            // 执行注册操作...
            return ['success' => true, 'message' => '注册成功！'];
        } else {
            return ['success' => false, 'message' => '请填写完整信息'];
        }
    }
}

同样的，你可以创建login.php和settings.php控制器，分别处理登录和设置的业务逻辑。

在你的Vue组件里，直接通过URL调用这些端点即可，记得带上AJAX标识和CSRF令牌（PrestaShop的安全要求）：

// 注册请求示例
async function submitRegistration(userForm) {
    try {
        const response = await fetch('/mymodule/register', {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json',
                'X-Requested-With': 'XMLHttpRequest', // 标记为AJAX请求
                'X-CSRF-Token': window.csrfToken // 从模板传递的CSRF令牌
            },
            body: JSON.stringify(userForm)
        });
        return await response.json();
    } catch (err) {
        console.error('注册请求出错:', err);
        return { success: false, message: '请求失败' };
    }
}

• CSRF保护：在模板里把PrestaShop的CSRF令牌传递给Vue，比如在tpl文件里加：

  <script>
      window.csrfToken = '{$token|escape:"javascript"}';
  </script>
  

• 权限控制：如果设置页面需要登录才能访问，在控制器的init方法里加检查：

  public function init()
  {
      parent::init();
      if (!$this->context->customer->isLogged()) {
          Tools::redirect('index.php?controller=authentication');
      }
  }
  

• 缓存刷新：修改路由后，一定要清空PrestaShop的缓存（后台→高级参数→性能→清空缓存），否则新路由不会生效。

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