package Default
inherited_from \Zend\Mail\Storage\AbstractStorage

 Methods

create instance with parameters Supported parameters are - host hostname or ip address of POP3 server - user username - password password for user 'username' [optional, default = ''] - port port for POP3 server [optional, default = 110] - ssl 'SSL' or 'TLS' for secure sockets

__construct(array $params) 
inherited_from \Zend\Mail\Storage\AbstractStorage::__construct()

Parameters

$params

array mail reader specific parameters

Exceptions

\Zend\Mail\Storage\Exception\InvalidArgumentException
\Zend\Mail\Protocol\Exception\RuntimeException

Create instance with parameters

__construct(array $params) 
Inherited

Parameters

$params

array

mail reader specific parameters

Exceptions

\Zend\Mail\Storage\Exception\ExceptionInterface

Destructor calls close() and therefore closes the resource.

__destruct() 
Inherited

Special handling for hasTop and hasUniqueid. The headers of the first message is retrieved if Top wasn't needed/tried yet.

__get(string $var) : string

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
see
inherited_from \Zend\Mail\Storage\AbstractStorage::__get()

Parameters

$var

string

Returns

string

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

__get(string $var) : boolean
Inherited

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

$var

string

property name

Exceptions

\Zend\Mail\Storage\Exception\InvalidArgumentException

Returns

booleansupported or not

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

close() 
inherited_from \Zend\Mail\Storage\AbstractStorage::close()

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

close() 
Inherited

Countable::count()

count() : integer
Inherited

Returns

integer

Count messages all messages in current box

countMessages() : integer
inherited_from \Zend\Mail\Storage\AbstractStorage::countMessages()

Exceptions

\Zend\Mail\Storage\Exception\ExceptionInterface
\Zend\Mail\Protocol\Exception\ExceptionInterface

Returns

integernumber of messages

Count messages messages in current box/folder

countMessages() : integer
Inherited

Exceptions

\Zend\Mail\Storage\Exception\ExceptionInterface

Returns

integernumber of messages

Iterator::current()

current() : \Zend\Mail\Storage\Message
Inherited

Returns

\Zend\Mail\Storage\Messagecurrent message

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

getCapabilities() : array
Inherited

Returns

arraylist of features as array(feature_name => true|false[|null])

Fetch a message

getMessage(integer $id) : \Zend\Mail\Storage\Message
inherited_from \Zend\Mail\Storage\AbstractStorage::getMessage()

Parameters

$id

integer

number of message

Exceptions

\Zend\Mail\Protocol\Exception\ExceptionInterface

Returns

\Zend\Mail\Storage\Message

Get a message with headers and body

getMessage($id) : \Zend\Mail\Storage\Message
Inherited

Parameters

$id

int number of message

Returns

\Zend\Mail\Storage\Message

get a message number from a unique id

getNumberByUniqueId(string $id) : integer

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()

inherited_from \Zend\Mail\Storage\AbstractStorage::getNumberByUniqueId()

Parameters

$id

string

unique id

Exceptions

\Zend\Mail\Storage\Exception\InvalidArgumentException

Returns

integermessage number

get a message number from a unique id

getNumberByUniqueId(string $id) : integer
Inherited

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

$id

string

unique id

Exceptions

\Zend\Mail\Storage\Exception\ExceptionInterface

Returns

integermessage number

Get raw content of message or part

