mailifica/mailifica-php

Official PHP SDK for Mailifica Email Infrastructure Platform

v1.0.1 2026-08-31 10:33 UTC

Requires

• php: >=8.1
• ext-json: *
• guzzlehttp/guzzle: ^7.5

Requires (Dev)

• phpunit/phpunit: ^10.0 || ^11.0

MIT

• Mailifica

• api
• email
• sdk
• transactional
• resend
• mailifica

Published on Packagist.org on 2026-08-31 11:29 UTC

README

SDK oficial em PHP para a infraestrutura de e-mails transacionais Mailifica, com interface fluida e compatível com o Resend PHP SDK.

📦 Instalação

Instale o pacote via Composer:

composer require mailifica/mailifica-php

🚀 Como Usar

1. Inicializar o Cliente

use Mailifica\Mailifica;

// Inicialização com a chave de API
$mailifica = new Mailifica('ma_live_123456789');

// Ou através do método estático auxiliar (lê MAILIFICA_API_KEY se omitido):
$mailifica = Mailifica::client();

2. Enviar um E-mail Transacional

$response = $mailifica->emails->send([
    'from' => '[e-mail]',
    'to' => ['[e-mail]'],
    'subject' => 'Boas-vindas à Mailifica!',
    'html' => '<h1>Olá!</h1><p>Seu e-mail transacional foi entregue com sucesso.</p>',
]);

echo 'E-mail enviado! ID: ' . $response['id'];

3. Envio em Lote (Batch)

$response = $mailifica->batch->send([
    [
        'from' => '[e-mail]',
        'to' => '[e-mail]',
        'subject' => 'Atualização Semanal #1',
        'html' => '<p>Conteúdo da newsletter 1</p>',
    ],
    [
        'from' => '[e-mail]',
        'to' => '[e-mail]',
        'subject' => 'Atualização Semanal #2',
        'html' => '<p>Conteúdo da newsletter 2</p>',
    ],
]);

print_r($response);

4. Gestão de Domínios & API Keys

// Criar novo domínio
$domain = $mailifica->domains->create([
    'name' => 'suaempresa.ao',
]);

// Verificar registros DNS
$verified = $mailifica->domains->verify($domain['id']);

// Listar API Keys
$apiKeys = $mailifica->apiKeys->list();

5. Validação de Webhooks HMAC SHA-256

use Mailifica\Services\Webhooks;

$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_MAILIFICA_SIGNATURE'] ?? '';
$secret = getenv('MAILIFICA_WEBHOOK_SECRET');

// Validar assinatura
$isValid = Webhooks::verifySignature($payload, $signature, $secret);

if (!$isValid) {
    http_response_code(400);
    exit('Invalid signature');
}

// Obter dados do evento
$event = Webhooks::constructEvent($payload, $signature, $secret);
echo 'Evento recebido: ' . $event['event'];

🧪 Testes

Para rodar os testes unitários do SDK:

composer test
# ou
vendor/bin/phpunit

📄 Licença

Distribuído sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

Copyright (c) 2026 Mailifica.