djunehor / laravel-vtu
购买话费、数据套餐以及支付水电费
dev-master
2020-01-13 17:06 UTC
Requires
- php: ^7.0|~7.2
- guzzlehttp/guzzle: ^6.0
Requires (Dev)
- orchestra/testbench: ^3.8
- phpunit/phpunit: ^7.0
This package is auto-updated.
Last update: 2024-09-09 14:36:16 UTC
README
Laravel VTU 允许您通过超过 3 个 vtu 提供商之一,或您自己的 vtu 提供商,从 Laravel 应用程序购买话费和数据套餐,以及支付水电网费。
安装
第 1 步
您可以通过 composer 安装此包
composer require djunehor/laravel-vtu
Laravel 5.5 及以上
此包将自动注册,因此您可以立即开始使用它。
Laravel 5.4 及以下
在 Laravel 版本 5.4 及以下版本中,您需要手动在 config/app.php
文件中添加服务提供者
'providers' => [ // ... Djunehor\Vtu\VtuServiceProvider::class, ];
Lumen
安装包后,您需要手动在 bootstrap/app.php
文件中注册它
// Register Service Providers // ... $app->register(Djunehor\Vtu\VtuServiceProvider::class); ];
环境变量键
VOICE_AND_TEXT_TOKEN VOICE_AND_TEXT_CALLBACK COWRIESYS_CLIENT_ID COWRIESYS_CLIENT_KEY VTPASS_USERNAME VTPASS_PASSWORD FPEVTU_USERNAME FPEVTU_PASSWORD UNIK_MOBILE_USERNAME UNIK_MOBILE_PASSWORD MOBILE_AIRTIME_USERNAME MOBILE_AIRTIME_PASSWORD
第 2 步 - 发布文件
运行: php artisan vendor:publish --tag=laravel-vtu
这将迁移文件、种子文件和配置文件移动到您的应用程序中。您可以在配置文件或通过 env 设置您的短信详情
第 3 步 - 添加 SMS 凭据
- 将环境变量键添加到您的
.env
文件中 - 或编辑
config/laravel-vtu.php
文件
使用方法
//using VoiceAndText use Djunehor\Vtu\Concrete\VoiceAndText; $vtu = new VoiceAndText(); $amount = 100; $mobileNumber = '08149659347'; $mobileNetwork = '01'; $callBackUrl = 'http://www.your-website.com'; $send = $vtu->buyAirtime($amount, $mobileNumber, $mobileNetwork, $callBackUrl);
使用辅助函数
//VoiceAndtext $send = buy_airtime($amount, $mobileNumber, $mobileNetwork, $callBackUrl, $token = 121231112, \Djunehor\Vtu\Concrete\VoiceAndText::class);
默认的 VTU 提供商是 VoiceAndText。您可以在 config/laravel-vtu.php
中设置默认的 SMS 提供商,例如 'default' => \Djunehor\Vtu\Concrete\VoiceAndText::class,
因此您可以像这样使用辅助函数
$send = buy_airtime($amount, $mobileNumber, $mobileNetwork); //$token, $callbackUrl and $class are optional and better set in the config
可用的 VTU 提供商
创建自定义 SMS 提供商
- 创建一个扩展
Djunehor\Vtu\Concrete\Vtu
类的类 - 实现所需的方法(buyAirtime、buyData、PayUtility),这会使出请求并返回布尔值
- (可选) 您可以将提供者密钥添加到
config/laravel-vtu.php
贡献
- 分支此项目
- 克隆您的分支仓库
- 运行
composer install
- 进行更改并运行测试
composer test
- 推送并创建 Pull request