djunehor/laravel-vtu

购买话费、数据套餐以及支付水电费

dev-master 2020-01-13 17:06 UTC

This package is auto-updated.

Last update: 2024-09-09 14:36:16 UTC


README

CircleCI Latest Stable Version Total Downloads License Build Status Scrutinizer Code Quality Code Coverage

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