pippa/notification-sdk-curl

Notification Service SDK for plain PHP — zero dependencies, pure cURL

1.0.3 2026-05-07 03:40 UTC

Requires

• php: ^8.1

Requires (Dev)

• phpunit/phpunit: ^10.0|^11.0

MIT

• Rajoni Akter

README

Pure PHP SDK for the Notification Service API.
Zero dependencies — works in any PHP 8.1+ environment without Laravel or Guzzle.

Installation

composer require Pippa\notification-sdk-curl

Setup

<?php
require 'vendor/autoload.php';

use Pippa\NotificationSdkCurl\NotificationClient;

$client = new NotificationClient(
    apiKey:    'your_api_key',
    secretKey: 'your_secret_key',
);

Usage

Send Email

$response = $client->sendEmail(
    email:    '[e-mail]',
    template: 'welcome_email',
    data:     ['name' => 'Rahim']
);

Send SMS

$response = $client->sendSms(
    phone:    '[phone]',
    template: 'otp_sms',
    data:     ['otp' => '1234']
);

Send In-App Notification

$response = $client->sendInApp(
    userId:   'user_123',
    template: 'order_update',
    data:     ['order_id' => 'ORD-456', 'status' => 'Shipped']
);

Multi-channel (Courier-style)

use Pippa\NotificationSdkCurl\Requests\SendMessageRequest;
use Pippa\NotificationSdkCurl\DTOs\TemplateMessage;
use Pippa\NotificationSdkCurl\DTOs\Recipient;

$response = $client->send(
    new SendMessageRequest([
        'message' => new TemplateMessage([
            'to' => [
                Recipient::email('[e-mail]'),
                Recipient::phone('[phone]'),
                Recipient::userId('user_123'),
            ],
            'template' => 'welcome_notification',
            'data'     => ['name' => 'Rahim'],
        ]),
    ])
);

if ($response->isSuccess()) {
    echo 'Sent! ID: ' . $response->getRequestId();
}

Exception Handling

use Pippa\NotificationSdkCurl\Exceptions\NotificationException;

try {
    $client->sendEmail('[e-mail]', 'my_template');
} catch (NotificationException $e) {
    echo $e->getMessage();   // error message
    echo $e->getCode();      // HTTP status code
    print_r($e->getErrors()); // validation errors array
}

Available Methods

Method	Description
send(SendMessageRequest)	Full control
sendEmail($email, $template, $data)	Send email via template
sendSms($phone, $template, $data)	Send SMS via template
sendInApp($userId, $template, $data)	Send in-app notification
sendMulti($recipients[], $template, $data)	Multi-channel, multi-recipient

Recipient Helpers

use Pippa\NotificationSdkCurl\DTOs\Recipient;

Recipient::email('[e-mail]')
Recipient::phone('[phone]')
Recipient::userId('user_123')
Recipient::make(['email' => '...', 'phone' => '...', 'user_id' => '...'])
Recipient::make([...])->only(['email', 'sms'])  // restrict channels

License

MIT