PHPackages                             atima/php-email-lib - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. atima/php-email-lib

ActiveLibrary[Mail & Notifications](/categories/mail)

atima/php-email-lib
===================

Cliente PHP puro para envio de e-mails via API HTTP customizada (sem dependências de framework)

01PHP

Since Mar 24Pushed 3mo agoCompare

[ Source](https://github.com/Barbosalb96/ati-mailer-puro)[ Packagist](https://packagist.org/packages/atima/php-email-lib)[ RSS](/packages/atima-php-email-lib/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependenciesVersions (1)Used By (0)

ATI PHP Email Lib
=================

[](#ati-php-email-lib)

Cliente PHP puro para envio de e-mails via API HTTP customizada. Sem dependências de framework — funciona em qualquer projeto PHP 8.1+.

Instalação
----------

[](#instalação)

```
composer require atima/php-email-lib
```

Requer as extensões PHP `ext-curl` e `ext-json`.

---

Configuração
------------

[](#configuração)

### Via array (recomendado para uso direto)

[](#via-array-recomendado-para-uso-direto)

```
use Atima\PhpEmailLib\AtiMailer;

$mailer = new AtiMailer([
    'key'      => 'sua_api_key',
    'endpoint' => 'https://api.seuservico.com',
    'staging'  => true,
    'ssl_cert' => true,    // true, false, ou caminho para .pem
    'timeout'  => 30,
]);
```

### Via variáveis de ambiente

[](#via-variáveis-de-ambiente)

Copie `.env.example` e preencha as variáveis, então:

```
$mailer = AtiMailer::fromEnv();
```

Variáveis suportadas:

VariávelPadrãoDescrição`ATI_EMAIL_KEY`—Chave de autenticação (obrigatória)`ATI_EMAIL_ENDPOINT`—URL base da API (obrigatória)`ATI_STAGING``true`Modo staging (true/false)`ATI_SSL_CERT``true`SSL: true, false ou caminho para .pem`ATI_EMAIL_TIMEOUT``30`Timeout em segundos---

Uso
---

[](#uso)

### E-mail simples

[](#e-mail-simples)

```
use Atima\PhpEmailLib\AtiMessage;

$mailer->send(
    AtiMessage::create()
        ->to('destinatario@exemplo.com')
        ->subject('Olá!')
        ->html('Olá, mundo!')
);
```

### Múltiplos destinatários e campos opcionais

[](#múltiplos-destinatários-e-campos-opcionais)

```
$mailer->send(
    AtiMessage::create()
        ->to(['user1@exemplo.com', 'user2@exemplo.com'])
        ->cc('copia@exemplo.com')
        ->bcc('oculto@exemplo.com')
        ->from('remetente@exemplo.com', 'Meu Sistema')
        ->replyTo('respostas@exemplo.com')
        ->subject('Relatório diário')
        ->html('RelatórioSegue em anexo.')
        ->text('Relatório — veja o arquivo em anexo.')
);
```

### Com anexo de arquivo

[](#com-anexo-de-arquivo)

```
$mailer->send(
    AtiMessage::create()
        ->to('cliente@exemplo.com')
        ->subject('Nota fiscal')
        ->html('Segue a nota fiscal em anexo.')
        ->attach('/var/www/storage/nf-1234.pdf')
);
```

### Com anexo gerado em memória

[](#com-anexo-gerado-em-memória)

```
$csvData = "nome,email\nJoão,joao@exemplo.com";

$mailer->send(
    AtiMessage::create()
        ->to('analista@exemplo.com')
        ->subject('Exportação')
        ->html('Exportação em anexo.')
        ->attachData($csvData, 'usuarios.csv', 'text/csv')
);
```

---

Tratamento de erros
-------------------

[](#tratamento-de-erros)

```
use Atima\PhpEmailLib\Exception\AtiMailException;

try {
    $mailer->send($message);
} catch (AtiMailException $e) {
    echo $e->getMessage();      // mensagem de erro
    echo $e->getHttpStatus();   // código HTTP (ex: 401, 500)
    echo $e->getResponseBody(); // corpo da resposta da API
} catch (\InvalidArgumentException $e) {
    echo 'Dados inválidos: ' . $e->getMessage();
}
```

---

Estrutura
---------

[](#estrutura)

```
src/
├── AtiMailer.php         # Cliente principal (configuração + envio via cURL)
├── AtiMessage.php        # Builder fluente para compor e-mails
├── AtiAttachment.php     # Helper para anexos (arquivo ou dados em memória)
└── Exception/
    └── AtiMailException.php  # Exceção com httpStatus e responseBody

```

###  Health Score

19

—

LowBetter than 9% of packages

Maintenance55

Moderate activity, may be stable

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/65544563?v=4)[Barbosalb96](/maintainers/Barbosalb96)[@Barbosalb96](https://github.com/Barbosalb96)

---

Top Contributors

[![Barbosalb96](https://avatars.githubusercontent.com/u/65544563?v=4)](https://github.com/Barbosalb96 "Barbosalb96 (2 commits)")

### Embed Badge

![Health badge](/badges/atima-php-email-lib/health.svg)

```
[![Health](https://phpackages.com/badges/atima-php-email-lib/health.svg)](https://phpackages.com/packages/atima-php-email-lib)
```

###  Alternatives

[mattketmo/email-checker

Throwaway email detection library

2752.1M5](/packages/mattketmo-email-checker)[sarfraznawaz2005/noty

Laravel package to incorporate noty flash notifications into laravel.

324.5k](/packages/sarfraznawaz2005-noty)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)