[Summary view] [Print] [Text view]

   1  <?php
   2  /**
   3   * Copyright 2008-2014 Horde LLC (http://www.horde.org/)
   4   *
   5   * See the enclosed file COPYING for license information (LGPL). If you
   6   * did not receive this file, see http://www.horde.org/licenses/lgpl21.
   7   *
   8   * @category  Horde
   9   * @copyright 2008-2014 Horde LLC
  10   * @license   http://www.horde.org/licenses/lgpl21 LGPL 2.1
  11   * @package   Imap_Client
  12   */
  13  
  14  /**
  15   * Base class for Horde_Imap_Client package. Defines common constants for use
  16   * in the package.
  17   *
  18   * @author    Michael Slusarz <slusarz@horde.org>
  19   * @category  Horde
  20   * @copyright 2008-2014 Horde LLC
  21   * @license   http://www.horde.org/licenses/lgpl21 LGPL 2.1
  22   * @package   Imap_Client
  23   */
  24  class Horde_Imap_Client
  25  {
  26      /* Constants for openMailbox() */
  27      const OPEN_READONLY = 1;
  28      const OPEN_READWRITE = 2;
  29      const OPEN_AUTO = 3;
  30  
  31      /* Constants for listMailboxes() */
  32      const MBOX_SUBSCRIBED = 1;
  33      const MBOX_SUBSCRIBED_EXISTS = 2;
  34      const MBOX_UNSUBSCRIBED = 3;
  35      const MBOX_ALL = 4;
  36  
  37      /* Constants for status() */
  38      const STATUS_MESSAGES = 1;
  39      const STATUS_RECENT = 2;
  40      const STATUS_UIDNEXT = 4;
  41      const STATUS_UIDVALIDITY = 8;
  42      const STATUS_UNSEEN = 16;
  43      const STATUS_ALL = 32;
  44      const STATUS_FIRSTUNSEEN = 64;
  45      const STATUS_FLAGS = 128;
  46      const STATUS_PERMFLAGS = 256;
  47      const STATUS_HIGHESTMODSEQ = 512;
  48      const STATUS_SYNCMODSEQ = 1024;
  49      const STATUS_SYNCFLAGUIDS = 2048;
  50      const STATUS_UIDNOTSTICKY = 4096;
  51      const STATUS_UIDNEXT_FORCE = 8192;
  52      const STATUS_SYNCVANISHED = 16384;
  53      /* @since 2.12.0 */
  54      const STATUS_RECENT_TOTAL = 32768;
  55      /* @since 2.14.0 */
  56      const STATUS_FORCE_REFRESH = 65536;
  57  
  58      /* Constants for search() */
  59      const SORT_ARRIVAL = 1;
  60      const SORT_CC = 2;
  61      const SORT_DATE = 3;
  62      const SORT_FROM = 4;
  63      const SORT_REVERSE = 5;
  64      const SORT_SIZE = 6;
  65      const SORT_SUBJECT = 7;
  66      const SORT_TO = 8;
  67      /* SORT_THREAD provided for completeness - it is not a valid sort criteria
  68       * for search() (use thread() instead). */
  69      const SORT_THREAD = 9;
  70      /* Sort criteria defined in RFC 5957 */
  71      const SORT_DISPLAYFROM = 10;
  72      const SORT_DISPLAYTO = 11;
  73      /* SORT_SEQUENCE does a simple numerical sort on the returned
  74       * UIDs/sequence numbers. */
  75      const SORT_SEQUENCE = 12;
  76      /* Fuzzy sort criteria defined in RFC 6203 */
  77      const SORT_RELEVANCY = 13;
  78      /* @since 2.4.0 */
  79      const SORT_DISPLAYFROM_FALLBACK = 14;
  80      /* @since 2.4.0 */
  81      const SORT_DISPLAYTO_FALLBACK = 15;
  82  
  83      /* Search results constants */
  84      const SEARCH_RESULTS_COUNT = 1;
  85      const SEARCH_RESULTS_MATCH = 2;
  86      const SEARCH_RESULTS_MAX = 3;
  87      const SEARCH_RESULTS_MIN = 4;
  88      const SEARCH_RESULTS_SAVE = 5;
  89      /* Fuzzy sort criteria defined in RFC 6203 */
  90      const SEARCH_RESULTS_RELEVANCY = 6;
  91  
  92      /* Constants for thread() */
  93      const THREAD_ORDEREDSUBJECT = 1;
  94      const THREAD_REFERENCES = 2;
  95      const THREAD_REFS = 3;
  96  
  97      /* Fetch criteria constants. */
  98      const FETCH_STRUCTURE = 1;
  99      const FETCH_FULLMSG = 2;
 100      const FETCH_HEADERTEXT = 3;
 101      const FETCH_BODYTEXT = 4;
 102      const FETCH_MIMEHEADER = 5;
 103      const FETCH_BODYPART = 6;
 104      const FETCH_BODYPARTSIZE = 7;
 105      const FETCH_HEADERS = 8;
 106      const FETCH_ENVELOPE = 9;
 107      const FETCH_FLAGS = 10;
 108      const FETCH_IMAPDATE = 11;
 109      const FETCH_SIZE = 12;
 110      const FETCH_UID = 13;
 111      const FETCH_SEQ = 14;
 112      const FETCH_MODSEQ = 15;
 113      /* @since 2.11.0 */
 114      const FETCH_DOWNGRADED = 16;
 115  
 116      /* Namespace constants. @deprecated */
 117      const NS_PERSONAL = 1;
 118      const NS_OTHER = 2;
 119      const NS_SHARED = 3;
 120  
 121      /* ACL constants (RFC 4314 [2.1]). */
 122      const ACL_LOOKUP = 'l';
 123      const ACL_READ = 'r';
 124      const ACL_SEEN = 's';
 125      const ACL_WRITE = 'w';
 126      const ACL_INSERT = 'i';
 127      const ACL_POST = 'p';
 128      const ACL_CREATEMBOX = 'k';
 129      const ACL_DELETEMBOX = 'x';
 130      const ACL_DELETEMSGS = 't';
 131      const ACL_EXPUNGE = 'e';
 132      const ACL_ADMINISTER = 'a';
 133      // Old constants (RFC 2086 [3]; RFC 4314 [2.1.1])
 134      const ACL_CREATE = 'c';
 135      const ACL_DELETE = 'd';
 136  
 137      /* System flags. */
 138      // RFC 3501 [2.3.2]
 139      const FLAG_ANSWERED = '\\answered';
 140      const FLAG_DELETED = '\\deleted';
 141      const FLAG_DRAFT = '\\draft';
 142      const FLAG_FLAGGED = '\\flagged';
 143      const FLAG_RECENT = '\\recent';
 144      const FLAG_SEEN = '\\seen';
 145      // RFC 3503 [3.3]
 146      const FLAG_MDNSENT = '$mdnsent';
 147      // RFC 5550 [2.8]
 148      const FLAG_FORWARDED = '$forwarded';
 149      // RFC 5788 registered keywords:
 150      // http://www.ietf.org/mail-archive/web/morg/current/msg00441.html
 151      const FLAG_JUNK = '$junk';
 152      const FLAG_NOTJUNK = '$notjunk';
 153  
 154      /* Special-use mailbox attributes (RFC 6154 [2]). */
 155      const SPECIALUSE_ALL = '\\All';
 156      const SPECIALUSE_ARCHIVE = '\\Archive';
 157      const SPECIALUSE_DRAFTS = '\\Drafts';
 158      const SPECIALUSE_FLAGGED = '\\Flagged';
 159      const SPECIALUSE_JUNK = '\\Junk';
 160      const SPECIALUSE_SENT = '\\Sent';
 161      const SPECIALUSE_TRASH = '\\Trash';
 162  
 163      /* Constants for sync(). */
 164      const SYNC_UIDVALIDITY = 0;
 165      const SYNC_FLAGS = 1;
 166      const SYNC_FLAGSUIDS = 2;
 167      const SYNC_NEWMSGS = 4;
 168      const SYNC_NEWMSGSUIDS = 8;
 169      const SYNC_VANISHED = 16;
 170      const SYNC_VANISHEDUIDS = 32;
 171      const SYNC_ALL = 64;
 172  
 173      /**
 174       * Capability dependencies.
 175       *
 176       * @var array
 177       */
 178      static public $capability_deps = array(
 179          // RFC 7162 [3.2]
 180          'QRESYNC' => array(
 181              // QRESYNC requires CONDSTORE, but the latter is implied and is
 182              // not required to be listed.
 183              'ENABLE'
 184          ),
 185          // RFC 5182 [2.1]
 186          'SEARCHRES' => array(
 187              'ESEARCH'
 188          ),
 189          // RFC 5255 [3.1]
 190          'LANGUAGE' => array(
 191              'NAMESPACE'
 192          ),
 193          // RFC 5957 [1]
 194          'SORT=DISPLAY' => array(
 195              'SORT'
 196          )
 197      );
 198  
 199  }