README

一个经过全面测试的PHP 7.2+版本邮箱解析器（mailparse 扩展包装器）。

它在性能、外文字符编码、附件处理以及易用性方面是当前最有效的PHP邮箱解析器。遵循Internet消息格式RFC 822、2822、5322。

为什么？

此扩展可以用于...

• 解析和读取来自Postfix的邮箱
• 用于读取消息（文件扩展名：eml）
• 创建Web邮箱
• 将主题、HTML正文、附件等信息存储到数据库中

它可靠吗？

是的。所有已知问题都已重现、修复并测试。

我们使用GitHub Actions、Codecov、Codacy来帮助确保代码质量。您可以在下面的实时统计数据中查看

如何安装？

最简单的方式是通过 Composer。

要安装PHP MIME Mail Parser的最新版本，请运行以下命令

composer require php-mime-mail-parser/php-mime-mail-parser

需求

以下版本的PHP受到支持

• PHP 7.2
• PHP 7.3
• PHP 7.4
• PHP 8.0

早期版本

请确保正确安装了mailparse扩展（https://php.ac.cn/manual/en/book.mailparse.php）。命令行 php -m | grep mailparse 需要返回 "mailparse"。

安装mailparse扩展

Ubuntu、Debian及其衍生品

sudo apt install php-cli php-mailparse

Php docker镜像

# Example with an alpine distribution
RUN apk update && apk add g++ autoconf make re2c && \
    pecl install mailparse && \
    docker-php-ext-enable mailparse && \
    apk del g++ autoconf make re2c
    

其他平台

sudo apt install php-cli php-pear php-dev php-mbstring
pecl install mailparse

从源码安装

git clone https://github.com/php/pecl-mail-mailparse.git
cd pecl-mail-mailparse
phpize
./configure
sed -i 's/#if\s!HAVE_MBSTRING/#ifndef MBFL_MBFILTER_H/' ./mailparse.c
make
sudo mv modules/mailparse.so $(php-config --extension-dir)
echo "extension=mailparse.so" | sudo tee /etc/php/7.1/mods-available/mailparse.ini
sudo phpenmod mailparse

Windows

您需要从 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. Specify a file path (string)
$parser->setPath($path); 

// 2. Specify the raw mime mail text (string)
$parser->setText(file_get_contents($path));

// 3. Specify a php file resource (stream)
$parser->setStream(fopen($path, "r"));

// 4.  Specify a stream to work with mail server (stream)
$parser->setStream(fopen("php://stdin", "r"));

获取消息的元数据

获取发件人和收件人

$rawHeaderTo = $parser->getHeader('to');
// return "test" <test@example.com>, "test2" <test2@example.com>

$arrayHeaderTo = $parser->getAddresses('to');
// return [["display"=>"test", "address"=>"test@example.com", "is_group"=>false]]

$rawHeaderFrom = $parser->getHeader('from');
// return "test" <test@example.com>

$arrayHeaderFrom = $parser->getAddresses('from');
// return [["display"=>"test", "address"=>"test@example.com", "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

    $attachment->save('/path/to/save/myattachment/', Parser::ATTACHMENT_DUPLICATE_SUFFIX);
    // return the path and the filename saved (same strategy available than saveAttachments)
}

Postfix配置以管理来自邮件服务器的邮箱

接下来，您需要将邮件转发到上面的脚本。为此，我将使用 Postfix 作为邮件服务器，您需要配置 /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

我的赞助商

感谢我的第一位赞助商 Bertel Torp。感谢我的第二位赞助商 Will Browning。

我能贡献吗？

请随时贡献！

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 许可协议