PrestaShop 1.6订单号按年度重置独立序列的实现方案咨询

嘿，刚好我对PrestaShop 1.6的订单号自定义有不少实战经验，你想要的这种不依赖主键、每年自动重置的独立序列订单号，完全可以参考后台发票号的生成逻辑来实现，下面是我整理的最佳落地方案：

1. 创建独立的序列存储表 #

首先我们需要一张表来记录每年的订单序列值，避免和ps_orders的主键耦合。执行以下SQL语句创建表：

CREATE TABLE IF NOT EXISTS `ps_order_sequence` (
  `id_sequence` int(11) NOT NULL AUTO_INCREMENT,
  `year` int(4) NOT NULL,
  `current_value` int(11) NOT NULL DEFAULT 0,
  PRIMARY KEY (`id_sequence`),
  UNIQUE KEY `year` (`year`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

这张表会按年份存储当前已用的订单序号，保证每年的序列从1开始重置。

2. 编写获取下一个序列值的方法 #

在override/classes/Order.php中添加一个静态方法，用来安全地获取当前年份的下一个订单序号（处理并发和年份切换的情况）：

public static function getNextOrderNumber() {
    $currentYear = date('Y');
    $db = Db::getInstance();
    
    // 检查当前年份的序列是否已存在
    $result = $db->getRow('SELECT current_value FROM '._DB_PREFIX_.'order_sequence WHERE year = '.(int)$currentYear);
    
    if ($result) {
        // 已存在则自增序列值
        $nextValue = $result['current_value'] + 1;
        $db->execute('UPDATE '._DB_PREFIX_.'order_sequence SET current_value = '.(int)$nextValue.' WHERE year = '.(int)$currentYear);
    } else {
        // 新年份则初始化序列为1
        $nextValue = 1;
        $db->execute('INSERT INTO '._DB_PREFIX_.'order_sequence (year, current_value) VALUES ('.(int)$currentYear.', '.(int)$nextValue.')');
    }
    
    return $nextValue;
}

3. 重写Order类的add方法生成订单号 #

还是在override/classes/Order.php中，重写add方法，在订单创建时自动生成符合格式的订单号：

public function add($autodate = true, $null_values = false) {
    // 先执行父类的add方法创建订单
    if (parent::add($autodate, $null_values)) {
        // 获取下一个序列号
        $orderNumber = self::getNextOrderNumber();
        $currentYear = date('Y');
        // 格式化为SO/YYYY/000001的样式
        $this->reference = 'SO/'.$currentYear.'/'.str_pad($orderNumber, 6, '0', STR_PAD_LEFT);
        // 更新订单的reference字段
        return $this->update();
    }
    return false;
}

4. 确保字段长度符合要求 #

你之前已经调整过这部分，这里再确认一下：

• 在override/classes/Order.php中，确保reference字段的size设置为14（足够容纳SO/2024/000001这类13字符的订单号）：

  'reference' => array('type' => self::TYPE_STRING, 'size' => 14)
  

• 在override/classes/OrderPayment.php中，对应调整order_reference的size为14：

  'order_reference' => array('type' => self::TYPE_STRING, 'validate' => 'isAnything', 'size' => 14)
  

5. 初始化序列（可选） #

如果你的店铺已经有历史订单，可以手动插入当前年份的序列起始值，比如2024年要从1开始，执行：

INSERT INTO ps_order_sequence (year, current_value) VALUES (2024, 0);

这样下一个创建的订单就会生成SO/2024/000001。

注意事项 #

• 清除PrestaShop缓存：删除cache/class_index.php文件，让override类生效。
• 并发安全：因为我们用的是单条SQL语句更新序列，天然具备原子性，不用担心并发创建订单时的序号重复问题。
• 年份切换：当年份变更时，系统会自动在序列表中创建新的年份记录，自动从1开始生成订单号，完全符合你的需求。

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