Laravel中生成带日期和序列号的自动交易码：策略与实现

<?php

namespace App\Services;

use App\Models\Transaction;
use Illuminate\Support\Facades\DB;
use Carbon\Carbon;

class TransactionCodeGenerator
{
    /**
     * 生成一个符合 PREFIX-DDMMYYYY-NNN 格式的唯一交易码。
     * 示例: PSN-22102021-001
     *
     * @param string $prefix 前缀，例如 'PSN'
     * @param int $sequenceLength 序列号的期望长度，例如 3 代表 001, 002...
     * @return string 生成的唯一交易码
     * @throws \Exception 如果在多次尝试后仍无法生成唯一码
     */
    public function generate(string $prefix = 'PSN', int $sequenceLength = 3): string
    {
        $today = Carbon::now()->format('dmY'); // 格式化日期为 DDMMYYYY
        $maxAttempts = 5; // 最大尝试次数，以应对并发冲突

        for ($attempt = 0; $attempt < $maxAttempts; $attempt++) {
            DB::beginTransaction(); // 开启数据库事务
            try {
                // 查询当天已存在的最大交易码
                // 使用 lockForUpdate() 获取行级锁，防止其他并发请求同时读取和修改
                $lastTransaction = Transaction::where('code', 'like', "{$prefix}-{$today}-%")
                                            ->orderByDesc('code') // 按代码降序排列，以获取最大的序列号
                                            ->lockForUpdate() // 锁定查询结果，防止并发问题
                                            ->first();

                $sequence = 1;
                if ($lastTransaction) {
                    // 从最后一条交易码中提取序列号
                    $parts = explode('-', $lastTransaction->code);
                    if (count($parts) === 3) {
                        $lastSequence = (int) $parts[2];
                        $sequence = $lastSequence + 1;
                    }
                }

                // 格式化序列号，进行零填充
                $formattedSequence = str_pad($sequence, $sequenceLength, '0', STR_PAD_LEFT);

                $newCode = "{$prefix}-{$today}-{$formattedSequence}";

                // 最终检查：确认生成的代码是否已存在（理论上在 lockForUpdate 作用下不会重复，但作为额外保障）
                if (Transaction::where('code', $newCode)->exists()) {
                    DB::rollBack(); // 代码已存在，回滚事务，尝试下一次循环
                    continue;
                }

                DB::commit(); // 提交事务
                return $newCode;

            } catch (\Throwable $e) { // 捕获 Throwable 以处理所有错误，包括 Error
                DB::rollBack(); // 发生异常，回滚事务
                // 记录异常日志
                \Log::error("生成交易码失败，尝试次数: " . ($attempt + 1) . " 错误: " . $e->getMessage());

                // 如果不是最后一次尝试，等待一小段时间后重试
                if ($attempt < $maxAttempts - 1) {
                    usleep(100000); // 等待 100 毫秒
                    continue;
                }
                throw $e; // 抛出异常，如果所有尝试都失败
            }
        }

        throw new \Exception('在多次尝试后仍无法生成唯一的交易码。');
    }
}

// 在控制器或服务中使用
use App\Services\TransactionCodeGenerator;

class OrderController extends Controller
{
    public function createOrder()
    {
        $generator = new TransactionCodeGenerator();
        try {
            $transactionCode = $generator->generate('ORD', 4); // 生成如 ORD-22102021-0001
            // 将 $transactionCode 保存到数据库
            // ...
        } catch (\Exception $e) {
            // 处理生成失败的情况
            return back()->withErrors('无法生成订单号: ' . $e->getMessage());
        }
    }
}

<?php

function makeID($prefix = 'PRN'): string
{
    // microtime(true) 返回浮点数，如 1634871496.0619
    // str_replace('.', '-', ...) 将点替换为连字符，以便作为ID的一部分
    $time = str_replace('.', '-', microtime(true));
    return $prefix . '-' . $time;
}

echo makeID(); // 示例输出: PRN-1634871496-0619

<?php

function makeUniqueId($prefix = 'PRN'): string
{
    // uniqid() 生成一个基于当前微秒数的唯一ID
    // 默认生成13个字符的字符串，如 617229f798988
    return $prefix . '-' . uniqid();
}

echo makeUniqueId(); // 示例输出: PRN-617229f798988