Roundcube Framework
Back to top  

rcube_imap

Extends \rcube_storage

Interface class for accessing an IMAP server

package

Framework
subpackage

Storage
author

Thomas Bruederli roundcube@gmail.com
author

Aleksander Machniak alec@alec.pl

Methods

Object constructor.

__construct()

Magic getter for backward compat.

__get( $name)
deprecated

.

Arguments

$name

protected method for listing message headers

_list_messages(string $folder = '', integer $page = NULL, string $sort_field = NULL, string $sort_order = NULL, integer $slice) : array
see \rcube_imap::list_messages

Arguments

$folder

string

Folder name

$page

integer

Current page to list

$sort_field

string

Header field to sort by

$sort_order

string

Sort order [ASC|DESC]

$slice

integer

Number of slice items to extract from result array

Response

array

Indexed array with message header objects

Delete outdated cache entries

cache_gc()
inherited abstract

Subscribe/unsubscribe a list of folders and update local cache

change_subscription( $folders,  $mode)

Arguments

$folders

$mode

Check connection state, connect if not connected.

check_connection() : boolean
inherited abstract

Response

boolean

Connection state.

Checks the PERMANENTFLAGS capability of the current folder and returns true if the given flag is supported by the server.

check_permflag(string $flag) : boolean
inherited abstract

Arguments

$flag

string

Permanentflag name

Response

boolean

True if this flag is supported

Clears the cache.

clear_cache(string $key = null, boolean $prefix_mode = false)
inherited abstract

Arguments

$key

string

Cache key name or pattern

$prefix_mode

boolean

Enable it to clear all keys starting with prefix specified in $key

Remove all messages in a folder.

clear_folder(string $folder = null) : boolean
inherited

.

Arguments

$folder

string

Folder name

Response

boolean

True on success, False on error

Clears the messages cache.

clear_message_cache(string $folder = null, array $uids = null)

Arguments

$folder

string

Folder name

$uids

array

Optional message UIDs to remove from cache

Remove messagecount of a specific folder from cache

clear_messagecount( $folder,  $mode = array())

Arguments

$folder

$mode

Close connection. Usually done on script shutdown

close()
inherited abstract

Connect to the server

connect(string $host, string $user, string $pass, integer $port = 143, string $use_ssl = null) : boolean
inherited abstract

Arguments

$host

string

Host to connect

$user

string

Username for IMAP account

$pass

string

Password for IMAP account

$port

integer

Port to connect to

$use_ssl

string

SSL schema (either ssl or tls) or null if plain connection

Response

boolean

TRUE on success, FALSE on failure

Converts charset of search criteria string

convert_criteria(string $str, string $charset, string $dest_charset = 'US-ASCII') : string
static

Arguments

$str

string

Search string

$charset

string

Original charset

$dest_charset

string

Destination charset (default US-ASCII)

Response

string

Search string

Copy message(s) from one mailbox to another.

copy_message(mixed $uids, string $to, string $from = null) : boolean
inherited abstract

Arguments

$uids

mixed

Message UIDs as array or comma-separated string, or '*'

$to

string

Target folder

$from

string

Source folder

Response

boolean

True on success, False on error

Get messages count for a specific folder.

count(string $folder = null, string $mode = 'ALL', boolean $force = false, boolean $status = true) : integer
inherited abstract

Arguments

$folder

string

Folder name

$mode

string

Mode for count [ALL|THREADS|UNSEEN|RECENT|EXISTS]

$force

boolean

Force reading from server and update cache

$status

boolean

Enables storing folder status info (max UID/count), required for folder_status()

Response

integer

Number of messages

Protected method for getting number of messages

countmessages(string $folder, string $mode = 'ALL', boolean $force = false, boolean $status = true, boolean $no_search = false) : integer
see \rcube_imap::count()

Arguments

$folder

string

Folder name

$mode

string

Mode for count [ALL|THREADS|UNSEEN|RECENT|EXISTS]

$force

boolean

Force reading from server and update cache

$status

boolean

Enables storing folder status info (max UID/count), required for folder_status()

$no_search

boolean

Ignore current search result

Response

integer

Number of messages

Create all folders specified as default

create_default_folders()
inherited

Create a new folder on the server.

create_folder(string $folder, boolean $subscribe = false) : boolean
inherited abstract

Arguments

$folder

string

New folder name

