README

Verimor SMS Laravel 包

基于 Verimor 的 Laravel 短信发送和剩余信用查询包。
文档目录

演示 · 错误 · 需求

关于项目
开始
- 需求
- 将项目添加到您的项目
使用
许可
联系

关于项目

VerimorSms 是一个为 Laravel 创建的简单易用的 SMS 发送包，同时允许您轻松检查项目中的剩余信用。

为什么需要

无需为 Verimor 再次编写辅助函数。
访问 Verimor 提供的所有函数

只需几个简单的命令即可将包添加到项目中，并使用函数进行简单的短信发送。

(返回顶部)

开始

您需要的项目是一个 Laravel 项目。安装后，您可以使用 composer 将其添加到项目中。

需求

Laravel 版本应为 7 或更高。您需要在 Verimor 控制面板中记录您将使用此包的服务器或本地 IP 和 DNS。您可以在 SMS 服务 > SMS 设置部分中进行这些更改。SSL 证书验证必须开启。

请确保您的服务器上安装了最新版本的 cURL。否则，您可能会遇到 500 错误！

此外，API 访问选项也必须开启。如果您在测试短信时发现同一号码多次发送相同的短信，请确保重复发送短信选项开启。

将项目添加

在 Laravel 项目中打开终端，运行以下命令；

composer require theposeidonas/verimor-sms

如果需要，运行以下命令来共享 config 文件；

php artisan vendor:publish --tag=verimor-config --force

然后，为了在 config/app.php 中全局使用 Verimor，请在 'aliases' 部分添加以下代码；

'Verimor' => Theposeidonas\VerimorSms\Facades\Verimor::class,

配置

添加到项目中后，请在 .env 文件中添加以下行并修改；

VERIMOR_USERNAME=908501234567  // API Kullanıcı adı
VERIMOR_PASSWORD=XXXXXXXXX  // API şifreniz
VERIMOR_TITLE=XXXXXX  // SMS Gönderim başlığı (0850XXXXXXX şeklinde numaranız varsayılan başlığınızdır)

(返回顶部)

使用

您需要在控制器中包含此包；

use Theposeidonas\VerimorSms\Facades\Verimor;

在完成所有设置和配置后，您可以在控制器中调用以下函数；

// Kalan kredi kontrolü
$request = Verimor::checkCredit();
$request->credit; // (int) 9999 veya (string) Kullanıcı adı ve şifre geçersiz.
$request->status; // (int) 200 veya (int) 401

// SMS gönderimi (POST)
$request = Verimor::send('Mesajınız', '905312345678');
$request->message; // (string) 20210 veya (string) INSUFFICIENT_CREDITS 
$request->status; // (int) 200 veya (int) 400

// SMS gönderimi (GET)
$request = Verimor::sendGet('Mesajınız', '905312345678');
$request->message; // (string) 20210 veya (string) INSUFFICIENT_CREDITS 
$request->status; // (int) 200 veya (int) 400

// Ekstra parametreler ile SMS gönderimi (POST)
$parameters = [
'source_addr' => 'YENI BASLIK', // Kayıtlı diğer başlıklarınızdan
'valid_for' => '24:00', // SMS geçerlilik saati, SS:DD şeklinde veya S:DD şeklinde
'send_at' => '', // 2023-12-20 16:30:00 şeklinde datetime veya boş
'custom_id' => uniqid(), // Kampanya ID
'datacoding' => 0 // Datacoding
];

$request = Verimor::send('Mesajınız', '905312345678', $parameters);
$request->message; // (string) 20210 veya (string) INSUFFICIENT_CREDITS 
$request->status; // (int) 200 veya (int) 400