imap_fetchstructure

(PHP 3, PHP 4, PHP 5)

imap_fetchstructure -- Ermittelt die Struktur einer Nachricht

Beschreibung

object imap_fetchstructure ( resource imap_stream, int msg_number [, int options] )

Liefert alle Strukturinformationen für die gegebene Nachricht.

Parameter Liste

imap_stream

An IMAP stream returned by imap_open().

msg_number

Die gewünschte Nachrichtennummer

options

Wenn options auf FT_UID gesetzt wird so wird msg_number als UID und nicht als Nachrichtennummer interpretiert.

Rückgabewerte

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:

Tabelle 1. Returned Objects for imap_fetchstructure()

typePrimärer MIME-Typ des Nachrichtenteils
encodingBody transfer encoding
ifsubtypeTRUE wenn ein Untertyp-Eintrag existiert
subtypeMIME Untertyp
ifdescriptionTRUE wenn ein Beschreibungstext existiert
descriptionBeschreibungstext
ifidTRUE wenn ein Identifikationstext existiert
idIdentifikationstext
linesAnzahl der Zeilen
bytesGröße in Bytes
ifdispositionTRUE wenn ein "disposition" Eintrag zum Verwendungsart existiert
dispositionVerwendungsart
ifdparametersTRUE wenn ein "dparameter" Array existiert
dparameters Ein Array von Objekten mit je einer "attribute" und einer "value" Eigenschaft. Jedes dieser Objekte enthält je einen Eintrag aus der Content-disposition Kopfzeile des Nachrichtenteils.
ifparametersTRUE wenn ein "paramters" Array existiert
parameters Ein Array von Objekten mit je einer "attribute" und einer "value" Eigenschaft.
parts Wenn der Nachrichtenteil selbst weitere untergeorgnete Nachrichtenteile enthält so wird hier ein Array mit Objekten für diese Teile angelegt. Die Elemente dieses Arrays sind selbst jeweils wieder Objekte von der hier beschriebenen Struktur.

Tabelle 2. Gängige primäre Nachrichtentypen

0text
1multipart
2message
3application
4audio
5image
6video
7other

Tabelle 3. Gängige Ütertragungskodierungen

07BIT
18BIT
2BINARY
3BASE64
4QUOTED-PRINTABLE
5OTHER

Siehe auch

imap_fetchbody()
imap_bodyistruct()