$subscribe

boolean

True if the newvfolder should be subscribed

Response

boolean

True on success, False on error

Converts date string/object into IMAP date/time format

date_format( $date)

Arguments

$date

This is our own debug handler for the IMAP connection

debug_handler( &$imap,  $message)

Arguments

$imap

$message

Removes any <identifier,rights> pair for the specified user from the ACL for the specified folder (DELETEACL).

delete_acl(string $folder, string $user) : boolean
inherited abstract

Arguments

$folder

string

Folder name

$user

string

User name

Response

boolean

True on success, False on failure

Remove a folder from the server.

delete_folder(string $folder) : boolean
inherited abstract

Arguments

$folder

string

Folder name

Response

boolean

True on success, False on error

Mark message(s) as deleted and expunge.

delete_message(mixed $uids, string $folder = null) : boolean
inherited abstract

Arguments

$uids

mixed

Message UIDs as array or comma-separated string, or '*'

$folder

string

Source folder

Response

boolean

True on success, False on error

Unsets metadata/annotations (SETMETADATA/SETANNOTATION)

delete_metadata(string $folder, array $entries) : boolean
inherited abstract

Arguments

$folder

string

Folder name (empty for server metadata)

$entries

array

Entry names array

Response

boolean

True on success, False on failure

Send expunge command and clear the cache.

expunge_folder(string $folder = null, boolean $clear_cache = true) : boolean
inherited

Arguments

$folder

string

Folder name

$clear_cache

boolean

False if cache should not be cleared

Response

boolean

True on success, False on error

Expunge message(s) and clear the cache.

expunge_message(mixed $uids, string $folder = null, boolean $clear_cache = true) : boolean
inherited abstract

Arguments

$uids

mixed

Message UIDs as array or comma-separated string, or '*'

$folder

string

Folder name

$clear_cache

boolean

False if cache should not be cleared

Response

boolean

True on success, False on error

Fetches messages headers (by UID)

fetch_headers(string $folder, array $msgs, boolean $sort = true, boolean $force = false) : array

Arguments

$folder

string

Folder name

$msgs

array

Message UIDs

$sort

boolean

Enables result sorting by $msgs

$force

boolean

Disables cache use

Response

array

Messages headers indexed by UID

protected method for fetching threaded messages headers

fetch_thread_headers(string $folder, \rcube_result_thread $threads, integer $page, integer $slice) : array

Arguments

$folder

string

Folder name

$threads

\rcube_result_thread

Threads data object

$page

integer

List page number

$slice

integer

Number of threads to slice

Response

array

Messages headers

Filter the given list of folders according to access rights

filter_rights( $a_folders,  $rights)

For performance reasons we assume user has full rights on all personal folders.

Arguments

$a_folders

$rights

Gets folder attributes (from LIST response, e.g. \Noselect, \Noinferiors).

folder_attributes(string $folder, boolean $force = false) : array
inherited abstract

Arguments

$folder

string

Folder name

$force

boolean

Set to True if attributes should be refreshed

Response

array

Options list

Gets connection (and current folder) data: UIDVALIDITY, EXISTS, RECENT, PERMANENTFLAGS, UIDNEXT, UNSEEN

folder_data(string $folder) : array
inherited abstract

Arguments

$folder

string

Folder name

Response

array

Data

Checks if folder exists and is subscribed

folder_exists(string $folder, boolean $subscription = false) : boolean
inherited abstract

Arguments

$folder

string

Folder name

$subscription

boolean

Enable subscription checking

Response

boolean

True if folder exists, False otherwise

Returns extended information about the folder.

folder_info(string $folder) : array
inherited abstract

Arguments

$folder

string

Folder name

Response

array

Data

Returns the namespace where the folder is in

folder_namespace(string $folder) : string
inherited abstract

Arguments

$folder

string

Folder name

Response

string

One of 'personal', 'other' or 'shared'

Get folder size (size of all messages in a folder)

folder_size(string $folder) : integer
inherited abstract

Arguments

$folder

string

Folder name

Response

integer

Folder size in bytes, False on error

Returns current status of a folder (compared to the last time use)

folder_status(string $folder = null, array &$diff = array()) : integer
inherited abstract

Arguments

$folder

string

Folder name

$diff

array

Difference data

Response

integer

Folder status

Synchronizes messages cache.

