IMAP, POP3 和 NNTP

简介
安装／配置
预定义常量
IMAP 函数
- imap_8bit — Convert an 8bit string to a quoted-printable string
- imap_alerts — Returns all IMAP alert messages that have occurred
- imap_append — Append a string message to a specified mailbox
- imap_base64 — Decode BASE64 encoded text
- imap_binary — Convert an 8bit string to a base64 string
- imap_body — Read the message body
- imap_bodystruct — Read the structure of a specified body section of a specific message
- imap_check — Check current mailbox
- imap_clearflag_full — Clears flags on messages
- imap_close — Close an IMAP stream
- imap_create — 别名 imap_createmailbox
- imap_createmailbox — Create a new mailbox
- imap_delete — Mark a message for deletion from current mailbox
- imap_deletemailbox — Delete a mailbox
- imap_errors — Returns all of the IMAP errors that have occurred
- imap_expunge — Delete all messages marked for deletion
- imap_fetch_overview — Read an overview of the information in the headers of the given message
- imap_fetchbody — Fetch a particular section of the body of the message
- imap_fetchheader — Returns header for a message
- imap_fetchmime — Fetch MIME headers for a particular section of the message
- imap_fetchstructure — Read the structure of a particular message
- imap_fetchtext — 别名 imap_body
- imap_gc — Clears IMAP cache
- imap_get_quota — Retrieve the quota level settings, and usage statics per mailbox
- imap_get_quotaroot — Retrieve the quota settings per user
- imap_getacl — Gets the ACL for a given mailbox
- imap_getmailboxes — Read the list of mailboxes, returning detailed information on each one
- imap_getsubscribed — List all the subscribed mailboxes
- imap_header — 别名 imap_headerinfo
- imap_headerinfo — Read the header of the message
- imap_headers — Returns headers for all messages in a mailbox
- imap_last_error — Gets the last IMAP error that occurred during this page request
- imap_list — Read the list of mailboxes
- imap_listmailbox — 别名 imap_list
- imap_listscan — Returns the list of mailboxes that matches the given text
- imap_listsubscribed — 别名 imap_lsub
- imap_lsub — List all the subscribed mailboxes
- imap_mail_compose — Create a MIME message based on given envelope and body sections
- imap_mail_copy — Copy specified messages to a mailbox
- imap_mail_move — Move specified messages to a mailbox
- imap_mail — Send an email message
- imap_mailboxmsginfo — Get information about the current mailbox
- imap_mime_header_decode — Decode MIME header elements
- imap_msgno — Gets the message sequence number for the given UID
- imap_mutf7_to_utf8 — Decode a modified UTF-7 string to UTF-8
- imap_num_msg — Gets the number of messages in the current mailbox
- imap_num_recent — Gets the number of recent messages in current mailbox
- imap_open — Open an IMAP stream to a mailbox
- imap_ping — Check if the IMAP stream is still active
- imap_qprint — Convert a quoted-printable string to an 8 bit string
- imap_rename — 别名 imap_renamemailbox
- imap_renamemailbox — Rename an old mailbox to new mailbox
- imap_reopen — Reopen IMAP stream to new mailbox
- imap_rfc822_parse_adrlist — Parses an address string
- imap_rfc822_parse_headers — Parse mail headers from a string
- imap_rfc822_write_address — Returns a properly formatted email address given the mailbox, host, and personal info
- imap_savebody — Save a specific body section to a file
- imap_scan — 别名 imap_listscan
- imap_scanmailbox — 别名 imap_listscan
- imap_search — This function returns an array of messages matching the given search criteria
- imap_set_quota — Sets a quota for a given mailbox
- imap_setacl — Sets the ACL for a given mailbox
- imap_setflag_full — Sets flags on messages
- imap_sort — Gets and sort messages
- imap_status — Returns status information on a mailbox
- imap_subscribe — Subscribe to a mailbox
- imap_thread — Returns a tree of threaded message
- imap_timeout — Set or fetch imap timeout
- imap_uid — This function returns the UID for the given message sequence number
- imap_undelete — Unmark the message which is marked deleted
- imap_unsubscribe — Unsubscribe from a mailbox
- imap_utf7_decode — Decodes a modified UTF-7 encoded string
- imap_utf7_encode — Converts ISO-8859-1 string to modified UTF-7 text
- imap_utf8_to_mutf7 — Encode a UTF-8 string to modified UTF-7
- imap_utf8 — Converts MIME-encoded text to UTF-8

User Contributed Notes

opto 16-Mar-2012 12:08


it seems that in new PHP versions, $ssl must be specified even if no ssl is used - I got it working for POP3 only after adding /notls (honour some post I found somewhere)

Klaus

