PHP Send Email Using Authenticated SMTP Mail Server In Real Time

by on November 30, 2006 · 76 comments· LAST UPDATED April 18, 2008

in , ,

PHP has mail() function to send an email to users. However this mail() will not work:

=> If sendmail (or compatible binary) is not installed

=> If Apache Web server / Lighttpd running in chrooted jail

=> And your smtp server needs an authentication before sending an email

=> Or you just need to send email using PHP PEAR

In all these cases you need to use PHP PEAR's Mail:: interface. It defines the interface for implementing mailers under the PEAR hierarchy, and provides supporting functions which are useful in multiple mailer backends. In this tip you will learn about how to send an e-mail directly to client smtp server in real time.

PHP Pear's Mail.php is located in /usr/share/pear/ directory. Following is sample code to send an email via authenticated smtp server.

PHP send email using PHP SMTP mail Pear functions - Sample source code

Following code is well commented, you need to make necessary changes as per your setup.

/* mail setup recipients, subject etc */
$recipients = "";
$headers["From"] = "";
$headers["To"] = "";
$headers["Subject"] = "User feedback";
$mailmsg = "Hello, This is a test.";
/* SMTP server name, port, user/passwd */
$smtpinfo["host"] = "";
$smtpinfo["port"] = "25";
$smtpinfo["auth"] = true;
$smtpinfo["username"] = "smtpusername";
$smtpinfo["password"] = "smtpPassword";
/* Create the mail object using the Mail::factory method */
$mail_object =& Mail::factory("smtp", $smtpinfo);
/* Ok send mail */
$mail_object->send($recipients, $headers, $mailmsg);

Sending smtp email from chrooted Apache or Lighttpd webserver

Read following section, if you are running a secure chrooted Apache or Lighttpd web server. I have already written about setting php mail() function in chrooted jail. If you are using chrooted jail server setup, copy all files from /usr/share/pear directory to /chroot-directory/usr/share/pear directory. For example if lighttpd chrooted jail located in /webroot directory, you need to type following commands to install PHP pear support:
# mkdir -p /webroot/usr/share/pear
# cd /webroot/usr/share/pear
# cp -avr /usr/share/pear .

If PHP SAFE MODE is on, you must set /webroot/usr/share/pear directory permission to webserver username to allow access. Otherwise you will see error as follows:

1-Nov-2006 09:43:19] PHP Warning:  main(): SAFE MODE Restriction in effect.  The script whose uid is 506 is not allowed to access /usr/share/pear/PEAR.php owned by uid 0 in /usr/share/pear/Mail.php on line 636.

So if webserver username is lighttpd or apache use following command to setup correct ownership:
# chown lighttpd:lighttpd /webroot/usr/share/pear -ROR# chown apache:apache /webroot/usr/share/pear -R

You may also find modified wordpress WP-ContactForm plugin useful. It is a drop in form for users to contact you. It can be implemented on a page or a post. Original authored by Ryan Duff, which use php mail() function to send email. I have modified the same to send email via my ISP authenticated gateway using PHP PEAR's Mail:: interface :D

TwitterFacebookGoogle+PDF versionFound an error/typo on this page? Help us!

{ 76 comments… read them below or add one }

1 Loren Dorez January 27, 2007 at 11:02 pm

Im currently working on a PHP Mail File.. Essentiall it needs to log into a webbased mail account like ‘Outlook Web Access’. All tutorials i see you a submit button to the caling and send of the php file. Can i use the onclick evern like such


or must i use a sbumit button for the form. A submit buttons doesnt work with the current setup but i could model it to if it is neccessary..


2 subhendu das January 29, 2007 at 7:51 am

i need help for windows environment.
i use php triad 4.0.1


3 subhendu das January 29, 2007 at 7:53 am

How i configure smtp server.
i need help for windows environment.
i use php triad 4.0.1


4 nixCraft January 30, 2007 at 12:50 pm


I don’t use Windows so I have no idea about Windows SMTP server configuration.


5 gurjeet singh February 2, 2007 at 9:54 am

hi i got this error

