create-berna-stencil 1.0.8 → 1.0.10

package/src/api/vendor/phpmailer/phpmailer/test/POP3/PopBeforeSmtpTest.php

@@ -0,0 +1,139 @@
+<?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\POP3;
+
+use PHPMailer\PHPMailer\POP3;
+use Yoast\PHPUnitPolyfills\TestCases\TestCase;
+
+/**
+ * Test Pop before Smtp functionality.
+ *
+ * @group pop3
+ *
+ * @covers PHPMailer\PHPMailer\POP3
+ */
+final class PopBeforeSmtpTest extends TestCase
+{
+    /**
+     * PIDs of any processes we need to kill.
+     *
+     * @var array
+     */
+    protected $pids = [];
+
+    /**
+     * Run before each test class.
+     */
+    public static function set_up_before_class()
+    {
+        if (defined('PHPMAILER_INCLUDE_DIR') === false) {
+            /*
+             * Set up default include path.
+             * Default to the dir above the test dir, i.e. the project home dir.
+             */
+            define('PHPMAILER_INCLUDE_DIR', dirname(dirname(__DIR__)));
+        }
+    }
+
+    /**
+     * Run before each test is started.
+     */
+    protected function set_up()
+    {
+        if (DIRECTORY_SEPARATOR === '\\') {
+            self::markTestSkipped('This test needs a non-Windows OS to run');
+        }
+
+        // Chdir to test directory as runfakepopserver.sh runs fakepopserver.sh
+        // from its working directory.
+        chdir(PHPMAILER_INCLUDE_DIR . "/test");
+    }
+
+    /**
+     * Run after each test is completed.
+     */
+    protected function tear_down()
+    {
+        foreach ($this->pids as $pid) {
+            $p = escapeshellarg($pid);
+            shell_exec("ps $p && kill -TERM $p");
+        }
+    }
+
+    /**
+     * Use a fake POP3 server to test POP-before-SMTP auth with a known-good login.
+     */
+    public function testPopBeforeSmtpGood()
+    {
+        // Start a fake POP server.
+        $pid = shell_exec(
+            '/usr/bin/nohup ' .
+            \PHPMAILER_INCLUDE_DIR .
+            '/test/runfakepopserver.sh 1100 >/dev/null 2>/dev/null & printf "%u" $!'
+        );
+        $this->pids[] = $pid;
+
+        sleep(1);
+
+        // Test a known-good login.
+        self::assertTrue(
+            POP3::popBeforeSmtp('localhost', 1100, 10, 'user', 'test'),
+            'POP before SMTP failed'
+        );
+
+        // Kill the fake server, don't care if it fails.
+        @shell_exec('kill -TERM ' . escapeshellarg($pid));
+        sleep(2);
+    }
+
+    /**
+     * Use a fake POP3 server to test POP-before-SMTP auth
+     * with a known-bad login.
+     */
+    public function testPopBeforeSmtpBad()
+    {
+        // Start a fake POP server on a different port,
+        // so we don't inadvertently connect to the previous instance.
+        $pid = shell_exec(
+            '/usr/bin/nohup ' .
+            \PHPMAILER_INCLUDE_DIR .
+            '/test/runfakepopserver.sh 1101 >/dev/null 2>/dev/null & printf "%u" $!'
+        );
+        $this->pids[] = $pid;
+
+        sleep(2);
+
+        // Test a known-bad login.
+        self::assertFalse(
+            POP3::popBeforeSmtp('localhost', 1101, 10, 'user', 'xxx'),
+            'POP before SMTP should have failed'
+        );
+
+        // Kill the fake server, don't care if it fails.
+        @shell_exec('kill -TERM ' . escapeshellarg($pid));
+        sleep(2);
+    }
+
+    /**
+     * Test case when POP3 server is unreachable.
+     */
+    public function testPopBeforeSmtpUnreachable()
+    {
+        // There is no POP3 server at all. Port is different again.
+        self::assertFalse(
+            POP3::popBeforeSmtp('localhost', 1102, 10, 'user', 'xxx'),
+            'POP before SMTP should have failed'
+        );
+    }
+}

package/src/api/vendor/phpmailer/phpmailer/test/PreSendTestCase.php

@@ -0,0 +1,46 @@
+<?php
+
+/**
+ * PHPMailer - Base test class.
+ * 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;
+
+use PHPMailer\PHPMailer\SMTP;
+use PHPMailer\Test\TestCase;
+
+/**
+ * PHPMailer - Test class for tests which need the `PHPMailer::preSend()` method to be called.
+ */
+abstract class PreSendTestCase extends TestCase
+{
+    /**
+     * Property names and their values for the test instance of the PHPMailer class.
+     *
+     * These properties will be set in the `set_up()` method.
+     *
+     * This property can be enhanced/overloaded in concrete test classes to change the presets
+     * or add additional properties.
+     *
+     * @var array
+     */
+    protected $propertyChanges = [
+        // Generic changes.
+        'SMTPDebug'   => SMTP::DEBUG_CONNECTION, // Full debug output.
+        'Debugoutput' => ['PHPMailer\Test\DebugLogTestListener', 'debugLog'],
+
+        // Minimal set of properties which are needed for the preSend() command to succeed.
+        'From'        => 'unit_test@phpmailer.example.com',
+        'to'          => [
+            'address' => 'somebody@example.com',
+            'name'    => 'Test User',
+        ],
+    ];
+}

package/src/api/vendor/phpmailer/phpmailer/test/Security/DenialOfServiceVectorsTest.php

