create-berna-stencil 1.0.8 → 1.0.10

package/src/api/vendor/phpmailer/phpmailer/test/PHPMailer/CustomHeaderTest.php

@@ -0,0 +1,285 @@
+<?php
+
+/**
+ * PHPMailer - PHP email transport unit tests.
+ * PHP version 5.5.
+ *
+ * @author    Marcus Bointon <phpmailer@synchromedia.co.uk>
+ * @author    Andy Prevost
+ * @copyright 2012 - 2020 Marcus Bointon
+ * @copyright 2004 - 2009 Andy Prevost
+ * @license   https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU Lesser General Public License
+ */
+
+namespace PHPMailer\Test\PHPMailer;
+
+use PHPMailer\PHPMailer\Exception;
+use PHPMailer\PHPMailer\PHPMailer;
+use PHPMailer\Test\TestCase;
+
+/**
+ * Test custom header functionality.
+ */
+final class CustomHeaderTest extends TestCase
+{
+    /**
+     * Tests setting and getting custom headers.
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::addCustomHeader
+     * @covers \PHPMailer\PHPMailer\PHPMailer::getCustomHeaders
+     *
+     * @dataProvider dataAddAndGetCustomHeader
+     *
+     * @param array      $headers  Array of headers to set.
+     * @param array|null $expected Optional. The expected set headers.
+     *                             Only needs to be passed if different from the $headers array.
+     */
+    public function testAddAndGetCustomHeader($headers, $expected = null)
+    {
+        if (isset($expected) === false) {
+            $expected = $headers;
+        }
+
+        // Test setting the custom header(s).
+        foreach ($headers as $header) {
+            if (isset($header[1])) {
+                $set = $this->Mail->addCustomHeader($header[0], $header[1]);
+            } else {
+                $set = $this->Mail->addCustomHeader($header[0]);
+            }
+
+            self::assertTrue($set, 'Custom header failed to set for ' . var_export($header, true));
+        }
+
+        // Test retrieving the custom header(s) and verify they have been correctly set.
+        self::assertSame(
+            $expected,
+            $this->Mail->getCustomHeaders(),
+            'Custom headers retrieved not the same as expected'
+        );
+    }
+
+    /**
+     * Data provider.
+     *
+     * @return array
+     */
+    public function dataAddAndGetCustomHeader()
+    {
+        return [
+            'Single custom header' => [
+                'headers' => [
+                    ['foo', 'bar'],
+                ],
+            ],
+            'Multiple custom headers' => [
+                'headers' => [
+                    ['foo', 'bar'],
+                    ['foo', 'baz'],
+                ],
+            ],
+            'Custom header: only name, no colon' => [
+                'headers' => [
+                    ['yux'],
+                ],
+                'expected' => [
+                    ['yux', ''],
+                ],
+            ],
+            'Custom header: whitespace around name and value' => [
+                'headers' => [
+                    ['  name  ', '  value  '],
+                ],
+                'expected' => [
+                    ['name', 'value'],
+                ],
+            ],
+            'Custom headers: "name: value" sets' => [
+                'headers' => [
+                    ['Content-Type: application/json'],
+                    ['SomeHeader: Some Value'],
+                ],
+                'expected' => [
+                    ['Content-Type', 'application/json'],
+                    ['SomeHeader', 'Some Value'],
+                ],
+            ],
+            'Custom headers: "name:value" sets, no space and lots of space' => [
+                'headers' => [
+                    ['Content-Type:application/json'],
+                    ['SomeHeader    :     Some Value'],
+                ],
+                'expected' => [
+                    ['Content-Type', 'application/json'],
+                    ['SomeHeader', 'Some Value'],
+                ],
+            ],
+            'Custom headers: "name: value" set with a colon in the value' => [
+                'headers' => [
+                    ['name: value:value'],
+                ],
+                'expected' => [
+                    ['name', 'value:value'],
+                ],
+            ],
+            'Custom headers: "name: value" set without a value' => [
+                'headers' => [
+                    ['name:'],
+                ],
+                'expected' => [
+                    ['name', ''],
+                ],
+            ],
+            'Custom header: "name: value" set with whitespace around name and value' => [
+                'headers' => [
+                    ['  name  :  value  '],
+                ],
+                'expected' => [
+                    ['name', 'value'],
+                ],
+            ],
+            'Custom headers: duplicate headers' => [
+                'headers' => [
+                    ['SomeHeader: Some Value'],
+                    ['SomeHeader', 'Some Value']
+                ],
+                'expected' => [
+                    ['SomeHeader', 'Some Value'],
+                    ['SomeHeader', 'Some Value'],
+                ],
+            ],
+        ];
+    }
+
+    /**
+     * Tests failing to set custom headers when the header info provided does not validate.
+     *
+     * @covers       \PHPMailer\PHPMailer\PHPMailer::addCustomHeader
+     * @dataProvider dataAddCustomHeaderInvalid
+     *
+     * @param string $name  Custom header name.
+     * @param mixed  $value Optional. Custom header value.
+     */
+    public function testAddCustomHeaderInvalid($name, $value = null)
+    {
+        self::assertFalse($this->Mail->addCustomHeader($name, $value));
+    }
+
+    /**
+     * Data provider.
+     *
+     * @return array
+     */
+    public function dataAddCustomHeaderInvalid()
+    {
+        return [
+            'Invalid: new line in value' => [
+                'name'  => 'SomeHeader',
+                'value' => "Some\n Value",
+            ],
+            'Invalid: new line in name' => [
+                'name'  => "Some\nHeader",
+                'value' => 'Some Value',
+            ],
+            'Invalid: empty name' => [
+                'name'  => '   ',
+            ],
+            'Invalid: empty name and empty value' => [
+                'name'  => '  :  ',
+            ],
+        ];
+    }
+
+    /**
+     * Test removing previously set custom header.
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::clearCustomHeader
+     */
+    public function testClearCustomHeader()
+    {
+        // make sure 'foo' is cleared, even if there is more than one header set.
+        $this->Mail->addCustomHeader('foo', 'bar');
+        $this->Mail->addCustomHeader('foo', 'baz');
+        self::assertSame([['foo', 'bar'], ['foo', 'baz']], $this->Mail->getCustomHeaders());
+
+        $this->Mail->clearCustomHeader('foo');
+
+        $cleared = $this->Mail->getCustomHeaders();
+        self::assertIsArray($cleared);
+        self::assertEmpty($cleared);
+    }
+
+    /**
+     * Test removing previously set custom header value.
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::clearCustomHeader
+     */
+    public function testClearCustomHeaderValue()
+    {
+        // Test clearing 'name', 'value'
+        $this->Mail->addCustomHeader('foo', 'bar');
+        $this->Mail->addCustomHeader('foo', 'baz');
+        self::assertSame([['foo', 'bar'], ['foo', 'baz']], $this->Mail->getCustomHeaders());
+
+        $this->Mail->clearCustomHeader('foo', 'bar');
+        self::assertSame([['foo', 'baz']], array_values($this->Mail->getCustomHeaders()));
+
+        // Test clearing 'name: value'
+        $this->Mail->addCustomHeader('foo', 'bar');
+        self::assertSame([['foo', 'baz'], ['foo', 'bar']], array_values($this->Mail->getCustomHeaders()));
+
+        $this->Mail->clearCustomHeader('foo: bar');
+        self::assertSame([['foo', 'baz']], array_values($this->Mail->getCustomHeaders()));
+    }
+
+    /**
+     * Test removing previously set custom headers.
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::clearCustomHeaders
+     */
+    public function testClearCustomHeaders()
+    {
+        $this->Mail->addCustomHeader('foo', 'bar');
+        self::assertSame([['foo', 'bar']], $this->Mail->getCustomHeaders());
+
+        $this->Mail->clearCustomHeaders();
+
+        $cleared = $this->Mail->getCustomHeaders();
+        self::assertIsArray($cleared);
+        self::assertEmpty($cleared);
+    }
+
+    /**
+     * Check whether setting a bad custom header throws exceptions.
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::addCustomHeader
+     *
+     * @throws Exception
+     */
+    public function testInvalidHeaderException()
+    {
+        $this->expectException(Exception::class);
+        $this->expectExceptionMessage('Invalid header name or value');
+
+        $mail = new PHPMailer(true);
+        $mail->addCustomHeader('SomeHeader', "Some\n Value");
+    }
+
+    /**
+     * Test replacing a previously set custom header.
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::replaceCustomHeader
+     */
+    public function testReplaceCustomHeader()
+    {
+        $this->Mail->addCustomHeader('foo', 'bar');
+        $this->Mail->replaceCustomHeader('foo', 'baz');
+
+        // Test retrieving the custom header(s) and verify the updated value is seet.
+        self::assertSame(
+            [['foo', 'baz']],
+            $this->Mail->getCustomHeaders(),
+            'Custom header does not contain expected update'
+        );
+    }
+}

