適用於 PHP 8.0+ 的經過全面測試的電子郵件解析器(mailparse 擴充包裝器)。
就效能、外來字元編碼、附件處理和易用性而言,它是最有效的 PHP 電子郵件解析器。網路訊息格式 RFC 822、2822、5322。
該擴充功能可用於...
.eml
)是的。所有已知問題均已重現、修復和測試。
我們使用 GitHub Actions、Codecov、Codacy 來幫助確保程式碼品質。您可以在下面看到即時統計數據:
最簡單的方法是透過 Composer。
若要安裝最新版本的 PHP MIME 郵件解析器,請執行下列命令:
composer require php-mime-mail-parser/php-mime-mail-parser
支援以下 PHP 版本:
以前的版本:
PHP 相容性 | 版本 |
---|---|
HHVM | php-mime-郵件解析器 2.11.1 |
PHP 5.4 | php-mime-郵件解析器 2.11.1 |
PHP 5.5 | php-mime-郵件解析器 2.11.1 |
PHP 5.6 | php-mime-郵件解析器 3.0.4 |
PHP 7.0 | php-mime-郵件解析器 3.0.4 |
PHP 7.1 | php-mime-郵件解析器 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
您需要從http://pecl.php.net/package/mailparse下載mailparse DLL,並將extension=php_mailparse.dll
對應地加入到php.ini
。
您可以透過 4 種不同的方式載入電子郵件:
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 授權授權的開源軟體