mariuszmalek/unique-number-generator

Easy creation of unique number for your Eloquent models in Laravel

1.0.0 2021-10-16 07:39 UTC

Requires

• php: ^7.3|^8.0
• illuminate/config: ^8.0
• illuminate/database: ^8.0
• illuminate/support: ^8.0

Requires (Dev)

• limedeck/phpunit-detailed-printer: ^6.0
• mockery/mockery: ^1.4.2
• orchestra/database: ^6.0
• orchestra/testbench: ^6.0
• phpunit/phpunit: ^9.4

MIT

• Mariusz Malek

• generator
• number
• laravel
• unique
• lumen
• unique-number-generator

README

Easy creation of unique number generator for your Eloquent models in Laravel.

NOTE: These instructions are for the latest version of Laravel.
If you are using an older version, please install a version of the package that correlates to your Laravel version.

• Installation
• Usage
• Bugs, Suggestions, Contributions and Support
• Copyright and License

Installation

Depending on your version of Laravel, you should install a different version of the package.

1. Install the package via Composer:

   $ composer require mariuszmalek/unique-number-generator:dev-master

   The package will automatically register its service provider.

2. Optionally, publish the configuration file if you want to change any defaults:

   php artisan vendor:publish --provider="Malek\UniqueNumberGenerator\ServiceProvider"

Usage

Saving a model is easy:

$post->number = GeneratorNumber::generateID(Post::class, 'number', 'CLI-', $params);

The first parameter is $model in which we search an existing class, the second is a specific column in the database.

The next one is the prefix that will be added to the beginning of the result. The last one is the parameters for specific search classes. Only the first two parameters are required

Using traits:

use Malek\UniqueNumberGenerator\Numerable;

class Product extends Model
{
    use Numerable;

    /**
     * @return string
     */
    public function uniqueColumn(): string
    {
        return 'number';
    }
}

You can add a Trait, so that after creating the model, a new unique number will be automatically created. You also need to add the uniqueColumn function which will contain the name of the column to be used.

Bugs, Suggestions, Contributions and Support

Please use Github for reporting bugs, and making comments or suggestions.

See CONTRIBUTING.md for how to contribute changes.

Copyright and License

unique-number-generator was written by Mariusz Malek and is released under the MIT License.

Copyright (c) 2021 Mariusz Malek