Added new interfaces for file i/o classes.
[core.git] / inc / classes / third_party / php_mailer / ChangeLog.txt
1 ChangeLog
2
3 NOTE: THIS VERSION OF PHPMAILER IS DESIGNED FOR PHP5/PHP6. IT WILL NOT WORK WITH PHP4.
4
5 Version 2.3 (November 06, 2008)
6
7 * added Arabic language (many thanks to Bahjat Al Mostafa)
8 * removed English language from language files and made it a default within
9   class.phpmailer.php - if no language is found, it will default to use
10   the english language translation
11 * fixed public/private declarations
12 * corrected line 1728, $basedir to $directory
13 * added $sign_cert_file to avoid improper duplicate use of $sign_key_file
14 * corrected $this->Hello on line 612 to $this->Helo
15 * changed default of $LE to "\r\n" to comply with RFC 2822. Can be set by the user
16   if default is not acceptable
17 * removed trim() from return results in EncodeQP
18 * /test and three files it contained are removed from version 2.3
19 * fixed phpunit.php for compliance with PHP5
20 * changed $this->AltBody = $textMsg; to $this->AltBody = html_entity_decode($textMsg);
21 * We have removed the /phpdoc from the downloads. All documentation is now on
22   the http://phpmailer.codeworxtech.com website.
23
24 Version 2.2.1 () July 19 2008
25
26 * fixed line 1092 in class.smtp.php (my apologies, error on my part)
27
28 Version 2.2 () July 15 2008
29
30 * Fixed redirect issue (display of UTF-8 in thank you redirect)
31 * fixed error in getResponse function declaration (class.pop3.php)
32 * PHPMailer now PHP6 compliant
33 * fixed line 1092 in class.smtp.php (endless loop from missing = sign)
34
35 Version 2.1 (Wed, June 04 2008)
36
37 ** NOTE: WE HAVE A NEW LANGUAGE VARIABLE FOR DIGITALLY SIGNED S/MIME EMAILS.
38    IF YOU CAN HELP WITH LANGUAGES OTHER THAN ENGLISH AND SPANISH, IT WOULD BE
39    APPRECIATED.
40
41 * added S/MIME functionality (ability to digitally sign emails)
42   BIG THANKS TO "sergiocambra" for posting this patch back in November 2007.
43   The "Signed Emails" functionality adds the Sign method to pass the private key
44   filename and the password to read it, and then email will be sent with
45   content-type multipart/signed and with the digital signature attached.
46 * fully compatible with E_STRICT error level
47   - Please note:
48     In about half the test environments this development version was subjected
49     to, an error was thrown for the date() functions used (line 1565 and 1569).
50     This is NOT a PHPMailer error, it is the result of an incorrectly configured
51     PHP5 installation. The fix is to modify your 'php.ini' file and include the
52     date.timezone = America/New York
53     directive, to your own server timezone
54   - If you do get this error, and are unable to access your php.ini file:
55     In your PHP script, add
56     date_default_timezone_set('America/Toronto');
57     - do not try to use
58     $myVar = date_default_timezone_get();
59     as a test, it will throw an error.
60 * added ability to define path (mainly for embedded images)
61   function MsgHTML($message,$basedir='') ... where:
62   $basedir is the fully qualified path
63 * fixed MsgHTML() function:
64   - Embedded Images where images are specified by <protocol>:// will not be altered or embedded
65 * fixed the return value of SMTP exit code ( pclose )
66 * addressed issue of multibyte characters in subject line and truncating
67 * added ability to have user specified Message ID
68   (default is still that PHPMailer create a unique Message ID)
69 * corrected unidentified message type to 'application/octet-stream'
70 * fixed chunk_split() multibyte issue (thanks to Colin Brown, et al).
71 * added check for added attachments
72 * enhanced conversion of HTML to text in MsgHTML (thanks to "brunny")
73
74 Version 2.1.0beta2 (Sun, Dec 02 2007)
75 * implemented updated EncodeQP (thanks to coolbru, aka Marcus Bointon)
76 * finished all testing, all known bugs corrected, enhancements tested
77 - note: will NOT work with PHP4.
78
79 please note, this is BETA software
80 ** DO NOT USE THIS IN PRODUCTION OR LIVE PROJECTS
81 INTENDED STRICTLY FOR TESTING
82
83 Version 2.1.0beta1
84 please note, this is BETA software
85 ** DO NOT USE THIS IN PRODUCTION OR LIVE PROJECTS
86 INTENDED STRICTLY FOR TESTING
87
88 Version 2.0.0 rc2 (Fri, Nov 16 2007), interim release
89 * implements new property to control VERP in class.smtp.php
90   example (requires instantiating class.smtp.php):
91   $mail->do_verp = true;
92 * POP-before-SMTP functionality included, thanks to Richard Davey
93   (see class.pop3.php & pop3_before_smtp_test.php for examples)
94 * included example showing how to use PHPMailer with GMAIL
95 * fixed the missing Cc in SendMail() and Mail()
96
97 ******************
98 A note on sending bulk emails:
99
100 If the email you are sending is not personalized, consider using the
101 "undisclosed-recipient:;" strategy. That is, put all of your recipients
102 in the Bcc field and set the To field to "undisclosed-recipients:;".
103 It's a lot faster (only one send) and saves quite a bit on resources.
104 Contrary to some opinions, this will not get you listed in spam engines -
105 it's a legitimate way for you to send emails.
106
107 A partial example for use with PHPMailer:
108
109 $mail->AddAddress("undisclosed-recipients:;");
110 $mail->AddBCC("email1@anydomain.com,email2@anyotherdomain.com,email3@anyalternatedomain.com");
111
112 Many email service providers restrict the number of emails that can be sent
113 in any given time period. Often that is between 50 - 60 emails maximum
114 per hour or per send session.
115
116 If that's the case, then break up your Bcc lists into chunks that are one
117 less than your limit, and put a pause in your script.
118 *******************
119
120 Version 2.0.0 rc1 (Thu, Nov 08 2007), interim release
121 * dramatically simplified using inline graphics ... it's fully automated and requires no user input
122 * added automatic document type detection for attachments and pictures
123 * added MsgHTML() function to replace Body tag for HTML emails
124 * fixed the SendMail security issues (input validation vulnerability)
125 * enhanced the AddAddresses functionality so that the "Name" portion is used in the email address
126 * removed the need to use the AltBody method (set from the HTML, or default text used)
127 * set the PHP Mail() function as the default (still support SendMail, SMTP Mail)
128 * removed the need to set the IsHTML property (set automatically)
129 * added Estonian language file by Indrek P&auml;ri
130 * added header injection patch
131 * added "set" method to permit users to create their own pseudo-properties like 'X-Headers', etc.
132   example of use:
133   $mail->set('X-Priority', '3');
134   $mail->set('X-MSMail-Priority', 'Normal');
135 * fixed warning message in SMTP get_lines method
136 * added TLS/SSL SMTP support
137   example of use:
138   $mail = new PHPMailer();
139   $mail->Mailer = "smtp";
140   $mail->Host = "smtp.example.com";
141   $mail->SMTPSecure   = "tls"; // option
142   //$mail->SMTPSecure   = "ssl";  // option
143   ...
144   $mail->Send();
145 * PHPMailer has been tested with PHP4 (4.4.7) and PHP5 (5.2.7)
146 * Works with PHP installed as a module or as CGI-PHP
147 - NOTE: will NOT work with PHP5 in E_STRICT error mode
148
149 Version 1.73 (Sun, Jun 10 2005)
150 * Fixed denial of service bug: http://www.cybsec.com/vuln/PHPMailer-DOS.pdf
151 * Now has a total of 20 translations
152 * Fixed alt attachments bug: http://tinyurl.com/98u9k
153
154 Version 1.72 (Wed, May 25 2004)
155 * Added Dutch, Swedish, Czech, Norwegian, and Turkish translations.
156 * Received: Removed this method because spam filter programs like
157 SpamAssassin reject this header.
158 * Fixed error count bug.
159 * SetLanguage default is now "language/".
160 * Fixed magic_quotes_runtime bug.
161
162 Version 1.71 (Tue, Jul 28 2003)
163 * Made several speed enhancements
164 * Added German and Italian translation files
165 * Fixed HELO/AUTH bugs on keep-alive connects
166 * Now provides an error message if language file does not load
167 * Fixed attachment EOL bug
168 * Updated some unclear documentation
169 * Added additional tests and improved others
170
171 Version 1.70 (Mon, Jun 20 2003)
172 * Added SMTP keep-alive support
173 * Added IsError method for error detection
174 * Added error message translation support (SetLanguage)
175 * Refactored many methods to increase library performance
176 * Hello now sends the newer EHLO message before HELO as per RFC 2821
177 * Removed the boundary class and replaced it with GetBoundary
178 * Removed queue support methods
179 * New $Hostname variable
180 * New Message-ID header
181 * Received header reformat
182 * Helo variable default changed to $Hostname
183 * Removed extra spaces in Content-Type definition (#667182)
184 * Return-Path should be set to Sender when set
185 * Adds Q or B encoding to headers when necessary
186 * quoted-encoding should now encode NULs \000
187 * Fixed encoding of body/AltBody (#553370)
188 * Adds "To: undisclosed-recipients:;" when all recipients are hidden (BCC)
189 * Multiple bug fixes
190
191 Version 1.65 (Fri, Aug 09 2002)
192 * Fixed non-visible attachment bug (#585097) for Outlook
193 * SMTP connections are now closed after each transaction
194 * Fixed SMTP::Expand return value
195 * Converted SMTP class documentation to phpDocumentor format
196
197 Version 1.62 (Wed, Jun 26 2002)
198 * Fixed multi-attach bug
199 * Set proper word wrapping
200 * Reduced memory use with attachments
201 * Added more debugging
202 * Changed documentation to phpDocumentor format
203
204 Version 1.60 (Sat, Mar 30 2002)
205 * Sendmail pipe and address patch (Christian Holtje)
206 * Added embedded image and read confirmation support (A. Ognio)
207 * Added unit tests
208 * Added SMTP timeout support (*nix only)
209 * Added possibly temporary PluginDir variable for SMTP class
210 * Added LE message line ending variable
211 * Refactored boundary and attachment code
212 * Eliminated SMTP class warnings
213 * Added SendToQueue method for future queuing support
214
215 Version 1.54 (Wed, Dec 19 2001)
216 * Add some queuing support code
217 * Fixed a pesky multi/alt bug
218 * Messages are no longer forced to have "To" addresses
219
220 Version 1.50 (Thu, Nov 08 2001)
221 * Fix extra lines when not using SMTP mailer
222 * Set WordWrap variable to int with a zero default
223
224 Version 1.47 (Tue, Oct 16 2001)
225 * Fixed Received header code format
226 * Fixed AltBody order error
227 * Fixed alternate port warning
228
229 Version 1.45 (Tue, Sep 25 2001)
230 * Added enhanced SMTP debug support
231 * Added support for multiple ports on SMTP
232 * Added Received header for tracing
233 * Fixed AddStringAttachment encoding
234 * Fixed possible header name quote bug
235 * Fixed wordwrap() trim bug
236 * Couple other small bug fixes
237
238 Version 1.41 (Wed, Aug 22 2001)
239 * Fixed AltBody bug w/o attachments
240 * Fixed rfc_date() for certain mail servers
241
242 Version 1.40 (Sun, Aug 12 2001)
243 * Added multipart/alternative support (AltBody)
244 * Documentation update
245 * Fixed bug in Mercury MTA
246
247 Version 1.29 (Fri, Aug 03 2001)
248 * Added AddStringAttachment() method
249 * Added SMTP authentication support
250
251 Version 1.28 (Mon, Jul 30 2001)
252 * Fixed a typo in SMTP class
253 * Fixed header issue with Imail (win32) SMTP server
254 * Made fopen() calls for attachments use "rb" to fix win32 error
255
256 Version 1.25 (Mon, Jul 02 2001)
257 * Added RFC 822 date fix (Patrice)
258 * Added improved error handling by adding a $ErrorInfo variable
259 * Removed MailerDebug variable (obsolete with new error handler)
260
261 Version 1.20 (Mon, Jun 25 2001)
262 * Added quoted-printable encoding (Patrice)
263 * Set Version as public and removed PrintVersion()
264 * Changed phpdoc to only display public variables and methods
265
266 Version 1.19 (Thu, Jun 21 2001)
267 * Fixed MS Mail header bug
268 * Added fix for Bcc problem with mail(). *Does not work on Win32*
269   (See PHP bug report: http://www.php.net/bugs.php?id=11616)
270 * mail() no longer passes a fifth parameter when not needed
271
272 Version 1.15 (Fri, Jun 15 2001)
273 [Note: these changes contributed by Patrice Fournier]
274 * Changed all remaining \n to \r\n
275 * Bcc: header no longer writen to message except
276 when sent directly to sendmail
277 * Added a small message to non-MIME compliant mail reader
278 * Added Sender variable to change the Sender email
279 used in -f for sendmail/mail and in 'MAIL FROM' for smtp mode
280 * Changed boundary setting to a place it will be set only once
281 * Removed transfer encoding for whole message when using multipart
282 * Message body now uses Encoding in multipart messages
283 * Can set encoding and type to attachments 7bit, 8bit
284 and binary attachment are sent as is, base64 are encoded
285 * Can set Encoding to base64 to send 8 bits body
286 through 7 bits servers
287
288 Version 1.10 (Tue, Jun 12 2001)
289 * Fixed win32 mail header bug (printed out headers in message body)
290
291 Version 1.09 (Fri, Jun 08 2001)
292 * Changed date header to work with Netscape mail programs
293 * Altered phpdoc documentation
294
295 Version 1.08 (Tue, Jun 05 2001)
296 * Added enhanced error-checking
297 * Added phpdoc documentation to source
298
299 Version 1.06 (Fri, Jun 01 2001)
300 * Added optional name for file attachments
301
302 Version 1.05 (Tue, May 29 2001)
303 * Code cleanup
304 * Eliminated sendmail header warning message
305 * Fixed possible SMTP error
306
307 Version 1.03 (Thu, May 24 2001)
308 * Fixed problem where qmail sends out duplicate messages
309
310 Version 1.02 (Wed, May 23 2001)
311 * Added multiple recipient and attachment Clear* methods
312 * Added Sendmail public variable
313 * Fixed problem with loading SMTP library multiple times
314
315 Version 0.98 (Tue, May 22 2001)
316 * Fixed problem with redundant mail hosts sending out multiple messages
317 * Added additional error handler code
318 * Added AddCustomHeader() function
319 * Added support for Microsoft mail client headers (affects priority)
320 * Fixed small bug with Mailer variable
321 * Added PrintVersion() function
322
323 Version 0.92 (Tue, May 15 2001)
324 * Changed file names to class.phpmailer.php and class.smtp.php to match
325   current PHP class trend.
326 * Fixed problem where body not being printed when a message is attached
327 * Several small bug fixes
328
329 Version 0.90 (Tue, April 17 2001)
330 * Intial public release