Warning: main(Mail.php): failed to open stream: No such file or directory in /home/meresaja/public_html/mailtest.php on line 2

Fatal error: main(): Failed opening required ‘Mail.php’ (include_path=’.:/usr/lib/php:/usr/local/lib/php’) in /home/meresaja/public_html/mailtest.php on line 2

any body help me


6 niteen February 7, 2007 at 5:14 pm

you need to install pear in your server


7 Vincent February 19, 2007 at 4:00 pm

Ok I would like to hide the SMTP authentication from the web directory i.e. put it out of the path of public html, how would I call the functions for authentication in this case, also I want to e.mail the details of a form before it is posted or as it is being posted…..


8 nixCraft February 20, 2007 at 4:46 am

PHP is server side technology; as long as it is configured properly no one is going to see your SMTP authentication information.


9 Sia.G March 31, 2007 at 12:02 pm

Ok so my mailtest.php seems to have worked as I get my confirmation message. I just never receive the e-mail. ANyone know what’s going on?


10 Jackie May 8, 2007 at 3:59 pm

I’ve been trying to send emails using the PHP mail() function but it looks like the mails are not being sent. What do I need to configure on my windows server to get it to work?


11 Mateus Pezzin May 23, 2007 at 6:13 am

Thank’s a lot!

This sample is awesome!

I used with Mime to send attachments in the mail.


12 Kiran S May 27, 2007 at 12:36 pm

I am not that good with php..its working when done stand alone.. i customized the code given by u to fit my text fields.. but didn’t work.. cud you give me some tips so that i can make it fit for my site

Kiran S


13 MANOJ June 28, 2007 at 9:02 am

I’ve been trying to send emails using the given php code in file named contact.php
Its showing error

Parse error: syntax error, unexpected ‘@’ in /home/paragpap/public_html/contact.php on line 5

What do I need to configure on my linux server to get it to work?

Please help…



14 mazen March 25, 2008 at 7:23 pm

any download zip file ?


15 ehmeidan April 16, 2008 at 10:10 am

thanks for this thing


16 Uma Mahesh June 10, 2008 at 2:56 pm

