PrestaShop 1.7 的分类页产品加载逻辑由核心的 Product 类和相关控制器配合完成，默认查询 SQL 会按照系统预设的规则筛选、排序商品。如果需要添加自定义筛选条件、调整排序规则或者关联额外表获取自定义字段，就需要在不修改核心文件的前提下自定义查询 SQL。
分类页产品查询的核心流程
分类页加载时，首先会由 CategoryController 调用 Product 类的 getProducts 方法，该方法内部会构建基础的查询 SQL，包含商品基本信息、价格、库存等默认字段的筛选逻辑。整个查询过程会触发多个钩子，其中 actionProductListQuery 钩子就是用来修改最终执行的产品查询 SQL 的关键入口。
通过钩子修改查询 SQL 的实现步骤
1. 创建自定义模块
首先创建一个基础的 PrestaShop 模块，用来挂载钩子逻辑，模块结构如下：
<?php
// modules/customproductquery/customproductquery.php
if (!defined('_PS_VERSION_')) {
exit;
}
class CustomProductQuery extends Module
{
public function __construct()
{
$this->name = 'customproductquery';
$this->tab = 'front_office_features';
$this->version = '1.0.0';
$this->author = 'developer';
$this->need_instance = 0;
$this->ps_versions_compliancy = [
'min' => '1.7.0.0',
'max' => '1.7.9.9'
];
parent::__construct();
$this->displayName = '自定义分类页产品查询SQL';
$this->description = '通过钩子修改 PrestaShop 1.7 分类页的产品查询 SQL';
}
public function install()
{
return parent::install() && $this->registerHook('actionProductListQuery');
}
public function uninstall()
{
return parent::uninstall();
}
}
2. 实现钩子方法修改 SQL
在模块中添加 hookActionProductListQuery 方法，该方法会接收查询相关的参数，我们可以在这里修改 SQL 的各个组成部分：
<?php
// 接上面的模块代码
public function hookActionProductListQuery($params)
{
// 获取当前的查询 SQL 组成部分
$sql = &$params['sql'];
// 只在分类页生效，避免影响搜索页等其他产品列表页
if (isset($params['controller']) && $params['controller'] == 'category') {
// 添加自定义筛选条件，比如只查询库存大于 10 的商品
$sql['where'] .= ' AND p.quantity > 10';
// 调整排序规则，按自定义字段 custom_sort 升序排序
$sql['order'] = 'p.custom_sort ASC, ' . $sql['order'];
// 如果需要关联自定义表，添加 join 条件
$sql['join'] .= ' LEFT JOIN ' . _DB_PREFIX_ . 'product_custom pc ON p.id_product = pc.id_product';
// 如果需要查询自定义表的字段，添加到 select 中
$sql['select'] .= ', pc.custom_field';
}
}
3 安装启用模块
将模块文件夹上传到 PrestaShop 的 modules 目录，在后台模块管理页面找到该模块并安装启用，此时分类页的产品查询就会自动应用我们添加的自定义规则。
注意事项
- 修改 SQL 时尽量只添加条件，不要删除原有查询逻辑，避免影响价格计算、多店铺适配等核心功能。
- 如果添加了自定义表的关联，需要确保自定义表已经存在，并且字段名和表名符合 PrestaShop 的数据库规范。
- 修改后需要清空 PrestaShop 的类缓存和 Smarty 缓存，避免旧逻辑生效。
- 如果需要更复杂的查询逻辑，也可以重写 CategoryController 的 pagination 方法，但这种方式需要维护重写文件，不如钩子方式灵活。
常见问题排查
如果修改后没有生效，可以先检查钩子是否注册成功，然后在钩子方法中添加日志输出，查看是否触发了该钩子。如果 SQL 报错，可以打印最终的完整 SQL 语句，检查语法是否正确，表名和字段名是否存在。
PrestaShop_1.7分类页产品查询SQL自定义Product_Queryhook_修改修改时间：2026-06-22 04:36:33