PHP IMAP：高效筛选带附件邮件的教程

stdClass imap_fetchstructure ( resource $imap_stream , int $msg_number [, int $options = 0 ] )

<?php

class Mailbox_model extends CI_Model { // 假设这是在CodeIgniter模型中

    private $mailserver = "your.mailserver.com";
    private $user_id = "your_username";
    private $user_pwd = "your_password";

    public function mail_list() {
        $mbox_name = $this->input->get("boxname");
        $mbox_name = (isset($mbox_name)) ? $mbox_name : "INBOX";
        $mails = $this->connect_mailserver($mbox_name);

        $mailno_arr = array();
        if ($mails) {
            // 获取所有邮件的UID，然后根据UID排序或直接获取最新邮件
            // imap_sort 可能会比较慢，对于大邮箱，考虑 imap_search 结合 imap_uid
            $mail_uids = imap_sort($mails, SORTDATE, 1, SE_UID); // 获取按日期倒序排列的UIDs

            // 限制获取数量，例如只处理最新的15封邮件
            $latest_uids = array_slice($mail_uids, 0, 15);

            foreach ($latest_uids as $uid) {
                // 将UID转换为msg_number，因为imap_fetchstructure需要msg_number
                // 或者直接使用imap_uid转换为msg_number进行处理
                $msg_number = imap_msgno($mails, $uid);

                $has_attachments = $this->check_for_attachments($mails, $msg_number);

                $arr = array(
                    "no" => $msg_number, // 或者使用UID
                    "attachments" => $has_attachments ? "1" : "0"
                );
                array_push($mailno_arr, $arr);
            }
        }
        imap_close($mails);

        $data['mailno_arr'] = $mailno_arr;
        $this->load->view('mailbox/mail_list_v', $data);
    }

    /**
     * 递归检查邮件结构中是否存在附件
     * @param resource $imap_stream IMAP连接资源
     * @param int $msg_number 邮件编号
     * @return bool 如果包含附件则返回true，否则返回false
     */
    private function check_for_attachments($imap_stream, $msg_number) {
        $structure = imap_fetchstructure($imap_stream, $msg_number);

        if (isset($structure->parts) && is_array($structure->parts)) {
            return $this->traverse_parts_for_attachments($structure->parts);
        }

        // 对于非multipart邮件，如果它的类型不是文本，也可能是附件
        // 但通常附件会在multipart邮件中作为单独的part
        return $this->is_attachment_part($structure);
    }

    /**
     * 递归遍历邮件的各个部分以查找附件
     * @param array $parts 邮件部分的数组
     * @return bool 如果找到附件则返回true，否则返回false
     */
    private function traverse_parts_for_attachments($parts) {
        foreach ($parts as $part) {
            if ($this->is_attachment_part($part)) {
                return true;
            }
            // 如果当前部分是multipart，则递归检查其子部分
            if (isset($part->parts) && is_array($part->parts)) {
                if ($this->traverse_parts_for_attachments($part->parts)) {
                    return true;
                }
            }
        }
        return false;
    }

    /**
     * 判断一个邮件部分是否为附件
     * @param stdClass $part 邮件部分结构对象
     * @return bool 如果是附件则返回true
     */
    private function is_attachment_part($part) {
        // 常见的附件判断逻辑：
        // 1. Content-Disposition 为 ATTACHMENT
        // 2. Content-Disposition 为 INLINE，但 Content-Type 不是 text/plain 或 text/html，
        //    且文件名存在 (filename)。这通常是内联图片等，但有时也可能被视为附件。
        //    为了简单起见，我们主要关注 ATTACHMENT。
        // 3. Content-Type 不是 text/plain 或 text/html，且没有 disposition 或 disposition 不是 INLINE。

        // 优先检查 Content-Disposition
        if (isset($part->disposition) && strtolower($part->disposition) == 'attachment') {
            return true;
        }

        // 其次，检查 Content-Type 和文件名，排除常见的内联文本和HTML
        // IMAP类型定义:
        // 0: text, 1: multipart, 2: message, 3: application, 4: audio, 5: image, 6: video, 7: other
        if ($part->type > 0 && $part->type != 1 && $part->type != 2) { // 非文本、非multipart、非message
            // 排除内联显示但不是附件的类型
            if (isset($part->disposition) && strtolower($part->disposition) == 'inline') {
                // 如果是内联，但有文件名，且不是纯文本或HTML，也可能是附件
                if (isset($part->dparameters) && is_array($part->dparameters)) {
                    foreach ($part->dparameters as $dparam) {
                        if (strtolower($dparam->attribute) == 'filename') {
                            // 确保不是 text/plain 或 text/html
                            if (!((isset($part->subtype) && strtolower($part->subtype) == 'plain') || (isset($part->subtype) && strtolower($part->subtype) == 'html'))) {
                                return true;
                            }
                        }
                    }
                }
                return false; // 内联且没有明确文件名或为文本/HTML，通常不是附件
            }
            // 如果没有 disposition 或 disposition 不是 inline/attachment，但类型是非文本非multipart，且有文件名，则认为是附件
            if (isset($part->parameters) && is_array($part->parameters)) {
                foreach ($part->parameters as $param) {
                    if (strtolower($param->attribute) == 'name' && !empty($param->value)) {
                        return true;
                    }
                }
            }
        }

        return false;
    }

    public function connect_mailserver($mbox_name = "") {
        $host = "{" . $this->mailserver . ":143/imap/novalidate-cert}$mbox_name";
        return @imap_open($host, $this->user_id, $this->user_pwd);
    }
}