bitmoro/bitmoropackage

该包的最新版本(dev-main)没有可用的许可证信息。

一个提供bitmoro消息服务功能的包

dev-main 2024-08-29 06:32 UTC

This package is not auto-updated.

Last update: 2024-09-27 05:45:31 UTC


README

此PHP包提供了一种方便的方式将Bitmoro消息服务集成到项目中,包括发送短信、调度短信和处理OTP(一次性密码)操作。

安装

要使用此包,您需要在项目中包含它。如果已在Packagist上发布,您可以通过Composer安装它

composer require bitmoro/bitmoro-package

或者,您可以克隆存储库,并将文件直接包含到项目中。

使用

初始设置

首先,您需要包含包,并使用您的Bitmoro API令牌初始化主类

require 'vendor/autoload.php'; // If using Composer

use Bitmoro\BitmoroPackage\MessageSender;
use Bitmoro\BitmoroPackage\MessageScheduler;
use Bitmoro\BitmoroPackage\OtpHandler;

$token = 'your-api-token-here'; // Replace with your Bitmoro API token

$messageSender = new MessageSender($token);
$messageScheduler = new MessageScheduler($token);
$otpHandler = new OtpHandler($token);

发送短信

您可以按照以下方式发送简单的短信消息

$message = "Hello, this is a test message.";
$number = "0123456789"; // Replace with a valid phone number
$senderId = "MD_Alert" ;

$result = $messageSender->sendSms($message, $number, $senderId);
echo $result ? "SMS sent successfully\n" : "Failed to send SMS\n";

调度短信

您可以将短信调度到未来的某个时间发送

$futureTime = date('Y-m-d H:i:s', strtotime('+1 minute')); // Set to one minute in the future
$messageScheduler->scheduleSms("Scheduled message", $number, $futureTime, $senderId);

发送OTP

向手机号码发送OTP

$otpResult = $otpHandler->sendOtpMessage("0123456789", $senderId); // replace with real phone number
echo $otpResult ? "OTP sent successfully\n" : "Failed to send OTP\n";

验证OTP

验证收到的OTP

$isOtpValid = $otpHandler->verifyOtp("0123456789", "9601903565"); // Replace with the actual OTP received
echo $isOtpValid ? "OTP is valid\n" : "OTP is invalid\n";

异常处理

每个方法调用都被try-catch块包裹,以便优雅地处理异常

try {
    // Your code here
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}

要求

  • PHP 7.2或更高版本
  • PHP中启用了cURL扩展

许可证

此包是开源软件,根据MIT许可证授权。