Conexión a un server IMAP o POP3:
mail_handler=imap_open(string_mbox,user,password);
Donde mbox es de la forma:
{IP:PORT}MailBox
Ejemplos:
$mail=imap_open(“{190.190.190.190:143}INBOX”,”user”,”pass”);
Conexión a la carpeta INBOX de un servidor IMAP (puerto 143)
$mail=imap_open(“{190.190.190.190:110}”,”user”,”pass”);
Conexión a la carpeta raíz de un servidor POP3 (puerto 110)
Una vez establecida la conexión la función devuelve un handler que se utiliza en el resto de las funciones para acceder a las carpetas y mails dentro de las mismas.
Ejemplo:
$mbox = imap_open ("{your.imap.host:143}", "username", "password");
echo "
Mailboxes
\n";
$folders = imap_listmailbox ($mbox, "{your.imap.host:143}", "*");
if ($folders == false) {
echo "Call failed
\n";
} else {
while (list ($key, $val) = each ($folders)) {
echo $val."
\n";
}
}
echo "
Headers in INBOX
\n";
$headers = imap_headers ($mbox);
if ($headers == false) {
echo "Call failed
\n";
} else {
while (list ($key,$val) = each ($headers)) {
echo $val."
\n";
}
}
imap_close($mbox);
Una vez terminada la conexión se usa:
imap_close(mail_handler);
Manejo de MailBoxes:int=imap_createmailbox (mail_handler string_mbox)
String mbox debe estar codificado con imap_utf7_encode() y el formato del string es el mismo que en imap_open.
Ejemplo:
$mbox = imap_open("{your.imap.host}","username","password",OP_HALFOPEN)
|| die("can't connect: ".imap_last_error());
$name1 = "phpnewbox";
$name2 = imap_utf7_encode("phpnewböx");
$newname = $name1;
echo "Newname will be '$name1'
\n";
# we will now create a new mailbox "phptestbox" in your inbox folder,
# check its status after creation and finaly remove it to restore
# your inbox to its initial state
if(@imap_createmailbox($mbox,imap_utf7_encode("{your.imap.host}INBOX.$newname"))) {
$status = @imap_status($mbox,"{your.imap.host}INBOX.$newname",SA_ALL);
if($status) {
print("your new mailbox '$name1' has the following status:
\n");
print("Messages: ". $status->messages )."
\n";
print("Recent: ". $status->recent )."
\n";
print("Unseen: ". $status->unseen )."
\n";
print("UIDnext: ". $status->uidnext )."
\n";
print("UIDvalidity:". $status->uidvalidity)."
\n";
if(imap_renamemailbox($mbox,"{your.imap.host}INBOX.$newname","{your.imap.host}INBOX.$name2")) {
echo "renamed new mailbox from '$name1' to '$name2'
\n";
$newname=$name2;
} else {
print "imap_renamemailbox on new mailbox failed: ".imap_last_error()."
\n";
}
} else {
print "imap_status on new mailbox failed: ".imap_last_error()."
\n";
}
if(@imap_deletemailbox($mbox,"{your.imap.host}INBOX.$newname")) {
print "new mailbox removed to restore initial state
\n";
} else {
print "imap_deletemailbox on new mailbox failed:
".implode("
\n",imap_errors())."
\n";
}
} else {
print "could not create new mailbox: ".implode("
\n",imap_errors())."
\n";
}
imap_close($mbox);
Devuelve true si pudo crear el mailbox o false en caso contrario.
int=imap_deletemailbox (mail_handler, string_mbox);
Elimina el mailbox indicado, el formato de mbox es el mismo que en imap_open.
int=imap_renamemailbox (mail_handler, string_old_mbox, string_new_mbox)
Permite renombrar un mailbox, el nombre del mailbox debe estar en el mismo formato que en imap_open.
obj_array=imap_getmailboxes (mail_stream, string_ref, string_pattern)
Devuelve un vector de objetos con información sobre los mailboxes
Los objetos que se encuentran en el vector tienen seteados los siguientes data_members:
· name – Nombre del mailbox (completo) encodeado, decodificar con imap_utf7_decode()
· delimiter – Delimitador usado para separar la jerarquía de mailboxes
· attributes – Es un bitmask que puede compararse con:
- LATT_NOINFERIORS (el mailbox no tiene subcarpetas)
- LATT_NOSELECT (es un mailbox no seleccionable)
- LATT_MARKED (mailbox marcado)
- LATT_UNMARKED (mailbox no marcado)
Ejemplo:
$mbox = imap_open("{your.imap.host}","username","password")
|| die("can't connect: ".imap_last_error());
$list = imap_getmailboxes($mbox,"{your.imap.host}","*");
if(is_array($list)) {
reset($list);
while (list($key, $val) = each($list))
{
print "($key) ";
print imap_utf7_decode($val->name).",";
print "'".$val->delimiter."',";
print $val->attributes."
\n";
}
} else
print "imap_getmailboxes failed: ".imap_last_error()."\n";
imap_close($mbox);
object=imap_status (mail_handler, string_mailbox, SA_ALL)
SA_ALL es una constante para recuperar toda la información sobre el mailbox, devuelve un objeto con los siguientes data members seteados:
· messages – número de mensajes en el mailbox
· recent – número de mensajes recientes en el mailbox
· unseen – número de mensajes no vistos en el mailbox
Ejemplo:
$mbox = imap_open("{your.imap.host}","username","password",OP_HALFOPEN)
|| die("can't connect: ".imap_last_error());
$status = imap_status($mbox,"{your.imap.host}INBOX",SA_ALL);
if($status) {
print("Messages: ". $status->messages )."
\n";
print("Recent: ". $status->recent )."
\n";
print("Unseen: ". $status->unseen )."
\n";
print("UIDnext: ". $status->uidnext )."
\n";
print("UIDvalidity:". $status->uidvalidity)."
\n";
} else
print "imap_status failed: ".imap_lasterror()."\n";
imap_close($mbox);
int imap_num_msg (mail_handler)
Devuelve el número de mensajes en el mailbox actual. (El abierto por el mail_handler)
int imap_num_recent (mail_handler)
Devuelve el número de mensajes recientes del mailbox correspondiente a mail_handler.
Manejo de mensajes:object=imap_fetchstructure (mail_handler, int msg_number)
Devuelve un objeto con la estructura del mensaje recuperado:
Table 1. Returned Objects for imap_fetchstructure()type Primary body type
encoding Body transfer encoding
ifsubtype True if there is a subtype string
subtype MIME subtype
ifdescription True if there is a description string
description Content description string
ifid True if there is an identification string
id Identification string
lines Number of lines
bytes Number of bytes
ifdisposition True if there is a disposition string
disposition Disposition string
ifdparameters True if the dparameters array exists
dparameters Disposition parameter array
ifparameters True if the parameters array exists
parameters MIME parameters array
parts Array of objects describing each message part
Cuando el mensaje es multipart “parts” es un vector donde cada elemento es un objeto con los siguientes datamembers:
· type
· encoding
· subtype
· description
· lines
· disposition
Luego según el trasnfer encoding (ver tabla 3) se puede usar la función de decodificación apropiada
Table 2. Primary body type0 text
1 multipart
2 message
3 application
4 audio
5 image
6 video
7 other
Table 3. Transfer encodings0 7BIT
1 8BIT
2 BINARY
3 BASE64
4 QUOTED-PRINTABLE
5 OTHER
Las funciones de decodificación provistas son:
string=imap_base64(string) convierte de base 64 a 8 bits
string=imap_8bit(string) convierte de 8 bits a quoted printable
string=imap_utf7_decode(string) convierte de 7 bits a 8 bits
string=imap_qprint(string) convierte de quoted printable a 8 bits
string=imap_binary(string) convierte de 8 bits a base64
El formato de salida “string” es 8 bits, si el formato de encoding es otro basta con usar la función apropiada.
string=imap_fetchbody (mail_handler, int msg_number, string part_number )
Recupera la parte indicada del body de un determinado mensaje. No realiza ningún tipo de decodificación.
array= imap_headers (mail_handlers)
Devuelve un vector de headers para el mailbox actual (cada header es un string y es un elemento del vector)
object=imap_rfc822_parse_headers(string headers)
Parsea un header de acuerdo a rfc822, devuelve un objeto con los siguientes data_members:
· remail
· date
· Date
· subject
· Subject
· in_reply_to
· message_id
· newsgroups
· followup_to
· references
string imap_body (mail_handler, int msg_number)
Devuelve el body de un determinado mensaje.
Envío de mail:Enviar mail desde PHP es sencillo con la función:
bool= mail (string to, string subject, string message [, string additional_headers])
Ejemplo
mail("rasmus@lerdorf.on.ca", "My Subject", "Line 1\nLine 2\nLine 3");
Ejemplo 2. Envio de mail con encabezado.
mail("nobody@aol.com", "the subject", $message,
"From: webmaster@$SERVER_NAME\nReply-To: webmaster@$SERVER_NAME\nXMailer:
PHP/" . phpversion());
Posts
