Add email config for transferEncoding #11485

src/Mailer/Email.php

@@ -241,6 +241,14 @@ class Email implements JsonSerializable, Serializable
      */
     public $headerCharset;
 
+    /**
+     * The email transfer encoding used.
+     * If null, the $charset property is used for determined the transfer encoding.
+     *
+     * @var string|null
+     */
+    public $transferEncoding;
+
     /**
      * The application wide charset, used to encode headers and body
      *
@@ -827,6 +835,27 @@ public function headerCharset($charset = null)
         return $this->headerCharset;
     }
 
+    /**
+     * TransportCharset setter.
+     *
+     * @param string|null $encoding Character set.
+     * @return $this
+     */
+    public function setTransferEncoding($encoding) {
+        $this->transferEncoding = $encoding;
+
+        return $this;
+    }
+
+    /**
+     * TransportCharset getter.
+     *
+     * @return string|null Encoding
+     */
+    public function getTransferEncoding() {
+        return $this->transferEncoding;
+    }
+
     /**
      * EmailPattern setter/getter
      *
@@ -2224,6 +2253,7 @@ public function reset()
         $this->_priority = null;
         $this->charset = 'utf-8';
         $this->headerCharset = null;
+        $this->transferEncoding = null;
         $this->_attachments = [];
         $this->_profile = [];
         $this->_emailPattern = self::EMAIL_PATTERN;
@@ -2661,6 +2691,10 @@ protected function _renderTemplates($content)
      */
     protected function _getContentTransferEncoding()
     {
+        if ($this->transferEncoding) {
+            return $this->transferEncoding;
+        }
+
         $charset = strtoupper($this->charset);
         if (in_array($charset, $this->_charset8bit)) {
             return '8bit';

tests/TestCase/Mailer/EmailTest.php

@@ -90,6 +90,16 @@ public function render($content)
     {
         return $this->_render($content);
     }
+
+    /**
+     * GetContentTransferEncoding to protected method
+     *
+     * @return string
+     */
+    public function getContentTransferEncoding() {
+        return $this->_getContentTransferEncoding();
+    }
+
 }
 
 /**
@@ -2487,6 +2497,21 @@ public function testHeaderCharset()
         $this->assertSame($charset, 'Shift_JIS');
     }
 
+    /**
+     * Test transferEncoding
+     */
+    public function testTransferEncoding(){
+        // Test new transport encoding
+        $this->Email->setTransferEncoding('quoted-printable');
+        $this->assertSame($this->Email->getTransferEncoding(), 'quoted-printable');
+        $this->assertSame($this->Email->getContentTransferEncoding(), 'quoted-printable');
+
+        // Test default charset/encoding : utf8/8bit
+        $this->Email->reset();
+        $this->assertNull($this->Email->getTransferEncoding());
+        $this->assertSame($this->Email->getContentTransferEncoding(), '8bit');
+    }
+
     /**
      * Tests for compatible check.
      *          charset property and       charset() method.