Documentación offline PHP master

imap_gc

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

En esta página

imap_gc

Borra la caché IMAP

Descripción#

imap_gc(IMAP\Connection $imap, int $flags): true
```php

Elimina todas las entradas de un tipo dado en la caché IMAP.

## Parámetros

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

`flags`  
Indica el tipo de caché a purgar. Puede ser una combinación de las siguientes constantes: `IMAP_GC_ELT` (caché de los elementos de mensaje), `IMAP_GC_ENV` (sobre y cuerpo), `IMAP_GC_TEXTS` (textos).

## Valores devueltos

Retorna siempre `true`.

## Errores/Excepciones

Lanza una excepción `ValueError` si el argumento `flags` es inválido.

## 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. |
| 8.0.0 | Una excepción `ValueError` es ahora lanzada para valores de argumento `flags` inválidos. Anteriormente, se emitía una advertencia y la función devolvía `false`. |

## Ejemplos

Ejemplo con`imap_gc`

```php