PHP Send Email Using Authenticated SMTP Mail Server In Real Time

Posted on in Categories Apache, Howto, lighttpd, Mail server, php, Postfix, Security, Troubleshooting last updated November 30, 2006

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 = "[email protected]";
$headers["From"] = "[email protected]";
$headers["To"] = "[email protected]";
$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 😀

Posted by: Vivek Gite

The author is the creator of nixCraft and a seasoned sysadmin and a trainer for the Linux operating system/Unix shell scripting. He has worked with global clients and in various industries, including IT, education, defense and space research, and the nonprofit sector. Follow him on Twitter, Facebook, Google+.

Share this on (or read 80 comments/add one below):

80 comment

  1. 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. 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

  3. 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…..

  4. Hello,
    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?

  5. Hi,
    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

  6. Hello,
    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…


  7. 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
    [email protected]

  8. 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?

  9. .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);

  10. Hi,
    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?

  11. vivek,

    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.

  12. vivek,

    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?

  13. 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.


  14. 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 Fileswampwwwregister.php on line 61″

    What do I need to do?

    Thanks alot.

    1. 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:wampwwwSurajemail sentsend_email.php on line 24

  15. 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

  16. 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(‘[email protected]’, ‘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.

  17. 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
    *****ACTIVATION LINK*****n
    Thank You
    __________________________________________________ ____
    mail($usr_email, "Login Details", $message,
    "From: "Member Registration" rn" .
    "X-Mailer: PHP/" . phpversion());
    header("Location: thankyou.php");

    somebody please help me what to do.


  18. 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:wampwwwSamplekkk.php on line 2

    Warning: include() [function.include]: Failed opening ‘Mail.php’ for inclusion (include_path=’.;C:php5pear’) in D:wampwwwSamplekkk.php on line 2

    Fatal error: Class ‘Mail’ not found in D:wampwwwSamplekkk.php on line 15

    Please tell me how to include Mail.php…

    Thank You….

  19. 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

  20. 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


  21. 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:



  22. 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:xampphtdocsmaileradminmail.php on line 3

  23. 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.

  24. 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.

  25. 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:xamppphpPEARMail.php on line 154

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

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

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

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

  26. 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.

  27. 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:wampwwwSurajemail sentsend_email.php on line 24

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

Leave a Comment