如何在Laravel中设置主键起始值为0001这类带前导零的格式？

首先明确一个基础逻辑：数据库的数值类型字段本身不会存储前导零，startingValue(0001)里的0001在PHP里会被直接解析为整数1，所以存到库中自然就是1。以下是几种可落地的实现方案：

方案1：模型访问器格式化（最推荐，无需改库结构） #

这个方案核心是存储仍然用数值自增ID，输出的时候自动格式化为带前导零的格式，兼顾性能和易用性。

1. 在对应Eloquent模型中添加访问器方法：

// 示例为格式化为4位带前导零的字符串，可自行调整位数
public function getFormattedIdAttribute()
{
    return str_pad($this->id, 4, '0', STR_PAD_LEFT);
    // 也可以用sprintf实现：return sprintf('%04d', $this->id);
}

2. 调用方式：直接通过模型实例获取格式化后的ID即可

// 假设模型实例为$record，输出0001、0002格式的值
echo $record->formatted_id;

3. 如果你希望模型序列化（比如接口返回JSON）时自动带上格式化ID，在模型中添加$appends配置：

protected $appends = ['formatted_id'];

方案2：主键改为字符串类型，自定义生成规则（适合需要把格式化ID存在库中的场景） #

如果你要求数据库中存储的主键本身就是带前导零的格式，需要调整主键类型，关闭默认自增：

1. 调整迁移文件定义：

// 主键改为字符串类型，长度按你需要的位数设置
$table->string('id', 4)->primary();
// 新增一个隐藏的自增整数字段，用来辅助生成连续的序号，避免重复
$table->unsignedInteger('seq_id')->autoIncrement()->hidden();

2. 在模型中配置主键属性，并添加生成逻辑：

// 关闭默认自增
public $incrementing = false;
// 主键类型为字符串
protected $keyType = 'string';

protected static function booted()
{
    static::creating(function ($model) {
        // 拿到最新的序号生成格式化主键
        $latestSeq = static::max('seq_id') ?? 0;
        $model->id = str_pad($latestSeq + 1, 4, '0', STR_PAD_LEFT);
    });
}

注意：高并发场景下建议给创建逻辑加事务或分布式锁，避免主键重复。

方案3：使用MySQL ZEROFILL属性（不推荐，兼容性差） #

如果用的是MySQL数据库，可以用字段的ZEROFILL属性实现数据库层面自动补零，迁移写法如下：

$table->integer('id')->unsigned()->zerofill()->primary()->autoIncrement()->startingValue(1);

不过Laravel查询时默认会把字段值转为整数，会丢失前导零，需要在模型中添加字段类型转换：

protected $casts = [
    'id' => 'string',
];

注意：ZEROFILL属性在MySQL 8.0版本已被标记为弃用，后续版本可能会移除，不建议生产环境长期使用。

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