PHPMailer FAQ
7 |-
8 |
- Q: I am concerned that using include files will take up too much
9 | processing time on my computer. How can I make it run faster?
10 | A: PHP by itself is fairly fast, but it recompiles scripts every time they are run, which takes up valuable 11 | computer resources. You can bypass this by using an opcode cache which compiles 12 | PHP code and store it in memory to reduce overhead immensely. APC 13 | (Alternative PHP Cache) is a free opcode cache extension in the PECL library.
14 | - Q: Which mailer gives me the best performance?
15 | A: On a single machine the sendmail (or Qmail) is fastest overall. 16 | Next fastest is mail() to give you the best performance. Both do not have the overhead of SMTP. 17 | If you do not have a local mail server (as is typical on Windows), SMTP is your only option.
18 | - Q: When I try to attach a file with on my server I get a
19 | "Could not find {file} on filesystem error". Why is this?
20 | A: If you are using a Unix machine this is probably because the user 21 | running your web server does not have read access to the directory in question. If you are using Windows, 22 | then the problem is probably that you have used single backslashes to denote directories (\). 23 | A single backslash has a special meaning to PHP so these are not 24 | valid. Instead use double backslashes ("\\") or a single forward 25 | slash ("/").
26 |
9 |
19 |
20 |
21 |
--------------------------------------------------------------------------------
/php/PHPMailer/examples/exceptions.phps:
--------------------------------------------------------------------------------
1 | setFrom('from@example.com', 'First Last');
14 | //Set an alternative reply-to address
15 | $mail->addReplyTo('replyto@example.com', 'First Last');
16 | //Set who the message is to be sent to
17 | $mail->addAddress('whoto@example.com', 'John Doe');
18 | //Set the subject line
19 | $mail->Subject = 'PHPMailer Exceptions test';
20 | //Read an HTML message body from an external file, convert referenced images to embedded,
21 | //and convert the HTML into a basic plain-text alternative body
22 | $mail->msgHTML(file_get_contents('contents.html'), dirname(__FILE__));
23 | //Replace the plain text body with one created manually
24 | $mail->AltBody = 'This is a plain-text message body';
25 | //Attach an image file
26 | $mail->addAttachment('images/phpmailer_mini.png');
27 | //send the message
28 | //Note that we don't need check the response from this because it will throw an exception if it has trouble
29 | $mail->send();
30 | echo "Message sent!";
31 | } catch (phpmailerException $e) {
32 | echo $e->errorMessage(); //Pretty error messages from PHPMailer
33 | } catch (Exception $e) {
34 | echo $e->getMessage(); //Boring error messages from anything else!
35 | }
36 |
--------------------------------------------------------------------------------
/php/PHPMailer/examples/gmail.phps:
--------------------------------------------------------------------------------
1 | isSMTP();
17 |
18 | //Enable SMTP debugging
19 | // 0 = off (for production use)
20 | // 1 = client messages
21 | // 2 = client and server messages
22 | $mail->SMTPDebug = 2;
23 |
24 | //Ask for HTML-friendly debug output
25 | $mail->Debugoutput = 'html';
26 |
27 | //Set the hostname of the mail server
28 | $mail->Host = 'smtp.gmail.com';
29 | // use
30 | // $mail->Host = gethostbyname('smtp.gmail.com');
31 | // if your network does not support SMTP over IPv6
32 |
33 | //Set the SMTP port number - 587 for authenticated TLS, a.k.a. RFC4409 SMTP submission
34 | $mail->Port = 587;
35 |
36 | //Set the encryption system to use - ssl (deprecated) or tls
37 | $mail->SMTPSecure = 'tls';
38 |
39 | //Whether to use SMTP authentication
40 | $mail->SMTPAuth = true;
41 |
42 | //Username to use for SMTP authentication - use full email address for gmail
43 | $mail->Username = "username@gmail.com";
44 |
45 | //Password to use for SMTP authentication
46 | $mail->Password = "yourpassword";
47 |
48 | //Set who the message is to be sent from
49 | $mail->setFrom('from@example.com', 'First Last');
50 |
51 | //Set an alternative reply-to address
52 | $mail->addReplyTo('replyto@example.com', 'First Last');
53 |
54 | //Set who the message is to be sent to
55 | $mail->addAddress('whoto@example.com', 'John Doe');
56 |
57 | //Set the subject line
58 | $mail->Subject = 'PHPMailer GMail SMTP test';
59 |
60 | //Read an HTML message body from an external file, convert referenced images to embedded,
61 | //convert HTML into a basic plain-text alternative body
62 | $mail->msgHTML(file_get_contents('contents.html'), dirname(__FILE__));
63 |
64 | //Replace the plain text body with one created manually
65 | $mail->AltBody = 'This is a plain-text message body';
66 |
67 | //Attach an image file
68 | $mail->addAttachment('images/phpmailer_mini.png');
69 |
70 | //send the message, check for errors
71 | if (!$mail->send()) {
72 | echo "Mailer Error: " . $mail->ErrorInfo;
73 | } else {
74 | echo "Message sent!";
75 | }
76 |
--------------------------------------------------------------------------------
/php/PHPMailer/examples/gmail_xoauth.phps:
--------------------------------------------------------------------------------
1 | isSMTP();
21 |
22 | //Enable SMTP debugging
23 | // 0 = off (for production use)
24 | // 1 = client messages
25 | // 2 = client and server messages
26 | $mail->SMTPDebug = 0;
27 |
28 | //Ask for HTML-friendly debug output
29 | $mail->Debugoutput = 'html';
30 |
31 | //Set the hostname of the mail server
32 | $mail->Host = 'smtp.gmail.com';
33 |
34 | //Set the SMTP port number - 587 for authenticated TLS, a.k.a. RFC4409 SMTP submission
35 | $mail->Port = 587;
36 |
37 | //Set the encryption system to use - ssl (deprecated) or tls
38 | $mail->SMTPSecure = 'tls';
39 |
40 | //Whether to use SMTP authentication
41 | $mail->SMTPAuth = true;
42 |
43 | //Set AuthType
44 | $mail->AuthType = 'XOAUTH2';
45 |
46 | //User Email to use for SMTP authentication - Use the same Email used in Google Developer Console
47 | $mail->oauthUserEmail = "someone@gmail.com";
48 |
49 | //Obtained From Google Developer Console
50 | $mail->oauthClientId = "RANDOMCHARS-----duv1n2.apps.googleusercontent.com";
51 |
52 | //Obtained From Google Developer Console
53 | $mail->oauthClientSecret = "RANDOMCHARS-----lGyjPcRtvP";
54 |
55 | //Obtained By running get_oauth_token.php after setting up APP in Google Developer Console.
56 | //Set Redirect URI in Developer Console as [https/http]://This is a test of PHPMailer.
10 |
11 | 
12 |
13 |
12 | This example uses HTML.
14 |Chinese text: 郵件內容為空
15 |Russian text: Пустое тело сообщения
16 |Armenian text: Հաղորդագրությունը դատարկ է
17 |Czech text: Prázdné tělo zprávy
18 |'; 46 | break; //Abandon sending 47 | } else { 48 | echo "Message sent to :" . $row['full_name'] . ' (' . str_replace("@", "@", $row['email']) . ')
'; 49 | //Mark it as sent in the DB 50 | mysqli_query( 51 | $mysql, 52 | "UPDATE mailinglist SET sent = true WHERE email = '" . 53 | mysqli_real_escape_string($mysql, $row['email']) . "'" 54 | ); 55 | } 56 | // Clear all addresses and attachments for next loop 57 | $mail->clearAddresses(); 58 | $mail->clearAttachments(); 59 | } 60 | -------------------------------------------------------------------------------- /php/PHPMailer/examples/pop_before_smtp.phps: -------------------------------------------------------------------------------- 1 | isSMTP(); 18 | //Enable SMTP debugging 19 | // 0 = off (for production use) 20 | // 1 = client messages 21 | // 2 = client and server messages 22 | $mail->SMTPDebug = 2; 23 | //Ask for HTML-friendly debug output 24 | $mail->Debugoutput = 'html'; 25 | //Set the hostname of the mail server 26 | $mail->Host = "mail.example.com"; 27 | //Set the SMTP port number - likely to be 25, 465 or 587 28 | $mail->Port = 25; 29 | //Whether to use SMTP authentication 30 | $mail->SMTPAuth = false; 31 | //Set who the message is to be sent from 32 | $mail->setFrom('from@example.com', 'First Last'); 33 | //Set an alternative reply-to address 34 | $mail->addReplyTo('replyto@example.com', 'First Last'); 35 | //Set who the message is to be sent to 36 | $mail->addAddress('whoto@example.com', 'John Doe'); 37 | //Set the subject line 38 | $mail->Subject = 'PHPMailer POP-before-SMTP test'; 39 | //Read an HTML message body from an external file, convert referenced images to embedded, 40 | //and convert the HTML into a basic plain-text alternative body 41 | $mail->msgHTML(file_get_contents('contents.html'), dirname(__FILE__)); 42 | //Replace the plain text body with one created manually 43 | $mail->AltBody = 'This is a plain-text message body'; 44 | //Attach an image file 45 | $mail->addAttachment('images/phpmailer_mini.png'); 46 | //send the message 47 | //Note that we don't need check the response from this because it will throw an exception if it has trouble 48 | $mail->send(); 49 | echo "Message sent!"; 50 | } catch (phpmailerException $e) { 51 | echo $e->errorMessage(); //Pretty error messages from PHPMailer 52 | } catch (Exception $e) { 53 | echo $e->getMessage(); //Boring error messages from anything else! 54 | } 55 | -------------------------------------------------------------------------------- /php/PHPMailer/examples/scripts/shAutoloader.js: -------------------------------------------------------------------------------- 1 | (function() { 2 | 3 | var sh = SyntaxHighlighter; 4 | 5 | /** 6 | * Provides functionality to dynamically load only the brushes that a needed to render the current page. 7 | * 8 | * There are two syntaxes that autoload understands. For example: 9 | * 10 | * SyntaxHighlighter.autoloader( 11 | * [ 'applescript', 'Scripts/shBrushAppleScript.js' ], 12 | * [ 'actionscript3', 'as3', 'Scripts/shBrushAS3.js' ] 13 | * ); 14 | * 15 | * or a more easily comprehendable one: 16 | * 17 | * SyntaxHighlighter.autoloader( 18 | * 'applescript Scripts/shBrushAppleScript.js', 19 | * 'actionscript3 as3 Scripts/shBrushAS3.js' 20 | * ); 21 | */ 22 | sh.autoloader = function() 23 | { 24 | var list = arguments, 25 | elements = sh.findElements(), 26 | brushes = {}, 27 | scripts = {}, 28 | all = SyntaxHighlighter.all, 29 | allCalled = false, 30 | allParams = null, 31 | i 32 | ; 33 | 34 | SyntaxHighlighter.all = function(params) 35 | { 36 | allParams = params; 37 | allCalled = true; 38 | }; 39 | 40 | function addBrush(aliases, url) 41 | { 42 | for (var i = 0; i < aliases.length; i++) 43 | brushes[aliases[i]] = url; 44 | }; 45 | 46 | function getAliases(item) 47 | { 48 | return item.pop 49 | ? item 50 | : item.split(/\s+/) 51 | ; 52 | } 53 | 54 | // create table of aliases and script urls 55 | for (i = 0; i < list.length; i++) 56 | { 57 | var aliases = getAliases(list[i]), 58 | url = aliases.pop() 59 | ; 60 | 61 | addBrush(aliases, url); 62 | } 63 | 64 | // dynamically add tags to the document body 65 | for (i = 0; i < elements.length; i++) 66 | { 67 | var url = brushes[elements[i].params.brush]; 68 | 69 | if(url && scripts[url] === undefined) 70 | { 71 | if(elements[i].params['html-script'] === 'true') 72 | { 73 | if(scripts[brushes['xml']] === undefined) { 74 | loadScript(brushes['xml']); 75 | scripts[url] = false; 76 | } 77 | } 78 | 79 | scripts[url] = false; 80 | loadScript(url); 81 | } 82 | } 83 | 84 | function loadScript(url) 85 | { 86 | var script = document.createElement('script'), 87 | done = false 88 | ; 89 | 90 | script.src = url; 91 | script.type = 'text/javascript'; 92 | script.language = 'javascript'; 93 | script.onload = script.onreadystatechange = function() 94 | { 95 | if (!done && (!this.readyState || this.readyState == 'loaded' || this.readyState == 'complete')) 96 | { 97 | done = true; 98 | scripts[url] = true; 99 | checkAll(); 100 | 101 | // Handle memory leak in IE 102 | script.onload = script.onreadystatechange = null; 103 | script.parentNode.removeChild(script); 104 | } 105 | }; 106 | 107 | // sync way of adding script tags to the page 108 | document.body.appendChild(script); 109 | }; 110 | 111 | function checkAll() 112 | { 113 | for(var url in scripts) 114 | if (scripts[url] == false) 115 | return; 116 | 117 | if (allCalled) 118 | SyntaxHighlighter.highlight(allParams); 119 | }; 120 | }; 121 | 122 | })(); 123 | -------------------------------------------------------------------------------- /php/PHPMailer/examples/scripts/shLegacy.js: -------------------------------------------------------------------------------- 1 | var dp = { 2 | SyntaxHighlighter : {} 3 | }; 4 | 5 | dp.SyntaxHighlighter = { 6 | parseParams: function( 7 | input, 8 | showGutter, 9 | showControls, 10 | collapseAll, 11 | firstLine, 12 | showColumns 13 | ) 14 | { 15 | function getValue(list, name) 16 | { 17 | var regex = new XRegExp('^' + name + '\\[(?