folder_sync(string $folder)
inherited abstract

Arguments

$folder

string

Folder name

Returns the access control list for a folder (GETACL).

get_acl(string $folder) : array
inherited abstract

Arguments

$folder

string

Folder name

Response

array

User-rights array on success, NULL on error

Fetch message body of a specific message from the server

get_body(integer $uid,  $part = 1) : string
inherited
see \rcube_imap::get_message_part()

Arguments

$uid

integer

Message UID

$part

Response

string

$part Message/part body

Returns cached value

get_cache(string $key) : mixed
inherited abstract

Arguments

$key

string

Cache key

Response

mixed

Cached value

Getter for IMAP cache object

get_cache_engine()

Returns the storage server's (IMAP) capability

get_capability(string $cap) : mixed
inherited abstract

Arguments

$cap

string

Capability name

Response

mixed

Capability value or TRUE if supported, FALSE if not

Returns code of last error

get_error_code() : integer
inherited abstract

Response

integer

Error code

Returns message of last error

get_error_str() : string
inherited abstract

Response

string

Error message

Get message header names for rcube_imap_generic::fetchHeader(s)

get_fetch_headers() : string

Response

string

Space-separated list of header names

Returns the currently used folder name

get_folder() : string
inherited

Response

string

Name of the folder

Gets folder statistic data

get_folder_stats(string $folder) : array

Arguments

$folder

string

Folder name

Response

array

Stats data

Returns the delimiter that is used by the server for folder hierarchy separation.

get_hierarchy_delimiter() : string
inherited abstract

Response

string

Delimiter string

Getter for messages cache object

get_mcache_engine()

Fetch message headers and body structure from the server and build an object structure.

get_message(integer $uid, string $folder = null) : object
inherited abstract

Arguments

$uid

integer

Message UID to fetch

$folder

string

Folder to read from

Response

object

rcube_message_header Message data

Return message headers object of a specific message

get_message_headers( $uid, string $folder = null, boolean $force = false) : \rcube_message_header
inherited abstract

Arguments

$uid

$folder

string

Folder to read from

$force

boolean

True to skip cache

Response

\rcube_message_header

Message headers

Fetch message body of a specific message from the server

get_message_part(integer $uid, string $part = 1, \rcube_message_part $o_part = null, mixed $print = null, resource $fp = null, boolean $skip_charset_conv = false) : string
inherited abstract

Arguments

$uid

integer

Message UID

$part

string

Part number

$o_part

\rcube_message_part

Part object created by get_structure()

$print

mixed

True to print part, resource to write part contents in

$fp

resource

File pointer to save the message part

$skip_charset_conv

boolean

Disables charset conversion

Response

string

Message/part body if not printed

Returns folder metadata/annotations (GETMETADATA/GETANNOTATION).

get_metadata(string $folder, array $entries, array $options = array(), boolean $force = false) : array
inherited abstract

Arguments

$folder

string

Folder name (empty for server metadata)

$entries

array

Entries

$options

array

Command options (with MAXSIZE and DEPTH keys)

$force

boolean

Disables cache use

Response

array

Metadata entry-value hash array on success, NULL on error

Get namespace

get_namespace(string $name = null) : array
inherited abstract

Arguments

$name

string

Namespace array index: personal, other, shared, prefix

Response

array

Namespace data

Get connection/class option

get_option(string $name)
inherited

Arguments

$name

string

Option name

Gets internal list page number.

get_page() : integer
inherited

Response

integer

Page number

Get internal page size

get_pagesize() : integer
inherited

Response

integer

Number of messages to display on one page

Returns PERMANENTFLAGS of the specified folder

get_permflags(string $folder) : array

Arguments

$folder

string

Folder name

Response

array

Flags

Get mailbox quota information.

get_quota(string $folder = null) : mixed
inherited abstract

Arguments

$folder

string

Folder name

Response

mixed

Quota info or False if not supported

Returns the whole message source as string (or saves to a file)

get_raw_body(integer $uid, resource $fp = null, string $part = null) : string
inherited abstract

Arguments

$uid

integer

Message UID

$fp

resource

File pointer to save the message

$part

string

Optional message part ID

Response

string

Message source string

Returns the message headers as string

get_raw_headers(integer $uid, string $part = null) : string
inherited abstract

Arguments

$uid

integer

Message UID

$part

string

Optional message part ID

Response

