{"id":13463779,"url":"https://github.com/RobustaStudio/Resala","last_synced_at":"2025-03-25T09:31:02.887Z","repository":{"id":46210969,"uuid":"242328287","full_name":"RobustaStudio/Resala","owner":"RobustaStudio","description":"PHP \u0026 Laravel SMS Gateway Integration Package","archived":false,"fork":false,"pushed_at":"2024-12-22T10:26:26.000Z","size":75,"stargazers_count":22,"open_issues_count":2,"forks_count":14,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-03-23T04:17:05.005Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RobustaStudio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-02-22T11:16:38.000Z","updated_at":"2025-03-19T13:04:16.000Z","dependencies_parsed_at":"2024-01-13T17:54:49.605Z","dependency_job_id":"fd95f1cb-b64d-4069-a5a3-37b22e5a60c4","html_url":"https://github.com/RobustaStudio/Resala","commit_stats":{"total_commits":53,"total_committers":6,"mean_commits":8.833333333333334,"dds":0.5849056603773585,"last_synced_commit":"d46121800167f44f2c8a85fd0ca47428dc0d8c44"},"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobustaStudio%2FResala","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobustaStudio%2FResala/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobustaStudio%2FResala/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobustaStudio%2FResala/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RobustaStudio","download_url":"https://codeload.github.com/RobustaStudio/Resala/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245435079,"owners_count":20614825,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T14:00:28.417Z","updated_at":"2025-03-25T09:31:02.369Z","avatar_url":"https://github.com/RobustaStudio.png","language":"PHP","funding_links":[],"categories":["Projects"],"sub_categories":["Web and Publishing"],"readme":"# PHP \u0026 Laravel SMS Gateway Integration Package\n\n[![Latest Version on Packagist](https://img.shields.io/packagist/v/robust-tools/resala.svg?style=flat-square)](https://packagist.org/packages/robust-tools/resala)\n[![Total Downloads](https://img.shields.io/packagist/dt/robust-tools/resala.svg?style=flat-square)](https://packagist.org/packages/robust-tools/resala)\n\n**Resala** is a PHP \u0026 Laravel Package, (Designed to add support to your laravel or just native php app for sending SMS using local operators in the MENA region Like `Vodafone`, `Infopib`, `Conneckio`, `VectoryLink`).  \n**Resala** not just tied to use inside Laravel you can hook it up in any php code\n\n## Supported Providers\n- Vodafone SMS Gateway\n- Connekio SMS Gateway\n- InfoPib SMS Gateway\n- Vectory Link SMS Gateway\n\n## Installation\n\nYou can install the package via composer:\n\n```bash\ncomposer require robust-tools/resala\n```\n# Laravel Usage.\n\n## Configure\n\npublish the config file with:\n\n```bash\nphp artisan vendor:publish --provider=\"RobustTools\\Resala\\SMSServiceProvider\" --tag=\"config\"\n```\n\nThis is the contents of the published config file:\n\n```php\nreturn [\n\n    /*\n     * You can specify a default service provider driver here.\n     * If it is not set we'll use vodafone as the default driver.\n     */\n    'default' =\u003e env('SMS_DRIVER', 'vodafone'),\n\n    /*\n    |--------------------------------------------------------------------------\n    | List of sms drivers\n    |--------------------------------------------------------------------------\n    |\n    | This is a list of possible sms gateways drivers\n    |\n    */\n\n    'drivers' =\u003e [\n\n        'vodafone' =\u003e [\n            'end_point' =\u003e env('VODAFONE_END_POINT'),\n            'account_id' =\u003e env('VODAFONE_ACCOUNT_ID'),\n            'password' =\u003e env('VODAFONE_PASSWORD'),\n            'secure_hash' =\u003e env('VODAFONE_SECURE_HASH'),\n            'sender_name' =\u003e env('VODAFONE_SENDER_NAME', 'Vodafone')\n        ],\n\n        'connekio' =\u003e [\n            'single_sms_endpoint' =\u003e env('SINGLE_SMS_ENDPOINT'),\n            'batch_sms_endpoint' =\u003e env('BATCH_SMS_ENDPOINT'),\n            'username' =\u003e env('CONNEKIO_USERNAME'),\n            'password' =\u003e env('CONNEKIO_PASSWORD'),\n            'account_id' =\u003e env('CONNEKIO_ACCOUNT_ID'),\n            'sender_name' =\u003e env('CONNEKIO_SENDER_NAME')\n        ],\n\n        'infobip' =\u003e [\n            'end_point' =\u003e env('INFOBIP_END_POINT'),\n            'username' =\u003e env('INFOBIP_USERNAME'),\n            'password' =\u003e env('INFOBIP_PASSWORD'),\n            'sender_name' =\u003e env('INFOBIP_SENDER_NAME', 'Infobip')\n        ],\n\n        'vectory_link' =\u003e [\n            'end_point' =\u003e env('VECTORY_LINK_END_POINT'),\n            'username' =\u003e env('VECTORY_LINK_USERNAME'),\n            'password' =\u003e env('VECTORY_LINK_PASSWORD'),\n            'sender_name' =\u003e env('VECTORY_LINK_SENDER_NAME', 'Vectory Link'),\n            'lang' =\u003e env('VECTORY_LINK_LANG', 'E')\n        ],\n    ],\n\n    /*\n    |--------------------------------------------------------------------------\n    | Class Maps\n    |--------------------------------------------------------------------------\n    |\n    |\n    | This is a list of Classes that maps to the Drivers above.\n    */\n    'map' =\u003e [\n        'vodafone' =\u003e VodafoneDriver::class,\n        'connekio' =\u003e ConnekioDriver::class,\n        'infobip' =\u003e InfobipDriver::class,\n        'vectory_link' =\u003e VectoryLink::class\n    ],\n];\n```\n## Available Commands:\n\nThis adds `vodafone` environment variables to your .env file.\n```bash\nphp artisan resala:make vodafone\n```\n\nThis adds `connekio` environment variables to your .env file.\n```bash\nphp artisan resala:make connekio\n```\n\nThis adds `infobip` environment variables to your .env file.\n```bash\nphp artisan resala:make infobip\n```\n\nThis adds `vectory_link` environment variables to your .env file.\n```bash\nphp artisan resala:make vectory_link\n```\n\n## Usage\n\n``` php\nSMS::to('010xxxxxxxx')\n    -\u003emessage(\"Hello World\")\n    -\u003esend();\n\nSMS::to(['010xxxxxxxx', '011xxxxxxxx'])\n    -\u003emessage(\"Hello World\")\n    -\u003esend();\n```\n\nYou can inspect the returned response from your sms provider through:\n\n```php\n$response = SMS::to(['010xxxxxxxx', '011xxxxxxxx'])\n    -\u003emessage(\"Hello World\")\n    -\u003esend();\n\n$response-\u003esuccess(); // returns bool\n$response-\u003ebody(); // returns string\n```\n\nyou can optionally change the driver using the `via` method\n```php\nSMS::via('vodafone')\n    -\u003eto('010xxxxxxxx')\n    -\u003emessage(\"Hello World\")\n    -\u003esend();\n```\n\n## Outside Laravel\nYou need to add a config file named `resala.php` in your project directory the contents of the config file must match the schema of the package config file you can find it [HERE](https://github.com/RobustaStudio/Resala/blob/master/config/resala.php).    \njust replace the `env(values)` with your driver config values.  \n\n```php\nuse RobustTools\\Resala\\SMS;\n\n$configFile = __DIR__ . \"/config/resala.php\";\n\n(new SMS($driver, $configFile))-\u003eto(['010995162378', '012345522'])\n         -\u003emessage(\"Hello World\")\n         -\u003esend();\n```\n\nIF no configuration file is being passed a `InvalidArgumentException` will be thrown.\n\n## Contributing\n\nPlease see [CONTRIBUTING](CONTRIBUTING.md) for details.\n\n### Security\n\nIf you discover any security related issues, please email mohabdelaziz95@gmail.com instead of using the issue tracker.\n\n## Credits\n\n- [Mohamed AbdElaziz](https://github.com/mohabdelaziz95)\n- [All Contributors](../../contributors)\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRobustaStudio%2FResala","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FRobustaStudio%2FResala","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRobustaStudio%2FResala/lists"}