IMAP
PHP Manual

imap_createmailbox

(PHP 4, PHP 5)

imap_createmailbox — Crear un nuevo buzón de correo

Descripción

bool imap_createmailbox ( resource $secuencia_imap , string $buzon )

Crea un nuevo buzón de correo especificado por buzon .

Lista de parámetros

imap_stream

An IMAP stream returned by imap_open().

buzon

El nombre del buzón, vea imap_open() para más información. Los nombres que contengan caracteres internacionales deben ser codificados mediante imap_utf7_encode()

Valores retornados

Devuelve TRUE si todo se llevó a cabo correctamente, FALSE en caso de fallo.

Ejemplos

Example#1 Ejemplo de imap_createmailbox()

<?php
$buzon 
imap_open("{imap.example.org}""usuario""contraseña"OP_HALFOPEN)
     or die(
"no se pudo conectar: " imap_last_error());

$nombre1 "phpnuevobuzon";
$nombre2 imap_utf7_encode("phpnuevobuzón");

$nuevo_nombre $nombre1;

echo 
"El nuevo nombre será '$nombre1'<br />\n";

// ahora crearemos un nuevo buzón "phpbuzonprueba" en su carpeta de entrada,
// chequearemos su status después de su creación y finalmente lo removeremos
// para recuperar el estado inicial del buzón de entrada

if (@imap_createmailbox($buzonimap_utf7_encode("{imap.example.org}INBOX.$nuevo_nombre"))) {
    
$status = @imap_status($buzon"{imap.example.org}INBOX.$nuevo_nombre"SA_ALL);
    if (
$status) {
        echo 
"su nuevo buzón '$nombre1' tiene el siguiente status:<br />\n";
        echo 
"Mensajes:      " $status->messages    "<br />\n";
        echo 
"Recientes:     " $status->recent      "<br />\n";
        echo 
"No leídos:     " $status->unseen      "<br />\n";
        echo 
"Siguiente UID: " $status->uidnext     "<br />\n";
        echo 
"Validez UID:   " $status->uidvalidity "<br />\n";

        if (
imap_renamemailbox($buzon"{imap.example.org}INBOX.$nuevo_nombre""{imap.example.org}INBOX.$nombre2")) {
            echo 
"se renombró el nuevo buzón de '$nombre1' a '$nombre2'<br />\n";
            
$nuevo_nombre $nombre2;
        } else {
            echo 
"imap_renamemailbox en el nuevo buzón falló: " imap_last_error() . "<br />\n";
        }
    } else {
        echo 
"imap_status en el nuevo buzón falló: " imap_last_error() . "<br />\n";
    }

    if (@
imap_deletemailbox($buzon"{imap.example.org}INBOX.$nuevo_nombre")) {
        echo 
"el nuevo buzón fue eliminado para recuperar el estado inicial<br />\n";
    } else {
        echo 
"imap_deletemailbox en el nuevo buzón falló: " implode("<br />\n"imap_errors()) . "<br />\n";
    }

} else {
    echo 
"no se pudo crear un nuevo buzón: " implode("<br />\n"imap_errors()) . "<br />\n";
}

imap_close($buzon);
?>

Ver también


IMAP
PHP Manual