package/src/api/vendor/phpmailer/phpmailer/test/PHPMailer/DKIMTest.php

@@ -0,0 +1,258 @@
+<?php
+
+/**
+ * PHPMailer - PHP email transport unit tests.
+ * PHP version 5.5.
+ *
+ * @author    Marcus Bointon <phpmailer@synchromedia.co.uk>
+ * @author    Andy Prevost
+ * @copyright 2012 - 2020 Marcus Bointon
+ * @copyright 2004 - 2009 Andy Prevost
+ * @license   https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU Lesser General Public License
+ */
+
+namespace PHPMailer\Test\PHPMailer;
+
+use PHPMailer\PHPMailer\Exception;
+use PHPMailer\Test\SendTestCase;
+
+/**
+ * Test DKIM signing functionality.
+ *
+ * @group dkim
+ */
+final class DKIMTest extends SendTestCase
+{
+    /**
+     * Whether or not to initialize the PHPMailer object to throw exceptions.
+     *
+     * @var bool|null
+     */
+    const USE_EXCEPTIONS = true;
+
+    const PRIVATE_KEY_FILE = 'dkim_private.pem';
+
+    /**
+     * Run after each test is completed.
+     */
+    protected function tear_down()
+    {
+        if (file_exists(self::PRIVATE_KEY_FILE)) {
+            unlink(self::PRIVATE_KEY_FILE);
+        }
+
+        parent::tear_down();
+    }
+
+    /**
+     * DKIM body canonicalization tests.
+     *
+     * @link https://www.rfc-editor.org/rfc/rfc6376.html#section-3.4.4
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::DKIM_BodyC
+     */
+    public function testDKIMBodyCanonicalization()
+    {
+        // Example from https://www.rfc-editor.org/rfc/rfc6376.html#section-3.4.5.
+        $prebody = " C \r\nD \t E\r\n\r\n\r\n";
+        $postbody = " C \r\nD \t E\r\n";
+
+        self::assertSame(
+            "\r\n",
+            $this->Mail->DKIM_BodyC(''),
+            'DKIM empty body canonicalization incorrect (Empty body)'
+        );
+        self::assertSame(
+            'frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN/XKdLCPjaYaY=',
+            base64_encode(hash('sha256', $this->Mail->DKIM_BodyC(''), true)),
+            'DKIM canonicalized empty body hash mismatch'
+        );
+        self::assertSame($postbody, $this->Mail->DKIM_BodyC($prebody), 'DKIM body canonicalization incorrect');
+
+        //Ensure that non-break trailing whitespace in the body is preserved
+        $prebody = " C \r\nD \t E \r\n\r\n\r\n";
+        $postbody = " C \r\nD \t E \r\n";
+        self::assertSame(
+            $postbody,
+            $this->Mail->DKIM_BodyC($prebody),
+            'DKIM body canonicalization incorrect (trailing WSP)'
+        );
+    }
+
+    /**
+     * DKIM header canonicalization tests.
+     *
+     * @link https://www.rfc-editor.org/rfc/rfc6376.html#section-3.4.2
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::DKIM_HeaderC
+     */
+    public function testDKIMHeaderCanonicalization()
+    {
+        // Example from https://www.rfc-editor.org/rfc/rfc6376.html#section-3.4.5.
+        $preheaders = "A: X\r\nB : Y\t\r\n\tZ  \r\n";
+        $postheaders = "a:X\r\nb:Y Z\r\n";
+        self::assertSame(
+            $postheaders,
+            $this->Mail->DKIM_HeaderC($preheaders),
+            'DKIM header canonicalization incorrect'
+        );
+
+        // Check that long folded lines with runs of spaces are canonicalized properly.
+        $preheaders = 'Long-Header-1: <https://example.com/somescript.php?' .
+            "id=1234567890&name=Abcdefghijklmnopquestuvwxyz&hash=\r\n abc1234\r\n" .
+            "Long-Header-2: This  is  a  long  header  value  that  contains  runs  of  spaces and trailing    \r\n" .
+            ' and   is   folded   onto   2   lines';
+        $postheaders = 'long-header-1:<https://example.com/somescript.php?id=1234567890&' .
+            "name=Abcdefghijklmnopquestuvwxyz&hash= abc1234\r\nlong-header-2:This is a long" .
+            ' header value that contains runs of spaces and trailing and is folded onto 2 lines';
+        self::assertSame(
+            $postheaders,
+            $this->Mail->DKIM_HeaderC($preheaders),
+            'DKIM header canonicalization of long lines incorrect'
+        );
+    }
+
+    /**
+     * DKIM copied header fields tests.
+     *
+     * @link https://www.rfc-editor.org/rfc/rfc6376.html#section-3.5
+     *
+     * @requires extension openssl
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::DKIM_Add
+     * @covers \PHPMailer\PHPMailer\PHPMailer::DKIM_Sign
+     * @covers \PHPMailer\PHPMailer\PHPMailer::DKIM_QP
+     */
+    public function testDKIMOptionalHeaderFieldsCopy()
+    {
+        $pk = openssl_pkey_new(
+            [
+                'private_key_bits' => 2048,
+                'private_key_type' => OPENSSL_KEYTYPE_RSA,
+            ]
+        );
+        openssl_pkey_export_to_file($pk, self::PRIVATE_KEY_FILE);
+        $this->Mail->DKIM_private = self::PRIVATE_KEY_FILE;
+
+        // Example from https://www.rfc-editor.org/rfc/rfc6376.html#section-3.5.
+        $from = 'from@example.com';
+        $to = 'to@example.com';
+        $date = 'date';
+        $subject = 'example';
+
+        $headerLines = "From:$from\r\nTo:$to\r\nDate:$date\r\n";
+        $copyHeaderFields = " z=From:$from\r\n |To:$to\r\n |Date:$date\r\n |Subject:$subject;\r\n";
+
+        $this->Mail->DKIM_copyHeaderFields = true;
+        self::assertStringContainsString(
+            $copyHeaderFields,
+            $this->Mail->DKIM_Add($headerLines, $subject, ''),
+            'DKIM header with copied header fields incorrect'
+        );
+
+        $this->Mail->DKIM_copyHeaderFields = false;
+        self::assertStringNotContainsString(
+            $copyHeaderFields,
+            $this->Mail->DKIM_Add($headerLines, $subject, ''),
+            'DKIM header without copied header fields incorrect'
+        );
+    }
+
+    /**
+     * DKIM signing extra headers tests.
+     *
+     * @requires extension openssl
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::DKIM_Add
+     * @covers \PHPMailer\PHPMailer\PHPMailer::DKIM_Sign
+     * @covers \PHPMailer\PHPMailer\PHPMailer::DKIM_QP
+     */
+    public function testDKIMExtraHeaders()
+    {
+        $pk = openssl_pkey_new(
+            [
+                'private_key_bits' => 2048,
+                'private_key_type' => OPENSSL_KEYTYPE_RSA,
+            ]
+        );
+        openssl_pkey_export_to_file($pk, self::PRIVATE_KEY_FILE);
+        $this->Mail->DKIM_private = self::PRIVATE_KEY_FILE;
+
+        // Example from https://www.rfc-editor.org/rfc/rfc6376.html#section-3.5.
+        $from = 'from@example.com';
+        $to = 'to@example.com';
+        $date = 'date';
+        $subject = 'example';
+        $anyHeader = 'foo';
+        $unsubscribeUrl = '<https://www.example.com/unsubscribe/?newsletterId=anytoken&amp;actionToken=anyToken' .
+                            '&otherParam=otherValue&anotherParam=anotherVeryVeryVeryLongValue>';
+
+        $this->Mail->addCustomHeader('X-AnyHeader', $anyHeader);
+        $this->Mail->addCustomHeader('Baz', 'bar');
+        $this->Mail->addCustomHeader('List-Unsubscribe', $unsubscribeUrl);
+
+        $this->Mail->DKIM_extraHeaders = ['Baz', 'List-Unsubscribe'];
+
+        $headerLines = "From:$from\r\nTo:$to\r\nDate:$date\r\n";
+        $headerLines .= "X-AnyHeader:$anyHeader\r\nBaz:bar\r\n";
+        $headerLines .= 'List-Unsubscribe:' . $this->Mail->encodeHeader($unsubscribeUrl) . "\r\n";
+
+        $headerFields = 'h=From:To:Date:Baz:List-Unsubscribe:Subject';
+
+        $result = $this->Mail->DKIM_Add($headerLines, $subject, '');
+
+        self::assertStringContainsString($headerFields, $result, 'DKIM header with extra headers incorrect');
+    }
+
+    /**
+     * DKIM Signing tests.
+     *
+     * @requires extension openssl
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::DKIM_Add
+     * @covers \PHPMailer\PHPMailer\PHPMailer::DKIM_Sign
+     * @covers \PHPMailer\PHPMailer\PHPMailer::DKIM_QP
+     */
+    public function testDKIMSigningMail()
+    {
+        $this->Mail->Subject .= ': DKIM signing';
+        $this->Mail->Body = 'This message is DKIM signed.';
+        $this->buildBody();
+
+        // Make a new key pair.
+        // Note: 2048 bits is the recommended minimum key length - gmail won't accept less than 1024 bits.
+        $pk = openssl_pkey_new(
+            [
+                'private_key_bits' => 2048,
+                'private_key_type' => OPENSSL_KEYTYPE_RSA,
+            ]
+        );
+        openssl_pkey_export_to_file($pk, self::PRIVATE_KEY_FILE);
+
+        $this->Mail->DKIM_domain = 'example.com';
+        $this->Mail->DKIM_private = self::PRIVATE_KEY_FILE;
+        $this->Mail->DKIM_selector = 'phpmailer';
+        $this->Mail->DKIM_passphrase = ''; //key is not encrypted
+        self::assertTrue($this->Mail->send(), 'DKIM signed mail failed');
+
+        $this->Mail->isMail();
+        self::assertTrue($this->Mail->send(), 'DKIM signed mail via mail() failed');
+    }
+
+    /**
+     * Verify behaviour of the DKIM_Sign method when Open SSL is not available and exceptions is enabled.
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::DKIM_Sign
+     */
+    public function testDKIMSignOpenSSLNotAvailableException()
+    {
+        if (extension_loaded('openssl')) {
+            self::markTestSkipped('Test requires OpenSSL *not* to be available');
+        }
+
+        $this->expectException(Exception::class);
+        $this->expectExceptionMessage('Extension missing: openssl');
+
+        $this->Mail->DKIM_Sign('foo');
+    }
+}