@@ -0,0 +1,52 @@
+<?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\Security;
+
+use PHPMailer\Test\SendTestCase;
+
+/**
+ * Test denial of service attack vectors, which have been mitigated.
+ *
+ * @coversNothing
+ */
+final class DenialOfServiceVectorsTest extends SendTestCase
+{
+    /**
+     * Test this denial of service attack.
+     */
+    public function testDenialOfServiceAttack1()
+    {
+        $this->Mail->Body = 'This should no longer cause a denial of service.';
+        $this->buildBody();
+
+        $this->Mail->Subject = substr(str_repeat('0123456789', 100), 0, 998);
+        self::assertTrue($this->Mail->send(), $this->Mail->ErrorInfo);
+    }
+
+    /**
+     * Tests this denial of service attack.
+     *
+     * According to the ticket, this should get stuck in a loop, though I can't make it happen.
+     * @link https://sourceforge.net/p/phpmailer/bugs/383/
+     *
+     * @doesNotPerformAssertions
+     */
+    public function testDenialOfServiceAttack2()
+    {
+        // Encoding name longer than 68 chars.
+        $this->Mail->Encoding = '1234567890123456789012345678901234567890123456789012345678901234567890';
+        // Call wrapText with a zero length value.
+        $this->Mail->wrapText(str_repeat('This should no longer cause a denial of service. ', 30), 0);
+    }
+}

package/src/api/vendor/phpmailer/phpmailer/test/SendTestCase.php

@@ -0,0 +1,126 @@
+<?php
+
+/**
+ * PHPMailer - Base test class.
+ * 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;
+
+use Exception;
+
+/**
+ * PHPMailer - Test class for tests which need the `PHPMailer::send()` method to be called.
+ */
+abstract class SendTestCase extends PreSendTestCase
+{
+    /**
+     * Translation map for supported $REQUEST keys to the property name in the PHPMailer class.
+     *
+     * @var array
+     */
+    private $requestKeys = [
+        'mail_from'     => 'From',
+        'mail_host'     => 'Host',
+        'mail_port'     => 'Port',
+        'mail_useauth'  => 'SMTPAuth',
+        'mail_username' => 'Username',
+        'mail_userpass' => 'Password',
+        'mail_to'       => 'to',
+        'mail_cc'       => 'cc',
+        'mail_bcc'      => 'bcc',
+    ];
+
+    /**
+     * Run before each test is started.
+     */
+    protected function set_up()
+    {
+        /*
+         * Make sure the testbootstrap.php file is available.
+         * Pretty much everything will fail due to unset recipient if this is not done, so error
+         * the tests out before they run if the file does not exist.
+         */
+        if (file_exists(\PHPMAILER_INCLUDE_DIR . '/test/testbootstrap.php') === false) {
+            throw new Exception(
+                'Test config params missing - copy testbootstrap-dist.php to testbootstrap.php and change'
+                . ' as appropriate for your own test environment setup.'
+            );
+        }
+
+        include \PHPMAILER_INCLUDE_DIR . '/test/testbootstrap.php'; // Overrides go in here.
+
+        /*
+         * Process the $REQUEST values and add them to the list of properties
+         * to change at class initialization.
+         */
+        foreach ($this->requestKeys as $requestKey => $phpmailerKey) {
+            if (array_key_exists($requestKey, $_REQUEST) === false) {
+                continue;
+            }
+
+            switch ($requestKey) {
+                case 'mail_to':
+                    $this->propertyChanges[$phpmailerKey] = [
+                        'address' => $_REQUEST[$requestKey],
+                        'name'    => 'Test User',
+                    ];
+                    break;
+
+                case 'mail_cc':
+                    $this->propertyChanges[$phpmailerKey] = [
+                        'address' => $_REQUEST[$requestKey],
+                        'name'    => 'Carbon User',
+                    ];
+                    break;
+
+                case 'mail_bcc':
+                    $this->propertyChanges[$phpmailerKey] = [
+                        'address' => $_REQUEST[$requestKey],
+                        'name'    => 'Blind Carbon User',
+                    ];
+                    break;
+
+                default:
+                    $this->propertyChanges[$phpmailerKey] = $_REQUEST[$requestKey];
+                    break;
+            }
+        }
+
+        // Initialize the PHPMailer class.
+        parent::set_up();
+    }
+}
+/*
+ * This is a sample form for setting appropriate test values through a browser
+ * These values can also be set using a file called testbootstrap.php (not in repo) in the same folder as this script
+ * which is probably more useful if you run these tests a lot
+ * <html>
+ * <body>
+ * <h3>PHPMailer Unit Test</h3>
+ * By entering a SMTP hostname it will automatically perform tests with SMTP.
+ *
+ * <form name="phpmailer_unit" action=__FILE__ method="get">
+ * <input type="hidden" name="submitted" value="1"/>
+ * From Address: <input type="text" size="50" name="mail_from" value="<?php echo get("mail_from"); ?>"/>
+ * <br/>
+ * To Address: <input type="text" size="50" name="mail_to" value="<?php echo get("mail_to"); ?>"/>
+ * <br/>
+ * Cc Address: <input type="text" size="50" name="mail_cc" value="<?php echo get("mail_cc"); ?>"/>
+ * <br/>
+ * Bcc Address: <input type="text" size="50" name="mail_bcc" value="<?php echo get("mail_bcc"); ?>"/>
+ * <br/>
+ * SMTP Hostname: <input type="text" size="50" name="mail_host" value="<?php echo get("mail_host"); ?>"/>
+ * <p/>
+ * <input type="submit" value="Run Test"/>
+ *
+ * </form>
+ * </body>
+ * </html>
+ */