|
|
imap_fetchstructure (PHP 3, PHP 4, PHP 5) imap_fetchstructure -- Read the structure of a particular message Описаниеobject imap_fetchstructure ( resource imap_stream, int msg_number [, int options] )
Fetches all the structured information for a given message.
Список параметров
imap_streamAn IMAP stream returned by
imap_open(). msg_number
The message number
options
This optional parameter only has a single option,
FT_UID, which tells the function to treat the
msg_number argument as a
UID.
Возвращаемые значения
Returns an object includes the envelope, internal date, size, flags and
body structure along with a similar object for each mime attachment. The
structure of the returned objects is as follows:
Таблица 1.
Returned Objects for imap_fetchstructure()
| type | Primary body type | | encoding | Body transfer encoding | | ifsubtype | TRUE if there is a subtype string | | subtype | MIME subtype | | ifdescription | TRUE if there is a description string | | description | Content description string | | ifid | TRUE if there is an identification string | | id | Identification string | | lines | Number of lines | | bytes | Number of bytes | | ifdisposition | TRUE if there is a disposition string | | disposition | Disposition string | | ifdparameters | TRUE if the dparameters array exists | | dparameters | An array of objects where each object has an "attribute" and a
"value" property corresponding to the parameters on the
Content-disposition MIMEheader. | | ifparameters | TRUE if the parameters array exists | | parameters | An array of objects where each object has an "attribute" and
a "value" property. | | parts | An array of objects identical in structure to the top-level
object, each of which corresponds to a MIME body
part. |
Таблица 2. Primary body type | 0 | text | | 1 | multipart | | 2 | message | | 3 | application | | 4 | audio | | 5 | image | | 6 | video | | 7 | other |
Таблица 3. Transfer encodings | 0 | 7BIT | | 1 | 8BIT | | 2 | BINARY | | 3 | BASE64 | | 4 | QUOTED-PRINTABLE | | 5 | OTHER |
 add a note
User Contributed Notes
imap_fetchstructure
misc at e2007 dot cynergi dot com
21-Oct-2007 07:53
First of all, for a while now (not sure since which PHP version) a new "primary body type" constant exists: TYPEMODEL (int(7)) and TYPEOTHER became int(8). Furthermore the use of these constants can be misleading. The issue is that "other" MIME-types aren't just ==TYPEOTHER, but rather >=TYPEOTHER. I've added a PHP feature request to help solve this (http://bugs.php.net/43061).
To learn more, read this extract of a conversation I've had with Mark Crispin of IMAP's extension mailing list at UW (e-mail addresses deleted):
----
Mark Crispin:
I certainly understand the frustrations that end users experience with apparent mutual finger-pointing. The way to solve it is through communication.
For what it's worth, here are the current semantics of type codes:
0 TEXT
1 MULTIPART
2 MESSAGE
3 APPLICATION
4 AUDIO
5 IMAGE
6 VIDEO
7 MODEL
8 X-UNKNOWN (or expansion types filed up)
9 first expansion type
...
TYPEMAX last expansion type (currently 15)
On Wed, 17 Oct 2007, Cynergi wrote:
(...)
> -----Original Message-----
> Sent: ter
|
|
imap_fetchheader