API Documentation

Mail/Storage/Folder/Mbox.php

Zend Framework

LICENSE

This source file is subject to the new BSD license that is bundled with this package in the file LICENSE.txt. It is also available through the world-wide-web at this URL: http://framework.zend.com/license/new-bsd If you did not receive a copy of the license and are unable to obtain it through the world-wide-web, please send an email to license@zend.com so we can send you a copy immediately.

category
Zend  
copyright
Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)  
license
New BSD License  
package
Zend_Mail  
subpackage
Storage  
version
$Id: Mbox.php 23775 2011-03-01 17:25:24Z ralph $  

\Zend_Mail_Storage_Folder_Mbox

Extends from
\Zend_Mail_Storage_Mbox
Implements
\Zend_Mail_Storage_Folder_Interface
category
Zend  
copyright
Copyright (c) 2005-2011 Zend Technologies USA Inc. (http://www.zend.com)  
license
New BSD License  
package
Zend_Mail  
subpackage
Storage  

Properties

Propertyprotectedstring  $_currentFolder= ''

name of current folder

Details
Type
string
Propertyprotected\Zend_Mail_Storage_Folder  $_rootFolder= ''

Zend_Mail_Storage_Folder root folder for folder structure

Propertyprotectedstring  $_rootdir= ''

rootdir of folder structure

Details
Type
string

Methods

methodpublic__construct( array $params ) : void

Create instance with parameters

Disallowed parameters are: - filename use Zend_Mail_Storage_Mbox for a single file Supported parameters are: - dirname rootdir of mbox structure - folder intial selected folder, default is 'INBOX'

Parameters
Name Type Description
$params array mail reader specific parameters
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodpublic__destruct( ) : void

Destructor calls close() and therefore closes the resource.

Inherited from: \Zend_Mail_Storage_Abstract::__destruct()
methodpublic__get( string $var ) : bool

Getter for has-properties. The standard has properties are: hasFolder, hasUniqueid, hasDelete, hasCreate, hasTop

Inherited from: \Zend_Mail_Storage_Abstract::__get()

The valid values for the has-properties are: - true if a feature is supported - false if a feature is not supported - null is it's not yet known or it can't be know if a feature is supported

Parameters
Name Type Description
$var string property name
Returns
Type Description
bool supported or not
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodpublic__sleep( ) : array

magic method for serialize()

with this method you can cache the mbox class

Returns
Type Description
array name of variables
methodpublic__wakeup( ) : null

magic method for unserialize()

with this method you can cache the mbox class

Returns
Type Description
null
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodprotected_buildFolderTree( string $currentDir, \Zend_Mail_Storage_Folder|null $parentFolder = null, string $parentGlobalName ) : null

find all subfolders and mbox files for folder structure

Result is save in Zend_Mail_Storage_Folder instances with the root in $this->_rootFolder. $parentFolder and $parentGlobalName are only used internally for recursion.

Parameters
Name Type Description
$currentDir string call with root dir, also used for recursion.
$parentFolder \Zend_Mail_Storage_Folder|null used for recursion
$parentGlobalName string used for rescursion
Returns
Type Description
null
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodprotected_getPos( int $id ) : array

Get positions for mail message or throw exeption if id is invalid

Inherited from: \Zend_Mail_Storage_Mbox::_getPos()
Parameters
Name Type Description
$id int number of message
Returns
Type Description
array positions as in _positions
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodprotected_isMboxFile( resource|string $file, bool $fileIsString = true ) : bool

check if given file is a mbox file

Inherited from: \Zend_Mail_Storage_Mbox::_isMboxFile()

if $file is a resource its file pointer is moved after the first line

Parameters
Name Type Description
$file resource|string stream resource of name of file
$fileIsString bool file is string or resource
Returns
Type Description
bool file is mbox file
methodprotected_openMboxFile( string $filename ) : null

open given file as current mbox file

Inherited from: \Zend_Mail_Storage_Mbox::_openMboxFile()
Parameters
Name Type Description
$filename string filename of mbox file
Returns
Type Description
null
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodpublicclose( ) : void

Close resource for mail lib. If you need to control, when the resource is closed. Otherwise the destructor would call this.

Inherited from: \Zend_Mail_Storage_Mbox::close()
methodpubliccount( ) : int

Countable::count()

Inherited from: \Zend_Mail_Storage_Abstract::count()
Returns
Type Description
int
methodpubliccountMessages( ) : int

Count messages all messages in current box

Inherited from: \Zend_Mail_Storage_Mbox::countMessages()
Returns
Type Description
int number of messages
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodpubliccurrent( ) : \Zend_Mail_Message

Iterator::current()

Inherited from: \Zend_Mail_Storage_Abstract::current()
Returns
Type Description
\Zend_Mail_Message current message
methodpublicgetCapabilities( ) : array

Get a full list of features supported by the specific mail lib and the server

Inherited from: \Zend_Mail_Storage_Abstract::getCapabilities()
Returns
Type Description
array list of features as array(featurename => true|false[|null])
methodpublicgetCurrentFolder( ) : \Zend_Mail_Storage_Folder

get Zend_Mail_Storage_Folder instance for current folder

Returns
Type Description
\Zend_Mail_Storage_Folder instance of current folder
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodpublicgetFolders( string $rootFolder = null ) : \Zend_Mail_Storage_Folder

get root folder or given folder

Parameters
Name Type Description
$rootFolder string get folder structure for given folder, else root
Returns
Type Description
\Zend_Mail_Storage_Folder root or wanted folder
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodpublicgetMessage( int $id ) : \Zend_Mail_Message_File

Fetch a message

Inherited from: \Zend_Mail_Storage_Mbox::getMessage()
Parameters
Name Type Description
$id int number of message
Returns
Type Description
\Zend_Mail_Message_File
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodpublicgetNumberByUniqueId( string $id ) : int

get a message number from a unique id

Inherited from: \Zend_Mail_Storage_Mbox::getNumberByUniqueId()

I.e. if you have a webmailer that supports deleting messages you should use unique ids as parameter and use this method to translate it to message number right before calling removeMessage()

Parameters
Name Type Description
$id string unique id
Returns
Type Description
int message number
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodpublicgetRawContent( int $id, null|array|string $part = null ) : string

Get raw content of message or part

Inherited from: \Zend_Mail_Storage_Mbox::getRawContent()
Parameters
Name Type Description
$id int number of message
$part null|array|string path to part or null for messsage content
Returns
Type Description
string raw content
methodpublicgetRawHeader( int $id, null|array|string $part = null, int $topLines = 0 ) : string

Get raw header of message or part

Inherited from: \Zend_Mail_Storage_Mbox::getRawHeader()
Parameters
Name Type Description
$id int number of message
$part null|array|string path to part or null for messsage header
$topLines int

include this many lines with header (after an empty line)

Returns
Type Description
string raw header
methodpublicgetSize( int|null $id = 0 ) : int|array

Get a list of messages with number and size

Inherited from: \Zend_Mail_Storage_Mbox::getSize()
Parameters
Name Type Description
$id int|null number of message or null for all messages
Returns
Type Description
intarray size of given message of list with all messages as array(num => size)
methodpublicgetUniqueId( int|null $id = null ) : array|string

get unique id for one or all messages

Inherited from: \Zend_Mail_Storage_Mbox::getUniqueId()

Mbox does not support unique ids (yet) - it's always the same as the message number. That shouldn't be a problem, because we can't change mbox files. Therefor the message number is save enough.

Parameters
Name Type Description
$id int|null message number
Returns
Type Description
arraystring message number for given message or all messages as array
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodpublickey( ) : int

Iterator::key()

Inherited from: \Zend_Mail_Storage_Abstract::key()
Returns
Type Description
int id of current position
methodpublicnext( ) : void

Iterator::next()

Inherited from: \Zend_Mail_Storage_Abstract::next()
methodpublicnoop( ) : void

Waste some CPU cycles doing nothing.

Inherited from: \Zend_Mail_Storage_Mbox::noop()
methodpublicoffsetExists( int $id ) : boolean

ArrayAccess::offsetExists()

Inherited from: \Zend_Mail_Storage_Abstract::offsetExists()
Parameters
Name Type Description
$id int
Returns
Type Description
boolean
methodpublicoffsetGet( int $id ) : \Zend_Mail_Message

ArrayAccess::offsetGet()

Inherited from: \Zend_Mail_Storage_Abstract::offsetGet()
Parameters
Name Type Description
$id int
Returns
Type Description
\Zend_Mail_Message message object
methodpublicoffsetSet( \id $id, mixed $value ) : void

ArrayAccess::offsetSet()

Inherited from: \Zend_Mail_Storage_Abstract::offsetSet()
Parameters
Name Type Description
$id \id
$value mixed
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodpublicoffsetUnset( int $id ) : boolean

ArrayAccess::offsetUnset()

Inherited from: \Zend_Mail_Storage_Abstract::offsetUnset()
Parameters
Name Type Description
$id int
Returns
Type Description
boolean success
methodpublicremoveMessage(  $id ) : null

stub for not supported message deletion

Inherited from: \Zend_Mail_Storage_Mbox::removeMessage()
Parameters
Name Type Description
$id
Returns
Type Description
null
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodpublicrewind( ) : void

Iterator::rewind()

Inherited from: \Zend_Mail_Storage_Abstract::rewind()

Rewind always gets the new count from the storage. Thus if you use the interfaces and your scripts take long you should use reset() from time to time.

methodpublicseek( int $pos ) : void

SeekableIterator::seek()

Inherited from: \Zend_Mail_Storage_Abstract::seek()
Parameters
Name Type Description
$pos int
Throws
Exception Description
\OutOfBoundsException
methodpublicselectFolder( \Zend_Mail_Storage_Folder|string $globalName ) : null

select given folder

folder must be selectable!

Parameters
Name Type Description
$globalName \Zend_Mail_Storage_Folder|string global name of folder or instance for subfolder
Returns
Type Description
null
Throws
Exception Description
\Zend_Mail_Storage_Exception
methodpublicvalid( ) : boolean

Iterator::valid()

Inherited from: \Zend_Mail_Storage_Abstract::valid()
Returns
Type Description
boolean
Documentation was generated by DocBlox 0.13.3.