dev at bluehead dot com dot br 27-Nov-2011 06:13


Because I don't know regular expressions, I hacked the mail_parse_headers() to properly get the last line from the header string:





<?php


function mail_parse_headers($headers)


{





    $headers=preg_replace('/\r\n\s+/m', '',$headers);


    $headers=trim($headers)."\r\n"; /* a hack for the preg_match_all in the next line */


    preg_match_all('/([^: ]+): (.+?(?:\r\n\s(?:.+?))*)?\r\n/m', $headers, $matches);


    foreach ($matches[1] as $key =>$value) $result[$value]=$matches[2][$key];


    return($result);


}


?>

Wil Barath 25-Feb-2010 07:54


For all the people coming here praying for:





1) a dead-easy way to read MIME attachments, or


2) a dead-easy way to access POP3 folders





Look no further.





<?php 


function pop3_login($host,$port,$user,$pass,$folder="INBOX",$ssl=false)


{


    $ssl=($ssl==false)?"/novalidate-cert":"";


    return (imap_open("{"."$host:$port/pop3$ssl"."}$folder",$user,$pass));


}


function pop3_stat($connection)        


{


    $check = imap_mailboxmsginfo($connection);


    return ((array)$check);


}


function pop3_list($connection,$message="")


{


    if ($message)


    {


        $range=$message;


    } else {


        $MC = imap_check($connection);


        $range = "1:".$MC->Nmsgs;


    }


    $response = imap_fetch_overview($connection,$range);


    foreach ($response as $msg) $result[$msg->msgno]=(array)$msg;


        return $result;


}


function pop3_retr($connection,$message)


{


    return(imap_fetchheader($connection,$message,FT_PREFETCHTEXT));


}


function pop3_dele($connection,$message)


{


    return(imap_delete($connection,$message));


}


function mail_parse_headers($headers)


{


    $headers=preg_replace('/\r\n\s+/m', '',$headers);


    preg_match_all('/([^: ]+): (.+?(?:\r\n\s(?:.+?))*)?\r\n/m', $headers, $matches);


    foreach ($matches[1] as $key =>$value) $result[$value]=$matches[2][$key];


    return($result);


}


function mail_mime_to_array($imap,$mid,$parse_headers=false)


{


    $mail = imap_fetchstructure($imap,$mid);


    $mail = mail_get_parts($imap,$mid,$mail,0);


    if ($parse_headers) $mail[0]["parsed"]=mail_parse_headers($mail[0]["data"]);


    return($mail);


}


function mail_get_parts($imap,$mid,$part,$prefix)


{    


    $attachments=array();


    $attachments[$prefix]=mail_decode_part($imap,$mid,$part,$prefix);


    if (isset($part->parts)) // multipart


    {


        $prefix = ($prefix == "0")?"":"$prefix.";


        foreach ($part->parts as $number=>$subpart) 


            $attachments=array_merge($attachments, mail_get_parts($imap,$mid,$subpart,$prefix.($number+1)));


    }


    return $attachments;


}


function mail_decode_part($connection,$message_number,$part,$prefix)


{


    $attachment = array();





    if($part->ifdparameters) {


        foreach($part->dparameters as $object) {


            $attachment[strtolower($object->attribute)]=$object->value;


            if(strtolower($object->attribute) == 'filename') {


                $attachment['is_attachment'] = true;


                $attachment['filename'] = $object->value;


            }


        }


    }





    if($part->ifparameters) {


        foreach($part->parameters as $object) {


            $attachment[strtolower($object->attribute)]=$object->value;


            if(strtolower($object->attribute) == 'name') {


                $attachment['is_attachment'] = true;


                $attachment['name'] = $object->value;


            }


        }


    }





    $attachment['data'] = imap_fetchbody($connection, $message_number, $prefix);


    if($part->encoding == 3) { // 3 = BASE64


        $attachment['data'] = base64_decode($attachment['data']);


    }


    elseif($part->encoding == 4) { // 4 = QUOTED-PRINTABLE


        $attachment['data'] = quoted_printable_decode($attachment['data']);


    }


    return($attachment);


}


?>





[EDIT BY danbrown AT php DOT net: Contains a bugfix by "mn26826" on 09-JUN-2010, which fixed the erroneous reference to $imap as the parameter passed to imap_mailboxmsginfo() within the user function pop3_stat().  This was intended to be $connection.]





[EDIT BY visualmind AT php DOT net: Contains a bugfix by "elias-jobview" on 17-AUG-2010, which fixed the error in pop3_list function which didn't have: return $result]





[EDIT BY danbrown AT php DOT net: Contains a bugfix by "chrismeistre" on 09-SEP-2010, which fixed the erroneous reference to $mbox (should be $connection) in the pop3_list() function.]