LXII. mailparse Functions

Wstęp

Ostrzeżenie

Ten moduł jest w stadium EKSPERYMENTALNYM. Oznacza to, że zachowanie tych funkcji, ich nazwy, w zasadzie wszystko udokumentowane tutaj może zostać zmienione w przyszłych wersjach PHP bez wcześniejszego uprzedzenia. Używaj tego modułu na własne ryzyko.

To rozszerzenie zostało przeniesione do repozytorium PECL i nie jest rozprowadzane z PHP od wersji 4.2.0.

Instalacja

To rozszerzenie PECL nie jest dołączane do PHP. Dodatkowe informacje, takie jak nowe wersje, pliki do pobrania, pliki źródłowe, informacje o opiekunach czy rejestr zmian, można znaleźć tutaj: http://pecl.php.net/package/mailparse.

In order to use these functions you must compile PHP with mailparse support by using the --enable-mailparse configure option.

Windows users will enable php_mailparse.dll inside of php.ini in order to use these functions. DLL z tym rozszerzeniem PECL można pobrać ze strony PHP Downloads lub http://snaps.php.net/.

Spis treści
mailparse_determine_best_xfer_encoding -- Figures out the best way of encoding the content read from the file pointer fp, which must be seek-able
mailparse_msg_create -- Returns a handle that can be used to parse a message
mailparse_msg_extract_part_file -- Extracts/decodes a message section, decoding the transfer encoding
mailparse_msg_extract_part -- Extracts/decodes a message section
mailparse_msg_free -- Frees a handle allocated by mailparse_msg_create()
mailparse_msg_get_part_data -- Returns an associative array of info about the message
mailparse_msg_get_part -- Returns a handle on a given section in a mimemessage
mailparse_msg_get_structure -- Returns an array of mime section names in the supplied message
mailparse_msg_parse_file -- Parse file and return a resource representing the structure
mailparse_msg_parse -- Incrementally parse data into buffer
mailparse_rfc822_parse_addresses -- Parse addresses and returns a hash containing that data
mailparse_stream_encode -- Streams data from source file pointer, apply encoding and write to destfp
mailparse_uudecode_all -- Scans the data from fp and extract each embedded uuencoded file


[Authors note:


The tarball for 4.2.x can be found here:


http://thebrainroom.com/opensource/php/mailparse.php


and contains a script called try.php that demonstrates the usage of these functions.


]





I've pasted the contents of the file below:





<?php


/*


 * This is a simple email viewer.


 * make sure that $filename points to a file containing an email message and


 * load this page in your browser.


 * You will be able to choose a part to view.


 * */





$filename = "uumsg";





/* parse the message and return a mime message resource */


$mime = mailparse_msg_parse_file($filename);


/* return an array of message parts - this contsists of the names of the parts


 * only */


$struct = mailparse_msg_get_structure($mime);





echo "<table>\n";


/* print a choice of sections */


foreach($struct as $st) {


        echo "<tr>\n";


        echo "<td><a href=\"$PHP_SELF?showpart=$st\">$st</a></td>\n";


        /* get a handle on the message resource for a subsection */


        $section = mailparse_msg_get_part($mime, $st);


        /* get content-type, encoding and header information for that section */


        $info = mailparse_msg_get_part_data($section);


        echo "\n";


        echo "<td>" . $info["content-type"] . "</td>\n";


        echo "<td>" . $info["content-disposition"] . "</td>\n";


        echo "<td>" . $info["disposition-filename"] . "</td>\n";


        echo "<td>" . $info["charset"] . "</td>\n";


        echo "</tr>";


}


echo "</table>";





/* if we were called to display a part, do so now */


if ($showpart)  {


        /* get a handle on the message resource for the desired part */


        $sec = mailparse_msg_get_part($mime, $showpart);





        echo "<table border=1><tr><th>Section $showpart</th></tr><tr><td>";


        ob_start();


        /* extract the part from the message file and dump it to the output buff


er


         * */


        mailparse_msg_extract_part_file($sec, $filename);


        $contents = ob_get_contents();


        ob_end_clean();


        /* quote the message for safe display in a browser */


        echo nl2br(htmlentities($contents)) . "</td></tr></table>";;


}


?>

LXII. mailparse Functions

Wstęp

Instalacja

User Contributed Notes