string

Message headers string

Returns code of last command response

get_response_code() : integer
inherited abstract

Response

integer

Response code (class constant)

Return the saved search set.

get_search_set() : array
inherited abstract

Response

array

Search set in driver specific format, NULL if search wasn't initialized

Return configured special folders

get_special_folders( $forced = false)
inherited

Arguments

$forced

Get current threading flag.

get_threading() : mixed
inherited

Response

mixed

Threading algorithm or False if THREAD is not supported or disabled

Returns IMAP server vendor name

get_vendor() : string
since 1.2

Response

string

Vendor name

Find UID of the specified message sequence ID

id2uid(integer $id, string $folder = null) : integer

Arguments

$id

integer

Message (sequence) ID

$folder

string

Folder name

Response

integer

Message UID

Return sorted list of message UIDs

index(string $folder = null, string $sort_field = null, string $sort_order = null) : \rcube_result_index|\rcube_result_thread
inherited abstract

Arguments

$folder

string

Folder to get index from

$sort_field

string

Sort column

$sort_order

string

Sort order [ASC, DESC]

Response

\rcube_result_index|\rcube_result_thread

List of messages (UIDs)

Return sorted list of message UIDs ignoring current search settings.

index_direct(string $folder, string $sort_field = null, string $sort_order = null, \rcube_result_* $search = null) : \rcube_result_index

Doesn't uses cache by default.

Arguments

$folder

string

Folder to get index from

$sort_field

string

Sort column

$sort_order

string

Sort order [ASC, DESC]

$search

\rcube_result_*

Optional messages set to limit the result

Response

\rcube_result_index

Sorted list of message UIDs

Checks connection state.

is_connected() : boolean
inherited abstract

Response

boolean

TRUE on success, FALSE on failure

Check if specified folder is a special folder

is_special_folder( $name)
inherited

Arguments

$name

Public method for listing message flags

list_flags(string $folder, array $uids, integer $mod_seq = null) : array
inherited abstract

Arguments

$folder

string

Folder name

$uids

array

Message UIDs

$mod_seq

integer

Optional MODSEQ value

Response

array

Indexed array with message flags

Get a list of all folders available on the server.

list_folders(string $root = '', string $name = '*', mixed $filter = null, string $rights = null, boolean $skip_sort = false) : array
inherited abstract

Arguments

$root

string

IMAP root dir

$name

string

Optional name pattern

$filter

mixed

Optional filter

$rights

string

Optional ACL requirements

$skip_sort

boolean

Enable to return unsorted list (for better performance)

Response

array

Indexed array with folder names

Method for direct folders listing (LIST)

list_folders_direct(string $root = '', string $name = '*') : array
see \rcube_imap::list_folders()

Arguments

$root

string

Optional root folder

$name

string

Optional name pattern

Response

array

List of folders

Get a list of subscribed folders.

list_folders_subscribed(string $root = '', string $name = '*', string $filter = null, string $rights = null, boolean $skip_sort = false) : array
inherited abstract

Arguments

$root

string

Optional root folder

$name

string

Optional name pattern

$filter

string

Optional filter

$rights

string

Optional ACL requirements

$skip_sort

boolean

Enable to return unsorted list (for better performance)

Response

array

List of folders

Method for direct folders listing (LSUB)

list_folders_subscribed_direct(string $root = '', string $name = '*') : array
see \rcube_imap::list_folders_subscribed()

Arguments

$root

string

Optional root folder

$name

string

Optional name pattern

Response

array

List of subscribed folders

Fix folders list by adding folders from other namespaces.

list_folders_update(array &$result, string $type = null)

Needed on some servers eg. Courier IMAP

Arguments

$result

array

Reference to folders list

$type

string

Listing type (ext-subscribed, subscribed or all)

Public method for listing headers.

list_messages(string $folder = null, integer $page = null, string $sort_field = null, string $sort_order = null, integer $slice) : array
inherited abstract

Arguments

$folder

string

Folder name

$page

integer

Current page to list

$sort_field

string

Header field to sort by

$sort_order

string

Sort order [ASC|DESC]

$slice

integer

Number of slice items to extract from result array

Response

array

Indexed array with message header objects

Returns information about what rights can be granted to the user (identifier) in the ACL for the folder (LISTRIGHTS).

list_rights(string $folder, string $user) : array
inherited abstract

