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);
?>