faqs.org/rfcs/rfc2047.html). Zdekodowane elementy są zwracane w postaci tablicy obiektów, z który posiada dwie właściwości: charset i text. Jeżeli element nie może być zdekodowany a inne słowa są w US-ASCII, właściwość charset jest ustawiona na wartość domyślną.
array imap_mime_header_decode ( string text)
Przykład: imap_mime_header_decode()
$text="=?ISO-8859-1?Q?Keld_J=F8rn_Simonsen?= <keld@dkuug.dk>";
$elements=imap_mime_header_decode($text);
for($i=0;$i<count($elements);$i++) {
echo "Charset: {$elements[$i]->charset}\n";
echo "Text: {$elements[$i]->text}\n\n";
}
W przedstawionym przykładzie otrzymamy dwa elementy, gdzie pierwszy element jest zakodowany za
pomocą ISO-8859-1 a drugi będzie US-ASCII.
imap_msgno
Zwraca numer sekwencji wiadomości dla podanego UID. Jest to odwrotność imap_uid().
int imap_msgno ( int imap_stream, int uid)
273
PHP – Kompendium wiedzy
imap_num_msg
Zwraca ilość przesyłek w bieżącej skrzynce pocztowej.
int imap_num_msg ( int imap_stream)
imap_num_recent
Zwraca ilość ostatnich przesyłek w bieżącej skrzynki pocztowej.
int imap_num_recent ( int imap_stream)
imap_open
W przypadku powodzenia zwraca strumień IMAP, a w przypadku błędu False. Funkcja może być
używana do otwarcia strumienia do serwerów POP3 i NNTP i nie wszystkie funkcje i własności są dostępne na serwerach IMAP. Nazwa skrzynki składa się z dwóch części: nazwy serwera i ścieżki do skrzynki na tym serwerze. Nazwa specjalna INBOX określa bieżącą skrzynkę pocztową użytkownika. Fragment nazwy
określający serwer jest otoczony nawiasami klamrowymi {} i zawiera nazwę serwera, lub jego numer IP, określenie protokołu komunikacji (rozpoczynające się od /), oraz opcjonalnie numer portu rozpoczynający się od znaku :. Podawanie nazwy serwera jest obowiązkowe we wszystkich parametrach skrzynki pocztowej. Nazwy skrzynek zawierające znaki narodowe spoza drukowalnego podzbioru kodów ASCII są zakodowane za pomocą funkcji imap_utf7_encode().
int imap_open ( string mailbox, string username, string password [, int flags]) Opcje stanowią maskę bitową zawierającą jedną, lub więcej z poniższych wartości:
• OP_READONLY — otwiera skrzynkę tylko do odczytu,
• OP_ANONYMOUS — nie używa ani nie zmienia pliku .newsrc (tylko NNTP),
• OP_HALFOPEN — dla połączeń IMAP i NNTP, otwiera połączenie, ale nie otwiera skrzynki,
• CL_EXPUNGE — automatycznie czyści skrzynkę po jej zamknięciu.
Aby podłączyć się z serwerem IMAP działającym na porcie 143 na komputerze lokalnym, należy
wywołać funkcję w następujący sposób:
$mbox = imap_open ("{localhost:143}INBOX", "user_id", "password"); Aby podłączyć się z serwerem POP3 działającym na porcie 110 na komputerze lokalnym, należy wywołać funkcję w następujący sposób:
$mbox = imap_open ("{localhost:110/pop3}INBOX", "user_id", "password"); Aby podłączyć się z serwerem NNTP działającym na porcie 119 na komputerze lokalnym, należy
wywołać funkcję w następujący sposób:
$mbox = imap_open ("{localhost:993/imap/ssl}INBOX", "user_id", "password"); Aby połączyć się ze zdalnym serwerem należy zastąpić localhost nazwą lub numerem IP serwera, z którym ma być nawiązane połączenie.
Przykład: imap_open()
$mbox = imap_open ("{your.imap.host:143}", "username", "password"); echo "<p><h1>Skrzynki pocztowe</h1>\n";
$folders = imap_listmailbox ($mbox, "{your.imap.host:143}", "*");
if ($folders == false) {
echo "wywołanie nieudane<br>\n";
} else {
while (list ($key, $val) = each ($folders)) {
echo $val."<br>\n";
}
}
echo "<p><h1>nagłówki w INBOX</h1>\n";
$headers = imap_headers ($mbox);
if ($headers == false) {
echo "wywołanie nieudane<br>\n";
} else {
while (list ($key,$val) = each ($headers)) {