package/src/api/vendor/phpmailer/phpmailer/test/PHPMailer/DKIMWithoutExceptionsTest.php

@@ -0,0 +1,46 @@
+<?php
+
+/**
+ * PHPMailer - PHP email transport unit tests.
+ * PHP version 5.5.
+ *
+ * @author    Marcus Bointon <phpmailer@synchromedia.co.uk>
+ * @author    Andy Prevost
+ * @copyright 2012 - 2020 Marcus Bointon
+ * @copyright 2004 - 2009 Andy Prevost
+ * @license   https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU Lesser General Public License
+ */
+
+namespace PHPMailer\Test\PHPMailer;
+
+use PHPMailer\Test\TestCase;
+
+/**
+ * Test DKIM signing functionality.
+ *
+ * @group dkim
+ */
+final class DKIMWithoutExceptionsTest extends TestCase
+{
+    /**
+     * Whether or not to initialize the PHPMailer object to throw exceptions.
+     *
+     * @var bool|null
+     */
+    const USE_EXCEPTIONS = false;
+
+    /**
+     * Verify behaviour of the DKIM_Sign method when Open SSL is not available and exceptions is disabled.
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::DKIM_Sign
+     */
+    public function testDKIMSignOpenSSLNotAvailable()
+    {
+        if (extension_loaded('openssl')) {
+            self::markTestSkipped('Test requires OpenSSL *not* to be available');
+        }
+
+        $signature = $this->Mail->DKIM_Sign('foo');
+        self::assertSame('', $signature);
+    }
+}