alfa6661/laravel-autonumber

Laravel package to create autonumber for Eloquent model

Laravel AutoNumber

, _(*1)

Laravel package to create autonumber for Eloquent model, _(*2)

Installation

You can install the package via composer:, _(*3)

composer require alfa6661/laravel-autonumber

Register the ServiceProvider in config/app.php, _(*4)

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

Publish the default configuration, _(*5)

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

Running migration, _(*6)

php artisan migrate

Usage

Your Eloquent models should use the Alfa6661\AutoNumber\AutoNumberTrait trait, _(*7)

The trait contains an abstract method getAutoNumberOptions() that you must implement yourself., _(*8)

use Alfa6661\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' => 'SO.?', // 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., _(*9)

public function getAutoNumberOptions()
{
    return [
        'order_number' => [
            'format' => function () {
                return 'SO/' . 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. X',
]);

The order_number will be automatically generated based on the format given when saving the Order model., _(*10)

echo $order->order_number;

// SO/20170803/00001

License

Laravel-autonumber is open-sourced software licensed under the MIT license., _(*11)

Contributing

Please report any issue you find in the issues page. Pull requests are more than welcome., _(*12)