aldemco / laravel-notification-channel-sms-ru
This package makes it easy to send notifications using [sms.ru](https://sms.ru) (aka SMSRU) with Laravel 7.0 to 13.x (fomvasss/laravel-notification-channel-sms-ru fork)
Package info
github.com/aldemco/laravel-notification-channel-sms-ru
pkg:composer/aldemco/laravel-notification-channel-sms-ru
Requires
- php: >=7.2.5
- illuminate/events: ^7.0|^8.0|^9.0|^10.0|^11.0|^12.0|^13.0
- illuminate/notifications: ^7.0|^8.0|^9.0|^10.0|^11.0|^12.0|^13.0
- illuminate/support: ^7.0|^8.0|^9.0|^10.0|^11.0|^12.0|^13.0
- zelenin/smsru: ^4.1|^5.0
Requires (Dev)
- mockery/mockery: ^1.3
- phpunit/phpunit: ^8.0|^9.0|^10.0|^11.0|^12.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-16 22:55:07 UTC
README
Here's the latest documentation on Laravel's Notifications System:
https://laravel.com/docs/master/notifications
Contents
- Upgrade note: SmsRuNotification interface
- Installation
- Usage
- Changelog
- Security
- Contributing
- Credits
- License
Upgrade note: SmsRuNotification interface
When updating to a package version that includes the SmsRuNotification interface, update each notification that uses the SMS.ru channel to implement it. This makes the toSmsru() contract explicit and prevents Intelephense from reporting the method as undefined. The notification must still provide its toSmsru() method and may return either a string or an SmsRuMessage.
Add the interface import and implement it alongside Laravel's base Notification class:
use Illuminate\Notifications\Notification; use NotificationChannels\SmsRu\SmsRuNotification; class AccountApproved extends Notification implements SmsRuNotification { // Keep your existing toSmsru($notifiable) method. }
Installation
Install this package with Composer:
composer require aldemco/laravel-notification-channel-sms-ru:dev-main
The service provider gets loaded automatically. Or you can do this manually:
// config/app.php 'providers' => [ ... NotificationChannels\SmsRu\SmsRuServiceProvider::class, ],
Setting up the SmsRu service
Add your SmsRu apiID, default sender name (or phone number) to your config/services.php:
// config/services.php ... 'sms_ru' => [ 'api_id' => env('SMSRU_API_ID'), ], ...
Local development with Docker
The Docker environment includes PHP 8.4, Composer, and Xdebug. Start the container and install dependencies:
docker compose up -d --build docker compose exec app composer update docker compose exec app composer test
The project directory is mounted at /app; Composer installs dependencies into the project’s vendor directory. The container runs as UID/GID 1000 by default. If your host user has different IDs, set UID and GID in the environment before starting Compose. To run a command in a disposable container instead, use docker compose run --rm app composer test after installing dependencies.
Xdebug listens for IDE connections on port 9003. Configure your IDE to accept connections from host.docker.internal and map the project root to /app. Stop the container with docker compose down.
Usage
You can use the channel in your via() method inside the notification:
use Illuminate\Notifications\Notification; use NotificationChannels\SmsRu\SmsRuMessage; use NotificationChannels\SmsRu\SmsRuChannel; use NotificationChannels\SmsRu\SmsRuNotification; class AccountApproved extends Notification implements SmsRuNotification { public function via($notifiable) { return [SmsRuChannel::class]; } public function toSmsru($notifiable) { return (new SmsRuMessage())->content("Hello SMS!!!")->test(true)->translit(false); } }
In your notifiable model, make sure to include a routeNotificationForSmsru() method, which returns a phone number
or an array of phone numbers.
public function routeNotificationForSmsru() { return $this->phone; }
Available methods
from(): Sets the sender's name or phone number.
content(): Set a content of the notification message.
time(): Example argument = time() + 7*60*60 - Postpone shipping for 7 hours.
translit(): Text transliteration
test(): Test SMS sending (free)
from(): Approved letter sender
parentId(): You can specify your partner ID if you integrate the code into a foreign system
Credits
License
The MIT License (MIT). Please see License File for more information.