实现带前缀的自动递增编号：基于数据库自增ID的策略-php教程-PHP中文网

实现带前缀的自动递增编号：基于数据库自增ID的策略

聖光之護

发布： 2025-10-16 12:59:01

原创

193人浏览过

实现带前缀的自动递增编号：基于数据库自增id的策略

本教程详细阐述了如何在Web应用中，特别是使用CodeIgniter等框架时，实现一种安全可靠的自动递增编号生成机制。通过利用数据库的自增主键ID，我们可以在用户提交表单后，生成带有特定前缀（如“LP”）和零填充格式（如“LP00001”）的唯一引用编号，有效避免了并发提交可能导致的编号冲突问题。

引言：自动递增编号的需求与挑战

在许多业务场景中，我们需要为新创建的记录生成一个具有特定格式的唯一引用编号，例如订单号、工单号或资产编号。这些编号通常包含一个固定前缀和一系列递增的数字，如LP00001。一个常见的需求是，这个编号必须在用户提交表单后才生成，并且必须是唯一的。直接在客户端或提交前预生成编号存在明显的风险：如果两个用户同时访问页面，他们可能会看到并提交相同的编号，从而导致数据冲突和业务逻辑错误。因此，确保编号在服务器端安全、唯一地生成，并处理好并发问题，是实现这一功能的关键。

现有代码分析

在典型的MVC（Model-View-Controller）框架（如CodeIgniter）中，表单提交的处理流程通常如下：

控制器 (Controller): 负责接收用户请求，进行表单验证。验证通过后，将数据传递给模型层进行处理。

// 示例控制器代码片段
if ($this->form_validation->run() == FALSE)
{
    // 验证失败，重新加载表单
    $main['page'] = 'crm/listings/add';
    $this->load->view('crm/index', $main);
} else {
    // 验证成功，准备数据并调用模型
    $maindata=array(
        'clients_id'=>$this->session->userdata('clientsessid'),
        'property_for'=>$this->security->xss_clean($this->input->post('property_for')),
        'property_type'=>$this->security->xss_clean($this->input->post('property_type'))
    );
    $insertid=$this->listings_model->insert_listing($maindata); // 调用模型方法
    if($insertid){
        $this->session->set_flashdata('message', '<div>Successfully</div>');
        redirect('listings/sales');
    }
}

登录后复制

模型 (Model): 负责与数据库交互，执行数据的插入、更新等操作。
```
// 示例模型代码片段
function insert_listing($maindata){
    $this->db->insert("crm_listings", $maindata); // 插入数据
    $prime = $this->db->insert_id(); // 获取新插入行的主键ID
    return $prime; // 返回主键ID
}
```
登录后复制
在上述现有代码中，数据已成功插入数据库，并且模型返回了新插入记录的数据库自增主键ID（通常是id字段）。然而，refno字段目前仍为空，我们需要在此基础上生成并填充它。

核心思路：利用数据库自增ID

要实现带前缀的自动递增编号，最安全且高效的方法是利用数据库自身的AUTO_INCREMENT主键。数据库的自增ID具有以下优点：

唯一性保证： 数据库系统确保每个新插入的记录都会获得一个唯一的、递增的ID。
并发安全： 数据库层处理并发插入时的ID分配，无需开发者额外处理复杂的锁定机制。

因此，我们的策略是：

首先，正常插入除refno之外的所有数据，让数据库生成一个唯一的自增主键ID。
然后，利用这个已生成的自增ID来构造我们所需的refno格式。
最后，使用这个构造好的refno去更新刚刚插入的这条记录。

实现步骤与代码示例

我们将修改模型层中的insert_listing方法来完成这一逻辑。

腾讯智影-AI数字人

基于AI数字人能力，实现7*24小时AI数字人直播带货，低成本实现直播业务快速增增，全天智能在线直播

查看详情

1. 修改模型方法

/**
 * 插入新列表数据并生成自动递增的引用编号
 *
 * @param array $maindata 待插入的主要数据
 * @return int 新插入记录的自增主键ID
 */
function insert_listing($maindata){
    // 步骤1: 插入主要数据到数据库
    // 此时，数据库会为新记录生成一个唯一的自增主键ID
    $this->db->insert("crm_listings", $maindata);

    // 步骤2: 获取刚刚插入记录的自增主键ID
    // 这个ID是数据库保证唯一的，我们将基于它来生成refno
    $prime = $this->db->insert_id();

    // 步骤3: 构造引用编号 (refno)
    // 假设前缀是 "LP"，且数字部分需要5位零填充
    // 例如，如果prime是1，则refno是"LP00001"
    // 如果prime是123，则refno是"LP00123"
    $refno = "LP" . sprintf('%05d', $prime);

    // 步骤4: 更新刚刚插入的记录，设置其 refno 字段
    // 通过 WHERE 子句指定刚刚插入的记录（使用其自增ID）
    $this->db->set("refno", $refno);
    $this->db->where('id', $prime); // 假设自增主键字段名为 'id'
    $this->db->update("crm_listings");

    // 返回新插入记录的自增主键ID
    // 控制器可以根据此ID进行后续操作或确认插入成功
    return $prime;
}

登录后复制

代码解释：

$this-youjiankuohaophpcndb->insert("crm_listings", $maindata);：执行初始插入操作，将用户提交的数据存入crm_listings表。
$prime = $this->db->insert_id();：这是关键一步。它获取了数据库为刚刚插入的行分配的AUTO_INCREMENT主键值。
$refno = "LP" . sprintf('%05d', $prime);：
- sprintf('%05d', $prime)：这是一个PHP函数，用于格式化字符串。%05d表示将一个整数（$prime）格式化为至少5位宽的十进制数，不足5位时在前面用零填充。例如，如果$prime是1，则输出00001；如果$prime是123，则输出00123。
- 将格式化后的数字与前缀LP拼接，得到完整的refno。
$this->db->set("refno", $refno);：指定要更新的字段及其新值。
$this->db->where('id', $prime);：指定更新条件，确保只更新刚刚插入的那条记录。
$this->db->update("crm_listings");：执行更新操作。

注意事项

数据库字段类型： 确保crm_listings表中的refno字段的数据类型是VARCHAR或其他能存储字符串的类型，并且长度足够容纳生成的编号（例如VARCHAR(10)对于LP00001）。

事务处理： 虽然上述方法在大多数情况下是可靠的，但在高并发或对数据一致性要求极高的场景下，建议将插入和更新操作封装在一个数据库事务中。这样可以确保这两个操作要么都成功，要么都失败，避免因更新失败而导致refno字段仍为空的情况。

// 示例：使用事务
function insert_listing_with_transaction($maindata){
    $this->db->trans_start(); // 开启事务

    $this->db->insert("crm_listings", $maindata);
    $prime = $this->db->insert_id();

    if ($prime) { // 确保插入成功
        $refno = "LP" . sprintf('%05d', $prime);
        $this->db->set("refno", $refno);
        $this->db->where('id', $prime);
        $this->db->update("crm_listings");
    }

    $this->db->trans_complete(); // 完成事务

    if ($this->db->trans_status() === FALSE) {
        // 事务失败，处理错误
        return false;
    } else {
        return $prime;
    }
}

登录后复制

前缀和格式的灵活性： 前缀LP和零填充位数05d可以根据实际需求进行修改。例如，如果需要ORD-0001，则前缀为ORD-，格式为%04d。
初始值问题： 如果数据库的自增ID从1开始，那么第一个refno将是LP00001。如果需要从其他数字开始（例如LP10001），则需要调整sprintf的第二个参数，或者在数据库层面设置自增ID的起始值。