PHPackages                             rokde/laravel-subscription-manager - 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. [Payment Processing](/categories/payments)
4. /
5. rokde/laravel-subscription-manager

ActiveLibrary[Payment Processing](/categories/payments)

rokde/laravel-subscription-manager
==================================

This is my package SubscriptionManager

v1.1.0(2y ago)91024MITPHPPHP ^8.2

Since Aug 18Pushed 1y ago3 watchersCompare

[ Source](https://github.com/rokde/laravel-subscription-manager)[ Packagist](https://packagist.org/packages/rokde/laravel-subscription-manager)[ Docs](https://github.com/rokde/laravel_subscription_manager)[ Fund](https://www.paypal.me/rok)[ RSS](/packages/rokde-laravel-subscription-manager/feed)WikiDiscussions master Synced today

READMEChangelog (4)Dependencies (14)Versions (5)Used By (0)

The Subscription Manager for Laravel
====================================

[](#the-subscription-manager-for-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/eb409f6e89baeed1eba2454d12d6502a96c499f4a16f7b5f4ec1eab39890a3f4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f726f6b64652f6c61726176656c2d737562736372697074696f6e2d6d616e616765722e7376673f7374796c653d666c6174266c6f676f3d7061636b6167697374)](https://packagist.org/packages/rokde/laravel-subscription-manager)[![run-tests](https://github.com/rokde/laravel-subscription-manager/actions/workflows/run-tests.yml/badge.svg)](https://github.com/rokde/laravel-subscription-manager/actions/workflows/run-tests.yml)[![Check & fix styling](https://github.com/rokde/laravel-subscription-manager/actions/workflows/php-cs-fixer.yml/badge.svg)](https://github.com/rokde/laravel-subscription-manager/actions/workflows/php-cs-fixer.yml)[![PHPLint](https://github.com/rokde/laravel-subscription-manager/workflows/Lint%20Code%20Base/badge.svg)](https://github.com/marketplace/actions/check-php-syntax-errors)[![Total Downloads](https://camo.githubusercontent.com/08171a75a68acdbd84d522188a0ccfa823c6e7ea1b5f0a6d10c1df55823310a2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f726f6b64652f6c61726176656c2d737562736372697074696f6e2d6d616e616765722e7376673f7374796c653d666c6174266c6f676f3d7061636b6167697374)](https://packagist.org/packages/rokde/laravel-subscription-manager)

**NOT READY TO USE IN PRODUCTION ENVIRONMENTS**

OPEN TODOS
==========

[](#open-todos)

- Throwing subscription lifecycle events: ended, cycle, ...
- Metered features: limit numeric usages of a feature: just 10 customers can be managed

    - with limiting on checking subscribed
    - with upgrading possibility
    - with events: quota-reached, quota-exceeded

---

The Subscription Manager for Laravel should handle all subscription based stuff without handling any payment. In contrary to the well known payment handling packages like cashier or similar we do not support any payment handling. Just the plans with features, subscribing, starting with a trial and pro-rating or going on an grace period and so on.

For communicating the changes we threw a lot of events and have a toolkit on board including middlewares, blade conditions and other ask-for-feature acceptance services.

What it is not:

- Handling prices
- Handling payments
- Doing a checkout
- Handling coupons or vouchers
- Handling marketing data
- Printing invoices

What it is:

- Assemble Features to plans
- Subscribe a user (or other models) to one or more plans
    - add or remove features to an existing subscription
- Check paid status of a feature (like a guard) for a given user (or other models)
- Display subscription with details

What it is all about?
---------------------

[](#what-it-is-all-about)

### Glossary

[](#glossary)

**Subscribable** is an Entity which can subscribe to a set of features.

> In the real world it would be a human, which pays money for getting access to something premium.

**Subscription** is the relation between a Subscribable and its limited access granted to a set of features.

> In the real world it would be a contract with a time-limit and a recurrence definition, like a cellphone contract.

**Feature** is a name of a premium area or premium function not every user has access to.

> In the real world you get an access key to a hidden level.

**Plan** is a virtual composition of a set of Features.

> In the real world is a Plan the Package S, M or L with access to a few, more or all functions.

### Definition

[](#definition)

On the definition side you have Features - identified by a slug code. Features are there for control. Think of permissions or an access right for a secured part of your application. Features can be virtually grouped by a Plan - but do not have to.

Because we handle no prices, you do not have to have a plan or Feature bundle.

So each Feature can be part in no Plan, one Plan, more Plans or all Plans. A Plan can exist, multiple Plans can exists, but no Plan has to exist. Think of a role in terms of authorization.

### Subscription

[](#subscription)

A Subscription is loosely coupled to a plan and has a not-linked list of subscribed features. So the loosely coupled Plan is more an informative data link. The list of feature slugs are the important information within the subscription.

A Subscription runs infinite (`ends_at` is null) or until the end date. Additionally you can set a trial period (`trial_ends_at` is not null) end the trial ends at the specified timestamp. Before that you are on a trial.

A Subscription Circle is a virtual object in terms of periods. So a Subscription period is 1 year by default. So each Subscription has a list of Circles, at least one. Each Circle has a maximum of a period length, can be shorter when subscription is cancelled instant.

Subscriptions with an `infinite` period have just on Circle and are not recurring.

[![](https://camo.githubusercontent.com/0b7feb63e4814d7c3ad27385b2d94742776027d491a2d55099de3a1018fac23a/68747470733a2f2f6d65726d6169642e696e6b2f696d672f65794a6a6232526c496a6f695a584a456157466e636d467458473467494341674943416749434167526d5668644856795a5342396279347562337367554778686269413649484273595735665a6d5668644856795a56787549434167494341674943416749455a6c59585231636d5567664738754c6d393849464e31596e4e6a636d6c7764476c76626b5a6c59585231636d55674f6942316332566b58473467494341674943416749434167554778686269423862793475623373675533566963324e79615842306157397549446f676333566963324e7961574a6c5a4639306231787549434167494341674943416749464e31596e4e6a636d6c7764476c766269423866433475664873675533566963324e796158423061573975526d5668644856795a546f676147467a584734674943416749434167494341675533566963324e796158423061573975526d5668644856795a53423862793074664873675533566963324e796158423061573975526d5668644856795a56567a5957646c4f69426a6232357a6457316c5a46787549434167494341674943416749455a6c59585231636d55676531787549434167494341674943416749434167633352796157356e49474e765a47566362694167494341674943416749434239584734674943416749434167494341675547786862694237584734674943416749434167494341674943427a64484a70626d6367626d46745a567875494341674943416749434167494831636269416749434167494341674943425464574a7a59334a7063485270623234676531787549434167494341674943416749434167633352796157356e49485631615752636269416749434167494341674943416749473176636e426f49484e31596e4e6a636d6c6959574a735a56787549434167494341674943416749434167633352796157356e583239795832353162477767634756796157396b58473467494341674943416749434167494342306157316c633352686258426662334a66626e567362434230636d6c686246396c626d527a5832463058473467494341674943416749434167494342306157316c633352686258426662334a66626e56736243426c626d527a58324630584734674943416749434167494341676656787549434167494341674943416749464e31596e4e6a636d6c7764476c76626b5a6c59585231636d55676531787549434167494341674943416749434167633352796157356e49474e765a4756636269416749434167494341674943416749474a7662327767625756305a584a6c5a467875494341674943416749434167494341676157353058323979583235316247776763585676644746636269416749434167494341674943416749476c7564463976636c3975645778734948567a5a5752636269416749434167494341674943416749476c75644342795a57316861573570626d646362694167494341674943416749434239584734674943416749434167494341675533566963324e796158423061573975526d5668644856795a56567a5957646c494874636269416749434167494341674943416749473176636e426f4948567a5a575266596e6c636269416749434167494341674943416749476c75644342316332566b5847346749434167494341674943416766534973496d316c636d3168615751694f6e73696447686c625755694f694a6b5a575a6864577830496e3073496e56775a4746305a55566b61585276636949365a6d467363325639)](https://mermaid-js.github.io/mermaid-live-editor/#/edit/eyJjb2RlIjoiZXJEaWFncmFtXG4gICAgICAgICAgRmVhdHVyZSB9by4ub3sgUGxhbiA6IHBsYW5fZmVhdHVyZVxuICAgICAgICAgIEZlYXR1cmUgfG8uLm98IFN1YnNjcmlwdGlvbkZlYXR1cmUgOiB1c2VkXG4gICAgICAgICAgUGxhbiB8by4ub3sgU3Vic2NyaXB0aW9uIDogc3Vic2NyaWJlZF90b1xuICAgICAgICAgIFN1YnNjcmlwdGlvbiB8fC4ufHsgU3Vic2NyaXB0aW9uRmVhdHVyZTogaGFzXG4gICAgICAgICAgU3Vic2NyaXB0aW9uRmVhdHVyZSB8by0tfHsgU3Vic2NyaXB0aW9uRmVhdHVyZVVzYWdlOiBjb25zdW1lZFxuICAgICAgICAgIEZlYXR1cmUge1xuICAgICAgICAgICAgc3RyaW5nIGNvZGVcbiAgICAgICAgICB9XG4gICAgICAgICAgUGxhbiB7XG4gICAgICAgICAgICBzdHJpbmcgbmFtZVxuICAgICAgICAgIH1cbiAgICAgICAgICBTdWJzY3JpcHRpb24ge1xuICAgICAgICAgICAgc3RyaW5nIHV1aWRcbiAgICAgICAgICAgIG1vcnBoIHN1YnNjcmliYWJsZVxuICAgICAgICAgICAgc3RyaW5nX29yX251bGwgcGVyaW9kXG4gICAgICAgICAgICB0aW1lc3RhbXBfb3JfbnVsbCB0cmlhbF9lbmRzX2F0XG4gICAgICAgICAgICB0aW1lc3RhbXBfb3JfbnVsbCBlbmRzX2F0XG4gICAgICAgICAgfVxuICAgICAgICAgIFN1YnNjcmlwdGlvbkZlYXR1cmUge1xuICAgICAgICAgICAgc3RyaW5nIGNvZGVcbiAgICAgICAgICAgIGJvb2wgbWV0ZXJlZFxuICAgICAgICAgICAgaW50X29yX251bGwgcXVvdGFcbiAgICAgICAgICAgIGludF9vcl9udWxsIHVzZWRcbiAgICAgICAgICAgIGludCByZW1haW5pbmdcbiAgICAgICAgICB9XG4gICAgICAgICAgU3Vic2NyaXB0aW9uRmVhdHVyZVVzYWdlIHtcbiAgICAgICAgICAgIG1vcnBoIHVzZWRfYnlcbiAgICAgICAgICAgIGludCB1c2VkXG4gICAgICAgICAgfSIsIm1lcm1haWQiOnsidGhlbWUiOiJkZWZhdWx0In0sInVwZGF0ZUVkaXRvciI6ZmFsc2V9)

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require rokde/laravel-subscription-manager
```

You have to publish and run the migrations with:

```
php artisan vendor:publish --provider="Rokde\SubscriptionManager\SubscriptionManagerServiceProvider" --tag="laravel-subscription-manager-migrations"
php artisan migrate --step
```

You can publish the config file with:

```
php artisan vendor:publish --provider="Rokde\SubscriptionManager\SubscriptionManagerServiceProvider" --tag="laravel-subscription-manager-config"
```

You can configure the following parts (documentation is inside the shipped configuration file):

- middleware

Usage
-----

[](#usage)

If your subsciption subscribables are your users, then you have to do the following:

1.) Add the `Subscribable` trait to your User model.

```
// \App\Models\User
class User extends \Illuminate\Foundation\Auth\User {
    use \Rokde\SubscriptionManager\Models\Concerns\Subscribable;
}
```

2.) Subscribe something

```
//  using the SubscriptionBuilder, presented by Subscribable trait
/** @var \Rokde\SubscriptionManager\Models\Factory\SubscriptionBuilder $builder */
$builder = $user->newSubscription();    // without any plan
// or
$plan = \Rokde\SubscriptionManager\Models\Plan::byName('Superior');
$builder = $user->newSubscription($plan);    // subscribing to a plan -> the list of features will be taken from the plan
// or
$builder = $user->newFeatureSubscription(['feature-1', 'feature-2']);    // just a list of features, must not exist in database

$builder->periodLength('P1M')   // set period length to a month (default is 1 year)
    ->infinitePeriod()          // or set an infinite period
    ->trialDays(30)             // set 30 days for trial
    ->skipTrial()               // or skip trial (default)
    ->create();                 // and create a subscription
```

3.) Use one of the various checks.

See [Checking chapter](#checking) below.

4.) Ask any information on a subscription

A Subscription can have a relation to a plan. It should have a list of features - but an empty array is good too. You can get an array of Subscription Circles for a Subscription. Each Subscription Circle represents a period within the subscription.

```
$subscription->circles(); // resolves a list of SubscriptionCircles
```

Each Subscription Circle has a relation to the subscription, its own start and end date. You can get an interval and the indexed number (1-based) of a circle. It respects the end of a subscription in past or future. The last Subscription Circle on active Subscriptions will have the current timestamp within its borders. So you have to add Circles on your own, when you want to go into the future.

5.) Cancel a subscription

Subscriptions can be cancelled in a few ways, all provided in the `\Rokde\SubscriptionManager\Models\Concerns\HandlesCancellation` trait.

```
$user->subscription->cancel();              // cancel at the end of the current circle or at the end of the trial when you are on a trial
// or
$user->subscription->cancelNow();           // cancel just right now
// or
$user->subscription->cancelAt($datetime);   // cancel at a concrete time
```

6.) Resume a cancelled subscription

```
$user->subscription->resume();  // resume a cancelled subscription within grace period
```

### Consuming Features

[](#consuming-features)

1.) Setting a quota on metered features by actions (or direct via Subscription Builder)

```
$meteredFeature = (new CreateFeatureAction())->execute('users-count', true);

$subscription = (new CreateSubscriptionFromFeaturesAction())
    ->execute([$meteredFeature], request()->user(), function (SubscriptionBuilder $builder) {
        $builder->setQuota('users-count', 10); // allow 10 users
    });
```

### Checking

[](#checking)

#### Checking with Middleware

[](#checking-with-middleware)

We register a middleware `subscribed` as route middleware. You can change that by publishing config and modify the `subscription-manager::middleware` config key.

You can check route access by just looking if your subscribable has an active subscription by using the middleware like so:

```
// /routes/web.php
Route::group(['middleware' => 'subscribed'], function () {
    // here you can define your premium routes
});
```

If you want to be a bit more concrete, you can ask if your subscribable has an active subscription to a feature like so:

```
// /routes/web.php
Route::group(['middleware' => 'subscribed:track-time'], function () {
    // here you can define your routes for all users which have subscribed to a feature "track-time"
});
```

#### Checking on the Subscribable

[](#checking-on-the-subscribable)

```
// @var \App\Models\User|\App\Models\Team $subscribable
//  just currently active subscriptions
$hasAnyActiveSubscription = $subscribable->subscribed();
$isActivelySubscribedToAConcreteFeature = $subscribable->subscribed('feature-1');

//  active and past subscriptions
$hasAnySubscriptionEver = $subscribable->everSubscribed();
$wasSubscribedToAConcreteFeature = $subscribable->everSubscribed('feature-1');
```

#### Getting all subscribed features

[](#getting-all-subscribed-features)

You can retrieve an array of all subscribed features.

```
// @var \App\Models\User|\App\Models\Team $subscribable
$allFeatures = $subscribable->subscribedFeatures(); // ['feature-1', 'feature-2']
```

### Retrieving a different Subscribable

[](#retrieving-a-different-subscribable)

By default a subscribable is always the `Auth::user()`. But you can change that behaviour by registering another closure in your AppServiceProvider.

Maybe you are using JetStream or another team-based subscription subscribable option then do it like so:

```
// \App\Providers\AppServiceProvider::register()
\Rokde\SubscriptionManager\SubscribableResolver::resolveSubscribable(function () {
    return optional(\Illuminate\Support\Facades\Auth::user())->currentTeam;
});
```

And now you can add the `Subscribable` trait to your Team model:

```
// \App\Models\Team
class Team extends \Laravel\Jetstream\Team {
    use \Rokde\SubscriptionManager\Models\Concerns\Subscribable;
}
```

Now you can use one of the various checks.

Events
------

[](#events)

You can listen on various events during the subscription lifecycle.

The following events gets dispatched:

- `\Rokde\SubscriptionManager\Events\SubscriptionCreated` when a subscription gets created
- `\Rokde\SubscriptionManager\Events\SubscriptionCanceled` when a subscription gets cancelled
- `\Rokde\SubscriptionManager\Events\SubscriptionResumed` when a cancelled subscription gets resumed
- `\Rokde\SubscriptionManager\Events\SubscriptionUpdated` when a subscription gets updated
- `\Rokde\SubscriptionManager\Events\SubscriptionDeleted` when a subscription gets deleted (it is soft deleted)
- `\Rokde\SubscriptionManager\Events\SubscriptionPurged` when a subscription gets finally removed
- `\Rokde\SubscriptionManager\Events\SubscriptionRestored` when a soft-deleted subscription gets restored

Insights
--------

[](#insights)

### Customer Insights

[](#customer-insights)

You have to use the `Rokde\SubscriptionManager\Insights\Customer`.

You can get the following customer insights:

- Which are the customers within a period or the current timestamp?
- Which customers will churn in a given period?

Usually rolling 30 days or monthly periods are used for checking the indicators.

### Subscriptions Histogram

[](#subscriptions-histogram)

The historical data can be accessed with the `Rokde\SubscriptionManager\Insights\SubscriptionHistory`.

The default use case is to retrieve statistical data grouped by week for the last month.

```
$history = new \Rokde\SubscriptionManager\Insights\SubscriptionHistory();
$histogram = $history->get(); // keyed-map
```

Each grouped partition has the following data:

```
'2021-01-01' => [
    'start' => '2021-01-01 00:00:00',   // start of period
    'end' => '2021-02-01 00:00:00',     // end of period
    'count' => 3,                       // number of subscriptions within the period
    'new' => 2,                         // newly created subscriptions within the period
    'trial' => 2,                       // number of subscriptions being on trial within the period
    'grace' => 2,                       // number of subscriptions being on grace period within the period
    'ended' => 2,                       // subscriptions finally ended within the period
],
```

Testing
-------

[](#testing)

```
composer test
```

FAQ
---

[](#faq)

**Q** Why don't you use any model-relation between a subscription and the feature models?

**A** The tables for plans and features are just for the selling side of a subscription. You can use this structure yourself by filling these tables with your set of packages and features. But you don't have to to subscribe a user to a set of features.

Your business model can by selling subscriptions on a team level, but you can offer a personal feature to each user, which a user can subscribe to - no matter what the team has features for. So you do not have to struggle if this feature will be already on a plan or in your selling page.

Example: you have an HR app and you can sell a company-wide subscription to give all employees access to your app, billed by the company. A team of users want to track their own private todo list. Now you can subscribe these users to a special feature - like unlocking a special menu item.

**Q** Why don't you handle prices on plans or features or subscriptions?

**A** Because it is hard having prices in a world-wide usable package. You have various prices (with tax, without tax, including fees, various currencies, exchange rates, ...).

Add fields to the shipped migrations (tables) and inherit from the package models to suit your needs for handling price and currency. Sometimes it is easier to display prices just on a marketing page in html, than to have time-related multi-currency prices with or without taxes displayed for personal users or business customers.

Maybe it is better to tell a few USP features on the marketing selling page, but to have atomic features to handle subscription access even for crud operations - like a permission-based app.

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Robert Kummer](https://github.com/rokde)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance28

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~87 days

Total

4

Last Release

735d ago

PHP version history (2 changes)v1.0.0PHP ^8.1

v1.1.0PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4946056?v=4)[Robert Kummer](/maintainers/rokde)[@rokde](https://github.com/rokde)

---

Top Contributors

[![rokde](https://avatars.githubusercontent.com/u/4946056?v=4)](https://github.com/rokde "rokde (33 commits)")

---

Tags

subscriptionsubscription-managerlaravelsubscriptionplan

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/rokde-laravel-subscription-manager/health.svg)

```
[![Health](https://phpackages.com/badges/rokde-laravel-subscription-manager/health.svg)](https://phpackages.com/packages/rokde-laravel-subscription-manager)
```

###  Alternatives

[laravel/pulse

Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application.

1.7k12.1M99](/packages/laravel-pulse)[laravel/cashier

Laravel Cashier provides an expressive, fluent interface to Stripe's subscription billing services.

2.5k25.9M107](/packages/laravel-cashier)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[psalm/plugin-laravel

Psalm plugin for Laravel

3274.9M308](/packages/psalm-plugin-laravel)[spatie/laravel-health

Monitor the health of a Laravel application

85810.0M83](/packages/spatie-laravel-health)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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