Полностью протестированный анализатор электронной почты для PHP 8.0+ (оболочка расширения mailparse).
Это самый эффективный парсер электронной почты PHP с точки зрения производительности, кодировки иностранных символов, обработки вложений и простоты использования. Формат интернет-сообщений RFC 822, 2822, 5322.
Это расширение можно использовать для...
.eml
)Да. Все известные проблемы воспроизведены, исправлены и протестированы.
Мы используем GitHub Actions, Codecov, Codacy, чтобы обеспечить качество кода. Ниже вы можете увидеть статистику в реальном времени:
Самый простой способ — через Composer.
Чтобы установить последнюю версию PHP MIME Mail Parser, выполните следующую команду:
composer require php-mime-mail-parser/php-mime-mail-parser
Поддерживаются следующие версии PHP:
Предыдущие версии:
Совместимость с PHP | Версия |
---|---|
ХХВМ | PHP-мим-парсер почты 2.11.1 |
PHP 5.4 | PHP-мим-парсер почты 2.11.1 |
PHP 5.5 | PHP-мим-парсер почты 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 | PHP-мим-парсер почты 5.0.5 |
PHP 7.2 | PHP-mime-парсер почты 7.1.2 |
PHP 7.3 | PHP-mime-парсер почты 7.1.2 |
PHP 7.4 | PHP-mime-парсер почты 7.1.2 |
Убедитесь, что у вас правильно установлено расширение mailparse (http://php.net/manual/en/book.mailparse.php). Командная строка php -m | grep mailparse
должен вернуть «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 должен быть 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
Вам необходимо загрузить DLL mailparse с http://pecl.php.net/package/mailparse и добавить строку extension=php_mailparse.dll
в php.ini
соответственно.
Вы можете загрузить электронное письмо четырьмя различными способами:
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 " ));
Получите отправителя и получателя:
$ 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]]
Получите тему:
$ subject = $ parser -> getHeader ( ' subject ' );
Получите другие заголовки:
$ 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 images
Сохраните все вложения в папке
$ 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.
Получить все вложения
$ 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)
Перебрать все вложения
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)
}
Чтобы пересылать почту из Postfix в приведенный выше PHP-скрипт, добавьте эту строку в конец файла /etc/postfix/master.cf
(чтобы указать myhook для отправки всех писем в скрипт 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}
Отредактируйте эту строку (зарегистрируйте myhook)
smtp inet n - - - - smtpd
-o content_filter=myhook:dummy
Для работы с этой конфигурацией PHP-скрипт должен использовать четвертый метод (см. выше).
И, наконец, самый простой способ — использовать мой SaaS https://mailcare.io.
Не стесняйтесь внести свой вклад!
git clone https://github.com/php-mime-mail-parser/php-mime-mail-parser
cd php-mime-mail-parser
composer install
./vendor/bin/phpunit
Если вы сообщаете о проблеме, укажите необработанный адрес электронной почты, который ее вызвал. Это поможет нам воспроизвести проблему и устранить ее быстрее.
php-mime-mail-parser/php-mime-mail-parser — это программное обеспечение с открытым исходным кодом, лицензированное по лицензии MIT.