php mime mail parser
9.0.1
Um analisador de e-mail totalmente testado para PHP 8.0+ (wrapper de extensão mailparse).
É o analisador de e-mail PHP mais eficaz em termos de desempenho, codificação de caracteres estrangeiros, tratamento de anexos e facilidade de uso. Formato de mensagem da Internet RFC 822, 2822, 5322.
Esta extensão pode ser usada para...
.eml )Sim. Todos os problemas conhecidos foram reproduzidos, corrigidos e testados.
Usamos GitHub Actions, Codecov, Codacy para ajudar a garantir a qualidade do código. Você pode ver estatísticas em tempo real abaixo:
A maneira mais fácil é através do Composer.
Para instalar a versão mais recente do PHP MIME Mail Parser, execute o comando abaixo:
composer require php-mime-mail-parser/php-mime-mail-parser
As seguintes versões do PHP são suportadas:
Versões anteriores:
| Compatibilidade PHP | Versão |
|---|---|
| HHVM | php-mime-mail-parser 2.11.1 |
| PHP 5.4 | php-mime-mail-parser 2.11.1 |
| PHP 5.5 | php-mime-mail-parser 2.11.1 |
| PHP 5.6 | php-mime-mail-parser 3.0.4 |
| PHP 7.0 | php-mime-mail-parser 3.0.4 |
| PHP 7.1 | analisador de php-mime-mail 5.0.5 |
| PHP 7.2 | analisador de php-mime-mail 7.1.2 |
| PHP 7.3 | analisador de php-mime-mail 7.1.2 |
| PHP 7.4 | analisador de php-mime-mail 7.1.2 |
Certifique-se de ter a extensão mailparse (http://php.net/manual/en/book.mailparse.php) instalada corretamente. A linha de comando php -m | grep mailparse precisa retornar "mailparse".
sudo apt install php-cli php-mailparse
brew install php
pecl install mailparse
sudo apt install php-cli php-pear php-dev php-mbstring
pecl install mailparse
AAAAMMDD deve ser php-config --extension-dir
git clone https://github.com/php/pecl-mail-mailparse.git
cd pecl-mail-mailparse
phpize
./configure
sed -i 's/#ifs!HAVE_MBSTRING/#ifndef MBFL_MBFILTER_H/' ./mailparse.c
make
sudo mv modules/mailparse.so /usr/lib/php/AAAAMMDD/
echo "extension=mailparse.so" | sudo tee /etc/php/8.4/mods-available/mailparse.ini
sudo phpenmod mailparse
Você precisa baixar a DLL mailparse de http://pecl.php.net/package/mailparse e adicionar a linha extension=php_mailparse.dll ao php.ini de acordo.
Você pode carregar um e-mail de 4 maneiras diferentes:
require_once __DIR__ . ' /vendor/autoload.php ' ;
$ path = ' path/to/email.eml ' ;
$ parser = new PhpMimeMailParser Parser ();
// 1. Either specify a file path (string)
$ parser -> setPath ( $ path );
// 2. or specify the raw mime mail text (string)
$ parser -> setText ( file_get_contents ( $ path ));
// 3. or specify a php file resource (stream)
$ parser -> setStream ( fopen ( $ path , " r " ));
// 4. or specify a stream to work with a mail server (stream)
$ parser -> setStream ( fopen ( " php://stdin " , " r " ));Obtenha o remetente e o destinatário:
$ rawHeaderTo = $ parser -> getHeader ( ' to ' );
// return "test" <[email protected]>, "test2" <[email protected]>
$ arrayHeaderTo = $ parser -> getAddresses ( ' to ' );
// return [["display"=>"test", "address"=>"[email protected]", false]]
$ rawHeaderFrom = $ parser -> getHeader ( ' from ' );
// return "test" <[email protected]>
$ arrayHeaderFrom = $ parser -> getAddresses ( ' from ' );
// return [["display"=>"test", "address"=>"[email protected]", "is_group"=>false]]Obtenha o assunto:
$ subject = $ parser -> getHeader ( ' subject ' );Obtenha outros cabeçalhos:
$ stringHeaders = $ parser -> getHeadersRaw ();
// return all headers as a string, no charset conversion
$ arrayHeaders = $ parser -> getHeaders ();
// return all headers as an array, with charset conversion $ text = $ parser -> getMessageBody ( ' text ' );
// return the text version
$ html = $ parser -> getMessageBody ( ' html ' );
// return the html version
$ htmlEmbedded = $ parser -> getMessageBody ( ' htmlEmbedded ' );
// return the html version with the embedded contents like imagesSalve todos os anexos em um diretório
$ parser -> saveAttachments ( ' /path/to/save/attachments/ ' );
// return all attachments saved in the directory (include inline attachments)
$ parser -> saveAttachments ( ' /path/to/save/attachments/ ' , false );
// return all attachments saved in the directory (exclude inline attachments)
// Save all attachments with the strategy ATTACHMENT_DUPLICATE_SUFFIX (default)
$ parser -> saveAttachments ( ' /path/to/save/attachments/ ' , false , Parser:: ATTACHMENT_DUPLICATE_SUFFIX );
// return all attachments saved in the directory: logo.jpg, logo_1.jpg, ..., logo_100.jpg, YY34UFHBJ.jpg
// Save all attachments with the strategy ATTACHMENT_RANDOM_FILENAME
$ parser -> saveAttachments ( ' /path/to/save/attachments/ ' , false , Parser:: ATTACHMENT_RANDOM_FILENAME );
// return all attachments saved in the directory: YY34UFHBJ.jpg and F98DBZ9FZF.jpg
// Save all attachments with the strategy ATTACHMENT_DUPLICATE_THROW
$ parser -> saveAttachments ( ' /path/to/save/attachments/ ' , false , Parser:: ATTACHMENT_DUPLICATE_THROW );
// return an exception when there is attachments duplicate.Obtenha todos os anexos
$ attachments = $ parser -> getAttachments ();
// return an array of all attachments (include inline attachments)
$ attachments = $ parser -> getAttachments ( false );
// return an array of all attachments (exclude inline attachments)Percorra todos os anexos
foreach ( $ attachments as $ attachment ) {
echo ' Filename : ' . $ attachment -> getFilename (). ' <br> ' ;
// return logo.jpg
echo ' Filesize : ' . filesize ( $ attach_dir . $ attachment -> getFilename ()). ' <br> ' ;
// return 1000
echo ' Filetype : ' . $ attachment -> getContentType (). ' <br> ' ;
// return image/jpeg
echo ' MIME part string : ' . $ attachment -> getMimePartStr (). ' <br> ' ;
// return the whole MIME part of the attachment
$ stream = $ attachment -> getStream ();
// get the stream of the attachment file
$ attachment -> save ( ' /path/to/save/myattachment/ ' , Parser:: ATTACHMENT_DUPLICATE_SUFFIX );
// return the path and the filename saved (same strategy available than saveAttachments)
} Para encaminhar e-mails do Postfix para o script PHP acima, adicione esta linha no final do seu /etc/postfix/master.cf (para especificar myhook para enviar todos os e-mails para o script test.php ):
myhook unix - n n - - pipe
flags=F user=www-data argv=php -c /etc/php5/apache2/php.ini -f /var/www/test.php ${sender} ${size} ${recipient}
Edite esta linha (registre myhook)
smtp inet n - - - - smtpd
-o content_filter=myhook:dummy
O script PHP deve utilizar o quarto método (veja acima) para trabalhar com esta configuração.
E finalmente a maneira mais fácil é usar meu SaaS https://mailcare.io
Fique à vontade para contribuir!
git clone https://github.com/php-mime-mail-parser/php-mime-mail-parser
cd php-mime-mail-parser
composer install
./vendor/bin/phpunit
Se você relatar um problema, forneça o e-mail bruto que o acionou. Isso nos ajuda a reproduzir o problema e corrigi-lo mais rapidamente.
O php-mime-mail-parser/php-mime-mail-parser é um software de código aberto licenciado sob a licença MIT