Arguments

$folder

string

Folder name

$user

string

User name

Response

array

List of user rights

protected method for listing a set of message headers (search results)

list_search_messages(string $folder, integer $page, integer $slice) : array

Arguments

$folder

string

Folder name

$page

integer

Current page to list

$slice

integer

Number of slice items to extract from result array

Response

array

Indexed array with message header objects

protected method for listing a set of threaded message headers (search results)

list_search_thread_messages(string $folder, integer $page, integer $slice) : array
see \rcube_imap::list_search_messages()

Arguments

$folder

string

Folder name

$page

integer

Current page to list

$slice

integer

Number of slice items to extract from result array

Response

array

Indexed array with message header objects

protected method for listing message headers using threads

list_thread_messages(string $folder, integer $page, integer $slice) : array
see \rcube_imap::list_messages

Arguments

$folder

string

Folder name

$page

integer

Current page to list

$slice

integer

Number of slice items to extract from result array

Response

array

Indexed array with message header objects

Converts the METADATA extension entry name into the correct entry-attrib names for older ANNOTATEMORE version.

md2annotate(string $entry) : array

Arguments

$entry

string

Entry name

Response

array

Entry-attribute list, NULL if not supported (?)

Modify folder name according to namespace.

mod_folder(string $folder, string $mode = 'out') : string
inherited abstract

For output it removes prefix of the personal namespace if it's possible. For input it adds the prefix. Use it before creating a folder in root of the folders tree.

Arguments

$folder

string

Folder name

$mode

string

Mode name (out/in)

Response

string

Folder name

Move message(s) from one folder to another.

move_message(mixed $uids, string $to, string $from = null) : boolean
inherited abstract

Arguments

$uids

mixed

Message UIDs as array or comma-separated string, or '*'

$to

string

Target folder

$from

string

Source folder

Response

boolean

True on success, False on error

Returns the set of rights that the current user has to a folder (MYRIGHTS).

my_rights(string $folder) : array
inherited abstract

Arguments

$folder

string

Folder name

Response

array

MYRIGHTS response on success, NULL on error

Parse message UIDs input

parse_uids(mixed $uids) : array
inherited

Arguments

$uids

mixed

UIDs array or comma-separated list or '' or '1:'

Response

array

Two elements array with UIDs converted to list and ALL flag

Sends the whole message source to stdout

print_raw_body(integer $uid, boolean $formatted = true)
inherited abstract

Arguments

$uid

integer

Message UID

$formatted

boolean

Enables line-ending formatting

Refresh saved search set

refresh_search() : array
inherited abstract

Response

array

Current search set

Set a new name to an existing folder

rename_folder(string $folder, string $new_name) : boolean
inherited abstract

Arguments

$folder

string

Folder to rename

$new_name

string

New folder name

Response

boolean

True on success, False on error

Append a mail message (source) to a specific folder.

save_message(string $folder, string|array &$message, string $headers = '', boolean $is_file = false, array $flags = array(), mixed $date = null) : integer|boolean
inherited abstract

Arguments

$folder

string

Target folder

$message

string|array

The message source string or filename or array (of strings and file pointers)

$headers

string

Headers string if $message contains only the body

$is_file

boolean

True if $message is a filename

$flags

array

Message flags

$date

mixed

Message internal date

Response

integer|boolean

Appended message UID or True on success, False on error

Invoke search request to the server.

search(string $folder = null, string $str = 'ALL', string $charset = null, string $sort_field = null)
inherited abstract
todo

: Search criteria should be provided in non-IMAP format, eg. array

Arguments

$folder

string

Folder name to search in

$str

string

Search criteria

$charset

string

Search charset

$sort_field

string

Header field to sort by

protected search method

search_index(string $folder, string $criteria = 'ALL', string $charset = NULL, string $sort_field = NULL) : \rcube_result_index|\rcube_result_thread
see \rcube_imap::search()

Arguments

$folder

string

Folder name

$criteria

string

Search criteria

$charset

string

Charset

$sort_field

string

Sorting field

Response

\rcube_result_index|\rcube_result_thread

Search results (UIDs)

Direct (real and simple) search request (without result sorting and caching).

search_once(string $folder = null, string $str = 'ALL') : \rcube_result_index
inherited abstract

Arguments

$folder

string

Folder name to search in

$str

string

Search string

Response

\rcube_result_index

