yeeraf/laravel-document-numberer

Laravel包用于创建文档运行编号

v1.3.0 2022-06-07 14:00 UTC

This package is auto-updated.

Last update: 2024-09-07 18:58:36 UTC


README

example workflow

Laravel文档运行编号生成器

laravel包,用于生成文档编号,可以自定义前缀、后缀、编号长度,适用于账单、收据等各种文档。例如文档编号:

  • INV-000001
  • INV2101-0001
  • REC-0000001
  • QT #####1

安装方法

composer require yeeraf/laravel-document-numberer

安装后,需要运行迁移命令来创建保存文档编号信息的document_numbers表

php artisan migrate

使用示例

$documentNumberer = new \Yeeraf\DocumentNumberer\DocumentNumberer;
$docNumber = $documentNumberer->generate();

初始编号如下:

前缀为当前年月两位数,例如今天是2021年7月20日,文档编号前缀为2107

运行编号长度为6位,从1开始,例如:2107000001

如果需要两种类型的文档编号格式相同,但运行编号分开,例如:

账单编号从2107000001, 2107000002, 2107000003, ... 开始

收据编号从2107000001, 2107000002, 2107000003, ... 开始

系统可以如此区分类型:

// ใบแจ้งหนี้
$documentNumberer = new \Yeeraf\DocumentNumberer\DocumentNumberer;
$docNumber = $documentNumberer->name("invoice")->generate();
// ใบเสร็จรับเงิน
$documentNumberer = new \Yeeraf\DocumentNumberer\DocumentNumberer;
$docNumber = $documentNumberer->name("receipt")->generate();

如果需要更改文档编号的生成方式,例如需要:

  • 前缀为INV-
  • 运行编号为3位3
  • 将填充字符从0 -> #改变
  • 后缀为-X

示例:INV-##1-X

$documentNumberer = new \Yeeraf\DocumentNumberer\DocumentNumberer;
$docNumber = $documentNumberer
                ->prefix("INV-")
                ->padLength(3)
                ->padString("#")
                ->suffix("-X")
                ->generate();

许可证

MIT许可证(MIT)