Download the PHP package nfephp-org/sped-mail without Composer
On this page you can find all versions of the php package nfephp-org/sped-mail. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download nfephp-org/sped-mail
More information about nfephp-org/sped-mail
Files in nfephp-org/sped-mail
Package sped-mail
Short Description API para geração e envio dos emails relacionados com o SPED.
License GPL-3.0+ LGPL-3.0+ MIT
Homepage https://github.com/nfephp-org/sped-mail
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package sped-mail
sped-mail
O envio de emails é parte integrante das necessidades de quem opera com os serviços SPED.
De acordo com a legislação é obrigatório o envio de emails contendo os xml das NFe e dos CTe aos seus repectivos destinatários.
Alguns destinatários, erroneamente, pedem também que seja enviado o PDF relativo ao Documento Auxiliar (DANFE, DACTE ou DACCE) em anexo a esse email.
Outros requerem que os emails seja enviados a várias caixas postais.
Esta parte da API se destina a prover essa facilidade, caso se deseje.
Como instalar :
Adicione este pacote com o composer, por linha de comando:
Ou adicione ao seu composer.json:
Como usar :
Essa classe pode ser usada de duas formas distintas.
1 - Usando o método estatico:
Onde : $config é um stdClass contendo as configuração de seu SMTP (OBRIGATÓRIO)
$xml é o path ou o conteudo do xml que se deseja enviar (OBRIGATÓRIO)
ou ainda
Idem para o $pdf (OPCIONAL)
ou ainda
$address é um array contendo os endereços de email para quem você deseja enviar a mensagem. Essas listas de email serão verificadas e os endereços que não forem validos serão descartados. Se não for passada uma lista de endereços o sistema irá procurar no XML pelos endereços e esses serão usados, se existirem. (OPCIONAL)
O template usado pode ser substituido pelo de sua escolha, usando o parametro $template (OPCIONAL). Use como referencia os templates padrões para criar o seu veja isso na classe Base.php
O pfx é o conteudo do certificado pfx (OPCIONAL), que pode ser lido de um arquivo ou diretamente da sua base de dados.
Password é a senha do certificado pfx para que possa ser usado (OPCIONAL), é claro que se o certificado for passado a senha também severá ser passada.
O último parametro é uma instácia já existente do PHPMailer.
Para maiores detalhes veja os exemplos indicados na pasta examples.
NOTA: Em caso de falha será retornado um EXCEPTION
Como enviar para vários destinatários
Pordemos enviar os emails para vários destinatários basicamente de duas maneiras diferentes:
1 - Indicando todos os destinatários no próprio XML do documento
Neste caso podemos fazer uso da tag <obsCont> podem existir dezenas desses campos no xml, essa com certeza é a manira mais inteligente de indicar vários destinários, pois podem ser lidos diretamente do xml.
Veja que o tipo do campo xCampo="email" passa a ser obrigatório para que possamos identificar que este campo indica um email.
2 - Passando os endereços adicionais em um array nesta classe
Essa forma já foi indicada acima na variável $addresses = [ ... ];
Documentação
All versions of sped-mail with dependencies
ext-dom Version *
phpmailer/phpmailer Version ^6.1
soundasleep/html2text Version ~0.3
nfephp-org/sped-common Version ^5.0