Gabriele.vivinetto at 19:04, 5 January 2007

2007-01-05T19:04:45Z

New page

{{stub}}

Installare il pacchetto

apt-get install libphp-phpmailer

PHP doesn't allow you to send emails with SMTP authentication through the common command mail().

When you write scripts to send mails your server won't recognize you and sometimes will block your email except for the local network.

You also need authentication to send HTML Mails

To overcome this you should write a script to directly connect to SMTP socket passing parameters to the mail server through it.<br />As it is an hard work and require a good knowledge on sockets and PHP programming, every "normal" PHP user can download and install PHPmailer (http://phpmailer.sourceforge.net/).<br /><br />This PHP application includes many options, but we are focusing on simple use of authentication protocol. The installation need a folder (Ex. /PHPmailer) and 2 classes:
* class.phpmailer.php
* class.smtp.php<br />These are the 2 files you must have in your new folder with the /language folder.<br /><br />The other files you will find in the .zip are /docs (examples described), /test (testing installation), /phpdocs (documentation) and don't need to be uploaded onto your site.<br /><br />After you copy the files on your site you will be able to use PHPmailer in this way:<br /><br />'''1. insert'''<br /><br /><div class="codetop">CODE</div><div class="codemain">require("phpmailer/class.phpmailer.php"); </div><br /><br />in your .php file to load the functions.<br /><br /><br />'''2. use this code to send a mail: '''<br /><br /><div class="codetop">CODE</div><div class="codemain">$mail = new PHPMailer(); //Create PHPmailer class <br />$mail->From = "youremail@yourdomain.com"; //Sender address <br />$mail->FromName = "Name to Display "; //The name that you'll see as Sender<br />$mail->Host = "mail.youdomain.com"; //Your SMTP mail server <br />$mail->Mailer = "smtp"; //Protocol to use <br />$mail->AddAddress("SendToAddress@anydomain.com"); //The address you are sending mail to <br />$mail->Subject = "Mail Subject"; //Subject of the mail <br />$mail->Body = "Write your mail here"; //Body of the message</div><br /><br />You can also use account data if your server needs them for authentication:<br /><br /><div class="codetop">CODE</div><div class="codemain">$mail->SMTPAuth = "true";<br />$mail->Username = "User";<br />$mail->Password = "Pwd"; <br /><br />if(!$mail->Send()){ //Check for result of sending mail <br /> echo "There was an error sending the message"; //Write an error message if mail isn't sent <br /> exit; //Exit the script without executing the rest of the code <br />}</div><br /><br /><br />To send HTML mails you just have to set:<br /><br /><div class="codetop">CODE</div><div class="codemain">$mail->IsHTML(true); //You can set this parameter with a variable to let the user choose his preferred method (TEXT or HTML)</div><br /><br />Then you have to choose if you want to link images through absolute path or embedding them into the mail.<br />Using absolute path (Ex. http://www.yourdomain.com/images/header.gif) will let you easily modify each mail you sent until read cause each mail refers to your images. This result also in a smaller file to download and won't display images if the mail is read when not connected to the Internet. You can use the AltBody variable to set the message displayed if the user don't display the HTML body in the message:<br /><br /><div class="codetop">CODE</div><div class="codemain">$mail->AltBody = "You alternative text message"; //You have to use plain text, use \n to break line </div><br /><br />To embed images you must include some more commands in your script, using the AddEmbeddedImage function:<br /><br /><div class="codetop">CODE</div><div class="codemain">$path = "C:/myImages/myimage.gif"; //the address of the file. This could be any kind of file (sound, image, binary)<br />$cid = "MyIdentifier"; //This is the id you must use in your HTML to include embedded files. You will not use id instead of src <br />$name = "MyImage.gif"; //This will override your image name (OPTIONAL PARAMETER) <br />$encoding = "base64"; //This encodes the message. Options for this are "8bit", "7bit", "binary", "base64", and "quoted-printable" (OPTIONAL PARAMETER) <br />$type = "image/gif"; //This is MIME type of the embedded object. This parameter isn't optional if you are embedding an image. You should specify his MIME type as "image/gif" or "image/jpeg"<br />$mail->AddEmbeddedImage($path,$cid,$name,$encoding,$type); //Add the specified file to the email body</div><br /><br />Repeat the code for each file you need to embed in the mail.<br />PHPMailer has many other options you can set, like the confirm given back to a certain address:<br /><br /><div class="codetop">CODE</div><div class="codemain">$mail->ConfirmReadingTo = "myconfirmaddress@yourdomain.com"; //Enter the address where you want confirms go to. </div><br /><br />or set priority of a message:<br /><br /><div class="codetop">CODE</div><div class="codemain">$mail->Priority = 3; //Values are 1 = High , 3 = Normal, 5 = Low </div><br /><br />Further explaination of the commands are inside /phpdoc folder. <br /><br />Any comment or further examples can be addressed to info@hellord.com <br /><br /><br />Hope to help<br />Matteo Cappelloni</div><br /><br /><nowiki>--------------------</nowiki><br />

== Riferimenti ==

*[http://forums.emaxhosting.com/index.php?showtopic=680 PHPmailer tutorial on how to use SMTP Authentication in PHP Scripts]
*[http://www.hellotutorials.com/tutorials.php?id=1

Inviare email tramite php - Revision history

Gabriele.vivinetto at 19:04, 5 January 2007