Search result (UIDs)

Changes the ACL on the specified folder (SETACL)

set_acl(string $folder, string $user, string $acl) : boolean
inherited abstract

Arguments

$folder

string

Folder name

$user

string

User name

$acl

string

ACL string

Response

boolean

True on success, False on failure

Enable or disable indexes caching

set_caching(string $type)

Arguments

$type

string

Cache type (@see rcube::get_cache)

Set default message charset.

set_charset(string $cs)
inherited

This will be used for message decoding if a charset specification is not available

Arguments

$cs

string

Charset string

Activate/deactivate debug mode.

set_debug(boolean $dbg = true)
inherited abstract

Arguments

$dbg

boolean

True if conversation with the server should be logged

Sets delimiter and namespaces

set_env()

Set message flag to one or several messages

set_flag(mixed $uids, string $flag, string $folder = null, boolean $skip_cache = false) : boolean
inherited abstract

Arguments

$uids

mixed

Message UIDs as array or comma-separated string, or '*'

$flag

string

Flag to set: SEEN, UNDELETED, DELETED, RECENT, ANSWERED, DRAFT, MDNSENT

$folder

string

Folder name

$skip_cache

boolean

True to skip message cache clean up

Response

boolean

Operation status

Set internal folder reference.

set_folder(string $folder)
inherited

All operations will be performed on this folder.

Arguments

$folder

string

Folder name

Stores folder statistic data in session

set_folder_stats(string $folder, string $name, mixed $data)
TODO

: move to separate DB table (cache?)

Arguments

$folder

string

Folder name

$name

string

Data name

$data

mixed

Data value

Increde/decrese messagecount for a specific folder

set_messagecount( $folder,  $mode,  $increment)

Arguments

$folder

$mode

$increment

Enable or disable messages caching

set_messages_caching(boolean $set, integer $mode = null)

Arguments

$set

boolean

Flag

$mode

integer

Cache mode

Sets metadata/annotations (SETMETADATA/SETANNOTATION)

set_metadata(string $folder, array $entries) : boolean
inherited abstract

Arguments

$folder

string

Folder name (empty for server metadata)

$entries

array

Entry-value array (use NULL value as NIL)

Response

boolean

True on success, False on failure

Set connection and class options

set_options(array $opt)
inherited

Arguments

$opt

array

Options array

Set internal list page number.

set_page(integer $page)
inherited

Arguments

$page

integer

Page number to list

Set internal page size

set_pagesize(integer $size)
inherited

Arguments

$size

integer

Number of messages to display on one page

Set attachment filename from message part structure

set_part_filename(\rcube_message_part &$part, string $headers = null)

Arguments

$part

\rcube_message_part

Part object

$headers

string

Part's raw headers

Flag certain result subsets as 'incomplete'.

set_search_dirty( $folder)

For subsequent refresh_search() calls to only refresh the updated parts.

Arguments

$folder

Save a search result for future message listing methods.

set_search_set(mixed $set)
inherited abstract

Arguments

$set

mixed

Search set in driver specific format

Validate the given input and save to local properties

set_sort_order(string $sort_field, string $sort_order)

Arguments

$sort_field

string

Sort column

$sort_order

string

Sort order

Set special folder associations stored in backend

set_special_folders( $specials)
inherited

Arguments

$specials

protected method for setting threaded messages flags: depth, has_children, unread_children, flagged_children

set_thread_flags(array &$headers, \rcube_result_thread $threads) : array

Arguments

$headers

array

Reference to headers array indexed by message UID

$threads

\rcube_result_thread

Threads data object

Response

array

Message headers array indexed by message UID

Sets threading flag to the best supported THREAD algorithm.

set_threading(boolean $enable = false) : mixed
inherited

Enable/Disable threaded mode.

Arguments

$enable

boolean

TRUE to enable and FALSE

Response

mixed

Threading algorithm or False if THREAD is not supported

Callback for uasort() that implements correct locale-aware case-sensitive sorting

sort_folder_comparator( $str1,  $str2)

Arguments

$str1

$str2

Sort folders first by default folders and then in alphabethical order

sort_folder_list(array $a_folders, boolean $skip_default = false) : array

Arguments

$a_folders

array

Folders list

$skip_default

boolean

Skip default folders handling

Response

array

Sorted list

Recursive function to put subfolders of special folders in place

