pippa/notification-sdk-curl

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

v1.0.9 2026-06-22 04:41 UTC

Requires

• php: ^8.1

Requires (Dev)

• phpunit/phpunit: ^10.0|^11.0

MIT

• Rajoni Akter

Published on Packagist.org on 2026-06-22 04:41 UTC

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 WhatsApp

$response = $client->sendWhatsapp(
    whatsapp: '[phone]',
    template: 'whatsapp_template',
    data:     ['name' => 'Rahim']
);

Send Push Notification

$response = $client->sendPush(
    push:     'device_token_or_user_id',
    template: 'push_template',
    data:     ['title' => 'Hello!', 'body' => 'You have a new message.']
);

Send In-App Notification

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

Send Slack

$response = $client->sendSlack(
    slack:    '#general',
    template: 'slack_alert',
    data:     ['message' => 'Deployment successful!']
);

Send Discord

$response = $client->sendDiscord(
    discord:  'channel_id_or_webhook',
    template: 'discord_alert',
    data:     ['message' => 'New order received!']
);

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'),
                Recipient::whatsapp('[phone]'),
                Recipient::push('device_token'),
                Recipient::slack('#general'),
                Recipient::discord('channel_id'),
            ],
            '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
sendWhatsapp($whatsapp, $template, $data)	Send WhatsApp message
sendPush($push, $template, $data)	Send push notification
sendInApp($userId, $template, $data)	Send in-app notification
sendSlack($slack, $template, $data)	Send Slack message
sendDiscord($discord, $template, $data)	Send Discord message
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::whatsapp('[phone]')
Recipient::push('device_token')
Recipient::slack('#general')
Recipient::discord('channel_id')
Recipient::make(['email' => '...', 'phone' => '...', 'user_id' => '...'])
Recipient::make([...])->only(['email', 'sms'])

License

MIT