[Summary view] [Print] [Text view]

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