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

// 原始低效代码示例
for($i=0; $i<15; $i++) {
  $body = imap_body($mails, $mailno_arr_tmp[$i]); // 下载整个邮件体
  $res = (strpos($body, 'Content-Disposition: attachment')!=null)?  "1" : "0";
  // ...
}

<?php
// 假设 connect_mailserver 函数已定义并能成功连接到 IMAP 服务器

class MailController extends CI_Controller { // 假设这是一个CodeIgniter控制器

    private $mailserver = "your.mailserver.com"; // 替换为你的邮件服务器
    private $user_id = "your_username";         // 替换为你的用户名
    private $user_pwd = "your_password";         // 替换为你的密码

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

        if($mails) {
            $mailno_arr = array();
            // 获取最新15封邮件的UID，通常IMAP操作使用UID更稳定
            // imap_sort 默认返回邮件序号，这里为了保持与原代码逻辑一致，继续使用序号
            $mailno_arr_tmp = imap_sort($mails, SORTDATE, 1);

            // 只处理前15封邮件，或者根据需要调整循环范围
            $count = min(15, count($mailno_arr_tmp));

            for($i=0; $i < $count; $i++) {
                $mail_seq_num = $mailno_arr_tmp[$i]; // 邮件序列号
                $has_attachments = $this->check_for_attachments($mails, $mail_seq_num);

                $arr = array(
                    "no" => $mail_seq_num,
                    "attachments" => $has_attachments ? "1" : "0"
                );
                array_push($mailno_arr, $arr);
            }
            $data['mailno_arr'] = $mailno_arr;
            imap_close($mails); // 关闭IMAP连接
        } else {
            $data['mailno_arr'] = []; // 连接失败时返回空数组
            // 可以在这里添加错误处理逻辑
        }
        $this->load->view('mailbox/mail_list_v', $data);
    }

    /**
     * 连接到IMAP邮件服务器
     * @param string $mbox 邮箱名称，如 "INBOX"
     * @return resource|false IMAP连接资源或false
     */
    public function connect_mailserver($mbox="") {
        $host = "{" . $this->mailserver . ":143/imap/novalidate-cert}$mbox";
        return @imap_open($host, $this->user_id, $this->user_pwd);
    }

    /**
     * 检查邮件是否包含附件
     * @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)) {
            // 邮件没有多部分结构，通常意味着没有附件（除非附件是邮件的唯一部分，这很少见）
            return false;
        }

        foreach ($structure->parts as $part) {
            // 检查 Content-Disposition 头
            if (isset($part->ifdparameters) && $part->ifdparameters) {
                foreach ($part->dparameters as $dparam) {
                    if (strtolower($dparam->attribute) === 'disposition' && strtolower($dparam->value) === 'attachment') {
                        return true; // 找到附件
                    }
                }
            }
            // 检查 Content-Type 中是否有附件相关信息，例如 application/octet-stream
            // 这是一种备用检查，但 Content-Disposition 更直接
            if (isset($part->ifparameters) && $part->ifparameters) {
                foreach ($part->parameters as $param) {
                    if (strtolower($param->attribute) === 'name' && !empty($param->value)) {
                        // 如果有文件名参数，很可能是一个附件或内联内容
                        // 需要进一步判断 Content-Disposition
                        if (!isset($part->ifdparameters) || !$part->ifdparameters) {
                             // 如果没有明确的 Content-Disposition，但有文件名，可能是内联图片等，
                             // 根据需求决定是否算作“附件”
                             // 为了严格区分，这里暂时不算作附件
                             continue;
                        }
                    }
                }
            }
            // 递归检查多部分邮件的子部分
            if (isset($part->parts)) {
                if ($this->has_attachment_recursive($part->parts)) {
                    return true;
                }
            }
        }
        return false; // 未找到附件
    }

    /**
     * 递归检查邮件结构中的附件
     * @param array $parts 邮件部分的数组
     * @return bool
     */
    private function has_attachment_recursive($parts) {
        foreach ($parts as $part) {
            if (isset($part->ifdparameters) && $part->ifdparameters) {
                foreach ($part->dparameters as $dparam) {
                    if (strtolower($dparam->attribute) === 'disposition' && strtolower($dparam->value) === 'attachment') {
                        return true;
                    }
                }
            }
            if (isset($part->parts)) {
                if ($this->has_attachment_recursive($part->parts)) {
                    return true;
                }
            }
        }
        return false;
    }
}
?>