Mail/Part/File.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 [email protected] so we can send you a copy immediately.
- Category
- Zend
- Copyright
- Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
- Package
- Zend_Mail
- Version
- $Id: File.php 24593 2012-01-05 20:35:02Z matthew $
\Zend_Mail_Part_File
- Parent(s)
- \Zend_Mail_Part
- Children
- \Zend_Mail_Message_File
- Category
- Zend
- Copyright
- Copyright (c) 2005-2012 Zend Technologies USA Inc. (http://www.zend.com)
- License
- New BSD License
Properties


int $_iterationPos = 1
1
Details- Type
- int
- Inherited_from
- \Zend_Mail_Part::$$_iterationPos


null|\Zend_Mail_Storage_Abstract $_mail =
- Type
- null | \Zend_Mail_Storage_Abstract
- Inherited_from
- \Zend_Mail_Part::$$_mail


array $_parts = array()
array()
Details- Type
- array
- Inherited_from
- \Zend_Mail_Part::$$_parts


string $_topLines = ''
''
Details- Type
- string
- Inherited_from
- \Zend_Mail_Part::$$_topLines
Methods


__construct(array $params) : void
Public constructor
This handler supports the following params: - file filename or open file handler with message content (required) - startPos start position of message or part in file (default: current position) - endPos end position of message or part in file (default: end of file)
Name | Type | Description |
---|---|---|
$params | array | full message with or without headers |
Exception | Description |
---|---|
\Zend_Mail_Exception |


__get(string $name) : string
Getter for mail headers - name is matched in lowercase
Inherited from: \Zend_Mail_Part::__get()This getter is short for Zend_Mail_Part::getHeader($name, 'string')
Name | Type | Description |
---|---|---|
$name | string | header name |
Type | Description |
---|---|
string | value of header |
Exception | Description |
---|---|
\Zend_Mail_Exception |
- See
- \global\Zend_Mail_Part::getHeader()


__isset( $name) : boolean
This method is short syntax for Zend_Mail_Part::hasHeader($name);
Name | Type | Description |
---|---|---|
$name | string |
Type | Description |
---|---|
boolean |
- See
- \global\Zend_Mail_Part::hasHeader


_cacheContent() : null
Cache content and split in parts if multipart
Inherited from: \Zend_Mail_Part::_cacheContent()Type | Description |
---|---|
null |
Exception | Description |
---|---|
\Zend_Mail_Exception |


getContent( $stream = null) : string
Body of part
If part is multipart the raw content of this part with all sub parts is returned
Name | Type | Description |
---|---|---|
$stream |
Type | Description |
---|---|
string | body |
Exception | Description |
---|---|
\Zend_Mail_Exception |


getHeader(string $name, string $format = null) : string | array
Internally headers that occur more than once are saved as array, all other as string. If $format is set to string implode is used to concat the values (with Zend_Mime::LINEEND as delim).
Name | Type | Description |
---|---|---|
$name | string | name of header, matches case-insensitive, but camel-case is replaced with dashes |
$format | string | change type of return value to 'string' or 'array' |
Type | Description |
---|---|
string | array | value of header in wanted or internal format |
Exception | Description |
---|---|
\Zend_Mail_Exception |


getHeaderField(string $name, string $wantedPart = 0, string $firstName = 0) : string | array
Get a specific field from a header like content type or all fields as array
Inherited from: \Zend_Mail_Part::getHeaderField()If the header occurs more than once, only the value from the first header is returned.
Throws a Zend_Mail_Exception if the requested header does not exist. If the specific header field does not exist, returns null.
Name | Type | Description |
---|---|---|
$name | string | name of header, like in getHeader() |
$wantedPart | string | the wanted part, default is first, if null an array with all parts is returned |
$firstName | string | key name for the first part |
Type | Description |
---|---|
string | array | wanted part or all parts as array($firstName => firstPart, partname => value) |
Exception | Description |
---|---|
\Zend_Exception, | Zend_Mail_Exception |


getHeaders() : array
The returned headers are as saved internally. All names are lowercased. The value is a string or an array if a header with the same name occurs more than once.
Type | Description |
---|---|
array | headers as array(name => value) |


getPart(int $num) : \Zend_Mail_Part
Get part of multipart message
Name | Type | Description |
---|---|---|
$num | int | number of part starting with 1 for first part |
Type | Description |
---|---|
\Zend_Mail_Part | wanted part |
Exception | Description |
---|---|
\Zend_Mail_Exception |


getPartClass() : string
Retrieve the class name used to encapsulate message parts
Inherited from: \Zend_Mail_Part::getPartClass()Type | Description |
---|---|
string |


getSize() : int
Return size of part
Quite simple implemented currently (not decoding). Handle with care.
Type | Description |
---|---|
int | size |


headerExists(string $name) : boolean
Check wheater the Mail part has a specific header.
Inherited from: \Zend_Mail_Part::headerExists()Name | Type | Description |
---|---|---|
$name | string |
Type | Description |
---|---|
boolean |


setPartClass(string $class) : \Zend_Mail_Part
Set name pf class used to encapsulate message parts
Inherited from: \Zend_Mail_Part::setPartClass()Name | Type | Description |
---|---|---|
$class | string |
Type | Description |
---|---|
\Zend_Mail_Part |