基于数据库自增ID生成自定义格式引用编号的策略-php教程-PHP中文网

基于数据库自增ID生成自定义格式引用编号的策略

霞舞

发布： 2025-10-15 12:32:46

原创

836人浏览过

基于数据库自增ID生成自定义格式引用编号的策略

本文探讨了如何在web应用中，利用数据库的自增主键，安全且高效地生成如“lp00001”这类带有特定前缀和零填充的自定义引用编号。通过在数据首次插入后，基于返回的主键id进行格式化并回填，有效避免了并发提交时的id冲突问题，确保了编号的唯一性和连续性，为系统生成业务引用编号提供了可靠方案。

问题描述

在Web应用开发中，我们经常需要为业务数据生成具有特定格式的唯一标识符，例如订单号、参考编号等。一个常见的需求是生成形如 LP00001 的编号，其中 LP 是固定前缀，后续五位数字是递增的序列号。此编号应在用户提交表单时自动生成，并且必须确保在多用户并发提交时，每个用户都能获得一个唯一且连续的编号，避免出现重复。

直接在前端或提交前生成此类编号存在潜在的并发问题，因为两个用户可能同时看到并尝试使用相同的下一个编号。因此，理想的生成时机是在数据被成功插入数据库之后，利用数据库的原子性操作来确保唯一性。

初始的代码结构通常包括一个控制器（Controller）和一个模型（Model）：

控制器代码示例：

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');
    }
}

登录后复制

模型代码示例：

function insert_listing($maindata){
    $this->db->insert("crm_listings",$maindata);
    $prime=$this->db->insert_id(); // 获取自增主键ID
    return $prime;
}

登录后复制

当前模型仅负责插入数据并返回数据库自动生成的自增主键ID，refno 列仍为空。我们需要在此基础上实现 LP00001 格式的编号生成。

解决方案核心思路

解决此问题的关键在于利用数据库本身的自增主键（通常是 id 列）作为生成自定义编号的基础。数据库的自增主键是原子且唯一的，每次插入新记录都会获得一个全新的、递增的ID。我们可以将这个自增ID进行格式化，然后更新到 refno 列。

这种“先插入后更新”的策略有以下几个优点：

避免并发问题： 编号的生成依赖于数据库已成功分配的唯一主键，即使多个用户同时提交，每个插入操作都会获得不同的 id，从而保证生成的 refno 也是唯一的。
简单可靠： 利用了数据库的内建机制，无需复杂的锁机制或事务处理来保证编号的唯一性。
格式灵活： 可以根据自增ID灵活组合前缀、后缀和零填充。

代码实现细节

我们将修改模型层中的 insert_listing 函数，在数据插入并获取到自增主键ID后，立即构造并更新 refno 字段。

硅基智能

基于Web3.0的元宇宙，去中心化的互联网，高质量、沉浸式元宇宙直播平台，用数字化重新定义直播

查看详情

修改后的模型类代码：

function insert_listing($maindata){
    // 1. 插入主要数据到数据库
    $this->db->insert("crm_listings", $maindata);

    // 2. 获取刚刚插入记录的自增主键ID
    $prime = $this->db->insert_id();

    // 3. 格式化自增ID为5位数字，不足5位前面补零
    // 例如：如果 $prime 是 1，则格式化为 "00001"
    // 如果 $prime 是 123，则格式化为 "00123"
    $formatted_id = sprintf('%05d', $prime);

    // 4. 组合前缀 "LP" 和格式化后的ID，形成最终的refno
    $ref_no = "LP" . $formatted_id;

    // 5. 更新刚刚插入的记录，设置其 refno 字段
    // 使用 $this->db->set() 来指定要更新的字段及其值
    $this->db->set("refno", $ref_no);
    // 使用 $this->db->where() 来指定更新条件，确保只更新当前记录
    $this->db->where('id', $prime);
    // 执行更新操作
    $this->db->update("crm_listings");

    // 6. 返回自增主键ID，供控制器后续使用
    return $prime;
}

登录后复制

代码解析：

$this->db->insert("crm_listings", $maindata);：首先，像往常一样插入用户提交的主要数据。此时，数据库会自动为新记录分配一个 id（假设 id 是主键且设置为 AUTO_INCREMENT）。refno 字段在此阶段可以为 NULL 或空字符串。
$prime = $this->db->insert_id();：这是关键一步。它获取了上一步 insert 操作成功后，数据库为新记录生成的自增主键值。这个值是当前会话中最后一次插入操作的ID，因此是准确无误的。
sprintf('%05d', $prime);：sprintf 函数用于格式化字符串。%05d 表示将一个整数格式化为至少5位宽的十进制数，如果不足5位，则在前面用零填充。例如，如果 $prime 是 1，它会变成 "00001"；如果是 123，它会变成 "00123"。
$ref_no = "LP" . $formatted_id;：将固定的前缀 LP 与格式化后的数字拼接起来，形成最终的 refno，例如 LP00001。
$this->db->set("refno", $ref_no); $this->db->where('id', $prime); $this->db->update("crm_listings");：这是一个标准的数据库更新操作。我们指定要更新 crm_listings 表，将 refno 字段设置为刚刚生成的 $ref_no。where('id', $prime) 确保我们只更新了刚才插入的那条记录，而不是其他记录。

注意事项与最佳实践

数据库表结构： 确保 crm_listings 表中有一个 id 列作为主键，并且设置为 AUTO_INCREMENT。同时，refno 列应该允许为空（在插入初始数据时）或有一个默认值，并且建议为其添加 UNIQUE 约束，以确保业务编号的唯一性。
```
CREATE TABLE crm_listings (
    id INT AUTO_INCREMENT PRIMARY KEY,
    clients_id INT,
    property_for VARCHAR(255),
    property_type VARCHAR(255),
    refno VARCHAR(10) UNIQUE, -- 确保refno唯一且格式一致
    -- 其他字段...
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
```
登录后复制

事务处理： 虽然“先插入后更新”的方法在大多数情况下是可靠的，但在极少数情况下（例如，数据库在插入后、更新前崩溃），refno 字段可能仍然为空。为了提高数据一致性，可以将整个插入和更新过程封装在一个数据库事务中。如果任何一步失败，整个事务可以回滚。

function insert_listing($maindata){
    $this->db->trans_start(); // 开启事务

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

    $formatted_id = sprintf('%05d', $prime);
    $ref_no = "LP" . $formatted_id;

    $this->db->set("refno", $ref_no);
    $this->db->where('id', $prime);
    $this->db->update("crm_listings");

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

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

登录后复制

编号长度： refno 字段的长度（VARCHAR(10)）应足够容纳前缀和格式化后的数字。随着 id 的增长，如果超过5位，sprintf('%05d', $prime) 会自动扩展，但数据库字段长度需要相应调整。
错误处理： 在控制器中，检查 insert_listing 的返回值，如果返回 false（在事务处理失败时），则应向用户显示错误消息。

总结

通过利用数据库的自增主键并结合“先插入后更新”的策略，我们能够安全、高效地生成带有特定前缀和零填充的自定义引用编号，如 LP00001。这种方法不仅解决了并发提交时编号冲突的问题，还保持了代码的简洁性和可维护性。同时，结合数据库事务处理，可以进一步增强数据操作的原子性和可靠性，确保业务编号的准确性和唯一性。

以上就是基于数据库自增ID生成自定义格式引用编号的策略的详细内容，更多请关注php中文网其它相关文章！