aimedidierm/intouchsms

This is a php library to help developers include sms service, with IntouchSms gateway from RWANDA

v1.0.0 2023-07-20 23:04 UTC

Requires

• php: ^8.1
• guzzlehttp/guzzle: ^7.2

Requires (Dev)

• composer/composer: ^1.10
• dealerdirect/phpcodesniffer-composer-installer: ^1.0.0
• ergebnis/composer-normalize: ^2.5
• hamcrest/hamcrest-php: ^2
• mockery/mockery: ^1.3
• php-parallel-lint/php-parallel-lint: ^1.2
• phpstan/extension-installer: ^1
• phpstan/phpstan: ^0.12.25
• phpstan/phpstan-mockery: ^0.12.5
• phpstan/phpstan-phpunit: ^0.12.8
• phpunit/phpunit: ^9.1
• psy/psysh: ^0.10.4
• slevomat/coding-standard: ^8.13.1
• squizlabs/php_codesniffer: ^3.5
• vimeo/psalm: ^3.11

MIT

• Aime Didier Mugisha
• Yves Niyobuhungiro

README

This is a php library to help developers include sms service, with IntouchSms gateway from RWANDA

Installation

Install this package as a dependency using Composer.

composer require aimedidierm/intouchsms

Usage

This is the documantion

use Aimedidierm\IntouchSms\SmsSimple;

/** @var \Aimedidierm\IntouchSms\SmsSimple */
$sms = new SmsSimple();
$sms->recipients(["250788750979","0738584462"])
    ->message("Hello world")
    ->sender("intouchSenderId")
    ->username("intouchUsername")
    ->password("intouchPassword")
    ->apiUrl("www.intouchsms.co.rw/api/sendsms/.json")
    ->callBackUrl("");
print_r($sms->send());

That code works well, however it does call some static parameters such as senderId,Username,Password,ApiUrl and CallbackUrl. we can solve this by creating another class Called Sms which extends SmsAbstract

namespace App\Services;

use Aimedidierm\IntouchSms\SmsAbstract;

class Sms extends SmsAbstract
{
    public function __construct()
    {
        parent::__construct();

        //
    }

    public function configSender(): string
    {
        return "intouchSenderId";
    }

    public function configUsername(): string
    {
        return "intouchUsername";
    }

    public function configPassword(): string
    {
        return "intouchPassword";
    }

    public function configApiUrl(): string
    {
        return "www.intouchsms.co.rw/api/sendsms/.json";
    }

    public function configCallBackUrl(): string
    {
        return "";
    }


    public static function QuickSend($recipients, String $message, String $senderId = null)
    {
        $sms = new Sms();
        $sms->requiredData($recipients, $message, $senderId);
        return $sms->send();
    }
}

After creating this class you can now use simple codes like

$sms = new Sms();
// first parameter is recipients and second one is message
$sms->requiredData(["250788750979","0738584462"], "Hello there");
print_r($sms->send());

NB: For some people who are not using composer remember to add:

include_once("../vendor/autoload.php");

Contributing

Contributions are welcome! Before contributing to this project, familiarize yourself with CONTRIBUTING.md.

To develop this project, you will need PHP 8.0 or greater, Composer,

After cloning this repository locally, execute the following commands:

cd /path/to/repository
composer install

Now, you are ready to develop!

Copyright and License

This libraly is licensed under the MIT License - see the LICENSE file for details.