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 の互換性 | バージョン |
---|---|
HHVM | php-mime-mail-parser 2.11.1 |
PHP5.4 | php-mime-mail-parser 2.11.1 |
PHP5.5 | php-mime-mail-parser 2.11.1 |
PHP5.6 | php-mime-mail-parser 3.0.4 |
PHP7.0 | php-mime-mail-parser 3.0.4 |
PHP7.1 | php-mime-mail-parser 5.0.5 |
PHP7.2 | php-mime-mail-parser 7.1.2 |
PHP7.3 | php-mime-mail-parser 7.1.2 |
PHP7.4 | php-mime-mail-parser 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 をダウンロードし、それに応じてphp.ini
にextension=php_mailparse.dll
行を追加する必要があります。
電子メールは 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
の最後に次の行を追加します (スクリプトtest.php
にすべてのメールを送信するように myhook を指定します)。
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 スクリプトは 4 番目の方法 (上記を参照) を使用する必要があります。
そして最後に、最も簡単な方法は、私の 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 ライセンスに基づいてライセンス供与されたオープンソース ソフトウェアです。