getRawContent(integer $id, null|array|string $part = null
inherited_from \Zend\Mail\Storage\AbstractStorage::getRawContent()

Parameters

$id

$part

Get raw content of message or part

getRawContent(integer $id, null|array|string $part = null) : string
Inherited

Parameters

$id

integer

number of message

$part

nullarraystring

path to part or null for message content

Returns

stringraw content

Get raw header of message or part

getRawHeader(integer $id, null|array|string $part = null, integer $topLines = 0
inherited_from \Zend\Mail\Storage\AbstractStorage::getRawHeader()

Parameters

$id

$part

$topLines

Get raw header of message or part

getRawHeader(integer $id, null|array|string $part = null, integer $topLines = 0) : string
Inherited

Parameters

$id

integer

number of message

$part

nullarraystring

path to part or null for message header

$topLines

integer

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

Returns

stringraw header

get a list of messages with number and size

getSize(integer $id = 0) : integer | array
inherited_from \Zend\Mail\Storage\AbstractStorage::getSize()

Parameters

$id

integer

number of message

Exceptions

\Zend\Mail\Protocol\Exception\ExceptionInterface

Returns

integerarraysize of given message of list with all messages as array(num => size)

Get a list of messages with number and size

getSize(integer $id = 0) : integer | array
Inherited

Parameters

$id

integer

number of message

Returns

integerarraysize of given message of list with all messages as array(num => size)

get unique id for one or all messages

getUniqueId(integer|null $id = null) : array | string

if storage does not support unique ids it's the same as the message number

inherited_from \Zend\Mail\Storage\AbstractStorage::getUniqueId()

Parameters

$id

integernull

message number

Exceptions

\Zend\Mail\Storage\Exception\ExceptionInterface

Returns

arraystringmessage number for given message or all messages as array

get unique id for one or all messages

getUniqueId(integer|null $id = null) : array | string
Inherited

if storage does not support unique ids it's the same as the message number

Parameters

$id

integernull

message number

Exceptions

\Zend\Mail\Storage\Exception\ExceptionInterface

Returns

arraystringmessage number for given message or all messages as array

Iterator::key()

key() : integer
Inherited

Returns

integerid of current position

Iterator::next()

next() 
Inherited

Keep the server busy.

noop() 
inherited_from \Zend\Mail\Storage\AbstractStorage::noop()

Exceptions

\Zend\Mail\Protocol\Exception\RuntimeException

Keep the resource alive.

noop() 
Inherited

ArrayAccess::offsetExists()

offsetExists(integer $id) : boolean
Inherited

Parameters

$id

integer

Returns

boolean

ArrayAccess::offsetGet()

offsetGet(integer $id) : \Zend\Mail\Storage\Message
Inherited

Parameters

$id

integer

Returns

\Zend\Mail\Storage\Messagemessage object

ArrayAccess::offsetSet()

offsetSet(mixed $id, mixed $value) 
Inherited

Parameters

$id

mixed

$value

mixed

Exceptions

\Zend\Mail\Storage\Exception\RuntimeException

ArrayAccess::offsetUnset()

offsetUnset(integer $id) : boolean
Inherited

Parameters

$id

integer

Returns

booleansuccess

Remove a message from server. If you're doing that from a web environment you should be careful and use a uniqueid as parameter if possible to identify the message.

removeMessage(integer $id) 
inherited_from \Zend\Mail\Storage\AbstractStorage::removeMessage()

Parameters

$id

integer

number of message

Exceptions

\Zend\Mail\Protocol\Exception\RuntimeException

delete a message from current box/folder

removeMessage($id) 
Inherited

Parameters

$id

Iterator::rewind()

rewind() 
Inherited

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.

SeekableIterator::seek()

seek(integer $pos) 
Inherited

Parameters

$pos

integer

Exceptions

\Zend\Mail\Storage\Exception\OutOfBoundsException

Iterator::valid()

valid() : boolean
Inherited

Returns

boolean

 Properties

 

class capabilities with default values

$has : array

Default

array('uniqueid' => true, 'delete' => false, 'create' => false, 'top' => false, 'fetchPart' => true, 'flags' => false)
 

maximum iteration position (= message count)

$iterationMax : null | integer

Default

null
 

current iteration position

$iterationPos : integer

Default

0
 

used message class, change it in an extended class to extend the returned message class

$messageClass : string

Default

'Zend\Mail\Storage\Message'
 

protocol handler

$protocol : null | \Zend\Mail\Protocol\Pop3

Default