regoldidealista/esendex-laravel

This is a Laravel package for integrating with the Esendex SMS provider, but if you want you can implements your own service as a backup.

1.1.0 2025-05-22 12:42 UTC

Requires

• php: ^8.1
• illuminate/notifications: ^11.0 || ^12.0
• illuminate/support: ^11.0 || ^12.0

MIT

• Mirko Farina

README

This is a Laravel package for integrating with the Esendex SMS service, and you can set you own backup provider.

Installation

composer require regoldidealista/esendex-laravel

Usage

1. Register the service provider in your config/app.php file:

'providers' => [
    // Other Service Providers...

    Regoldidealista\EsendexLaravel\SmsServiceProvider::class,
],

1. Publishing the Configuration File
   After installing the package, you should publish the configuration file to your Laravel application. This will allow you to modify the package's configuration options. Run the following command in your terminal:

php artisan vendor:publish --provider="Regoldidealista\EsendexLaravel\SmsServiceProvider" 

This command will publish the sms.php configuration file from the package to your Laravel application's config directory. You can find the published configuration file at config/sms.php.

1. Use the SmsNotification class to send SMS notifications:

use Regoldidealista\EsendexLaravel\Notifications\SmsNotification;

class YourNotification extends SmsNotification
{
    // use the via method with the specific channel 
    public function via(object $notifiable): string
    {
        return $this->channel::class;
    }
    // also you can implement viaQueues method using the same channel.

    public function beforeSend(): void
    {
        // you can get notifiable object with $this->getNotifiable()
        $this->setTo(); // set the recipient phone number or array of phone numbers
        $this->setBodyMessage(); // set the body message as a string
    }
}