imap_fetchstructure

(PHP 4, PHP 5, PHP 7, PHP 8)

imap_fetchstructure特定のメッセージの構造を読み込む

説明

imap_fetchstructure(IMAP\Connection$imap, int$message_num, int$flags = 0): stdClass|false

この関数は、指定したメッセージに関するすべての構造化された情報を取り出します。

パラメータ

imap

IMAP\Connection クラスのインスタンス。

message_num

メッセージ番号。

flags

オプションのパラメータで、FT_UID のみが指定可能です。 これは、message_numUID として処理することを関数に指定するためのものです。

戻り値

以下の表に示すプロパティを持つオブジェクトを返します。 失敗した場合に false を返します

imap_fetchstructure() が返すオブジェクト
type最初の body 部の型
encodingbody 部を転送する際のエンコード法
ifsubtypesubtype 文字列がある場合に true
subtypeMIME の subtype
ifdescriptiondescription 文字列がある場合に true
description内容を記述する文字列
ifididentification 文字列がある場合に true
idIdentification 文字列
lines行数
bytesバイト数
ifdispositiondisposition 文字列がある場合に true
dispositionDisposition 文字列
ifdparametersdparameters 配列が存在する場合に true
dparametersオブジェクトの配列。各オブジェクトは "attribute" および "value" というプロパティを保持し、それぞれ Content-dispositionMIME ヘッダの 対応するパラメータを表す。
ifparameters配列 parameters が存在する場合に true
parametersオブジェクトの配列。各オブジェクトは "attribute" および "value" というプロパティを保持する。
partsオブジェクトの配列であり、その構造はトップレベルオブジェクトと 同じです。それぞれが MIME body 部に対応しています。

最初の body 部の型 (使用するライブラリによって異なるため、定数を使うことを推奨します)
定数
0textTYPETEXT
1multipartTYPEMULTIPART
2messageTYPEMESSAGE
3applicationTYPEAPPLICATION
4audioTYPEAUDIO
5imageTYPEIMAGE
6videoTYPEVIDEO
7modelTYPEMODEL
8otherTYPEOTHER

転送時のエンコーディング (使用するライブラリによって異なるため、定数を使うことを推奨します)
定数
07bitENC7BIT
18bitENC8BIT
2BinaryENCBINARY
3Base64ENCBASE64
4Quoted-PrintableENCQUOTEDPRINTABLE
5otherENCOTHER

変更履歴

バージョン説明
8.1.0 引数 imap は、IMAP\Connection クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、有効な imapリソース が期待されていました。

参考

  • imap_fetchbody() - メッセージ本文中の特定のセクションを取り出す
  • imap_bodystruct() - 指定したメッセージの指定した body セクションの構造を読み込む
To Top