- [DOC] add imap_gc (purge cache(s) and constants IMAP_GC_ELT, IMAP_GC_ENV and IMAP_G...

diff --git a/ext/imap/php_imap.c b/ext/imap/php_imap.c
index 9907d1dcc5961c53a1141a72691c8370c6068734..98daaa9bd5b2ad33cd75e336032a45244205f3f0 100644 (file)
--- a/ext/imap/php_imap.c
+++ b/ext/imap/php_imap.c
@@ -167,6 +167,11 @@ ZEND_BEGIN_ARG_INFO_EX(arginfo_imap_expunge, 0, 0, 1)
        ZEND_ARG_INFO(0, stream_id)
 ZEND_END_ARG_INFO()
 
+ZEND_BEGIN_ARG_INFO_EX(arginfo_imap_gc, 0, 0, 1)
+       ZEND_ARG_INFO(0, stream_id)
+       ZEND_ARG_INFO(0, flags)
+ZEND_END_ARG_INFO()
+
 ZEND_BEGIN_ARG_INFO_EX(arginfo_imap_close, 0, 0, 1)
        ZEND_ARG_INFO(0, stream_id)
        ZEND_ARG_INFO(0, options)
@@ -468,6 +473,7 @@ const zend_function_entry imap_functions[] = {
        PHP_FE(imap_savebody,                                                   arginfo_imap_savebody)
        PHP_FE(imap_fetchheader,                                                arginfo_imap_fetchheader)
        PHP_FE(imap_fetchstructure,                                             arginfo_imap_fetchstructure)
+       PHP_FE(imap_gc,                                                                         arginfo_imap_gc)
        PHP_FE(imap_expunge,                                                    arginfo_imap_expunge)
        PHP_FE(imap_delete,                                                             arginfo_imap_delete)
        PHP_FE(imap_undelete,                                                   arginfo_imap_undelete)
@@ -1025,6 +1031,15 @@ PHP_MINIT_FUNCTION(imap)
        ENCOTHER                unknown
        */
 
+       REGISTER_LONG_CONSTANT("IMAP_GC_ELT", GC_ELT , CONST_PERSISTENT | CONST_CS);
+       REGISTER_LONG_CONSTANT("IMAP_GC_ENV", GC_ENV , CONST_PERSISTENT | CONST_CS);
+       REGISTER_LONG_CONSTANT("IMAP_GC_TEXTS", GC_TEXTS , CONST_PERSISTENT | CONST_CS);
+       /*
+       GC_ELT                 message cache elements
+       GC_ENV                 ENVELOPEs and BODYs
+       GC_TEXTS               texts
+       */
+
        le_imap = zend_register_list_destructors_ex(mail_close_it, NULL, "imap", module_number);
        return SUCCESS;
 }
@@ -1472,6 +1487,31 @@ PHP_FUNCTION(imap_expunge)
 }
 /* }}} */
 
+/* {{{ proto bool imap_gc(resource stream_id, int flags)
+   This function garbage collects (purges) the cache of entries of a specific type. */
+PHP_FUNCTION(imap_gc)
+{
+       zval *streamind;
+       pils *imap_le_struct;
+       long flags;
+
+       if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rl", &streamind, &flags) == FAILURE) {
+               return;
+       }
+
+       if (flags && ((flags & ~(GC_TEXTS | GC_ELT | GC_ENV)) != 0)) {
+               php_error_docref(NULL TSRMLS_CC, E_WARNING, "invalid value for the flags parameter");
+               RETURN_FALSE;
+       }
+
+       ZEND_FETCH_RESOURCE(imap_le_struct, pils *, &streamind, -1, "imap", le_imap);
+
+       mail_gc(imap_le_struct->imap_stream, flags);
+
+       RETURN_TRUE;
+}
+/* }}} */
+
 /* {{{ proto bool imap_close(resource stream_id [, int options])
    Close an IMAP stream */
 PHP_FUNCTION(imap_close)

diff --git a/ext/imap/php_imap.h b/ext/imap/php_imap.h
index 76404f598caad3e79f8f6aee3283f8d6667861d8..b0c65419d04334cef3a89985df5d38f7dbe649a2 100644 (file)
--- a/ext/imap/php_imap.h
+++ b/ext/imap/php_imap.h
@@ -115,6 +115,7 @@ PHP_FUNCTION(imap_body);
 PHP_FUNCTION(imap_fetchstructure);
 PHP_FUNCTION(imap_fetchbody);
 PHP_FUNCTION(imap_savebody);
+PHP_FUNCTION(imap_gc);
 PHP_FUNCTION(imap_expunge);
 PHP_FUNCTION(imap_delete);
 PHP_FUNCTION(imap_undelete);