i downloaded Mail package that contain a folder with Mail.php, Mail/*.php.
the code testmail.php was in the folder of Mail.php and when i execute it is asking for PEAR.php
i could not finid it.
Plz tell me how to install Pear on the server to


17 Jake June 13, 2008 at 10:51 am

can i check with you guys,
i have a sever currently installed with Apache,

i written a script in php to send emails out.
what do i need to install other than:
PHP5 and SMTP mail server?


18 Vikrant July 15, 2008 at 12:16 pm

this code work for me, but I am not able to send attachment with mail. can anyone help me?


19 Uma Mahesh July 15, 2008 at 1:59 pm

plz tell me how did u do it?


20 CrazyGuy July 18, 2008 at 8:02 am

.scroll {font-weight:bold; font-size:36; text-align: center; font-family: Verdana,

Courier, Courier New;}

// globals
var initialx, initialy, scrolltext;
var frame = 0, frame2 = 0.5;
var amplitude1 = 50, amplitude2 = 30;
var offset = 0.2, speed = 0.2, speed2 = 0.35;
var offset2 = 0.6;
var scrollspeed = 6;
var charwidth = 30;

var twopi = Math.PI * 2;
var chracters, position, numvisible, nextchar, firstchar;
var skipsteps = 1;
var delaytimer = 0;
var interval;

// function to create sine scroller
function sinescroll (x, y, value, number_of_chars)
// setup globals
scrolltext = new String(value);
initialx = x;
initialy = y;
numvisible = number_of_chars;
nextchar = numvisible;
firstchar = 0;

// create fixed-size arrays of characters and positions
characters = new Array(numvisible);
position = initialx;

// write DIVs to hold characters
for (var i = 0; i < numvisible; i++)
scrolltext.charAt(i), ”);

// animation function
function step ()
// increment counters
frame += speed;
frame2 += speed2;

// delay timer
if (delaytimer > 0)
// update position
position -= scrollspeed;

// check for ‘offscreen’
if (position < (initialx – charwidth))
while (scrolltext.charAt(nextchar) == ‘|’)
delaytimer += 90;

// set nextchar into characters array
characters[firstchar].innerHTML = ” +

scrolltext.charAt(nextchar) + ”;

// update nextchar

// check for wrap-around
if (nextchar >= scrolltext.length)
nextchar = 0;

// change position and counters by offset
position += charwidth;
frame += offset;
frame2 += offset2;

// update firstchar

if (firstchar >= numvisible)
firstchar = 0;

// wrap-around counters
if (frame > twopi) frame -= twopi;
if (frame2 > twopi) frame2 -= twopi;

// set up loop variables
var angle = frame;
var angle2 = frame2;
var pos = position;

// update the html
for (var i=firstchar; i < numvisible; i++)
characters[i].style.left = pos;
characters[i] = initialy + amplitude1 * Math.sin(angle) +

amplitude2 * Math.sin(angle2);
angle += offset;
angle2 += offset2;
pos += charwidth;

for (var i=0; i < firstchar; i++)
characters[i].style.left = pos;
characters[i] = initialy + amplitude1 * Math.sin(angle) +

amplitude2 * Math.sin(angle2);
angle += offset;
angle2 += offset2;
pos += charwidth;

// start the animation
function start ()
if (!document.all)
// get all of the DIV tags into an array (IE only?)
characters = document.all.item(‘character’);

// setup timeout to call this function again
interval = window.setInterval(“step();”, 20);

// stop the animation
function stop ()
if (!document.all)
if (interval)


// create the scroller
if (document.all)
sinescroll(30, 100, “HI I Need to send more than one message field how can i do pls give me a solution Thanks. “, 15);


21 CrazyGuy July 18, 2008 at 8:03 am

HI I Need to send more than one message field how can i do pls give me a solution Thanks.


22 peji July 20, 2008 at 6:30 am

how can run without Mail.php?


23 Vikrant July 24, 2008 at 11:24 am

hi Uma Mahesh,
u required xamplate which give u php and mysql, you also find mail.php file in it. just include it in this code.


24 Nuno September 6, 2008 at 8:37 pm

Hi i tryed the code but it just give me this as answer in my browser:

send($recipients, $headers, $mailmsg)

Can anyone help me figure out what is the problem?



25 Digital Lynx October 1, 2008 at 9:02 am

You could do all of that, but it’s pretty easy to do the above with the mMail library found here:


26 Joseph McLaughlin October 24, 2008 at 8:39 pm

When I run the php file in the browser I just get a blank page (also View Source is a blank page) no messages. I places an echo ‘Done” ; as the last statement and that doesn’t print.

Any thoughts anyone?


27 nixCraft October 24, 2008 at 8:47 pm


Run php -i script.php to see error from the shell prompt.


28 Joseph McLaughlin October 26, 2008 at 2:27 pm


When I run “php -i smtp_test.php” from the terminal command prompt it returns 438 lines of definitions of properties, variables, etc., but I am unable to locate anything that appear to be errors.


29 nixCraft October 26, 2008 at 2:50 pm


Opps, -i will return phpinfo(); it should be:
php script.php


30 Joseph McLaughlin October 26, 2008 at 4:43 pm


That works. It was a path issue on include(“/usr/share/pear/Mail.php”). When I moved smtp_test.php into the /usr/share/pear/ directory it sent the email, but that won’t work for me as my email scripts are in /var/www/vhosts//httpdocs/mailer/. Can I copy the PEAR PHP files into my mailer directory?


31 khalid December 12, 2008 at 10:29 am

help me. :S

not working at my end.


32 Julius December 26, 2008 at 3:12 am

Hello I found this code helpful but it works stand alone, How can I use it if I want to get all the data (name, email and message of the sender ) from a form in a html file or a contact form in SWF.



33 Ace January 14, 2009 at 8:42 am

not sure I follow


34 Ruben Zevallos Jr. January 25, 2009 at 12:52 pm

Hi, I’m looking for a 100% PHP sample… thanks for your post


35 sandhiya January 29, 2009 at 8:08 am

Please tell me how i set mailmsg in html format in $mail_object->send($recipients, $headers, $mailmsg);


36 andres navarro April 15, 2009 at 10:55 pm

Do you know how can i send an html mail using pear ?


37 articles submit May 6, 2009 at 12:09 am

I got error : Fatal error: Undefined class name ‘mail’ line no 15 : $mail_object =& Mail::factory(“smtp”, $smtpinfo); how to fix this


38 Robbie Smith May 14, 2009 at 4:05 am

Any reason why I’m getting this error:
Failed to connect to [SMTP: Failed to connect socket: No route to host (code: -1, response: )]


39 Caspar July 14, 2009 at 1:11 pm

I get this error whenever trying to use the mail function on my WAMP server:

“Warning: mail() [function.mail]: Failed to connect to mailserver at “localhost” port 25, verify your “SMTP” and “smtp_port” setting in php.ini or use ini_set() in C:\Program Files\wamp\www\register.php on line 61″

What do I need to do?

Thanks alot.


40 suraj December 14, 2012 at 7:34 pm

give me answer this type problem

Warning: mail() [function.mail]: Failed to connect to mailserver at “localhost” port 25, verify your “SMTP” and “smtp_port” setting in php.ini or use ini_set() in C:\wamp\www\Suraj\email sent\send_email.php on line 24


41 Caspar July 14, 2009 at 1:27 pm

Don’t worry – sorted it.


42 derek September 3, 2009 at 10:45 am

i am getting this error
Warning: mail() [function.mail]: Failed to connect to mailserver at “localhost” port 25, verify your “SMTP” and “smtp_port” setting in php.ini or use ini_set()

can someone guide me so that i can use the mail() successfully


43 ashim September 4, 2009 at 5:03 am

hey derek i have the same problem….. if u got it sorted out…… please let me know……


44 Thapar November 11, 2009 at 9:06 pm

I have been using the following script to send a simple echoes “Good” as per the coding..but mail doesn’t appear in recipient’s inbox..!
My system configuration is Mac OSX 10.4.11..I have XAMPP installed on my Mac..and when I am trying to send mail..I have internet connectivity ( quite obvious ).
SMTP host is set to “localhost”..and port is set to 25.

$message = “Hi..\n Test message \n from site”;
$message = wordwrap($message, 70);
if(mail(‘’, ‘Mail Check’, $message)==true)
echo “Good”;
else echo “Not able to send mail”;
Do I need to install anything any SMTP server or anything else..?
PS.- I have only XAMPP installed on my Mac for this purpose.


45 sangeeta November 26, 2009 at 6:49 pm

somebody help me please

I am very frustrated as this scipt not sending the activation email to user.
i tried a lot.
this is script code from 1 to 105—————————————————————

is_valid) {
die ("Image Verification failed!. Go back and try again." .
"(reCAPTCHA said: " . $resp->error . ")");
$user_ip = $_SERVER['REMOTE_ADDR'];
$md5pass = md5($_POST['pwd']);
$host = $_SERVER['HTTP_HOST'];
$host_upper = strtoupper($host);
$path = rtrim(dirname($_SERVER['PHP_SELF']), '/\\');
$activ_code = rand(1000,9999);
$usr_email = mysql_real_escape_string($_POST['usr_email']);
$user_name = mysql_real_escape_string($_POST['user_name']);
$rs_duplicate = mysql_query("select count(*) as total from users where user_email='$usr_email' OR user_name='$user_name'") or die(mysql_error());
list($total) = mysql_fetch_row($rs_duplicate);
if ($total > 0)
$err = urlencode("ERROR: The username/email already exists. Please try again with different username and email.");
header("Location: register.php?msg=$err");
$sql_insert = "INSERT into `users`
(`full_name`,`user_email`,`pwd`,`address`,`tel`,`f ax`,`website`,`date`,`users_ip`,`activation_code`, `country`,`user_name`
mysql_query($sql_insert,$link) or die("Insertion Failed:" . mysql_error());
$user_id = mysql_insert_id($link);
$md5_id = md5($user_id);
mysql_query("update users set md5_id='$md5_id' where id='$user_id'");
// echo "Thank You We received your submission.";
$message =
"Thank you for registering with us. Here are your login details...\n
User ID: $user_name
Email: $usr_email \n
Passwd: $_POST[pwd] \n
Activation code: $activ_code \n
Thank You
__________________________________________________ ____
mail($usr_email, "Login Details", $message,
"From: \"Member Registration\" \r\n" .
"X-Mailer: PHP/" . phpversion());
header("Location: thankyou.php");

somebody please help me what to do.



46 subhash January 8, 2010 at 5:15 am

please provide me full codding of mail function.
How to configure;
changes configure;
html coding


47 Ramya January 20, 2010 at 3:38 am

Hai Friends,
I am new to php.just now i tried to send email from localhost but i am getting the following error.,

Warning: include(Mail.php) [function.include]: failed to open stream: No such file or directory in D:\wamp\www\Sample\kkk.php on line 2

Warning: include() [function.include]: Failed opening ‘Mail.php’ for inclusion (include_path=’.;C:\php5\pear’) in D:\wamp\www\Sample\kkk.php on line 2

Fatal error: Class ‘Mail’ not found in D:\wamp\www\Sample\kkk.php on line 15

Please tell me how to include Mail.php…

Thank You….


48 ben October 10, 2011 at 7:33 pm

Go to your command line (if linux or mac) and type “pear install –alldeps mail” without the quotes and you are done.

If you are on windows, check this url … i don’t know for windows


49 Joseph Kurt February 25, 2010 at 12:50 am

how to use external smtp mail server that im going to use in my site for sending emails


50 And1 April 16, 2010 at 8:06 pm

I have installed Pear Mail package but same error

Warning: require(Mail.php) [function.require]: failed to open stream: No such file or directory in /home/chemisaq/public_html/test_message.php on line 3

Fatal error: require() [function.require]: Failed opening required ‘Mail.php’ (include_path=’.:/usr/lib/php:/usr/local/lib/php’) in /home/chemisaq/public_html/test_message.php on line 3

I Installed it using CPanel Software Service.. PEAR PACKAGE.. anyway returns that error


51 yinka web May 21, 2010 at 4:15 pm

The script worked just fine for me and saved me lots of time.


52 Jill Barnes May 27, 2010 at 3:57 am

I am new to Forms, and would like to know what steps I have to do to create a “Contact Us” form that when the form button “Submit” is clicked, it sends two emails – one to the customer confirming the information supplied, and one to the site owner with all the details.

I can create the form using Dreamweaver CS4, but after that I don’t know what to do. all my coduing has been in HTML to date.

I would appreciate any ideas and sugfgestions



53 PREM KUMAR August 14, 2010 at 10:36 am

Its work good thanks…………
Good sharing……..


54 Jason January 19, 2011 at 6:41 pm

Wow, people are still finding and commenting on this thread so I’ll add my experience.

On RHEL I did a:

yum install php php-pear

then a:

pear install Net_SMTP

but the Mail.php that is included in the above script did not exist.

Tried to do a:

pear install Mail but was thrown:

pear/Mail requires PEAR Installer (version >= 1.5.6), installed version is 1.4.9

So I just used the example script that includes Net/SMTP.php instead found here:




55 ben October 10, 2011 at 7:34 pm

fyi: an easier way is to do “pear install -alldeps mail” which will install all the dependencies of mail such as net_smtp.


56 Gabriel May 10, 2011 at 7:03 pm

this script works great.can you help me to change it to a bulk mailer ?


57 Shashi June 6, 2011 at 8:05 am

I customised this script to fit my needs, and when i executed it, i did not get any errors, but the mail too was not sent. Dont know what was going wrong.


58 Rahul Malik July 4, 2011 at 1:41 pm

wen i execute this code my browser is giving me the following error
Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 6144 bytes) in C:\xampp\htdocs\mailer\admin\mail.php on line 3


59 Darshan July 6, 2011 at 12:11 pm

your codes run well ,m just want to know how would i send attachment with this mail


60 kim September 23, 2011 at 1:23 pm

hey can you give me mail.php file directly 4 download.. i need it .


61 SkiOne October 1, 2011 at 10:50 pm

For those of you looking for mail.php you need 2 things installed on your server:
and pear Mail

pear is a package for PHP that gets installed after PHP is compiled. If pear is not installed you need to do so at the OS level. If you own your own server then look up installing pear for your OS (ubuntu is apt-get install pear) if you are on a shared server your provider will need to have that library installed for you. And if its not, then you probably won’t get them to do it.

Once pear is installed on your system you can install it with this command. Pear install Net_SMTP. There might be dependencies of other things but you just can’t have mail.php in your home directory and include it that way. It just doesn’t work like that.

Hopefully this is helpful.


62 Crez October 11, 2011 at 8:50 pm

Make sure that when you’re testing this check the php.ini file and double check that include_path has the path for the “pear” folder. It should read include_path .:/usr/share/php:/usr/share/pear or where ever yours might be installed. I edited the php.ini to include this file path and restarted apache2 and in my php code in did the include(“Mail.php”) with a Capital M and this cleared up my problem. I figured I would share my solution to help out with anyone else that might be having some issues.


63 Abbas Uddin October 17, 2011 at 9:22 am

I got this message after last step of this tutorial. Would you please help?

Deprecated: Assigning the return value of new by reference is deprecated in E:\xampp\php\PEAR\Mail.php on line 154

Strict Standards: Non-static method Mail::factory() should not be called statically in E:\xampp\htdocs\email.php on line 60

Strict Standards: Non-static method PEAR::isError() should not be called statically, assuming $this from incompatible context in E:\xampp\php\PEAR\Mail\smtp.php on line 365

Strict Standards: Non-static method PEAR::isError() should not be called statically, assuming $this from incompatible context in E:\xampp\php\PEAR\Net\SMTP.php on line 339

Strict Standards: Non-static method PEAR::isError() should not be called statically, assuming $this from incompatible context in E:\xampp\php\PEAR\Net\SMTP.php on line 344


64 SkiOne October 17, 2011 at 12:50 pm

That error is non-fatal, you have strict standards on. If you lowered your reporting to normal the errors will go away.

Otherwise you can edit the files listed in the error and you will see on those lines object declarations with an & in them. Remove the & and everything will work right. I wish Pear would fix this in their library.


65 hany October 21, 2011 at 3:00 am

Thanks , it works great!


66 Astika January 10, 2012 at 6:34 am

what should the Mail.php file contains.


67 Hammad January 12, 2012 at 12:35 pm

what code Mail.php contain ?


68 Alison Smythe January 16, 2012 at 5:59 pm

I am a newbie to actively playing which means this sort of advice is very useful.


69 gagan March 19, 2012 at 10:14 am

where to find the “Mail.php” file??????????????


70 lalit September 13, 2014 at 6:39 am

i am also wetting for this answer


71 João April 12, 2012 at 9:00 pm

How can i add HTML headers??

Can someone help


72 Dar August 14, 2012 at 10:07 pm

Didn’t work for me at first but after changing host to “localhost” worked. Any ideas why it didn’t work with domain name


73 Madhu November 21, 2012 at 6:25 am

After download i extract them into my folder and then include “mail.php ” and write the same code but it was not working.
else what can i do.


74 suraj December 14, 2012 at 7:32 pm

Warning: mail() [function.mail]: Failed to connect to mailserver at “localhost” port 25, verify your “SMTP” and “smtp_port” setting in php.ini or use ini_set() in C:\wamp\www\Suraj\email sent\send_email.php on line 24

how did I solve it reply fast with answer
regard :suraj saxena


75 NAZIM January 12, 2013 at 6:02 am



76 lalit September 13, 2014 at 5:52 am

where to download Mail.php file to include in this code

send($recipients, $headers, $mailmsg);


Leave a Comment

Tagged as: , , , , , , , , , , ,

Previous post:

Next post: