PHPackages                             grigio/notifications - 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. [Mail & Notifications](/categories/mail)
4. /
5. grigio/notifications

ActiveLibrary[Mail & Notifications](/categories/mail)

grigio/notifications
====================

Notification handler

v2.1.0(6y ago)09MITPHPPHP >=5.5

Since Feb 17Pushed 6y agoCompare

[ Source](https://github.com/farshadfakhar/notifications)[ Packagist](https://packagist.org/packages/grigio/notifications)[ RSS](/packages/grigio-notifications/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (5)Dependencies (2)Versions (6)Used By (0)

Notifications
=============

[](#notifications)

PHP Notification handler

### Supported notification channels

[](#supported-notification-channels)

- Sms.ir
- Laravel email

Instalation
-----------

[](#instalation)

- `composer require grigio/notifications`
- `php artisan vendor:publish` and choose config
- Add this environment variables to .env

    ```
      SMSIR_SECRET_KEY=
      SMSIR_API_KEY=
      SMSIR_NUMBER=

    ```
- Email channel use `MAIL_USERNAME` as from address and `APP_NAME` as name for sending emails
- Create your notification class like this

    ```
    class YourNotification extends GrigioNotification {

      public function viaSmsIR()
      {
          $data = $this->data();
          $this->setReceiver(
            //Get mobile from $data
          );
          $this->setMessage(
              //Put your message here
          );
          return $this->sendPrepration();
      }

      public function viaEmail()
      {
          $data = $this->data();
          $this->setSubject(
            // Email title
          );
          $this->setReceiver(
            //Reciver email address
          );
          $this->setMessage(view('Your Email Template', ['data' => $data]));
          return $this->sendPrepration();

      }
    }

    ```
- Use `Notifible` trait in your model
- Now in your method that you want send notification

```
   $order->notify(new YourNotification($order));

```

Channel Development
-------------------

[](#channel-development)

- Create a class like this

```
class SmsIRChannel extends GerigioChannel implements ChannelContract
{
   /**
    * Name of the method for this channel in notification class
    */
   public $channel = 'fill with notification class method name';

   /**
    * Channel Send Method
    * Do process of sending message
    */
   public function send()
   {
       // You access seted datas in notification class as an array
       $message = $this->getMessage();
       // Do the process of sending notification
   }
}

```

- Register it in config/grigionotification.php
- Add channel method to your notification class. Now you have a new channel :)

If you like to help us send your new channel as a pull request <3
====================================================================

[](#if-you-like-to-help-us-send-your-new-channel-as-a-pull-request-3)

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity55

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 ~5 days

Total

5

Last Release

2261d ago

Major Versions

v1.0.1 → v2.02020-03-08

### Community

Maintainers

![](https://www.gravatar.com/avatar/de1b468eb5a5052df4cd70669ea21210f1207da175fcda33fb86d7894300a07f?d=identicon)[farshadfakhar](/maintainers/farshadfakhar)

---

Top Contributors

[![farshadfakhar](https://avatars.githubusercontent.com/u/45591134?v=4)](https://github.com/farshadfakhar "farshadfakhar (1 commits)")

---

Tags

emailnotificationsmssmsirsms ir

### Embed Badge

![Health badge](/badges/grigio-notifications/health.svg)

```
[![Health](https://phpackages.com/badges/grigio-notifications/health.svg)](https://phpackages.com/packages/grigio-notifications)
```

###  Alternatives

[tzsk/sms

A robust and unified SMS gateway integration package for Laravel, supporting multiple providers.

320244.3k6](/packages/tzsk-sms)[gr8shivam/laravel-sms-api

A modern, flexible Laravel package for integrating any SMS gateway with REST API support

10138.4k](/packages/gr8shivam-laravel-sms-api)[ferdous/laravel-otp-validate

Laravel package for OTP validation with built-in features like retry and resend mechanism. Built in max retry and max resend blocking. OTP/Security Code can be send over SMS or Email of your choice with user-defined template.

7124.4k](/packages/ferdous-laravel-otp-validate)[nikolaposa/notifier

Extensible library for building notifications and sending them via different delivery channels.

211.6k](/packages/nikolaposa-notifier)[ghanem/laravel-smsmisr

Send SMS and SMS Notification via SMS Misr for Laravel

194.8k](/packages/ghanem-laravel-smsmisr)[hooman-mirghasemi/laravel-iran-sms

Laravel Sms

241.8k](/packages/hooman-mirghasemi-laravel-iran-sms)

PHPackages © 2026

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