virusphp/autonumbering

Laravel package to create autonumber for Eloquent model

v1.4 2022-08-28 17:09 UTC

Requires

• illuminate/config: ^5.1|^6.0|^7.0|^8.0|^9.0
• illuminate/database: ^5.1|^6.0|^7.0|^8.0|^9.0
• illuminate/support: ^5.1|^6.0|^7.0|^8.0|^9.0

MIT

• Slamet Sugandi

• laravel
• eloquent
• autonumber

README

Laravel package to create autonumber for Eloquent model

Installation

You can install the package via composer:

composer require virusphp/autonumbering

Register the ServiceProvider in config/app.php

'providers' => [
    // ...
	Virusphp\AutoNumber\AutoNumberServiceProvider::class,
],

Publish the default configuration

php artisan vendor:publish --provider='Virusphp\AutoNumber\AutoNumberServiceProvider'

Running migration

php artisan migrate

Usage

Your Eloquent models should use the Virusphp\AutoNumber\AutoNumberTrait trait

The trait contains an abstract method getAutoNumberOptions() that you must implement yourself.

use Virusphp\AutoNumber\AutoNumberTrait;

class Order extends Model
{
    use AutoNumberTrait;

    /**
     * Return the autonumber configuration array for this model.
     *
     * @return array
     */
    public function getAutoNumberOptions()
    {
        return [
            'order_number' => [
                'format' => 'PO.?', // autonumber format. '?' will be replaced with the generated number.
                'length' => 5 // The number of digits in an autonumber
            ]
        ];
    }

}

You can also pass a closure for the format value.

public function getAutoNumberOptions()
{
    return [
        'order_number' => [
            'format' => function () {
                return 'PO/' . date('Ymd') . '/?'; // autonumber format. '?' will be replaced with the generated number.
            },
            'length' => 5 // The number of digits in the autonumber
        ]
    ];
}

Saving Model

$order = Order::create([
    'customer' => 'Mr. PO',
]);

The order_number will be automatically generated based on the format given when saving the Order model.

echo $order->order_number;

// PO/20170803/00001

License

Laravel-autonumber is open-sourced software licensed under the MIT license.

Contributing

Please report any issue you find in the issues page. Pull requests are more than welcome.