supportkbz/kandmailer

Client PHP pour l'API KandMailer (emails marketing et transactionnels).

Maintainers

Package info

github.com/SupportKBZ/KandMailer

pkg:composer/supportkbz/kandmailer

Statistics

Installs: 94

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v1.4.6 2026-01-28 15:11 UTC

Requires

  • php: ^8.3

Requires (Dev)

MIT 5a3d5a99a6885f5d8a74c82b9e40c835d06c9cac

  • Clément ISELIN <ciselin.woop@kandbaz.com>

emailsdkmarketingkandmailertransactionnel

This package is auto-updated.

Last update: 2026-02-28 15:17:16 UTC

README

PHP Version License Tests

Client PHP léger pour KandMailer

Installation

composer require supportkbz/kandmailer

Usage

Config

use KandMailer\MailerClient;

$client = new MailerClient('your_api_key', 'https://exemple.com');

Tips

Send - Envoi de messages

Utilisez des objets Recipient pour une meilleure flexibilité et type-safety :

use KandMailer\Models\Recipient;

// Envoi simple
$client->template('welcome_email')
       ->sendTo(new Recipient(
           email: 'john@example.com',
           firstName: 'John',
           lastName: 'Doe',
           options: ['lang' => 'en', 'priority' => 'high']
       ));

// Envoi multiple avec des options différentes pour chaque destinataire
$recipients = [
    new Recipient(
        email: 'john@example.com',
        firstName: 'John',
        options: ['lang' => 'en', 'crm' => '111']
    ),
    new Recipient(
        email: 'jane@example.com',
        firstName: 'Jane',
        options: ['lang' => 'fr', 'crm' => '222']
    ),
    new Recipient(
        phone: '+33612345678',
        firstName: 'Bob',
        options: ['lang' => 'en', 'crm' => '333']
    ),
];

$client->template('welcome_email')
       ->sendToMultiple($recipients);

Add - Approche Classique

// Set value
$client->scenario('welcome_scenario');
$client->firstName('John');
$client->lastName('Doe');
$client->email('john@example.com');
$client->phone('+33612345678');
$client->accountId('12345');

// Options, remove, exists
$client->options(['lang' => 'en']);
$client->setRemove(['old_tag']);
$client->setExists(['check_tag']);

// Call
$client->add();

// Chaining
$client->scenario('welcome')
       ->firstName('John')
       ->lastName('Doe')
       ->email('john@example.com')
       ->phone('+33612345678')
       ->add();

Remove - Approche Classique

// Set scenario (required) and email
$client->scenario('welcome_scenario');
$client->email('john@example.com');
$client->remove();

// Set scenario (required) and phone
$client->scenario('welcome_scenario');
$client->phone('+33612345678');
$client->remove();

// Chaining
$client->scenario('welcome_scenario')->email('john@example.com')->remove();

Remove - Approche Orientée Objet

// Suppression d'un contact
$client->removeFrom(new Recipient(
    email: 'john@example.com',
    scenario: 'welcome_sequence'
));

Méthodes avancées

Reset - Réutiliser le client
// Envoyer à plusieurs destinataires avec la même instance
$client->template('newsletter')
       ->email('john@example.com')
       ->options(['lang' => 'en'])
       ->sendSingle();

// Réinitialiser pour un nouvel envoi
$client->reset();

$client->template('newsletter')
       ->email('jane@example.com')
       ->options(['lang' => 'fr'])
       ->sendSingle();

Exigences

  • PHP 8.3+
  • Extension curl

Licence

MIT. Voir le fichier LICENSE.