PHPackages nfephp-org/sped-mail - 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. nfephp-org/sped-mail ActiveLibrary[Mail & Notifications](/categories/mail) nfephp-org/sped-mail ==================== API para geração e envio dos emails relacionados com o SPED. v1.0.0(4y ago)1123.7k↓40.2%28[1 issues](https://github.com/nfephp-org/sped-mail/issues)GPL-3.0+PHPPHP >= 7.0CI failing Since Oct 12Pushed 3y ago5 watchersCompare [ Source](https://github.com/nfephp-org/sped-mail)[ Packagist](https://packagist.org/packages/nfephp-org/sped-mail)[ Docs](https://github.com/nfephp-org/sped-mail)[ RSS](/packages/nfephp-org-sped-mail/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (8)Versions (9)Used By (0) 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. [![Join the chat at https://gitter.im/nfephp-org/sped-mail](https://camo.githubusercontent.com/b39881a0235df0b0531623d6358a277b4b7bbd00b3a5b03c8da85417abe148d2/68747470733a2f2f6261646765732e6769747465722e696d2f6e66657068702d6f72672f737065642d6d61696c2e737667)](https://gitter.im/nfephp-org/sped-mail?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Actions Status](https://github.com/nfephp-org/sped-ibpt/actions/workflows/ci.yml/badge.svg?style=flat-square)](https://github.com/nfephp-org/sped-gtin/actions) [![Latest Stable Version](https://camo.githubusercontent.com/7b23f4243f4dba0c237d519b2608dc4757bfa845101b39fb02e8e1ab64af40ef/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f737065642d6d61696c2f762f737461626c652e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-mail/releases)[![Latest Version on Packagist](https://camo.githubusercontent.com/a6850bb31474e38582a11cdee2b14cedf82cbd67fe977649e2336a1cefdf6c26/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e66657068702d6f72672f737065642d6d61696c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-mail)[![License](https://camo.githubusercontent.com/e0273385d246b6a90332d858facac88177613ea018b9a21e402ffad0d613f302/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f6e66657068702f6c6963656e73652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-mail)[![Total Downloads](https://camo.githubusercontent.com/42cc5bed89a7fc09ed2482f5c73c665559de3ac721c0e1fadafd10268b51a0e3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e66657068702d6f72672f737065642d6d61696c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-mail) [![Issues](https://camo.githubusercontent.com/98a3d01184c5e60c225502da3b81066f29040a5d9ea532423402b12186570e22/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6e66657068702d6f72672f737065642d6d61696c2e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-mail/issues)[![Forks](https://camo.githubusercontent.com/b745d748b74c384838b62068526870ba1882f2185f2c87aad8470e4329308303/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6e66657068702d6f72672f737065642d6d61696c2e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-mail/network)[![Stars](https://camo.githubusercontent.com/efceb341d5f93bdd428bc26855b10b3ab1aacb54e4263c4c745325c8bef5af36/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e66657068702d6f72672f737065642d6d61696c2e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-mail/stargazers) Como instalar : =============== [](#como-instalar-) Adicione este pacote com o composer, por linha de comando: ``` composer require nfephp-org/sped-mail ``` Ou adicione ao seu composer.json: ``` { "require": { "nfephp-org/sped-mail": "^1.0" } } ``` Como usar : =========== [](#como-usar-) Essa classe pode ser usada de duas formas distintas. 1 - Usando o método estatico: ----------------------------- [](#1---usando-o-método-estatico) ``` $resp = Mail::sendMail($config, $xml, $pdf, $addresses, $template, $pfx, $password, $mailer); ``` Onde : $config é um stdClass contendo as configuração de seu SMTP (OBRIGATÓRIO) ``` $config = new stdClass(); $config->smtpdebug = 0; //0-no 1-client 2-server 3-connection 4-lowlevel $config->host = 'smtp.example.com.br'; $config->port = 587; //25 ou 465 ou 587 $config->smtpauth = true; $config->user = 'fulano@example.com.br'; $config->password = 'senha'; $config->secure = 'tls'; $config->authtype = ''; //'', CRAM-MD5, PLAIN, LOGIN, XOAUTH2 $config->from = 'fulano@example.com.br'; $config->fantasy = 'Fulanoda Silva'; $config->replyTo = 'ciclano@mail.com'; $config->replyName = 'Ciclano Moreira'; $config->smtpoptions = null; /*[ 'ssl' => [ 'verify_peer' => true, 'verify_depth' => 3, 'allow_self_signed' => true, 'peer_name' => 'smtp.example.com', 'cafile' => '/etc/ssl/ca_cert.pem', ] ];*/ $config->timeout = 130; ``` $xml é o path ou o conteudo do xml que se deseja enviar (OBRIGATÓRIO) ``` $xml = '../nfe.xml'; ``` ou ainda ``` $xml = file_get_contents('../nfe.xml'); ``` Idem para o $pdf (OPCIONAL) ``` $pdf = '../nfe.pdf'; ``` ou ainda ``` $pdf = file_get_contents('../nfe.pdf'); ``` $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) ``` $addresses = ['fulano@client.com.br']; ``` 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 ``` $template = 'Meu HTML {emitente} .... '; ``` O pfx é o conteudo do certificado pfx (OPCIONAL), que pode ser lido de um arquivo ou diretamente da sua base de dados. ``` $pfx = file_get_contents('path ao certificado pfx'); ``` 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. ``` $password = 'senha'; ``` O último parametro é uma instácia já existente do PHPMailer. ``` $mailer = new PHPMailer(); ``` Para maiores detalhes veja os exemplos indicados na pasta examples. > #### NOTA: Em caso de falha será retornado um EXCEPTION > > [](#nota-em-caso-de-falha-será-retornado-um-exception) Como enviar para vários destinatários ===================================== [](#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 ---------------------------------------------------------------- [](#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. ``` fulano@yahoo.com.br ``` 2 - Passando os endereços adicionais em um array nesta classe ------------------------------------------------------------- [](#2---passando-os-endereços-adicionais-em-um-array-nesta-classe) Essa forma já foi indicada acima na variável $addresses = \[ ... \]; [Documentação](docs/Mail.md) ============================ [](#documentação) ### Health Score 38 — LowBetter than 85% of packages Maintenance18 Infrequent updates — may be unmaintained Popularity39 Limited adoption so far Community20 Small or concentrated contributor base Maturity63 Established project with proven stability Bus Factor1 Top contributor holds 90.2% 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. ### Release Activity Cadence Every ~261 days Recently: every ~410 days Total 8 Last Release 1676d ago Major Versions v0.1.6 → v1.0.02021-10-15 PHP version history (2 changes)v0.1.0PHP ~5.6|~7.0 v0.1.4PHP >= 7.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/83b3feccdc04943c30ac9b785307cb73385c30d5b3ad8a7c700f7704416dc280?d=identicon)[robmachado](/maintainers/robmachado) --- Top Contributors [![robmachado](https://avatars.githubusercontent.com/u/1437008?v=4)](https://github.com/robmachado "robmachado (120 commits)")[![rabraga](https://avatars.githubusercontent.com/u/16154651?v=4)](https://github.com/rabraga "rabraga (7 commits)")[![guicalabria](https://avatars.githubusercontent.com/u/2413349?v=4)](https://github.com/guicalabria "guicalabria (3 commits)")[![geovanent](https://avatars.githubusercontent.com/u/21218952?v=4)](https://github.com/geovanent "geovanent (1 commits)")[![gitter-badger](https://avatars.githubusercontent.com/u/8518239?v=4)](https://github.com/gitter-badger "gitter-badger (1 commits)")[![vvamondes](https://avatars.githubusercontent.com/u/4061784?v=4)](https://github.com/vvamondes "vvamondes (1 commits)") --- Tags nfsenfephpsped ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP\_CodeSniffer Type Coverage Yes ### Embed Badge ![Health badge](/badges/nfephp-org-sped-mail/health.svg) ``` [![Health](https://phpackages.com/badges/nfephp-org-sped-mail/health.svg)](https://phpackages.com/packages/nfephp-org-sped-mail) ``` ### Alternatives [nfephp-org/sped-nfe API para geração e comunicação da NFe e NFCe com as SEFAZ autorizadoras. 1.4k1.4M10](/packages/nfephp-org-sped-nfe)[nfephp-org/sped-da sped-da contêm as classes para criação dos documentos auxiliares referidos no projeto Sped. 145806.7k8](/packages/nfephp-org-sped-da)[nfephp-org/sped-cte API para geração e comunicação da CTe com as SEFAZ autorizadoras. 113227.7k1](/packages/nfephp-org-sped-cte)[nfephp-org/sped-nfse-ginfes API para geração e comunicação de RPS e NFSe no padão Ginfes. 434.7k](/packages/nfephp-org-sped-nfse-ginfes)[lucas-simoes/php-nfse API para geração e comunicação da NFSe com as Prefeituras. Este é um fork do projeto nfephp-org/sped-nfse que foi descontinuado 572.3k](/packages/lucas-simoes-php-nfse)[nfephp-org/sped-mdfe API para geração e comunicação da MDFe com as SEFAZ autorizadoras. 50135.1k](/packages/nfephp-org-sped-mdfe) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)