alikhalaj/sms

Package for SMS system with support for multiple gateways (SMS.ir, Kavenegar, RayanSms)

1.1.0 2025-12-31 20:03 UTC

Requires

• php: ^7.4|^8.0|^8.1|^8.2|^8.3
• illuminate/http: ^8.0|^9.0|^10.0|^11.0
• illuminate/support: ^8.0|^9.0|^10.0|^11.0

Requires (Dev)

• mockery/mockery: ^1.0
• orchestra/testbench: ^6.0|^7.0|^8.0
• phpunit/phpunit: ^9.0|^10.0

MIT

• alikhalaj

• sms
• laravel
• otp
• verification
• kavenegar
• sms.ir
• rayansms

README

پکیج کامل برای ارسال پیامک با پشتیبانی از چندین درگاه (SMS.ir, Kavenegar, RayanSms)

نصب

composer require alikhalaj/sms

پیکربندی

پس از نصب، فایل کانفیگ را publish کنید:

php artisan vendor:publish --provider="Leenset\Sms\SmsServiceProvider8" --tag="config"

سپس در فایل .env خود تنظیمات زیر را اضافه کنید:

SMS_CONNECTION=smsir

# تنظیمات SMS.ir
SMS_API_KEY=your-api-key
SMS_API_SECRET_KEY=your-secret-key
SMS_API_URL=https://ws.sms.ir/
SMS_LINE_NUMBER=10001001
SMS_TEMPLATE_ID=424974

# تنظیمات Kavenegar
KAVENEGAR_API_KEY=your-api-key
KAVENEGAR_API_URL=https://api.kavenegar.com/v1/
KAVENEGAR_NUMBER=10001001
KAVENEGAR_VERIFICATION_TEMPLATE=template-name

# تنظیمات RayanSms
RAYANSMS_API_KEY=your-api-key
RAYANSMS_API_URL=https://rayansms.com/api/

استفاده

استفاده از Facade

use Leenset\Sms\Sms;

// ارسال پیامک ساده
Sms::send('متن پیامک', '09123456789');

// ارسال کد OTP
Sms::OTP('123456', '09123456789');

// ارسال کد تأیید (برای SMS.ir)
Sms::verificationCode('123456', '09123456789');

استفاده مستقیم از Resolver

use Leenset\Sms\SmsResolver;

$sms = new SmsResolver();
$sms->make('kavenegar')->send('متن پیامک', '09123456789');

تغییر درگاه

// استفاده از درگاه خاص
Sms::make('kavenegar')->send('متن پیامک', '09123456789');
Sms::make('rayansms')->OTP('123456', '09123456789');

درگاه‌های پشتیبانی شده

SMS.ir

• send($message, $mobileNumber) - ارسال پیامک ساده
• OTP($code, $mobileNumber, $templateId) - ارسال کد OTP
• verificationCode($code, $mobileNumber) - ارسال کد تأیید

Kavenegar

• send($message, $mobileNumber) - ارسال پیامک ساده
• OTP($code, $mobileNumber, $template) - ارسال کد OTP
• VerifyLookup($mobileNumber, $template, ...$tokens) - ارسال با چندین توکن

RayanSms

• send($message, $mobileNumber) - ارسال پیامک ساده
• OTP($code, $mobileNumber, $template) - ارسال کد OTP
• verificationCode($code, $mobileNumber) - ارسال کد تأیید

تست

برای اجرای تست‌ها:

composer test

یا:

./vendor/bin/phpunit

نیازمندی‌ها

• PHP >= 7.4
• Laravel >= 8.0

مجوز

MIT License

نویسنده

alikhalaj - [e-mail]