SimpleMail
La classe simplemail 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.
Les Méthodes
- simplemail - Nouvelle Instance
- addrecipient - Ajouter un destinataire.
- addfrom - Spécifier l'expediteur
- addcc - Ajouter un destinataire copie conforme.
- addbcc - Ajouter un destinataire copie conforme cachée.
- addsubject - Specifier le sujet.
- addreplyto - Specifier l'adresse de reponse.
- addattachement - Ajouter un attachement.
- addhtmlattachement - Ajouter un attachement HTML.
- text = string 'plain text ...' - Spécifier le corp plain text.
- html = string 'contenu html...' - Spécifier le corp HTML.
- set_mode = string 'mode' - Spécifier le mode d'envoi.
- sendmail - Envoyer le mail.
- error_log - Error log.
Exemples
Description des Méthodes
Nouvelle Instance
simplemail()
constructeur des instances de mail. Il initialise les variable de la classe.
- gctime : fixe la durée de vie maximum en seconde d'un fichier dans le repertoire de cache. Tout fichier plus agé est supprimé.
$mail = new simple
Ajouter un destinataire.
addrecipient( 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->addrecipient( string 'adressmail' [ , string 'nom' ] )
Spécifier l'expediteur
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->addfrom('adressmail' [ , 'nom' ] )
Ajouter un destinataire copie conforme.
addcc( string 'adressmail' [ , string 'nom' ] )
Ajouter un destiantaire copie conforme ( Cc: ) si l'adresse est valide.
- adressmail : l'adresse mail.
$mail->addcc('adressmail' [ , 'nom' ] )
Ajouter un destinataire copie conforme cachée.
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->addbcc('adressmail' [ , 'nom' ] )
Specifier le sujet.
addsubject( string 'subject')
Spécifier le sujet du mail ( Subject: ).
- subject : le sujet du mail.
$mail->addsubject('subject')
Specifier l'adresse de reponse.
addreplyto( string 'adressmail')
Spécifier l'adresse de reponse. ( Reply-To: ) si l'adresse est valide.
- adressmail : l'adresse mail.
$mail->addrreplyto('adressmail')
Ajouter un attachement.
addattachement( string 'filename')
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->addattachement('filename')
Ajouter un attachement HTML.
addhtmlattachement( 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->addattachement('filename','cid','content-type')
Spécifier le corp plain text.
text = string 'plain text ...'
Spécifier le corp plain text du mail, lisible par TOUS les client mail.
- plaintext : le text du corp du mail en ASCII.
$mail->text = string 'plaintext'
Spécifier le corp HTML.
html = string 'contenu html...'
Spécifier le contenu HTML s'il y a lieu.
- code html : le corps du mail en HTML.
$mail->html = 'code html'
Spécifier le mode d'envoi.
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.
- mode : 'php' pour utiliser la fonction mail de PHP, ou 'socket' pour utiliser directment les sockets ( plus rapide ).
$mail->set_mode = 'socket';
Envoyer le mail.
sendmail()
Envoie le mail composé.
$mail->sendmail()
Error log.
error_log([ string 'message'])
Methode qui ajoute un message au log des erreurs quand l'argument message est passé. La methode renvoi tout les logs d'erreur si elle est evoqué sans argument.
$mail->error_log('msg')
