Download the PHP package nabilhassen/laravel-usage-limiter without Composer

Laravel Usage Limiter

Introduction

A Laravel package to track, limit, & restrict usages of users, accounts, or any other model.

Features

• Define usage limits you need for your app per plan
• Set reset frequency for each of your limits
• Attach usage limits to models (e.g. User model)
• Consume and unconsume usage limits whenever a resource is created or deleted
• Get usage report of a specific model (e.g. User model)
• Check and determine if a model can consume more resources
• Manually reset consumed usage limits of a model
• Automatically reset consumed usage limits by setting reset frequencies such as every second, every minute, every hour, every day, every month, etc and scheduling a built-in artisan command

Use cases

Basically with this package you can track your users' or any other models' usages and restrict them when they hit their maximum limits.

Example use-cases:

• API usages per second, minute, month, etc
• Resource creation. E.g: projects, teams, users, products, etc
• Resource usages. E.g: storage, etc

Versions

Compatible for Laravel versions >= 8.0.

Quick Tutorial

This README documentation serves more as a reference. For a step-by-step getting started tutorial check https://nabilhassen.com/laravel-usage-limiter-manage-rate-and-usage-limits and you can always refer to this README documentation for details and advanced stuff.

Installation

Install Laravel Usage Limiter using the Composer package manager:

Next, you should publish the Laravel Usage Limiter configuration and migration files using the vendor:publish Artisan command:

Finally, you should run the migrate command in order to create the tables needed to store Laravel Usage Limiter's data:

Basic Usage

First, you need to use the HasLimits trait on your model.

Create your Limits

Possible values for "reset_frequency" column

• null
• "every second" // works in Laravel >= 10
• "every minute"
• "every hour"
• "every day"
• "every week",
• "every two weeks",
• "every month",
• "every quarter",
• "every six months",
• "every year"

Set Limits on models

Set Limits on models with beginning used amounts

If a user has already consumed limits then:

Unset Limits from models

Consume/Unconsume Limits

Both useLimit and unuseLimit methods throws an exception if a user exceeded limits or tried to unuse limits below 0.

Reset Limits for models

All available methods

All available commands

Blade

Schedule Limit Usage Resetting

The limit:reset command will reset your model's (e.g. user) limit usages based on the Limit's reset_frequency.

Add limit:reset command to the console kernel.

Advanced Usage

Extending

• If you would like to write your own model, make sure that your new Limit model extends NabilHassen\LaravelUsageLimiter\Models\Limit::class and change the model in the limit.php config file to your new model.
• If you already have used the limits method or property where the HasLimits trait is used, you can change it to any string value (e.g. 'restricts') by changing the relationship key in the limit.php config file and you're done.
• If there are any conficts in the database table names, you will just need to change the tables names in the limit.php config file and you're good to go.

Clear your config cache if you have made any changes in the limit.php config file.

Caching

By default, Laravel Usage Limiter uses the default cache you chose for your app. If you would like to use any other cache store you will need to change the store key in the limit.php config file to your preferred cache store.

• All of your Limits will be cached for 24 hours.
• On create, update, or deleting of a limit, the Limits cache will be refreshed.
• Model-specific limits are cached in-memory (i.e. during the request).

Manual Cache Reset

In your code

Via command line

Testing

Security

If you have found any security issues, please send an email to the author at [email protected].

Contributing

You are welcome to contribute to the package and you will be credited. Just make sure your PR does one thing and add tests.

License

The Laravel Usage Limiter is open-sourced software licensed under the MIT license MIT license.