mailhdr.hsm
- KURZANLEITUNG -

Das Modul wurde am 23.02.2001 von Martin Diedrich ins Netz gestellt.
Das letzte Update war am 23.02.2001.
Kontakt-URL: http://www.mdiedrich.de


- INHALT -

1. - Die Funktionen und ihre Aufgaben und Rückgabewerte
2. - Aufruf der Funktionen
3. - Erläuterungen
4. - Sonstiges

1. - DIE FUNKTIONEN UND IHRE AUFGABEN UND RÜCKGABEWERTE
Das Modul beinhaltet zwei Funktionen, die das Auslesen der Header-Felder einer eMail übernehmen. Vor dem Aufruf der Funktionen ist die Definition der folgenden Variablen innerhalb des aufrufenden Scripts (globale Variable) notwendig:
  • $filename - Diese Variable muss den Dateinamen der Datei (mit komplettem Pfad) beinhalten, die verarbeitet werden soll.
Des weiteren ist es notwendig, folgende Variablen zu deklarieren:
  • Var($orgsubject, $orgmid, $orgdate, $orgfrom, $orgto, $orgorganization, $orgsender, $orgreplyto, $orgfirstbody, $left, $right)
Das Modul beinhaltet dann zwei Funktionen:
  1. mailhdr_extract - Zur Verfügung stellen der Header-Einträge eingehender eMails in Form von Variablen (Variablen siehe oben).
    Die Funktion gibt zurück: Header-Felder als globale Variablen; return(0) -> OK; return(1) -> Fehler (wird angegeben im Log). Die Variable '$firstbody' beinhaltet dabei die erste Zeile des Mail-Inhalts (z.B. für Befehle o.ä.).
  2. mailhdr_splitsubject - Wenn das Subject-Feld eien Eintrag der Art 'links-rechst' enthält (zwei Elemente getrennt durch '-'), werden die beiden Inhalte in den Variablen $left und $right abgelegt; der Bindestrich als Trennzeichen verfällt dabei.
    Die Funktion gibt zurück: $left, $right als globale Variablen; return(0) -> OK, return(1) -> Fehler beim Splitten.


2. - AUFRUF DER FUNKTIONEN
Die Funktionen sollen globale Variablen verändern können, müssen also mit Parameterübergabe aufgerufen werden (siehe HAMSTER-Hilfe: Gültigkeit von Variablen). Der korrekte Aufruf der beiden Funktionen:
  • mailhdr_extract($orgfrom, $orgto, $orgsubject, $orgdate, $orgmid, $orgreplyto, $orgsender, $orgorganization, $orgfirstbody)
  • mailhdr_splitsubject($left,$right)
Die in den Klammern angegebenen Variablen sind dann global vorhanden und einsetzbar. Sie beinhalten die Einträge aus der eMail bzw. nichts, wenn das Header-Feld nicht vorhanden war.
Natürlich ist es möglich, die Variablen umzubenennen, doch halte ich das erstens wegen der Offensichtlichkeit der Inhalte als auch wegen der Kompatibilität zu weiteren Scripts von mir nicht für sinnvoll (LISTSERV, HAMADVISE, beide in Arbeit).


3. - ERLÄUTERUNGEN
Tja, hier steht noch nichts, aber wenn jemand was vermisst... ich nehmīs gern auf ;)!


4. - SONSTIGES
Wie immer:
THIS SCRIPT IS PROVIDED "AS IS" SO THAT NEITHER THE AUTHOR OF THIS SCRIPT NOR ANY PERSON CHANGING OR REDISTRIBUTING IT MIGHT BE MADE RESPONSIBLE FOR ANY DAMAGE OR LOSS OR PROBLEMS THIS SCRIPT MIGHT CALL. IF THE USER DOESNīT KNOW WHAT TO DO WITH THIS, PLEASE DONīT LET HIM TRY UNTIL HE DOES. PLEASE SEND QUESTIONS, COMMENTS AND OTHER STATEMENT OR EVEN CHANGES YOU BELIEVE THEY ARE WELL DONE TO THE AUTHORīS EMAIL-ADDRESS SHOWN ABOVE.

Keine Garantie für irgendetwas, Meckereien etc. bitte an den Autor. eMail-Adresse steht oben (weiter oben, noch weiter oben, ...).