The IMAP driver class for accessing Kolab storage.
Copyright 2009-2012 Horde LLC (http://www.horde.org/)
See the enclosed file COPYING for license information (LGPL). If you
did not receive this file, see http://www.horde.org/licenses/lgpl21.
Methods summary
public
mixed
|
#
createBackend( )
Create the backend driver.
Create the backend driver.
Returns
mixed The backend driver.
|
public
array
|
#
listFolders( )
Retrieves a list of folders from the server.
Retrieves a list of folders from the server.
Returns
array The list of folders.
|
public
null
|
#
create( string $folder )
Create the specified folder.
Create the specified folder.
Parameters
- $folder
- The folder to create.
Returns
null
|
public
null
|
#
delete( string $folder )
Delete the specified folder.
Delete the specified folder.
Parameters
- $folder
- The folder to delete.
Returns
null
|
public
null
|
#
rename( string $old, string $new )
Rename the specified folder.
Rename the specified folder.
Parameters
- $old
- The folder to rename.
- $new
- The new name of the folder.
Returns
null
|
public
boolean
|
#
hasAclSupport( )
Does the backend support ACL?
Does the backend support ACL?
Returns
boolean True if the backend supports ACLs.
|
public
An
|
#
getAcl( Horde_Kolab_Storage_Folder $folder )
Retrieve the access rights for a folder.
Retrieve the access rights for a folder.
Parameters
- $folder
- The folder to retrieve the ACL for.
Returns
An array of rights.
|
public
string
|
#
getMyAcl( string $folder )
Retrieve the access rights the current user has on a folder.
Retrieve the access rights the current user has on a folder.
Parameters
- $folder
- The folder to retrieve the user ACL for.
Returns
string The user rights.
|
public
null
|
#
setAcl( string $folder, string $user, string $acl )
Set the access rights for a folder.
Set the access rights for a folder.
Parameters
- $folder
- The folder to act upon.
- $user
- The user to set the ACL for.
- $acl
- The ACL.
Returns
null
|
public
null
|
#
deleteAcl( string $folder, string $user )
Delete the access rights for user on a folder.
Delete the access rights for user on a folder.
Parameters
- $folder
- The folder to act upon.
- $user
- The user to delete the ACL for
Returns
null
|
public
array
|
#
listAnnotation( string $annotation )
Retrieves the specified annotation for the complete list of folders.
Retrieves the specified annotation for the complete list of folders.
Parameters
- $annotation
- The name of the annotation to retrieve.
Returns
array An associative array combining the folder names as key with
the corresponding annotation value.
|
public
string
|
#
getAnnotation( string $folder, string $annotation )
Fetches the annotation from a folder.
Fetches the annotation from a folder.
Parameters
- $folder
- The name of the folder.
- $annotation
- The annotation to get.
Returns
string The annotation value.
|
public
null
|
#
setAnnotation( string $folder, string $annotation, array $value )
Sets the annotation on a folder.
Sets the annotation on a folder.
Parameters
- $folder
- The name of the folder.
- $annotation
- The annotation to set.
- $value
- The values to set
Returns
null
|
public
Horde_Kolab_Storage_Driver_Namespace
|
#
getNamespace( )
Retrieve the namespace information for this connection.
Retrieve the namespace information for this connection.
Returns
Horde_Kolab_Storage_Driver_Namespace The initialized namespace handler.
Overrides
|
public
null
|
#
select( string $folder, mixed $mode = Horde_Imap_Client::OPEN_AUTO )
Opens the given folder.
Parameters
- $folder
- The folder to open
- $mode
-
Returns
null
|
public
array
|
#
status( string $folder )
Returns the status of the current folder.
Returns the status of the current folder.
Parameters
- $folder
- Check the status of this folder.
Returns
array An array that contains 'uidvalidity' and 'uidnext'.
|
public
array
|
#
getUids( string $folder )
Returns the message ids of the messages in this folder.
Returns the message ids of the messages in this folder.
Parameters
- $folder
- Check the status of this folder.
Returns
array The message ids.
|
public
array
|
#
fetchComplete( string $folder, array $uid )
Retrieves a complete message.
Retrieves a complete message.
Parameters
- $folder
- The folder to fetch the messages from.
- $uid
- The message UID.
Returns
array The message encapsuled as an array that contains a
Horde_Mime_Headers and a Horde_Mime_Part object.
Overrides
|
public
array
|
#
fetchStructure( string $folder, array $uids )
Retrieves the messages for the given message ids.
Retrieves the messages for the given message ids.
Parameters
- $folder
- The folder to fetch the messages from.
- $uids
- The message UIDs.
Returns
array An array of message structures parsed into Horde_Mime_Part
instances.
Overrides
|
public
resource|string
|
#
fetchBodypart( string $folder, array $uid, array $id )
Retrieves a bodypart for the given message ID and mime part ID.
Retrieves a bodypart for the given message ID and mime part ID.
Parameters
- $folder
- The folder to fetch the messages from.
- $uid
- The message UID.
- $id
- The mime part ID.
Returns
resource|string The body part, as a stream resource or string.
Overrides
|
public
mixed
|
#
appendMessage( string $folder, resource $msg )
Appends a message to the given folder.
Appends a message to the given folder.
Parameters
- $folder
- The folder to append the message(s) to.
- $msg
- The message to append.
Returns
mixed True or the UID of the new message in case the backend
supports UIDPLUS.
|
public
null
|
#
deleteMessages( string $folder, integer $uids )
Deletes messages from the specified folder.
Deletes messages from the specified folder.
Parameters
- $folder
- The folder to delete messages from.
- $uids
- IMAP message ids.
Returns
null
|
public
null
|
#
moveMessage( integer $uid, string $old_folder, string $new_folder )
Moves a message to a new folder.
Moves a message to a new folder.
Parameters
- $uid
- IMAP message id.
- $old_folder
- Source folder.
- $new_folder
- Target folder.
Returns
null
|
public
null
|
#
expunge( string $folder )
Expunges messages in the current folder.
Expunges messages in the current folder.
Parameters
- $folder
- The folder to expunge.
Returns
null
|