Initial commit

.drone.yml

@@ -0,0 +1,18 @@
+kind: pipeline
+type: docker
+name: test
+
+steps:
+  - name: composer
+    image: composer:latest
+    commands:
+      - composer install
+
+  - name: test
+    image: registry.i15.nl/i15/fuzephp:8.1-alpine
+    commands:
+      - docker-php-ext-enable xdebug
+      - vendor/bin/phpunit -c test/phpunit.xml
+
+image_pull_secrets:
+  - dockerconfig

.gitattributes

@@ -0,0 +1,4 @@
+.gitattributes export-ignore
+.gitignore export-ignore
+.drone.yml export-ignore
+test/ export-ignore

.gitignore

@@ -0,0 +1,7 @@
+composer.lock
+composer.phar
+.idea/
+build/
+test/temp/
+vendor/
+test/.phpunit.result.cache

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2013-2023 i15
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

PHPMailerWrapper.php

@@ -0,0 +1,92 @@
+<?php
+/**
+ * FuzeWorks PHPMailer Wrapper
+ *
+ * The FuzeWorks PHP FrameWork
+ *
+ * Copyright (C) 2013-${YEAR} i15
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * @author    i15
+ * @copyright Copyright (c) 2013 - ${YEAR}, i15. (http://i15.nl)
+ * @license   https://opensource.org/licenses/MIT MIT License
+ *
+ * @link  https://i15.nl
+ * @since Version 1.3.0
+ *
+ * @version Version 1.3.0
+ */
+
+namespace FuzeWorks\Mailer;
+use FuzeWorks\Config;
+use FuzeWorks\Factory;
+use FuzeWorks\iLibrary;
+use FuzeWorks\Priority;
+use PHPMailer\PHPMailer\PHPMailer;
+
+class PHPMailerWrapper extends PHPMailer implements iLibrary
+{
+
+    public function __construct()
+    {
+        parent::__construct(true);
+
+        // Load the basic requirements for every request
+        /** @var Config $config */
+        $config = Factory::getInstance('config');
+        $libraryPath = dirname(__FILE__);
+        $config->addComponentPath($libraryPath, Priority::LOWEST);
+
+        // Load config and apply to PHPMailer
+        $mailerCfg = $config->get("mailer");
+        foreach ($mailerCfg->toArray() as $key => $val)
+        {
+            if (str_contains($key, '()'))
+            {
+                $key = str_replace('()', '', $key);
+                if (is_array($val))
+                    $this->{$key}(...$val);
+                elseif (empty($val))
+                    $this->{$key}();
+                else
+                    $this->{$key}($val);
+            }
+            else
+                $this->{$key} = $val;
+        }
+
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getClassesPrefix(): ?string
+    {
+        return null;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getSourceDirectory(): ?string
+    {
+        return null;
+    }
+}

composer.json

@@ -0,0 +1,37 @@
+{
+  "name": "fuzeworks/mailer-wrapper",
+  "license": ["MIT"],
+  "authors": [
+    {
+      "name": "Abel Hoogeveen",
+      "homepage": "https://i15.nl"
+    }
+  ],
+  "require": {
+    "php": ">=8.1.0",
+    "fuzeworks/core": "~1.3.0",
+    "phpmailer/phpmailer": "~6.7",
+    "ext-ctype": "*",
+    "ext-filter": "*",
+    "ext-hash": "*"
+  },
+  "require-dev": {
+    "phpunit/phpunit": "^9",
+    "fuzeworks/tracycomponent": "~1.3.0"
+  },
+  "suggest": {
+    "ext-mbstring": "Needed to send email in multibyte encoding charset or decode encoded addresses",
+    "ext-openssl": "Needed for secure SMTP sending and DKIM signing",
+    "greew/oauth2-azure-provider": "Needed for Microsoft Azure XOAUTH2 authentication",
+    "hayageek/oauth2-yahoo": "Needed for Yahoo XOAUTH2 authentication",
+    "league/oauth2-google": "Needed for Google XOAUTH2 authentication",
+    "psr/log": "For optional PSR-3 debug logging",
+    "thenetworg/oauth2-azure": "Needed for Microsoft XOAUTH2 authentication",
+    "symfony/polyfill-mbstring": "To support UTF-8 if the Mbstring PHP extension is not enabled (^1.2)"
+  },
+  "autoload": {
+    "psr-4": {
+      "FuzeWorks\\Mailer\\": ""
+    }
+  }
+}

config.mailer.php

@@ -0,0 +1,48 @@
+<?php
+/**
+ * FuzeWorks PHPMailer Wrapper
+ *
+ * The FuzeWorks PHP FrameWork
+ *
+ * Copyright (C) 2013-${YEAR} i15
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * @author    i15
+ * @copyright Copyright (c) 2013 - ${YEAR}, i15. (http://i15.nl)
+ * @license   https://opensource.org/licenses/MIT MIT License
+ *
+ * @link  https://i15.nl
+ * @since Version 1.3.0
+ *
+ * @version Version 1.3.0
+ */
+
+return [
+    'isSMTP()' => '',
+    'Host' => '',
+    'SMTPAuth' => false,
+    'Username' => '',
+    'Password' => '',
+    'SMTPSecure' => '',
+    'Port' => 25,
+
+    'setFrom()' => ['noreply@example.com', 'From name']
+
+];

test/base/WrapperTest.php

@@ -0,0 +1,55 @@
+<?php
+/**
+ * FuzeWorks PHPMailer Wrapper
+ *
+ * The FuzeWorks PHP FrameWork
+ *
+ * Copyright (C) 2013-2022 i15
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * @author    i15
+ * @copyright Copyright (c) 2013 - 2022, i15. (http://i15.nl)
+ * @license   https://opensource.org/licenses/MIT MIT License
+ *
+ * @link  https://i15.nl
+ * @since Version 1.3.0
+ *
+ * @version Version 1.3.0
+ */
+
+use FuzeWorks\Mailer\PHPMailerWrapper;
+use PHPUnit\Framework\TestCase;
+
+class WrapperTest extends TestCase
+{
+
+    private PHPMailerWrapper $wrapper;
+
+    public function setUp(): void
+    {
+        parent::setUp();
+        $this->wrapper = \FuzeWorks\Factory::getInstance('libraries')->get('mailer');
+    }
+
+    public function testFoundation()
+    {
+        $this->assertInstanceOf(PHPMailerWrapper::class, $this->wrapper);
+    }
+}

test/bootstrap.php

@@ -0,0 +1,56 @@
+<?php
+/**
+ * FuzeWorks PHPMailer Wrapper
+ *
+ * The FuzeWorks PHP FrameWork
+ *
+ * Copyright (C) 2013-${YEAR} i15
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * @author    i15
+ * @copyright Copyright (c) 2013 - ${YEAR}, i15. (http://i15.nl)
+ * @license   https://opensource.org/licenses/MIT MIT License
+ *
+ * @link  https://i15.nl
+ * @since Version 1.3.0
+ *
+ * @version Version 1.3.0
+ */
+
+require_once(dirname(__DIR__) . '/vendor/autoload.php');
+
+use FuzeWorks\Configurator;
+use FuzeWorks\Mailer\PHPMailerWrapper;
+
+$configurator = new Configurator();
+
+// Set directories
+$configurator->setTempDirectory(__DIR__ . '/temp');
+$configurator->setLogDirectory(__DIR__ . '/temp');
+
+// Other values
+$configurator->setTimeZone('Europe/Amsterdam');
+
+// Build the container
+$container = $configurator->createContainer();
+
+// And add the library
+$container->libraries->addLibraryClass("mailer", PHPMailerWrapper::class);
+return $container;

test/phpunit.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd" bootstrap="bootstrap.php" convertErrorsToExceptions="true" convertNoticesToExceptions="true" convertWarningsToExceptions="true" stopOnError="false" stopOnFailure="false" stopOnIncomplete="false" stopOnSkipped="false" colors="false">
+    <coverage processUncoveredFiles="false">
+        <include>
+            <directory suffix=".php">../</directory>
+        </include>
+        <exclude>
+            <directory suffix=".php">../vendor/</directory>
+            <directory suffix=".php">../test/</directory>
+        </exclude>
+    </coverage>
+    <testsuites>
+        <testsuite name="Mailer Suite">
+            <directory>./</directory>
+        </testsuite>
+    </testsuites>
+</phpunit>

test/temp/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore