yeeraf / laravel-document-numberer
Laravel包用于创建文档运行编号
v1.3.0
2022-06-07 14:00 UTC
Requires
- php: ^7.4|^8.0
Requires (Dev)
- orchestra/testbench: ^6.0
- phpunit/phpunit: ^9.5
README
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)