sort_folder_specials( $folder,  &$list,  &$specials,  &$out)

Arguments

$folder

$list

$specials

$out

Sort threaded result, using THREAD=REFS method if available.

sort_threads(\rcube_result_thread $threads)

If not, use any method and re-sort the result in THREAD=REFS way.

Arguments

$threads

\rcube_result_thread

Threads result set

Get charset name from message structure (first part)

structure_charset(array $structure) : string

Arguments

$structure

array

Message structure

Response

string

Charset name

Build message part object

structure_part(array $part, integer $count, string $parent = '',  $mime_headers = null)

Arguments

$part

array

$count

integer

$parent

string

$mime_headers

Subscribe to a specific folder(s)

subscribe(array $folders) : boolean
inherited abstract

Arguments

$folders

array

Folder name(s)

Response

boolean

True on success

Return index of threaded message UIDs

thread_index(string $folder = '', string $sort_field = NULL, string $sort_order = NULL) : \rcube_result_thread

Arguments

$folder

string

Folder to get index from

$sort_field

string

Sort column

$sort_order

string

Sort order [ASC, DESC]

Response

\rcube_result_thread

Message UIDs

Method for fetching threads data

threads(string $folder) : \rcube_imap_thread

Arguments

$folder

string

Folder name

Response

\rcube_imap_thread

Thread data object

Method for direct fetching of threads data

threads_direct(string $folder) : \rcube_imap_thread

Arguments

$folder

string

Folder name

Response

\rcube_imap_thread

Thread data object

Remove message flag for one or several messages

unset_flag(mixed $uids, string $flag, string $folder = null) : boolean
inherited
see \set_flag

Arguments

$uids

mixed

Message UIDs as array or comma-separated string, or '*'

$flag

string

Flag to unset: SEEN, DELETED, RECENT, ANSWERED, DRAFT, MDNSENT

$folder

string

Folder name

Response

boolean

Operation status

Unsubscribe folder(s)

unsubscribe(array $folders) : boolean
inherited abstract

Arguments

$folders

array

Folder name(s)

Response

boolean

True on success

Update cache

update_cache(string $key, mixed $data)

Arguments

$key

string

Cache key

$data

mixed

Data

Constants

UNKNOWN

UNKNOWN
inherited

NOPERM

NOPERM
inherited

READONLY

READONLY
inherited

TRYCREATE

TRYCREATE
inherited

INUSE

INUSE
inherited

OVERQUOTA

OVERQUOTA
inherited

ALREADYEXISTS

ALREADYEXISTS
inherited

NONEXISTENT

NONEXISTENT
inherited

CONTACTADMIN

CONTACTADMIN
inherited

Properties

Instance of connection object e.g. rcube_imap_generic

conn : mixed
inherited
var

Type(s)

mixed

Instance of rcube_imap_cache

mcache : \rcube_imap_cache
var

Type(s)

\rcube_imap_cache

Instance of rcube_cache

cache : \rcube_cache
var

Type(s)

\rcube_cache

Internal (in-memory) cache

icache : array
var

Type(s)

array

plugins

plugins :

Type(s)

delimiter

delimiter :

Type(s)

namespace

namespace :

Type(s)

sort_field

sort_field :

Type(s)

sort_order

sort_order :

Type(s)

struct_charset

struct_charset :

Type(s)

search_set

search_set :
inherited

Type(s)

search_string

search_string :

Type(s)

search_charset

search_charset :

Type(s)

search_sort_field

search_sort_field :

Type(s)

search_threads

search_threads :

Type(s)

search_sorted

search_sorted :

Type(s)

options

options :
inherited

Type(s)

caching

caching :

Type(s)

messages_caching

messages_caching :

Type(s)

threading

threading :
inherited

Type(s)

List of supported special folder types

folder_types : array
inherited static
var

Type(s)

array

folder

folder :
inherited

Type(s)

default_charset

default_charset :
inherited

Type(s)

page_size

page_size :
inherited

Type(s)

list_page

list_page :
inherited

Type(s)

All (additional) headers used (in any way) by Roundcube Not listed here: DATE, FROM, TO, CC, REPLY-TO, SUBJECT, CONTENT-TYPE, LIST-POST (used for messages listing) are hardcoded in rcube_imap_generic::fetchHeaders()

all_headers : array
inherited
var

Type(s)

array