imap_createmailbox

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Descripción#
Véase también#

imap_createmailbox

Crea un nuevo buzón de correo

Descripción#

imap_createmailbox(IMAP\Connection $imap, string $mailbox): bool
```php

Crea un nuevo buzón de correo llamado `mailbox`.

## Parámetros

`imap`  
Una instancia de `IMAP\Connection`.

`mailbox`  
El nombre del buzón de correo, ver la documentación de la función `imap_open` para más información. Los nombres que contienen caracteres internacionales deben ser codificados por la función `imap_utf7_encode`

> [!WARNING]
> Pasar datos no confiables a este parámetro es *inseguro*, a menos que [imap.enable_insecure_rsh](#ini.imap.enable-insecure-rsh) esté desactivado.

## Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.1.0 | El parámetro `imap` ahora espera una instancia de `IMAP\Connection` ; anteriormente, se esperaba un `resource` `imap` válido. |

## Ejemplos

Ejemplo con `imap_createmailbox`

\n"; // Vamos a crear ahora un nuevo buzón de correo "phptestbox" // en su carpeta inbox, verificar su estado y, finalmente, eliminarlo // para devolver su inbox a su estado inicial. if (@imap_createmailbox($mbox, imap_utf7_encode("{imap.example.org}INBOX.$newname"))) { $status = @imap_status($mbox, "{imap.example.org}INBOX.$newname", SA_ALL); if ($status) { echo "Su nuevo buzón '$name1' está en el siguiente estado :
\n"; echo "Mensajes : " . $status->messages . "
\n"; echo "Recientes : " . $status->recent . "
\n"; echo "No leídos : " . $status->unseen . "
\n"; echo "UIDnext : " . $status->uidnext . "
\n"; echo "UIDvalidity :" . $status->uidvalidity . "
\n"; if (imap_renamemailbox($mbox, "{imap.example.org}INBOX.$newname", "{imap.example.org}INBOX.$name2")) { echo "renombrando el buzón de correo '$name1' a '$name2'
\n"; $newname = $name2; } else { echo "imap_renamemailbox en el nuevo buzón de correo falló : " . imap_last_error() . "
\n"; } } else { echo "imap_status en el nuevo buzón de correo falló : " . imap_last_error() . "
\n"; } if (@imap_deletemailbox($mbox, "{imap.example.org}INBOX.$newname")) { echo "nuevo buzón de correo eliminado para devolver todo a su estado
\n"; } else { echo "imap_deletemailbox en el nuevo buzón de correo falló : " . implode("
\n", imap_errors()) . "
\n"; } } else { echo "Imposible crear un nuevo buzón de correo : " . implode("
\n", imap_errors()) . "
\n"; } imap_close($mbox); ?>

```php

Véase también#

imap_renamemailbox, imap_deletemailbox