douglasmariz/email-twig-pdf

Email-Twig-PDF 是一个用于提交电子邮件、生成 PDF 并使用 Twig 渲染模板的抽象类。

1.0.3 2018-08-11 21:59 UTC

This package is not auto-updated.

Last update: 2024-09-27 00:45:50 UTC


README

PHP 邮件类:用于发送邮件的库。包括 "swiftmailer", "twig" 和 "html2pdf"。

Email-Twig-PDF 是一个用于提交电子邮件、生成 PDF 并使用 Twig 渲染模板的抽象类。

如何使用

文件和文件夹配置

Verifique se os modelos existem no diretório base: "{DIRETORIO_BASE}/templates/email/{feature}/{fileName}".
Se não existir, crie o(s) modelo(s) com extensões {.html.twig} para enviar mensagens HTML e {.text.twig} para uma mensagem simples sem tags html.

EmailTwigPdf_Config 类

Você pode configurar um diretório base para armazenar os templates.
Ex: $config = new EmailTwigPdf_Config(['template_path' => __DIR__.'/your-path']);

OBS: Deve seguir a seguinte estrutura:
DIRETORIO_BASE
    templates
        email

EmailTwigPdf_Auth 类

Classe para colocar suas credenciais de acesso ao email do remetente.
Ex: 
    $credentials = [
            'userName' => 'user_name',
            'password' => 'password',
            'from' => 'email@gmail.com',
            'fromName' => 'from_name',
            'smtp' => 'smtp.email.com',
            'port' => 465,
            'encryption' => 'ssl',
        ];
        $auth = new EmailTwigPdf_Auth($credentials);

示例模板

Já existe uma pasta chamada "templates" com um modelo default, de exemplo.

简单使用类

require_once('vendor/autoload.php');

use \DouglasMariz\Email\Twig\Pdf\EmailTwigPdf_Email;
use \DouglasMariz\Email\Twig\Pdf\EmailTwigPdf_Auth;
use \DouglasMariz\Email\Twig\Pdf\EmailTwigPdf_Config;

try {
    $email = new EmailTwigPdf_Email($auth, $config);
    $context = [
        'nome' => 'Usuário',
        'titulo' => 'Título',
        'mensagem' => 'Lorem ipsum dolor sit amet, consectetur adipisicing elit.
                        Blanditiis cum debitis et expedita fugit hic iure laboriosam laudantium.',
    ];
    $result = $email->setTo('email@gmail.com', 'Nome Destinatário')
        ->setSubject('Assunto do email')
        ->setTemplateFile('pasta-arquivo', $context)
        ->setCssFile('pasta-arquivo')
        ->setDateHour() //Adiciona ao template a data e hora no formato pt_BR, apenas se existir no template as variáveis {{data}} e {{hora}}
        ->pdf()
        ->sendMail();

} catch (Exception $e) {
    echo $e->getMessage();
}

实用工具

$email->pdf(); // Para gerar um arquivo PDF e enviar como anexo ao email.
$email->setFileNamePdf(); // Define o nome para o arquivo PDF.
$email->setBlock(); // Define o BLOCO que será utilizado no template, caso esteja definido
    EX:
        {% if block == 'default' %}
            {% block default %}
                {{ content }}
            {% endblock %}
        {% endif %}
        
$email->showTemplateText(); // Renderiza na tela o template.
$email->showTemplateHtml(); // Renderiza na tela o template.