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($buzon, imap_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