Mail5
La classe mail5 fourni des fonctions permettant de construire puis d'envoyer des mail texte, html avec ou sans pièces jointes.
La nouvelle mouture permet l'envoi grace aux fonctions intégrées a PHP ainsi que directement grace au sockets. Ainsi que l'envoi a des destinataires multiples. De plus la nouvelle mouture devrait mieux s'accordé avec les système antispam. Par contre elle nécessite l'usage de PHP5.
Les Méthodes
- mailMain - Nouvelle Instance
- model->addTO - Ajouter un destinataire.
- model->addFROM - Spécifier l'expediteur
- model->addCC - Ajouter un destinataire copie conforme.
- model->addBCC - Ajouter un destinataire copie conforme cachée.
- model->addSubject - Specifier le sujet.
- model->addReplyTo - Specifier l'adresse de reponse.
- model->addFile - Ajouter un attachement.
- model->addHTMLfile - Ajouter un attachement HTML.
- model->addPlainText - Spécifier le corp plain text.
- model->addHTML - Spécifier le corp HTML.
- sender->set_mode = string 'mode' - Spécifier le mode d'envoi.
- sender->send - Envoyer le mail.
- log - Error log.
Exemples
Description des Méthodes
Nouvelle Instance
mailMain()
constructeur des instances de mail. Il initialise les variable de la classe.
$mail = new simple
Ajouter un destinataire.
model->addTO( string 'adressmail' [ , string 'nom' ] )
Ajoute un destinataire ( TO: ). Renvoi TRUE si l'adresse est valable. FALSE sinon.
- adressmail : l'adresse mail.
- nom : le nom du destinataire ( facultatif ).
$mail->model->addTO( string 'adressmail' [ , string 'nom' ] )
Spécifier l'expediteur
model->addFROM( string 'adressmail' [ , string 'nom' ] )
Spécifie l'expediteur ( From: ) si l'adresse est valide.
- adressmail : l'adresse mail.
- nom : le nom du destinataire ( facultatif ).
$mail->model->addFROM('adressmail' [ , 'nom' ] )
Ajouter un destinataire copie conforme.
model->addCC( string 'adressmail' [ , string 'nom' ] )
Ajouter un destiantaire copie conforme ( Cc: ) si l'adresse est valide.
- adressmail : l'adresse mail.
- nom : le nom du destinataire ( facultatif ).
$mail->model->addCC('adressmail' [ , 'nom' ] )
Ajouter un destinataire copie conforme cachée.
model->addBCC( string 'adressmail' [ , string 'nom' ] )
Ajouter un destiantaire copie conforme ( Cc: ) si l'adresse est valide.
- adressmail : l'adresse mail.
- nom : le nom du destinataire ( facultatif ).
$mail->model->addBCC('adressmail' [ , 'nom' ] )
Specifier le sujet.
model->addSubject( string 'subject')
Spécifier le sujet du mail ( Subject: ).
- subject : le sujet du mail.
$mail->addsubject('subject')
Specifier l'adresse de reponse.
model->addReplyTo( string 'adressmail')
Spécifier l'adresse de reponse. ( Reply-To: ) si l'adresse est valide.
- adressmail : l'adresse mail.
$mail->model->addReplyTo('adressmail')
Ajouter un attachement.
model->addFile( string 'filename', string 'content-type')
Ajouter un attachement ( fichier joint) dans le mail. Cette fonction ne permet pas d'afficher l'attachement ds le contenu html.
- filename : le chemin jusqu'au fichier a inclure.
$mail->model->addFile('filename')
Ajouter un attachement HTML.
model->addHTMLfile( string 'filename', string 'cid', string 'content-type')
Ajoute le fichier en piece jointe en vue de l'afficher dans le mail au format html ( comme des image par exemple ). cid ( content-id ) represente le nom auquel vous ferez reference dans votre contenu html (ex: <img src="cid:monimage1">) et content-type precise le type de document ( ex: image/png ).
- filename : le chemin jusqu'au fichier a inclure.
- cid : le content id, permet de faire reference a votre fichier attaché dans les tags html.
- content-type : contient le type MIME du fichier attaché.
$mail->model->addHTMLfile('filename','cid','content-type')
Spécifier le corp plain text.
model->addPlainText( string 'PlainText' )
Spécifier le corp plain text du mail, lisible par TOUS les client mail.
- plaintext : le text du corp du mail en ASCII.
$mail->model->addPlainText( string 'plaintext')
Spécifier le corp HTML.
model->addHTML( string 'contenu html' )
Spécifier le contenu HTML s'il y a lieu.
- code html : le corps du mail en HTML.
$mail->model->addHTML( string 'code html' )
Spécifier le mode d'envoi.
sender->set_mode = string 'mode'
Spécifier le mode d'envoi du mail, l'ajout de l'envoie par socket a surtout pour but l'accroissement des performance lors de l'envoi en nombre. note : le mode php marche mal pour l envoi de pièces jointes pour le moment.
- mode : 'php' pour utiliser la fonction mail de PHP, ou 'socket' pour utiliser directment les sockets ( plus rapide ).
$mail->sender->set_mode = 'socket';
Envoyer le mail.
sender->send()
Envoie le mail composé.
$mail->sender->send()
Error log.
log()
Methode qui ajoute un message au log des erreurs quand l'argument message est passé. La methode renvoi un tableau des erreur de tous les modules autrement.
$mail->log()