recca0120 / mitake
三竹簡訊 mitake api client
Requires
- php: >=5.5.9
- guzzlehttp/psr7: ^1.4
- nesbot/carbon: ^1.22|^2.0
- php-http/client-implementation: ^1.0|^2.0
- php-http/discovery: ^1.2
- php-http/httplug: ^1.1|^2.0
- php-http/message: ^1.5
Requires (Dev)
- illuminate/support: ^5.1
- mockery/mockery: ~0.9.4|~1.0
- php-http/guzzle6-adapter: ^1.1|^2.0
- phpunit/phpunit: ~4.8|~5.4|~6.1|~7.0
Suggests
- illuminate/notifications: If you need Laravel Notification
This package is auto-updated.
Last update: 2021-12-07 23:30:32 UTC
README
This package makes it easy to send notifications using [mitake] with Laravel 5.3+.
Contents
Installation
You can install the package via composer:
composer require taiwan-sms/mitake illuminate/notifications php-http/guzzle6-adapter
Then you must install the service provider:
// config/app.php 'providers' => [ ... TaiwanSms\Mitake\MitakeServiceProvider::class, ],
Setting up the Mitake service
Add your Mitake login, secret key (hashed password) and default sender name (or phone number) to
your config/services.php
:
// config/services.php ... 'mitake' => [ 'username' => env('SERVICES_MITAKE_USERNAME'), 'password' => env('SERVICES_MITAKE_PASSWORD'), ], ...
Usage
You can use the channel in your via()
method inside the notification:
use TaiwanSms\Mitake\MitakeMessage; use TaiwanSms\Mitake\MitakeChannel; use Illuminate\Notifications\Notification; class AccountApproved extends Notification { public function via($notifiable) { return [MitakeChannel::class]; } public function toMitake($notifiable) { return MitakeMessage::create("Task #{$notifiable->id} is complete!"); } }
In your notifiable model, make sure to include a routeNotificationForTwSMS() method, which return the phone number.
public function routeNotificationForTwSMS() { return $this->phone; }
Available methods
subject()
: Sets a subject of the notification subject.
content()
: Sets a content of the notification message.
sendTime()
: Set send time of the notification message.
Changelog
Please see CHANGELOG for more information what has changed recently.
Testing
$ composer test
Security
If you discover any security related issues, please email recca0120@gmail.com instead of using the issue tracker.
Contributing
Please see CONTRIBUTING for details.
Credits
License
The MIT License (MIT). Please see License File for more information.
API Only
composer require taiwan-sms/mitake php-http/guzzle6-adapter
How to use
require __DIR__.'/vendor/autoload.php'; use TaiwanSms\Mitake\Client; $userId = 'xxx'; $password = 'xxx'; $client = new Client($userId, $password); var_dump($client->credit()); // 取得額度 var_dump($client->send([ 'to' => '09xxxxxxxx', 'text' => 'test message', ])); /* return [ 'msgid' => '0892448417', 'statuscode' => '1', 'AccountPoint' => '97', ]; */