راهنمای ارسال پیامک با PHP

کتابخانه ارسال پیامک PHP با وب سرویس قاصدک

وب‌سرویس پیام کوتاه قاصدک، یک سرویس ارسال و دریافت پیام کوتاه از طریق REST API برای ارسال پیامک‌های وب‌سرویسی است.

تلاش قاصدک در این سرویس بر ارائه‌ی خدمات با کیفیت، قابل اتکا و ساده به کاربرانش می باشد. در این قسمت راهنمای ساده برای ارسال و دریافت پیامک از طریق کتابخانه قاصدک برای php آماده کردیم.

نحوه نصب کتابخانه php

کتابخانه ghasedak رو به سادگی می توانید از روی composer نصب کنید :

    
        composer require ghasedaksms/php

نحوه استفاده از کتابخانه نصب شده

بعد از این مرحله نیاز هست که یک Instance از Ghasedak بسازید و کلید API خود را به این متد پاس دهید. اگر کلید API ندارید، می توانید بعد از ثبت نام این کلید را دریافت کنید و البته برای کاربران تازه، مقداری اعتبار رایگان برای تست در نظر گرفته شده است :

    
        require __DIR__ . '/vendor/autoload.php';

        $ghasedaksms = new GhasedaksmsApi('your_api_key');

سپس می توانید به سادگی پیام خود را به شماره مورد نظر ارسال کنید :

    
        $sendDate = new DateTimeImmutable('now');
        $lineNumber = '3000****';
        $receptor = '093596****';
        $message = 'test';
        try {
        $response = $ghasedaksms->sendSingle(new SingleMessageDTO(
        sendDate: $sendDate,
        lineNumber: $lineNumber,
        receptor: $receptor,
        message: $message
        ));
        var_dump($response);
        } catch (ExceptionsGhasedakSMSException $e) {
        var_dump($e->getMessage());
        }

تو این مثال تنها نیاز دارید که مقادیر مورد نظر خود را تغییر بدید.

قاصدک در گیت هاب

با استفاده از این کتابخانه می توانید از عملیات های مختلفی مثل ارسال پیامک‌های ساده، ارسال پیامک otp، ارسال پیامک گروهی و سایر خدمات قاصدک استفاده کنید. برای اینکار می توانید به صفحه‌ی کتابخانه روی گیت هاب بروید، البته مستندات وب سرویس قاصدک هم می تواند راه استفاده از قاصدک برای زبان های برنامه نویسی مختلف را برای شما ساده تر نماید.

Ghasedak for php

Ghasedak sms webservice package for php

Installation

The easiest way to install by using Composer:

    
        composer require ghasedaksms/php:"dev-master"

Usage

You need a Ghasedak account. Register and get your API key.

Create an instance from Ghasedak class with your API key:

Instance

 
    
        require __DIR__ . '/vendor/autoload.php';

        $ghasedaksms = new GhasedaksmsApi('your_api_key');

Send Verify SMS

 
    
        $sendDate = new DateTimeImmutable('now');
        try {
        $response = $ghasedaksms->sendOtpWithParams(new OtpMessageWithParamsDTO(
        sendDate: $sendDate,
        receptors: [
        new ReceptorDTO(
        mobile: '0912*******',
        clientReferenceId: '1'
        )
        ],
        templateName: 'newOtp',
        param1: 'param1',
        param2: 'param2'
        ));
        var_dump($response);
        } catch (Exceptions\GhasedakSMSException $e) {
        var_dump($e->getMessage());
        }

Send Single SMS

 
    
        $sendDate = new DateTimeImmutable('now');
        $lineNumber = '3000****';
        $receptor = '0912*******';
        $message = 'test';
        try {
        $response = $ghasedaksms->sendSingle(new SingleMessageDTO(
        sendDate: $sendDate,
        lineNumber: $lineNumber,
        receptor: $receptor,
        message: $message
        ));
        var_dump($response);
        } catch (Exceptions\GhasedakSMSException $e) {
        var_dump($e->getMessage());
        }

Done!