PHPackages                             yeeraf/laravel-document-numberer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. yeeraf/laravel-document-numberer

ActiveLibrary[Utility & Helpers](/categories/utility)

yeeraf/laravel-document-numberer
================================

A Laravel package for create document running number

v1.3.0(3y ago)21.0k↓50%MITPHPPHP ^7.4|^8.0

Since Jul 24Pushed 1y ago1 watchersCompare

[ Source](https://github.com/yeeraf/laravel-document-numberer)[ Packagist](https://packagist.org/packages/yeeraf/laravel-document-numberer)[ RSS](/packages/yeeraf-laravel-document-numberer/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (4)Used By (0)

Test Status
-----------

[](#test-status)

[![Test](https://github.com/yeeraf/laravel-document-numberer/actions/workflows/test.yml/badge.svg)](https://github.com/yeeraf/laravel-document-numberer/actions/workflows/test.yml)

Laravel Document Running Number Generator
=========================================

[](#laravel-document-running-number-generator)

แพคเกจ laravel สำหรับการสร้าง เลขที่เอกสาร โดยสร้างสามารถระบุ ตัวอักษร นำหน้า, ต่อท้าย, จำนวนหลักตัวเลข ได้เอง เหมาระกับการใช้กับพวกเอกสารใบแจ้งหนี้ ใบเสร็จรับเงิน หรือเอกสารต่างๆได้ ตัวอย่างเลขที่เอกสาร

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

การติดตั้ง
----------

[](#การติดตั้ง)

```
composer require yeeraf/laravel-document-numberer
```

หลังจากติดตั้งแล้วจะต้องทำการ run คำสั่ง migration สำหรับสร้าง table document\_numbers เพื่อเก็บข้อมูลการสร้างเลขที่เอกสาร

```
php artisan migrate
```

ตัวอย่างการใข้งาน
-----------------

[](#ตัวอย่างการใข้งาน)

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

โดยค่าเริ่มต้น เลขที่เอกสารจะเป็น

นำหน้าด้วย ปีปัจจุบัน 2 digit และ เดือนปัจจุบัน 2 digit เข่น ถ้าวันนี้วันที่ 20/07/2021 เลขนำหน้าเอกสารจะเป็น **2107**000001

ความยาวของ running number จะเป็น 6 หลัก เริ่มต้องด้วย 1 เช่น 2107**000001**

### กรณีต้องการให้เลขที่เอกสาร 2 ประเภทมี format เดียวกัน แต่ต้องการให้ running แยกกัน เข่น

[](#กรณีต้องการให้เลขที่เอกสาร-2-ประเภทมี-format-เดียวกัน-แต่ต้องการให้-running-แยกกัน-เข่น)

เลขใบแจ้งหนี้ เริ่มที่ 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-**
- มี running number **3 หลัก**
- เปลี่ยน padding string จาก **0 -> #**
- ท้ายด้วย **-X**

ตัวอย่าง INV-##1-X

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

License
-------

[](#license)

The MIT License (MIT)

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance30

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 81.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~159 days

Total

3

Last Release

1442d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/945179?v=4)[Mn](/maintainers/mininoz)[@mininoz](https://github.com/mininoz)

---

Top Contributors

[![mininoz](https://avatars.githubusercontent.com/u/945179?v=4)](https://github.com/mininoz "mininoz (36 commits)")[![suphasits](https://avatars.githubusercontent.com/u/124806758?v=4)](https://github.com/suphasits "suphasits (8 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/yeeraf-laravel-document-numberer/health.svg)

```
[![Health](https://phpackages.com/badges/yeeraf-laravel-document-numberer/health.svg)](https://phpackages.com/packages/yeeraf-laravel-document-numberer)
```

###  Alternatives

[t3kit/t3kit

t3kit project. A TYPO3 website starterkit.

5624.3k](/packages/t3kit-t3kit)[welp/ical-bundle

Symfony Bundle to manage .ics iCal file (creating and eventually reading)

10114.3k](/packages/welp-ical-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)