$options
+ */
+ public function request(string $url, array $options): Request
+ {
+ $options['curlHandle'] = $this->getCurlHandle();
+
+ return new CurlRequest($url, $options);
+ }
+}
diff --git a/tools/htmlpurifier/HTMLPurifier.autoload-legacy.php b/tools/htmlpurifier/HTMLPurifier.autoload-legacy.php
index c271cd158..0a17ee4ad 100644
--- a/tools/htmlpurifier/HTMLPurifier.autoload-legacy.php
+++ b/tools/htmlpurifier/HTMLPurifier.autoload-legacy.php
@@ -4,12 +4,11 @@
* @file
* Legacy autoloader for systems lacking spl_autoload_register
*
- * Must be separate to prevent deprecation warning on PHP 7.2
*/
-function __autoload($class)
+spl_autoload_register(function($class)
{
- return HTMLPurifier_Bootstrap::autoload($class);
-}
+ return HTMLPurifier_Bootstrap::autoload($class);
+});
// vim: et sw=4 sts=4
diff --git a/tools/htmlpurifier/HTMLPurifier.autoload.php b/tools/htmlpurifier/HTMLPurifier.autoload.php
index 9d8d29926..7a691132f 100644
--- a/tools/htmlpurifier/HTMLPurifier.autoload.php
+++ b/tools/htmlpurifier/HTMLPurifier.autoload.php
@@ -17,6 +17,7 @@ if (function_exists('spl_autoload_register') && function_exists('spl_autoload_un
require dirname(__FILE__) . '/HTMLPurifier.autoload-legacy.php';
}
+// phpcs:ignore PHPCompatibility.IniDirectives.RemovedIniDirectives.zend_ze1_compatibility_modeRemoved
if (ini_get('zend.ze1_compatibility_mode')) {
trigger_error("HTML Purifier is not compatible with zend.ze1_compatibility_mode; please turn it off", E_USER_ERROR);
}
diff --git a/tools/htmlpurifier/HTMLPurifier.includes.php b/tools/htmlpurifier/HTMLPurifier.includes.php
index 151e6752d..4c713a33a 100644
--- a/tools/htmlpurifier/HTMLPurifier.includes.php
+++ b/tools/htmlpurifier/HTMLPurifier.includes.php
@@ -7,7 +7,7 @@
* primary concern and you are using an opcode cache. PLEASE DO NOT EDIT THIS
* FILE, changes will be overwritten the next time the script is run.
*
- * @version 4.13.0
+ * @version 4.18.0
*
* @warning
* You must *not* include any other HTML Purifier files before this file,
@@ -101,12 +101,14 @@ require 'HTMLPurifier/AttrDef/CSS/Length.php';
require 'HTMLPurifier/AttrDef/CSS/ListStyle.php';
require 'HTMLPurifier/AttrDef/CSS/Multiple.php';
require 'HTMLPurifier/AttrDef/CSS/Percentage.php';
+require 'HTMLPurifier/AttrDef/CSS/Ratio.php';
require 'HTMLPurifier/AttrDef/CSS/TextDecoration.php';
require 'HTMLPurifier/AttrDef/CSS/URI.php';
require 'HTMLPurifier/AttrDef/HTML/Bool.php';
require 'HTMLPurifier/AttrDef/HTML/Nmtokens.php';
require 'HTMLPurifier/AttrDef/HTML/Class.php';
require 'HTMLPurifier/AttrDef/HTML/Color.php';
+require 'HTMLPurifier/AttrDef/HTML/ContentEditable.php';
require 'HTMLPurifier/AttrDef/HTML/FrameTarget.php';
require 'HTMLPurifier/AttrDef/HTML/ID.php';
require 'HTMLPurifier/AttrDef/HTML/Pixels.php';
diff --git a/tools/htmlpurifier/HTMLPurifier.php b/tools/htmlpurifier/HTMLPurifier.php
index 3c0f8a0ec..e3bca8a22 100644
--- a/tools/htmlpurifier/HTMLPurifier.php
+++ b/tools/htmlpurifier/HTMLPurifier.php
@@ -19,7 +19,7 @@
*/
/*
- HTML Purifier 4.13.0 - Standards Compliant HTML Filtering
+ HTML Purifier 4.18.0 - Standards Compliant HTML Filtering
Copyright (C) 2006-2008 Edward Z. Yang
This library is free software; you can redistribute it and/or
@@ -58,12 +58,12 @@ class HTMLPurifier
* Version of HTML Purifier.
* @type string
*/
- public $version = '4.13.0';
+ public $version = '4.18.0';
/**
* Constant with version of HTML Purifier.
*/
- const VERSION = '4.13.0';
+ const VERSION = '4.18.0';
/**
* Global configuration object.
diff --git a/tools/htmlpurifier/HTMLPurifier.safe-includes.php b/tools/htmlpurifier/HTMLPurifier.safe-includes.php
index a3261f8a3..8a417d246 100644
--- a/tools/htmlpurifier/HTMLPurifier.safe-includes.php
+++ b/tools/htmlpurifier/HTMLPurifier.safe-includes.php
@@ -95,12 +95,14 @@ require_once $__dir . '/HTMLPurifier/AttrDef/CSS/Length.php';
require_once $__dir . '/HTMLPurifier/AttrDef/CSS/ListStyle.php';
require_once $__dir . '/HTMLPurifier/AttrDef/CSS/Multiple.php';
require_once $__dir . '/HTMLPurifier/AttrDef/CSS/Percentage.php';
+require_once $__dir . '/HTMLPurifier/AttrDef/CSS/Ratio.php';
require_once $__dir . '/HTMLPurifier/AttrDef/CSS/TextDecoration.php';
require_once $__dir . '/HTMLPurifier/AttrDef/CSS/URI.php';
require_once $__dir . '/HTMLPurifier/AttrDef/HTML/Bool.php';
require_once $__dir . '/HTMLPurifier/AttrDef/HTML/Nmtokens.php';
require_once $__dir . '/HTMLPurifier/AttrDef/HTML/Class.php';
require_once $__dir . '/HTMLPurifier/AttrDef/HTML/Color.php';
+require_once $__dir . '/HTMLPurifier/AttrDef/HTML/ContentEditable.php';
require_once $__dir . '/HTMLPurifier/AttrDef/HTML/FrameTarget.php';
require_once $__dir . '/HTMLPurifier/AttrDef/HTML/ID.php';
require_once $__dir . '/HTMLPurifier/AttrDef/HTML/Pixels.php';
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS.php b/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS.php
index ad2cb90ad..af6b8a05d 100644
--- a/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS.php
+++ b/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS.php
@@ -27,6 +27,13 @@ class HTMLPurifier_AttrDef_CSS extends HTMLPurifier_AttrDef
$definition = $config->getCSSDefinition();
$allow_duplicates = $config->get("CSS.AllowDuplicates");
+ $universal_attrdef = new HTMLPurifier_AttrDef_Enum(
+ array(
+ 'initial',
+ 'inherit',
+ 'unset',
+ )
+ );
// According to the CSS2.1 spec, the places where a
// non-delimiting semicolon can appear are in strings
@@ -96,16 +103,13 @@ class HTMLPurifier_AttrDef_CSS extends HTMLPurifier_AttrDef
if (!$ok) {
continue;
}
- // inefficient call, since the validator will do this again
- if (strtolower(trim($value)) !== 'inherit') {
- // inherit works for everything (but only on the base property)
+ $result = $universal_attrdef->validate($value, $config, $context);
+ if ($result === false) {
$result = $definition->info[$property]->validate(
$value,
$config,
$context
);
- } else {
- $result = 'inherit';
}
if ($result === false) {
continue;
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS/Background.php b/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS/Background.php
index 7f1ea3b0f..28c49883a 100644
--- a/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS/Background.php
+++ b/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS/Background.php
@@ -25,6 +25,7 @@ class HTMLPurifier_AttrDef_CSS_Background extends HTMLPurifier_AttrDef
$this->info['background-repeat'] = $def->info['background-repeat'];
$this->info['background-attachment'] = $def->info['background-attachment'];
$this->info['background-position'] = $def->info['background-position'];
+ $this->info['background-size'] = $def->info['background-size'];
}
/**
@@ -53,6 +54,7 @@ class HTMLPurifier_AttrDef_CSS_Background extends HTMLPurifier_AttrDef
$caught['repeat'] = false;
$caught['attachment'] = false;
$caught['position'] = false;
+ $caught['size'] = false;
$i = 0; // number of catches
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS/FontFamily.php b/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS/FontFamily.php
index 74e24c881..f1ff11636 100644
--- a/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS/FontFamily.php
+++ b/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS/FontFamily.php
@@ -10,23 +10,21 @@ class HTMLPurifier_AttrDef_CSS_FontFamily extends HTMLPurifier_AttrDef
public function __construct()
{
- $this->mask = '_- ';
- for ($c = 'a'; $c <= 'z'; $c++) {
- $this->mask .= $c;
- }
- for ($c = 'A'; $c <= 'Z'; $c++) {
- $this->mask .= $c;
- }
- for ($c = '0'; $c <= '9'; $c++) {
- $this->mask .= $c;
- } // cast-y, but should be fine
- // special bytes used by UTF-8
- for ($i = 0x80; $i <= 0xFF; $i++) {
- // We don't bother excluding invalid bytes in this range,
- // because the our restriction of well-formed UTF-8 will
- // prevent these from ever occurring.
- $this->mask .= chr($i);
- }
+ // Lowercase letters
+ $l = range('a', 'z');
+ // Uppercase letters
+ $u = range('A', 'Z');
+ // Digits
+ $d = range('0', '9');
+ // Special bytes used by UTF-8
+ $b = array_map('chr', range(0x80, 0xFF));
+ // All valid characters for the mask
+ $c = array_merge($l, $u, $d, $b);
+ // Concatenate all valid characters into a string
+ // Use '_- ' as an initial value
+ $this->mask = array_reduce($c, function ($carry, $value) {
+ return $carry . $value;
+ }, '_- ');
/*
PHP's internal strcspn implementation is
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS/Ratio.php b/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS/Ratio.php
new file mode 100644
index 000000000..e08e2c496
--- /dev/null
+++ b/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS/Ratio.php
@@ -0,0 +1,46 @@
+parseCDATA($ratio);
+
+ $parts = explode('/', $ratio, 2);
+ $length = count($parts);
+
+ if ($length < 1 || $length > 2) {
+ return false;
+ }
+
+ $num = new \HTMLPurifier_AttrDef_CSS_Number();
+
+ if ($length === 1) {
+ return $num->validate($parts[0], $config, $context);
+ }
+
+ $num1 = $num->validate($parts[0], $config, $context);
+ $num2 = $num->validate($parts[1], $config, $context);
+
+ if ($num1 === false || $num2 === false) {
+ return false;
+ }
+
+ return $num1 . '/' . $num2;
+ }
+}
+
+// vim: et sw=4 sts=4
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS/index.php b/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/AttrDef/CSS/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrDef/HTML/ContentEditable.php b/tools/htmlpurifier/HTMLPurifier/AttrDef/HTML/ContentEditable.php
new file mode 100644
index 000000000..5b03d3e37
--- /dev/null
+++ b/tools/htmlpurifier/HTMLPurifier/AttrDef/HTML/ContentEditable.php
@@ -0,0 +1,16 @@
+get('HTML.Trusted')) {
+ $allowed = array('', 'true', 'false');
+ }
+
+ $enum = new HTMLPurifier_AttrDef_Enum($allowed);
+
+ return $enum->validate($string, $config, $context);
+ }
+}
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrDef/HTML/index.php b/tools/htmlpurifier/HTMLPurifier/AttrDef/HTML/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/AttrDef/HTML/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrDef/URI/Host.php b/tools/htmlpurifier/HTMLPurifier/AttrDef/URI/Host.php
index 1beeaa5d2..17a97c1ec 100644
--- a/tools/htmlpurifier/HTMLPurifier/AttrDef/URI/Host.php
+++ b/tools/htmlpurifier/HTMLPurifier/AttrDef/URI/Host.php
@@ -63,24 +63,18 @@ class HTMLPurifier_AttrDef_URI_Host extends HTMLPurifier_AttrDef
// This doesn't match I18N domain names, but we don't have proper IRI support,
// so force users to insert Punycode.
- // There is not a good sense in which underscores should be
- // allowed, since it's technically not! (And if you go as
- // far to allow everything as specified by the DNS spec...
- // well, that's literally everything, modulo some space limits
- // for the components and the overall name (which, by the way,
- // we are NOT checking!). So we (arbitrarily) decide this:
- // let's allow underscores wherever we would have allowed
- // hyphens, if they are enabled. This is a pretty good match
- // for browser behavior, for example, a large number of browsers
- // cannot handle foo_.example.com, but foo_bar.example.com is
- // fairly well supported.
+ // Underscores defined as Unreserved Characters in RFC 3986 are
+ // allowed in a URI. There are cases where we want to consider a
+ // URI containing "_" such as "_dmarc.example.com".
+ // Underscores are not allowed in the default. If you want to
+ // allow it, set Core.AllowHostnameUnderscore to true.
$underscore = $config->get('Core.AllowHostnameUnderscore') ? '_' : '';
// Based off of RFC 1738, but amended so that
// as per RFC 3696, the top label need only not be all numeric.
// The productions describing this are:
$a = '[a-z]'; // alpha
- $an = '[a-z0-9]'; // alphanum
+ $an = "[a-z0-9$underscore]"; // alphanum
$and = "[a-z0-9-$underscore]"; // alphanum | "-"
// domainlabel = alphanum | alphanum *( alphanum | "-" ) alphanum
$domainlabel = "$an(?:$and*$an)?";
@@ -106,7 +100,7 @@ class HTMLPurifier_AttrDef_URI_Host extends HTMLPurifier_AttrDef
// If we have Net_IDNA2 support, we can support IRIs by
// punycoding them. (This is the most portable thing to do,
// since otherwise we have to assume browsers support
- } elseif ($config->get('Core.EnableIDNA')) {
+ } elseif ($config->get('Core.EnableIDNA') && class_exists('Net_IDNA2')) {
$idna = new Net_IDNA2(array('encoding' => 'utf8', 'overlong' => false, 'strict' => true));
// we need to encode each period separately
$parts = explode('.', $string);
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrDef/URI/index.php b/tools/htmlpurifier/HTMLPurifier/AttrDef/URI/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/AttrDef/URI/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrDef/index.php b/tools/htmlpurifier/HTMLPurifier/AttrDef/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/AttrDef/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrTransform/NameSync.php b/tools/htmlpurifier/HTMLPurifier/AttrTransform/NameSync.php
index 36079b786..5a1fdbbfc 100644
--- a/tools/htmlpurifier/HTMLPurifier/AttrTransform/NameSync.php
+++ b/tools/htmlpurifier/HTMLPurifier/AttrTransform/NameSync.php
@@ -8,6 +8,11 @@
class HTMLPurifier_AttrTransform_NameSync extends HTMLPurifier_AttrTransform
{
+ /**
+ * @type HTMLPurifier_AttrDef_HTML_ID
+ */
+ public $idDef;
+
public function __construct()
{
$this->idDef = new HTMLPurifier_AttrDef_HTML_ID();
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrTransform/SafeParam.php b/tools/htmlpurifier/HTMLPurifier/AttrTransform/SafeParam.php
index 1143b4b49..1033106b3 100644
--- a/tools/htmlpurifier/HTMLPurifier/AttrTransform/SafeParam.php
+++ b/tools/htmlpurifier/HTMLPurifier/AttrTransform/SafeParam.php
@@ -24,6 +24,11 @@ class HTMLPurifier_AttrTransform_SafeParam extends HTMLPurifier_AttrTransform
*/
private $uri;
+ /**
+ * @type HTMLPurifier_AttrDef_Enum
+ */
+ public $wmode;
+
public function __construct()
{
$this->uri = new HTMLPurifier_AttrDef_URI(true); // embedded
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrTransform/TargetBlank.php b/tools/htmlpurifier/HTMLPurifier/AttrTransform/TargetBlank.php
index dd63ea89c..cc30ab8c3 100644
--- a/tools/htmlpurifier/HTMLPurifier/AttrTransform/TargetBlank.php
+++ b/tools/htmlpurifier/HTMLPurifier/AttrTransform/TargetBlank.php
@@ -33,7 +33,11 @@ class HTMLPurifier_AttrTransform_TargetBlank extends HTMLPurifier_AttrTransform
// XXX Kind of inefficient
$url = $this->parser->parse($attr['href']);
- $scheme = $url->getSchemeObj($config, $context);
+
+ // Ignore invalid schemes (e.g. `javascript:`)
+ if (!($scheme = $url->getSchemeObj($config, $context))) {
+ return $attr;
+ }
if ($scheme->browsable && !$url->isBenign($config, $context)) {
$attr['target'] = '_blank';
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrTransform/index.php b/tools/htmlpurifier/HTMLPurifier/AttrTransform/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/AttrTransform/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/AttrTypes.php b/tools/htmlpurifier/HTMLPurifier/AttrTypes.php
index 3b70520b6..e4429e86d 100644
--- a/tools/htmlpurifier/HTMLPurifier/AttrTypes.php
+++ b/tools/htmlpurifier/HTMLPurifier/AttrTypes.php
@@ -41,6 +41,7 @@ class HTMLPurifier_AttrTypes
$this->info['IAlign'] = self::makeEnum('top,middle,bottom,left,right');
$this->info['LAlign'] = self::makeEnum('top,bottom,left,right');
$this->info['FrameTarget'] = new HTMLPurifier_AttrDef_HTML_FrameTarget();
+ $this->info['ContentEditable'] = new HTMLPurifier_AttrDef_HTML_ContentEditable();
// unimplemented aliases
$this->info['ContentType'] = new HTMLPurifier_AttrDef_Text();
diff --git a/tools/htmlpurifier/HTMLPurifier/Bootstrap.php b/tools/htmlpurifier/HTMLPurifier/Bootstrap.php
index 707122bb2..bd8f9984f 100644
--- a/tools/htmlpurifier/HTMLPurifier/Bootstrap.php
+++ b/tools/htmlpurifier/HTMLPurifier/Bootstrap.php
@@ -79,44 +79,11 @@ class HTMLPurifier_Bootstrap
public static function registerAutoload()
{
$autoload = array('HTMLPurifier_Bootstrap', 'autoload');
- if (($funcs = spl_autoload_functions()) === false) {
+ if (spl_autoload_functions() === false) {
spl_autoload_register($autoload);
- } elseif (function_exists('spl_autoload_unregister')) {
- if (version_compare(PHP_VERSION, '5.3.0', '>=')) {
- // prepend flag exists, no need for shenanigans
- spl_autoload_register($autoload, true, true);
- } else {
- $buggy = version_compare(PHP_VERSION, '5.2.11', '<');
- $compat = version_compare(PHP_VERSION, '5.1.2', '<=') &&
- version_compare(PHP_VERSION, '5.1.0', '>=');
- foreach ($funcs as $func) {
- if ($buggy && is_array($func)) {
- // :TRICKY: There are some compatibility issues and some
- // places where we need to error out
- $reflector = new ReflectionMethod($func[0], $func[1]);
- if (!$reflector->isStatic()) {
- throw new Exception(
- 'HTML Purifier autoloader registrar is not compatible
- with non-static object methods due to PHP Bug #44144;
- Please do not use HTMLPurifier.autoload.php (or any
- file that includes this file); instead, place the code:
- spl_autoload_register(array(\'HTMLPurifier_Bootstrap\', \'autoload\'))
- after your own autoloaders.'
- );
- }
- // Suprisingly, spl_autoload_register supports the
- // Class::staticMethod callback format, although call_user_func doesn't
- if ($compat) {
- $func = implode('::', $func);
- }
- }
- spl_autoload_unregister($func);
- }
- spl_autoload_register($autoload);
- foreach ($funcs as $func) {
- spl_autoload_register($func);
- }
- }
+ } else {
+ // prepend flag exists, no need for shenanigans
+ spl_autoload_register($autoload, true, true);
}
}
}
diff --git a/tools/htmlpurifier/HTMLPurifier/CSSDefinition.php b/tools/htmlpurifier/HTMLPurifier/CSSDefinition.php
index 21f1a5899..3732c076a 100644
--- a/tools/htmlpurifier/HTMLPurifier/CSSDefinition.php
+++ b/tools/htmlpurifier/HTMLPurifier/CSSDefinition.php
@@ -13,7 +13,7 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
* Assoc array of attribute name to definition object.
* @type HTMLPurifier_AttrDef[]
*/
- public $info = array();
+ public $info = [];
/**
* Constructs the info array. The meat of this class.
@@ -22,7 +22,7 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
protected function doSetup($config)
{
$this->info['text-align'] = new HTMLPurifier_AttrDef_Enum(
- array('left', 'right', 'center', 'justify'),
+ ['left', 'right', 'center', 'justify'],
false
);
@@ -31,7 +31,7 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
$this->info['border-right-style'] =
$this->info['border-left-style'] =
$this->info['border-top-style'] = new HTMLPurifier_AttrDef_Enum(
- array(
+ [
'none',
'hidden',
'dotted',
@@ -42,42 +42,42 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
'ridge',
'inset',
'outset'
- ),
+ ],
false
);
$this->info['border-style'] = new HTMLPurifier_AttrDef_CSS_Multiple($border_style);
$this->info['clear'] = new HTMLPurifier_AttrDef_Enum(
- array('none', 'left', 'right', 'both'),
+ ['none', 'left', 'right', 'both'],
false
);
$this->info['float'] = new HTMLPurifier_AttrDef_Enum(
- array('none', 'left', 'right'),
+ ['none', 'left', 'right'],
false
);
$this->info['font-style'] = new HTMLPurifier_AttrDef_Enum(
- array('normal', 'italic', 'oblique'),
+ ['normal', 'italic', 'oblique'],
false
);
$this->info['font-variant'] = new HTMLPurifier_AttrDef_Enum(
- array('normal', 'small-caps'),
+ ['normal', 'small-caps'],
false
);
$uri_or_none = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
- new HTMLPurifier_AttrDef_Enum(array('none')),
+ [
+ new HTMLPurifier_AttrDef_Enum(['none']),
new HTMLPurifier_AttrDef_CSS_URI()
- )
+ ]
);
$this->info['list-style-position'] = new HTMLPurifier_AttrDef_Enum(
- array('inside', 'outside'),
+ ['inside', 'outside'],
false
);
$this->info['list-style-type'] = new HTMLPurifier_AttrDef_Enum(
- array(
+ [
'disc',
'circle',
'square',
@@ -87,7 +87,7 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
'lower-alpha',
'upper-alpha',
'none'
- ),
+ ],
false
);
$this->info['list-style-image'] = $uri_or_none;
@@ -95,30 +95,44 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
$this->info['list-style'] = new HTMLPurifier_AttrDef_CSS_ListStyle($config);
$this->info['text-transform'] = new HTMLPurifier_AttrDef_Enum(
- array('capitalize', 'uppercase', 'lowercase', 'none'),
+ ['capitalize', 'uppercase', 'lowercase', 'none'],
false
);
$this->info['color'] = new HTMLPurifier_AttrDef_CSS_Color();
$this->info['background-image'] = $uri_or_none;
$this->info['background-repeat'] = new HTMLPurifier_AttrDef_Enum(
- array('repeat', 'repeat-x', 'repeat-y', 'no-repeat')
+ ['repeat', 'repeat-x', 'repeat-y', 'no-repeat']
);
$this->info['background-attachment'] = new HTMLPurifier_AttrDef_Enum(
- array('scroll', 'fixed')
+ ['scroll', 'fixed']
);
$this->info['background-position'] = new HTMLPurifier_AttrDef_CSS_BackgroundPosition();
+ $this->info['background-size'] = new HTMLPurifier_AttrDef_CSS_Composite(
+ [
+ new HTMLPurifier_AttrDef_Enum(
+ [
+ 'auto',
+ 'cover',
+ 'contain',
+ ]
+ ),
+ new HTMLPurifier_AttrDef_CSS_Percentage(),
+ new HTMLPurifier_AttrDef_CSS_Length()
+ ]
+ );
+
$border_color =
$this->info['border-top-color'] =
$this->info['border-bottom-color'] =
$this->info['border-left-color'] =
$this->info['border-right-color'] =
$this->info['background-color'] = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
- new HTMLPurifier_AttrDef_Enum(array('transparent')),
+ [
+ new HTMLPurifier_AttrDef_Enum(['transparent']),
new HTMLPurifier_AttrDef_CSS_Color()
- )
+ ]
);
$this->info['background'] = new HTMLPurifier_AttrDef_CSS_Background($config);
@@ -130,32 +144,32 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
$this->info['border-bottom-width'] =
$this->info['border-left-width'] =
$this->info['border-right-width'] = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
- new HTMLPurifier_AttrDef_Enum(array('thin', 'medium', 'thick')),
+ [
+ new HTMLPurifier_AttrDef_Enum(['thin', 'medium', 'thick']),
new HTMLPurifier_AttrDef_CSS_Length('0') //disallow negative
- )
+ ]
);
$this->info['border-width'] = new HTMLPurifier_AttrDef_CSS_Multiple($border_width);
$this->info['letter-spacing'] = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
- new HTMLPurifier_AttrDef_Enum(array('normal')),
+ [
+ new HTMLPurifier_AttrDef_Enum(['normal']),
new HTMLPurifier_AttrDef_CSS_Length()
- )
+ ]
);
$this->info['word-spacing'] = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
- new HTMLPurifier_AttrDef_Enum(array('normal')),
+ [
+ new HTMLPurifier_AttrDef_Enum(['normal']),
new HTMLPurifier_AttrDef_CSS_Length()
- )
+ ]
);
$this->info['font-size'] = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
+ [
new HTMLPurifier_AttrDef_Enum(
- array(
+ [
'xx-small',
'x-small',
'small',
@@ -165,20 +179,20 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
'xx-large',
'larger',
'smaller'
- )
+ ]
),
new HTMLPurifier_AttrDef_CSS_Percentage(),
new HTMLPurifier_AttrDef_CSS_Length()
- )
+ ]
);
$this->info['line-height'] = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
- new HTMLPurifier_AttrDef_Enum(array('normal')),
+ [
+ new HTMLPurifier_AttrDef_Enum(['normal']),
new HTMLPurifier_AttrDef_CSS_Number(true), // no negatives
new HTMLPurifier_AttrDef_CSS_Length('0'),
new HTMLPurifier_AttrDef_CSS_Percentage(true)
- )
+ ]
);
$margin =
@@ -186,11 +200,11 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
$this->info['margin-bottom'] =
$this->info['margin-left'] =
$this->info['margin-right'] = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
+ [
new HTMLPurifier_AttrDef_CSS_Length(),
new HTMLPurifier_AttrDef_CSS_Percentage(),
- new HTMLPurifier_AttrDef_Enum(array('auto'))
- )
+ new HTMLPurifier_AttrDef_Enum(['auto'])
+ ]
);
$this->info['margin'] = new HTMLPurifier_AttrDef_CSS_Multiple($margin);
@@ -201,41 +215,40 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
$this->info['padding-bottom'] =
$this->info['padding-left'] =
$this->info['padding-right'] = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
+ [
new HTMLPurifier_AttrDef_CSS_Length('0'),
new HTMLPurifier_AttrDef_CSS_Percentage(true)
- )
+ ]
);
$this->info['padding'] = new HTMLPurifier_AttrDef_CSS_Multiple($padding);
$this->info['text-indent'] = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
+ [
new HTMLPurifier_AttrDef_CSS_Length(),
new HTMLPurifier_AttrDef_CSS_Percentage()
- )
+ ]
);
$trusted_wh = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
+ [
new HTMLPurifier_AttrDef_CSS_Length('0'),
new HTMLPurifier_AttrDef_CSS_Percentage(true),
- new HTMLPurifier_AttrDef_Enum(array('auto', 'initial', 'inherit'))
- )
+ new HTMLPurifier_AttrDef_Enum(['auto'])
+ ]
);
$trusted_min_wh = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
+ [
new HTMLPurifier_AttrDef_CSS_Length('0'),
new HTMLPurifier_AttrDef_CSS_Percentage(true),
- new HTMLPurifier_AttrDef_Enum(array('initial', 'inherit'))
- )
+ ]
);
$trusted_max_wh = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
+ [
new HTMLPurifier_AttrDef_CSS_Length('0'),
new HTMLPurifier_AttrDef_CSS_Percentage(true),
- new HTMLPurifier_AttrDef_Enum(array('none', 'initial', 'inherit'))
- )
+ new HTMLPurifier_AttrDef_Enum(['none'])
+ ]
);
$max = $config->get('CSS.MaxImgLength');
@@ -247,10 +260,10 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
'img',
// For img tags:
new HTMLPurifier_AttrDef_CSS_Composite(
- array(
+ [
new HTMLPurifier_AttrDef_CSS_Length('0', $max),
- new HTMLPurifier_AttrDef_Enum(array('auto'))
- )
+ new HTMLPurifier_AttrDef_Enum(['auto'])
+ ]
),
// For everyone else:
$trusted_wh
@@ -262,12 +275,7 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
new HTMLPurifier_AttrDef_Switch(
'img',
// For img tags:
- new HTMLPurifier_AttrDef_CSS_Composite(
- array(
- new HTMLPurifier_AttrDef_CSS_Length('0', $max),
- new HTMLPurifier_AttrDef_Enum(array('initial', 'inherit'))
- )
- ),
+ new HTMLPurifier_AttrDef_CSS_Length('0', $max),
// For everyone else:
$trusted_min_wh
);
@@ -279,22 +287,46 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
'img',
// For img tags:
new HTMLPurifier_AttrDef_CSS_Composite(
- array(
+ [
new HTMLPurifier_AttrDef_CSS_Length('0', $max),
- new HTMLPurifier_AttrDef_Enum(array('none', 'initial', 'inherit'))
- )
+ new HTMLPurifier_AttrDef_Enum(['none'])
+ ]
),
// For everyone else:
$trusted_max_wh
);
+ $this->info['aspect-ratio'] = new HTMLPurifier_AttrDef_CSS_Multiple(
+ new HTMLPurifier_AttrDef_CSS_Composite([
+ new HTMLPurifier_AttrDef_CSS_Ratio(),
+ new HTMLPurifier_AttrDef_Enum(['auto']),
+ ])
+ );
+
+ // text-decoration and related shorthands
$this->info['text-decoration'] = new HTMLPurifier_AttrDef_CSS_TextDecoration();
+ $this->info['text-decoration-line'] = new HTMLPurifier_AttrDef_Enum(
+ ['none', 'underline', 'overline', 'line-through']
+ );
+
+ $this->info['text-decoration-style'] = new HTMLPurifier_AttrDef_Enum(
+ ['solid', 'double', 'dotted', 'dashed', 'wavy']
+ );
+
+ $this->info['text-decoration-color'] = new HTMLPurifier_AttrDef_CSS_Color();
+
+ $this->info['text-decoration-thickness'] = new HTMLPurifier_AttrDef_CSS_Composite([
+ new HTMLPurifier_AttrDef_CSS_Length(),
+ new HTMLPurifier_AttrDef_CSS_Percentage(),
+ new HTMLPurifier_AttrDef_Enum(['auto', 'from-font'])
+ ]);
+
$this->info['font-family'] = new HTMLPurifier_AttrDef_CSS_FontFamily();
// this could use specialized code
$this->info['font-weight'] = new HTMLPurifier_AttrDef_Enum(
- array(
+ [
'normal',
'bold',
'bolder',
@@ -308,7 +340,7 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
'700',
'800',
'900'
- ),
+ ],
false
);
@@ -324,21 +356,21 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
$this->info['border-right'] = new HTMLPurifier_AttrDef_CSS_Border($config);
$this->info['border-collapse'] = new HTMLPurifier_AttrDef_Enum(
- array('collapse', 'separate')
+ ['collapse', 'separate']
);
$this->info['caption-side'] = new HTMLPurifier_AttrDef_Enum(
- array('top', 'bottom')
+ ['top', 'bottom']
);
$this->info['table-layout'] = new HTMLPurifier_AttrDef_Enum(
- array('auto', 'fixed')
+ ['auto', 'fixed']
);
$this->info['vertical-align'] = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
+ [
new HTMLPurifier_AttrDef_Enum(
- array(
+ [
'baseline',
'sub',
'super',
@@ -347,11 +379,11 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
'middle',
'bottom',
'text-bottom'
- )
+ ]
),
new HTMLPurifier_AttrDef_CSS_Length(),
new HTMLPurifier_AttrDef_CSS_Percentage()
- )
+ ]
);
$this->info['border-spacing'] = new HTMLPurifier_AttrDef_CSS_Multiple(new HTMLPurifier_AttrDef_CSS_Length(), 2);
@@ -359,7 +391,7 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
// These CSS properties don't work on many browsers, but we live
// in THE FUTURE!
$this->info['white-space'] = new HTMLPurifier_AttrDef_Enum(
- array('nowrap', 'normal', 'pre', 'pre-wrap', 'pre-line')
+ ['nowrap', 'normal', 'pre', 'pre-wrap', 'pre-line']
);
if ($config->get('CSS.Proprietary')) {
@@ -406,21 +438,21 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
// more CSS3
$this->info['page-break-after'] =
$this->info['page-break-before'] = new HTMLPurifier_AttrDef_Enum(
- array(
+ [
'auto',
'always',
'avoid',
'left',
'right'
- )
+ ]
);
- $this->info['page-break-inside'] = new HTMLPurifier_AttrDef_Enum(array('auto', 'avoid'));
+ $this->info['page-break-inside'] = new HTMLPurifier_AttrDef_Enum(['auto', 'avoid']);
$border_radius = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
+ [
new HTMLPurifier_AttrDef_CSS_Percentage(true), // disallow negative
new HTMLPurifier_AttrDef_CSS_Length('0') // disallow negative
- ));
+ ]);
$this->info['border-top-left-radius'] =
$this->info['border-top-right-radius'] =
@@ -437,7 +469,7 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
protected function doSetupTricky($config)
{
$this->info['display'] = new HTMLPurifier_AttrDef_Enum(
- array(
+ [
'inline',
'block',
'list-item',
@@ -456,12 +488,12 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
'table-cell',
'table-caption',
'none'
- )
+ ]
);
$this->info['visibility'] = new HTMLPurifier_AttrDef_Enum(
- array('visible', 'hidden', 'collapse')
+ ['visible', 'hidden', 'collapse']
);
- $this->info['overflow'] = new HTMLPurifier_AttrDef_Enum(array('visible', 'hidden', 'auto', 'scroll'));
+ $this->info['overflow'] = new HTMLPurifier_AttrDef_Enum(['visible', 'hidden', 'auto', 'scroll']);
$this->info['opacity'] = new HTMLPurifier_AttrDef_CSS_AlphaValue();
}
@@ -471,23 +503,23 @@ class HTMLPurifier_CSSDefinition extends HTMLPurifier_Definition
protected function doSetupTrusted($config)
{
$this->info['position'] = new HTMLPurifier_AttrDef_Enum(
- array('static', 'relative', 'absolute', 'fixed')
+ ['static', 'relative', 'absolute', 'fixed']
);
$this->info['top'] =
$this->info['left'] =
$this->info['right'] =
$this->info['bottom'] = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
+ [
new HTMLPurifier_AttrDef_CSS_Length(),
new HTMLPurifier_AttrDef_CSS_Percentage(),
- new HTMLPurifier_AttrDef_Enum(array('auto')),
- )
+ new HTMLPurifier_AttrDef_Enum(['auto']),
+ ]
);
$this->info['z-index'] = new HTMLPurifier_AttrDef_CSS_Composite(
- array(
+ [
new HTMLPurifier_AttrDef_Integer(),
- new HTMLPurifier_AttrDef_Enum(array('auto')),
- )
+ new HTMLPurifier_AttrDef_Enum(['auto']),
+ ]
);
}
diff --git a/tools/htmlpurifier/HTMLPurifier/ChildDef/List.php b/tools/htmlpurifier/HTMLPurifier/ChildDef/List.php
index 4fc70e0ef..3d584e727 100644
--- a/tools/htmlpurifier/HTMLPurifier/ChildDef/List.php
+++ b/tools/htmlpurifier/HTMLPurifier/ChildDef/List.php
@@ -22,6 +22,8 @@ class HTMLPurifier_ChildDef_List extends HTMLPurifier_ChildDef
// XXX: This whole business with 'wrap' is all a bit unsatisfactory
public $elements = array('li' => true, 'ul' => true, 'ol' => true);
+ public $whitespace;
+
/**
* @param array $children
* @param HTMLPurifier_Config $config
diff --git a/tools/htmlpurifier/HTMLPurifier/ChildDef/Table.php b/tools/htmlpurifier/HTMLPurifier/ChildDef/Table.php
index cb6b3e6cd..d92205b32 100644
--- a/tools/htmlpurifier/HTMLPurifier/ChildDef/Table.php
+++ b/tools/htmlpurifier/HTMLPurifier/ChildDef/Table.php
@@ -164,7 +164,7 @@ class HTMLPurifier_ChildDef_Table extends HTMLPurifier_ChildDef
}
}
- if (empty($content)) {
+ if (empty($content) && $thead === false && $tfoot === false) {
return false;
}
@@ -190,6 +190,9 @@ class HTMLPurifier_ChildDef_Table extends HTMLPurifier_ChildDef
$current_tr_tbody = null;
foreach($content as $node) {
+ if (!isset($node->name)) {
+ continue;
+ }
switch ($node->name) {
case 'tbody':
$current_tr_tbody = null;
diff --git a/tools/htmlpurifier/HTMLPurifier/ChildDef/index.php b/tools/htmlpurifier/HTMLPurifier/ChildDef/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/ChildDef/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/Config.php b/tools/htmlpurifier/HTMLPurifier/Config.php
index 3133d8a4f..e6566e802 100644
--- a/tools/htmlpurifier/HTMLPurifier/Config.php
+++ b/tools/htmlpurifier/HTMLPurifier/Config.php
@@ -21,7 +21,7 @@ class HTMLPurifier_Config
* HTML Purifier's version
* @type string
*/
- public $version = '4.13.0';
+ public $version = '4.18.0';
/**
* Whether or not to automatically finalize
@@ -803,7 +803,7 @@ class HTMLPurifier_Config
if ($index !== false) {
$array = (isset($array[$index]) && is_array($array[$index])) ? $array[$index] : array();
}
- $mq = $mq_fix && function_exists('get_magic_quotes_gpc') && get_magic_quotes_gpc();
+ $mq = $mq_fix && version_compare(PHP_VERSION, '7.4.0', '<') && function_exists('get_magic_quotes_gpc') && get_magic_quotes_gpc();
$allowed = HTMLPurifier_Config::getAllowedDirectivesForForm($allowed, $schema);
$ret = array();
diff --git a/tools/htmlpurifier/HTMLPurifier/ConfigSchema/Builder/index.php b/tools/htmlpurifier/HTMLPurifier/ConfigSchema/Builder/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/ConfigSchema/Builder/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/ConfigSchema/Interchange/index.php b/tools/htmlpurifier/HTMLPurifier/ConfigSchema/Interchange/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/ConfigSchema/Interchange/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/ConfigSchema/index.php b/tools/htmlpurifier/HTMLPurifier/ConfigSchema/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/ConfigSchema/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/ConfigSchema/schema.ser b/tools/htmlpurifier/HTMLPurifier/ConfigSchema/schema.ser
index a5426c736..3cd756bee 100644
--- a/tools/htmlpurifier/HTMLPurifier/ConfigSchema/schema.ser
+++ b/tools/htmlpurifier/HTMLPurifier/ConfigSchema/schema.ser
@@ -1 +1 @@
-O:25:"HTMLPurifier_ConfigSchema":3:{s:8:"defaults";a:127:{s:19:"Attr.AllowedClasses";N;s:24:"Attr.AllowedFrameTargets";a:0:{}s:15:"Attr.AllowedRel";a:0:{}s:15:"Attr.AllowedRev";a:0:{}s:18:"Attr.ClassUseCDATA";N;s:20:"Attr.DefaultImageAlt";N;s:24:"Attr.DefaultInvalidImage";s:0:"";s:27:"Attr.DefaultInvalidImageAlt";s:13:"Invalid image";s:19:"Attr.DefaultTextDir";s:3:"ltr";s:13:"Attr.EnableID";b:0;s:21:"Attr.ForbiddenClasses";a:0:{}s:13:"Attr.ID.HTML5";N;s:16:"Attr.IDBlacklist";a:0:{}s:22:"Attr.IDBlacklistRegexp";N;s:13:"Attr.IDPrefix";s:0:"";s:18:"Attr.IDPrefixLocal";s:0:"";s:24:"AutoFormat.AutoParagraph";b:0;s:17:"AutoFormat.Custom";a:0:{}s:25:"AutoFormat.DisplayLinkURI";b:0;s:18:"AutoFormat.Linkify";b:0;s:33:"AutoFormat.PurifierLinkify.DocURL";s:3:"#%s";s:26:"AutoFormat.PurifierLinkify";b:0;s:32:"AutoFormat.RemoveEmpty.Predicate";a:4:{s:8:"colgroup";a:0:{}s:2:"th";a:0:{}s:2:"td";a:0:{}s:6:"iframe";a:1:{i:0;s:3:"src";}}s:44:"AutoFormat.RemoveEmpty.RemoveNbsp.Exceptions";a:2:{s:2:"td";b:1;s:2:"th";b:1;}s:33:"AutoFormat.RemoveEmpty.RemoveNbsp";b:0;s:22:"AutoFormat.RemoveEmpty";b:0;s:39:"AutoFormat.RemoveSpansWithoutAttributes";b:0;s:19:"CSS.AllowDuplicates";b:0;s:18:"CSS.AllowImportant";b:0;s:15:"CSS.AllowTricky";b:0;s:16:"CSS.AllowedFonts";N;s:21:"CSS.AllowedProperties";N;s:17:"CSS.DefinitionRev";i:1;s:23:"CSS.ForbiddenProperties";a:0:{}s:16:"CSS.MaxImgLength";s:6:"1200px";s:15:"CSS.Proprietary";b:0;s:11:"CSS.Trusted";b:0;s:20:"Cache.DefinitionImpl";s:10:"Serializer";s:20:"Cache.SerializerPath";N;s:27:"Cache.SerializerPermissions";i:493;s:22:"Core.AggressivelyFixLt";b:1;s:29:"Core.AggressivelyRemoveScript";b:1;s:28:"Core.AllowHostnameUnderscore";b:0;s:23:"Core.AllowParseManyTags";b:0;s:18:"Core.CollectErrors";b:0;s:18:"Core.ColorKeywords";a:148:{s:9:"aliceblue";s:7:"#F0F8FF";s:12:"antiquewhite";s:7:"#FAEBD7";s:4:"aqua";s:7:"#00FFFF";s:10:"aquamarine";s:7:"#7FFFD4";s:5:"azure";s:7:"#F0FFFF";s:5:"beige";s:7:"#F5F5DC";s:6:"bisque";s:7:"#FFE4C4";s:5:"black";s:7:"#000000";s:14:"blanchedalmond";s:7:"#FFEBCD";s:4:"blue";s:7:"#0000FF";s:10:"blueviolet";s:7:"#8A2BE2";s:5:"brown";s:7:"#A52A2A";s:9:"burlywood";s:7:"#DEB887";s:9:"cadetblue";s:7:"#5F9EA0";s:10:"chartreuse";s:7:"#7FFF00";s:9:"chocolate";s:7:"#D2691E";s:5:"coral";s:7:"#FF7F50";s:14:"cornflowerblue";s:7:"#6495ED";s:8:"cornsilk";s:7:"#FFF8DC";s:7:"crimson";s:7:"#DC143C";s:4:"cyan";s:7:"#00FFFF";s:8:"darkblue";s:7:"#00008B";s:8:"darkcyan";s:7:"#008B8B";s:13:"darkgoldenrod";s:7:"#B8860B";s:8:"darkgray";s:7:"#A9A9A9";s:8:"darkgrey";s:7:"#A9A9A9";s:9:"darkgreen";s:7:"#006400";s:9:"darkkhaki";s:7:"#BDB76B";s:11:"darkmagenta";s:7:"#8B008B";s:14:"darkolivegreen";s:7:"#556B2F";s:10:"darkorange";s:7:"#FF8C00";s:10:"darkorchid";s:7:"#9932CC";s:7:"darkred";s:7:"#8B0000";s:10:"darksalmon";s:7:"#E9967A";s:12:"darkseagreen";s:7:"#8FBC8F";s:13:"darkslateblue";s:7:"#483D8B";s:13:"darkslategray";s:7:"#2F4F4F";s:13:"darkslategrey";s:7:"#2F4F4F";s:13:"darkturquoise";s:7:"#00CED1";s:10:"darkviolet";s:7:"#9400D3";s:8:"deeppink";s:7:"#FF1493";s:11:"deepskyblue";s:7:"#00BFFF";s:7:"dimgray";s:7:"#696969";s:7:"dimgrey";s:7:"#696969";s:10:"dodgerblue";s:7:"#1E90FF";s:9:"firebrick";s:7:"#B22222";s:11:"floralwhite";s:7:"#FFFAF0";s:11:"forestgreen";s:7:"#228B22";s:7:"fuchsia";s:7:"#FF00FF";s:9:"gainsboro";s:7:"#DCDCDC";s:10:"ghostwhite";s:7:"#F8F8FF";s:4:"gold";s:7:"#FFD700";s:9:"goldenrod";s:7:"#DAA520";s:4:"gray";s:7:"#808080";s:4:"grey";s:7:"#808080";s:5:"green";s:7:"#008000";s:11:"greenyellow";s:7:"#ADFF2F";s:8:"honeydew";s:7:"#F0FFF0";s:7:"hotpink";s:7:"#FF69B4";s:9:"indianred";s:7:"#CD5C5C";s:6:"indigo";s:7:"#4B0082";s:5:"ivory";s:7:"#FFFFF0";s:5:"khaki";s:7:"#F0E68C";s:8:"lavender";s:7:"#E6E6FA";s:13:"lavenderblush";s:7:"#FFF0F5";s:9:"lawngreen";s:7:"#7CFC00";s:12:"lemonchiffon";s:7:"#FFFACD";s:9:"lightblue";s:7:"#ADD8E6";s:10:"lightcoral";s:7:"#F08080";s:9:"lightcyan";s:7:"#E0FFFF";s:20:"lightgoldenrodyellow";s:7:"#FAFAD2";s:9:"lightgray";s:7:"#D3D3D3";s:9:"lightgrey";s:7:"#D3D3D3";s:10:"lightgreen";s:7:"#90EE90";s:9:"lightpink";s:7:"#FFB6C1";s:11:"lightsalmon";s:7:"#FFA07A";s:13:"lightseagreen";s:7:"#20B2AA";s:12:"lightskyblue";s:7:"#87CEFA";s:14:"lightslategray";s:7:"#778899";s:14:"lightslategrey";s:7:"#778899";s:14:"lightsteelblue";s:7:"#B0C4DE";s:11:"lightyellow";s:7:"#FFFFE0";s:4:"lime";s:7:"#00FF00";s:9:"limegreen";s:7:"#32CD32";s:5:"linen";s:7:"#FAF0E6";s:7:"magenta";s:7:"#FF00FF";s:6:"maroon";s:7:"#800000";s:16:"mediumaquamarine";s:7:"#66CDAA";s:10:"mediumblue";s:7:"#0000CD";s:12:"mediumorchid";s:7:"#BA55D3";s:12:"mediumpurple";s:7:"#9370DB";s:14:"mediumseagreen";s:7:"#3CB371";s:15:"mediumslateblue";s:7:"#7B68EE";s:17:"mediumspringgreen";s:7:"#00FA9A";s:15:"mediumturquoise";s:7:"#48D1CC";s:15:"mediumvioletred";s:7:"#C71585";s:12:"midnightblue";s:7:"#191970";s:9:"mintcream";s:7:"#F5FFFA";s:9:"mistyrose";s:7:"#FFE4E1";s:8:"moccasin";s:7:"#FFE4B5";s:11:"navajowhite";s:7:"#FFDEAD";s:4:"navy";s:7:"#000080";s:7:"oldlace";s:7:"#FDF5E6";s:5:"olive";s:7:"#808000";s:9:"olivedrab";s:7:"#6B8E23";s:6:"orange";s:7:"#FFA500";s:9:"orangered";s:7:"#FF4500";s:6:"orchid";s:7:"#DA70D6";s:13:"palegoldenrod";s:7:"#EEE8AA";s:9:"palegreen";s:7:"#98FB98";s:13:"paleturquoise";s:7:"#AFEEEE";s:13:"palevioletred";s:7:"#DB7093";s:10:"papayawhip";s:7:"#FFEFD5";s:9:"peachpuff";s:7:"#FFDAB9";s:4:"peru";s:7:"#CD853F";s:4:"pink";s:7:"#FFC0CB";s:4:"plum";s:7:"#DDA0DD";s:10:"powderblue";s:7:"#B0E0E6";s:6:"purple";s:7:"#800080";s:13:"rebeccapurple";s:7:"#663399";s:3:"red";s:7:"#FF0000";s:9:"rosybrown";s:7:"#BC8F8F";s:9:"royalblue";s:7:"#4169E1";s:11:"saddlebrown";s:7:"#8B4513";s:6:"salmon";s:7:"#FA8072";s:10:"sandybrown";s:7:"#F4A460";s:8:"seagreen";s:7:"#2E8B57";s:8:"seashell";s:7:"#FFF5EE";s:6:"sienna";s:7:"#A0522D";s:6:"silver";s:7:"#C0C0C0";s:7:"skyblue";s:7:"#87CEEB";s:9:"slateblue";s:7:"#6A5ACD";s:9:"slategray";s:7:"#708090";s:9:"slategrey";s:7:"#708090";s:4:"snow";s:7:"#FFFAFA";s:11:"springgreen";s:7:"#00FF7F";s:9:"steelblue";s:7:"#4682B4";s:3:"tan";s:7:"#D2B48C";s:4:"teal";s:7:"#008080";s:7:"thistle";s:7:"#D8BFD8";s:6:"tomato";s:7:"#FF6347";s:9:"turquoise";s:7:"#40E0D0";s:6:"violet";s:7:"#EE82EE";s:5:"wheat";s:7:"#F5DEB3";s:5:"white";s:7:"#FFFFFF";s:10:"whitesmoke";s:7:"#F5F5F5";s:6:"yellow";s:7:"#FFFF00";s:11:"yellowgreen";s:7:"#9ACD32";}s:30:"Core.ConvertDocumentToFragment";b:1;s:36:"Core.DirectLexLineNumberSyncInterval";i:0;s:20:"Core.DisableExcludes";b:0;s:15:"Core.EnableIDNA";b:0;s:13:"Core.Encoding";s:5:"utf-8";s:26:"Core.EscapeInvalidChildren";b:0;s:22:"Core.EscapeInvalidTags";b:0;s:29:"Core.EscapeNonASCIICharacters";b:0;s:19:"Core.HiddenElements";a:2:{s:6:"script";b:1;s:5:"style";b:1;}s:13:"Core.Language";s:2:"en";s:24:"Core.LegacyEntityDecoder";b:0;s:14:"Core.LexerImpl";N;s:24:"Core.MaintainLineNumbers";N;s:22:"Core.NormalizeNewlines";b:1;s:21:"Core.RemoveInvalidImg";b:1;s:33:"Core.RemoveProcessingInstructions";b:0;s:25:"Core.RemoveScriptContents";N;s:13:"Filter.Custom";a:0:{}s:34:"Filter.ExtractStyleBlocks.Escaping";b:1;s:31:"Filter.ExtractStyleBlocks.Scope";N;s:34:"Filter.ExtractStyleBlocks.TidyImpl";N;s:25:"Filter.ExtractStyleBlocks";b:0;s:14:"Filter.YouTube";b:0;s:12:"HTML.Allowed";N;s:22:"HTML.AllowedAttributes";N;s:20:"HTML.AllowedComments";a:0:{}s:26:"HTML.AllowedCommentsRegexp";N;s:20:"HTML.AllowedElements";N;s:19:"HTML.AllowedModules";N;s:23:"HTML.Attr.Name.UseCDATA";b:0;s:17:"HTML.BlockWrapper";s:1:"p";s:16:"HTML.CoreModules";a:7:{s:9:"Structure";b:1;s:4:"Text";b:1;s:9:"Hypertext";b:1;s:4:"List";b:1;s:22:"NonXMLCommonAttributes";b:1;s:19:"XMLCommonAttributes";b:1;s:16:"CommonAttributes";b:1;}s:18:"HTML.CustomDoctype";N;s:17:"HTML.DefinitionID";N;s:18:"HTML.DefinitionRev";i:1;s:12:"HTML.Doctype";N;s:25:"HTML.FlashAllowFullScreen";b:0;s:24:"HTML.ForbiddenAttributes";a:0:{}s:22:"HTML.ForbiddenElements";a:0:{}s:10:"HTML.Forms";b:0;s:17:"HTML.MaxImgLength";i:1200;s:13:"HTML.Nofollow";b:0;s:11:"HTML.Parent";s:3:"div";s:16:"HTML.Proprietary";b:0;s:14:"HTML.SafeEmbed";b:0;s:15:"HTML.SafeIframe";b:0;s:15:"HTML.SafeObject";b:0;s:18:"HTML.SafeScripting";a:0:{}s:11:"HTML.Strict";b:0;s:16:"HTML.TargetBlank";b:0;s:19:"HTML.TargetNoopener";b:1;s:21:"HTML.TargetNoreferrer";b:1;s:12:"HTML.TidyAdd";a:0:{}s:14:"HTML.TidyLevel";s:6:"medium";s:15:"HTML.TidyRemove";a:0:{}s:12:"HTML.Trusted";b:0;s:10:"HTML.XHTML";b:1;s:28:"Output.CommentScriptContents";b:1;s:19:"Output.FixInnerHTML";b:1;s:18:"Output.FlashCompat";b:0;s:14:"Output.Newline";N;s:15:"Output.SortAttr";b:0;s:17:"Output.TidyFormat";b:0;s:17:"Test.ForceNoIconv";b:0;s:18:"URI.AllowedSchemes";a:7:{s:4:"http";b:1;s:5:"https";b:1;s:6:"mailto";b:1;s:3:"ftp";b:1;s:4:"nntp";b:1;s:4:"news";b:1;s:3:"tel";b:1;}s:8:"URI.Base";N;s:17:"URI.DefaultScheme";s:4:"http";s:16:"URI.DefinitionID";N;s:17:"URI.DefinitionRev";i:1;s:11:"URI.Disable";b:0;s:19:"URI.DisableExternal";b:0;s:28:"URI.DisableExternalResources";b:0;s:20:"URI.DisableResources";b:0;s:8:"URI.Host";N;s:17:"URI.HostBlacklist";a:0:{}s:16:"URI.MakeAbsolute";b:0;s:9:"URI.Munge";N;s:18:"URI.MungeResources";b:0;s:18:"URI.MungeSecretKey";N;s:26:"URI.OverrideAllowedSchemes";b:1;s:20:"URI.SafeIframeRegexp";N;}s:12:"defaultPlist";O:25:"HTMLPurifier_PropertyList":3:{s:7:" * data";a:127:{s:19:"Attr.AllowedClasses";N;s:24:"Attr.AllowedFrameTargets";a:0:{}s:15:"Attr.AllowedRel";a:0:{}s:15:"Attr.AllowedRev";a:0:{}s:18:"Attr.ClassUseCDATA";N;s:20:"Attr.DefaultImageAlt";N;s:24:"Attr.DefaultInvalidImage";s:0:"";s:27:"Attr.DefaultInvalidImageAlt";s:13:"Invalid image";s:19:"Attr.DefaultTextDir";s:3:"ltr";s:13:"Attr.EnableID";b:0;s:21:"Attr.ForbiddenClasses";a:0:{}s:13:"Attr.ID.HTML5";N;s:16:"Attr.IDBlacklist";a:0:{}s:22:"Attr.IDBlacklistRegexp";N;s:13:"Attr.IDPrefix";s:0:"";s:18:"Attr.IDPrefixLocal";s:0:"";s:24:"AutoFormat.AutoParagraph";b:0;s:17:"AutoFormat.Custom";a:0:{}s:25:"AutoFormat.DisplayLinkURI";b:0;s:18:"AutoFormat.Linkify";b:0;s:33:"AutoFormat.PurifierLinkify.DocURL";s:3:"#%s";s:26:"AutoFormat.PurifierLinkify";b:0;s:32:"AutoFormat.RemoveEmpty.Predicate";a:4:{s:8:"colgroup";a:0:{}s:2:"th";a:0:{}s:2:"td";a:0:{}s:6:"iframe";a:1:{i:0;s:3:"src";}}s:44:"AutoFormat.RemoveEmpty.RemoveNbsp.Exceptions";a:2:{s:2:"td";b:1;s:2:"th";b:1;}s:33:"AutoFormat.RemoveEmpty.RemoveNbsp";b:0;s:22:"AutoFormat.RemoveEmpty";b:0;s:39:"AutoFormat.RemoveSpansWithoutAttributes";b:0;s:19:"CSS.AllowDuplicates";b:0;s:18:"CSS.AllowImportant";b:0;s:15:"CSS.AllowTricky";b:0;s:16:"CSS.AllowedFonts";N;s:21:"CSS.AllowedProperties";N;s:17:"CSS.DefinitionRev";i:1;s:23:"CSS.ForbiddenProperties";a:0:{}s:16:"CSS.MaxImgLength";s:6:"1200px";s:15:"CSS.Proprietary";b:0;s:11:"CSS.Trusted";b:0;s:20:"Cache.DefinitionImpl";s:10:"Serializer";s:20:"Cache.SerializerPath";N;s:27:"Cache.SerializerPermissions";i:493;s:22:"Core.AggressivelyFixLt";b:1;s:29:"Core.AggressivelyRemoveScript";b:1;s:28:"Core.AllowHostnameUnderscore";b:0;s:23:"Core.AllowParseManyTags";b:0;s:18:"Core.CollectErrors";b:0;s:18:"Core.ColorKeywords";a:148:{s:9:"aliceblue";s:7:"#F0F8FF";s:12:"antiquewhite";s:7:"#FAEBD7";s:4:"aqua";s:7:"#00FFFF";s:10:"aquamarine";s:7:"#7FFFD4";s:5:"azure";s:7:"#F0FFFF";s:5:"beige";s:7:"#F5F5DC";s:6:"bisque";s:7:"#FFE4C4";s:5:"black";s:7:"#000000";s:14:"blanchedalmond";s:7:"#FFEBCD";s:4:"blue";s:7:"#0000FF";s:10:"blueviolet";s:7:"#8A2BE2";s:5:"brown";s:7:"#A52A2A";s:9:"burlywood";s:7:"#DEB887";s:9:"cadetblue";s:7:"#5F9EA0";s:10:"chartreuse";s:7:"#7FFF00";s:9:"chocolate";s:7:"#D2691E";s:5:"coral";s:7:"#FF7F50";s:14:"cornflowerblue";s:7:"#6495ED";s:8:"cornsilk";s:7:"#FFF8DC";s:7:"crimson";s:7:"#DC143C";s:4:"cyan";s:7:"#00FFFF";s:8:"darkblue";s:7:"#00008B";s:8:"darkcyan";s:7:"#008B8B";s:13:"darkgoldenrod";s:7:"#B8860B";s:8:"darkgray";s:7:"#A9A9A9";s:8:"darkgrey";s:7:"#A9A9A9";s:9:"darkgreen";s:7:"#006400";s:9:"darkkhaki";s:7:"#BDB76B";s:11:"darkmagenta";s:7:"#8B008B";s:14:"darkolivegreen";s:7:"#556B2F";s:10:"darkorange";s:7:"#FF8C00";s:10:"darkorchid";s:7:"#9932CC";s:7:"darkred";s:7:"#8B0000";s:10:"darksalmon";s:7:"#E9967A";s:12:"darkseagreen";s:7:"#8FBC8F";s:13:"darkslateblue";s:7:"#483D8B";s:13:"darkslategray";s:7:"#2F4F4F";s:13:"darkslategrey";s:7:"#2F4F4F";s:13:"darkturquoise";s:7:"#00CED1";s:10:"darkviolet";s:7:"#9400D3";s:8:"deeppink";s:7:"#FF1493";s:11:"deepskyblue";s:7:"#00BFFF";s:7:"dimgray";s:7:"#696969";s:7:"dimgrey";s:7:"#696969";s:10:"dodgerblue";s:7:"#1E90FF";s:9:"firebrick";s:7:"#B22222";s:11:"floralwhite";s:7:"#FFFAF0";s:11:"forestgreen";s:7:"#228B22";s:7:"fuchsia";s:7:"#FF00FF";s:9:"gainsboro";s:7:"#DCDCDC";s:10:"ghostwhite";s:7:"#F8F8FF";s:4:"gold";s:7:"#FFD700";s:9:"goldenrod";s:7:"#DAA520";s:4:"gray";s:7:"#808080";s:4:"grey";s:7:"#808080";s:5:"green";s:7:"#008000";s:11:"greenyellow";s:7:"#ADFF2F";s:8:"honeydew";s:7:"#F0FFF0";s:7:"hotpink";s:7:"#FF69B4";s:9:"indianred";s:7:"#CD5C5C";s:6:"indigo";s:7:"#4B0082";s:5:"ivory";s:7:"#FFFFF0";s:5:"khaki";s:7:"#F0E68C";s:8:"lavender";s:7:"#E6E6FA";s:13:"lavenderblush";s:7:"#FFF0F5";s:9:"lawngreen";s:7:"#7CFC00";s:12:"lemonchiffon";s:7:"#FFFACD";s:9:"lightblue";s:7:"#ADD8E6";s:10:"lightcoral";s:7:"#F08080";s:9:"lightcyan";s:7:"#E0FFFF";s:20:"lightgoldenrodyellow";s:7:"#FAFAD2";s:9:"lightgray";s:7:"#D3D3D3";s:9:"lightgrey";s:7:"#D3D3D3";s:10:"lightgreen";s:7:"#90EE90";s:9:"lightpink";s:7:"#FFB6C1";s:11:"lightsalmon";s:7:"#FFA07A";s:13:"lightseagreen";s:7:"#20B2AA";s:12:"lightskyblue";s:7:"#87CEFA";s:14:"lightslategray";s:7:"#778899";s:14:"lightslategrey";s:7:"#778899";s:14:"lightsteelblue";s:7:"#B0C4DE";s:11:"lightyellow";s:7:"#FFFFE0";s:4:"lime";s:7:"#00FF00";s:9:"limegreen";s:7:"#32CD32";s:5:"linen";s:7:"#FAF0E6";s:7:"magenta";s:7:"#FF00FF";s:6:"maroon";s:7:"#800000";s:16:"mediumaquamarine";s:7:"#66CDAA";s:10:"mediumblue";s:7:"#0000CD";s:12:"mediumorchid";s:7:"#BA55D3";s:12:"mediumpurple";s:7:"#9370DB";s:14:"mediumseagreen";s:7:"#3CB371";s:15:"mediumslateblue";s:7:"#7B68EE";s:17:"mediumspringgreen";s:7:"#00FA9A";s:15:"mediumturquoise";s:7:"#48D1CC";s:15:"mediumvioletred";s:7:"#C71585";s:12:"midnightblue";s:7:"#191970";s:9:"mintcream";s:7:"#F5FFFA";s:9:"mistyrose";s:7:"#FFE4E1";s:8:"moccasin";s:7:"#FFE4B5";s:11:"navajowhite";s:7:"#FFDEAD";s:4:"navy";s:7:"#000080";s:7:"oldlace";s:7:"#FDF5E6";s:5:"olive";s:7:"#808000";s:9:"olivedrab";s:7:"#6B8E23";s:6:"orange";s:7:"#FFA500";s:9:"orangered";s:7:"#FF4500";s:6:"orchid";s:7:"#DA70D6";s:13:"palegoldenrod";s:7:"#EEE8AA";s:9:"palegreen";s:7:"#98FB98";s:13:"paleturquoise";s:7:"#AFEEEE";s:13:"palevioletred";s:7:"#DB7093";s:10:"papayawhip";s:7:"#FFEFD5";s:9:"peachpuff";s:7:"#FFDAB9";s:4:"peru";s:7:"#CD853F";s:4:"pink";s:7:"#FFC0CB";s:4:"plum";s:7:"#DDA0DD";s:10:"powderblue";s:7:"#B0E0E6";s:6:"purple";s:7:"#800080";s:13:"rebeccapurple";s:7:"#663399";s:3:"red";s:7:"#FF0000";s:9:"rosybrown";s:7:"#BC8F8F";s:9:"royalblue";s:7:"#4169E1";s:11:"saddlebrown";s:7:"#8B4513";s:6:"salmon";s:7:"#FA8072";s:10:"sandybrown";s:7:"#F4A460";s:8:"seagreen";s:7:"#2E8B57";s:8:"seashell";s:7:"#FFF5EE";s:6:"sienna";s:7:"#A0522D";s:6:"silver";s:7:"#C0C0C0";s:7:"skyblue";s:7:"#87CEEB";s:9:"slateblue";s:7:"#6A5ACD";s:9:"slategray";s:7:"#708090";s:9:"slategrey";s:7:"#708090";s:4:"snow";s:7:"#FFFAFA";s:11:"springgreen";s:7:"#00FF7F";s:9:"steelblue";s:7:"#4682B4";s:3:"tan";s:7:"#D2B48C";s:4:"teal";s:7:"#008080";s:7:"thistle";s:7:"#D8BFD8";s:6:"tomato";s:7:"#FF6347";s:9:"turquoise";s:7:"#40E0D0";s:6:"violet";s:7:"#EE82EE";s:5:"wheat";s:7:"#F5DEB3";s:5:"white";s:7:"#FFFFFF";s:10:"whitesmoke";s:7:"#F5F5F5";s:6:"yellow";s:7:"#FFFF00";s:11:"yellowgreen";s:7:"#9ACD32";}s:30:"Core.ConvertDocumentToFragment";b:1;s:36:"Core.DirectLexLineNumberSyncInterval";i:0;s:20:"Core.DisableExcludes";b:0;s:15:"Core.EnableIDNA";b:0;s:13:"Core.Encoding";s:5:"utf-8";s:26:"Core.EscapeInvalidChildren";b:0;s:22:"Core.EscapeInvalidTags";b:0;s:29:"Core.EscapeNonASCIICharacters";b:0;s:19:"Core.HiddenElements";a:2:{s:6:"script";b:1;s:5:"style";b:1;}s:13:"Core.Language";s:2:"en";s:24:"Core.LegacyEntityDecoder";b:0;s:14:"Core.LexerImpl";N;s:24:"Core.MaintainLineNumbers";N;s:22:"Core.NormalizeNewlines";b:1;s:21:"Core.RemoveInvalidImg";b:1;s:33:"Core.RemoveProcessingInstructions";b:0;s:25:"Core.RemoveScriptContents";N;s:13:"Filter.Custom";a:0:{}s:34:"Filter.ExtractStyleBlocks.Escaping";b:1;s:31:"Filter.ExtractStyleBlocks.Scope";N;s:34:"Filter.ExtractStyleBlocks.TidyImpl";N;s:25:"Filter.ExtractStyleBlocks";b:0;s:14:"Filter.YouTube";b:0;s:12:"HTML.Allowed";N;s:22:"HTML.AllowedAttributes";N;s:20:"HTML.AllowedComments";a:0:{}s:26:"HTML.AllowedCommentsRegexp";N;s:20:"HTML.AllowedElements";N;s:19:"HTML.AllowedModules";N;s:23:"HTML.Attr.Name.UseCDATA";b:0;s:17:"HTML.BlockWrapper";s:1:"p";s:16:"HTML.CoreModules";a:7:{s:9:"Structure";b:1;s:4:"Text";b:1;s:9:"Hypertext";b:1;s:4:"List";b:1;s:22:"NonXMLCommonAttributes";b:1;s:19:"XMLCommonAttributes";b:1;s:16:"CommonAttributes";b:1;}s:18:"HTML.CustomDoctype";N;s:17:"HTML.DefinitionID";N;s:18:"HTML.DefinitionRev";i:1;s:12:"HTML.Doctype";N;s:25:"HTML.FlashAllowFullScreen";b:0;s:24:"HTML.ForbiddenAttributes";a:0:{}s:22:"HTML.ForbiddenElements";a:0:{}s:10:"HTML.Forms";b:0;s:17:"HTML.MaxImgLength";i:1200;s:13:"HTML.Nofollow";b:0;s:11:"HTML.Parent";s:3:"div";s:16:"HTML.Proprietary";b:0;s:14:"HTML.SafeEmbed";b:0;s:15:"HTML.SafeIframe";b:0;s:15:"HTML.SafeObject";b:0;s:18:"HTML.SafeScripting";a:0:{}s:11:"HTML.Strict";b:0;s:16:"HTML.TargetBlank";b:0;s:19:"HTML.TargetNoopener";b:1;s:21:"HTML.TargetNoreferrer";b:1;s:12:"HTML.TidyAdd";a:0:{}s:14:"HTML.TidyLevel";s:6:"medium";s:15:"HTML.TidyRemove";a:0:{}s:12:"HTML.Trusted";b:0;s:10:"HTML.XHTML";b:1;s:28:"Output.CommentScriptContents";b:1;s:19:"Output.FixInnerHTML";b:1;s:18:"Output.FlashCompat";b:0;s:14:"Output.Newline";N;s:15:"Output.SortAttr";b:0;s:17:"Output.TidyFormat";b:0;s:17:"Test.ForceNoIconv";b:0;s:18:"URI.AllowedSchemes";a:7:{s:4:"http";b:1;s:5:"https";b:1;s:6:"mailto";b:1;s:3:"ftp";b:1;s:4:"nntp";b:1;s:4:"news";b:1;s:3:"tel";b:1;}s:8:"URI.Base";N;s:17:"URI.DefaultScheme";s:4:"http";s:16:"URI.DefinitionID";N;s:17:"URI.DefinitionRev";i:1;s:11:"URI.Disable";b:0;s:19:"URI.DisableExternal";b:0;s:28:"URI.DisableExternalResources";b:0;s:20:"URI.DisableResources";b:0;s:8:"URI.Host";N;s:17:"URI.HostBlacklist";a:0:{}s:16:"URI.MakeAbsolute";b:0;s:9:"URI.Munge";N;s:18:"URI.MungeResources";b:0;s:18:"URI.MungeSecretKey";N;s:26:"URI.OverrideAllowedSchemes";b:1;s:20:"URI.SafeIframeRegexp";N;}s:9:" * parent";N;s:8:" * cache";N;}s:4:"info";a:140:{s:19:"Attr.AllowedClasses";i:-8;s:24:"Attr.AllowedFrameTargets";i:8;s:15:"Attr.AllowedRel";i:8;s:15:"Attr.AllowedRev";i:8;s:18:"Attr.ClassUseCDATA";i:-7;s:20:"Attr.DefaultImageAlt";i:-1;s:24:"Attr.DefaultInvalidImage";i:1;s:27:"Attr.DefaultInvalidImageAlt";i:1;s:19:"Attr.DefaultTextDir";O:8:"stdClass":2:{s:4:"type";i:1;s:7:"allowed";a:2:{s:3:"ltr";b:1;s:3:"rtl";b:1;}}s:13:"Attr.EnableID";i:7;s:17:"HTML.EnableAttrID";O:8:"stdClass":2:{s:3:"key";s:13:"Attr.EnableID";s:7:"isAlias";b:1;}s:21:"Attr.ForbiddenClasses";i:8;s:13:"Attr.ID.HTML5";i:-7;s:16:"Attr.IDBlacklist";i:9;s:22:"Attr.IDBlacklistRegexp";i:-1;s:13:"Attr.IDPrefix";i:1;s:18:"Attr.IDPrefixLocal";i:1;s:24:"AutoFormat.AutoParagraph";i:7;s:17:"AutoFormat.Custom";i:9;s:25:"AutoFormat.DisplayLinkURI";i:7;s:18:"AutoFormat.Linkify";i:7;s:33:"AutoFormat.PurifierLinkify.DocURL";i:1;s:37:"AutoFormatParam.PurifierLinkifyDocURL";O:8:"stdClass":2:{s:3:"key";s:33:"AutoFormat.PurifierLinkify.DocURL";s:7:"isAlias";b:1;}s:26:"AutoFormat.PurifierLinkify";i:7;s:32:"AutoFormat.RemoveEmpty.Predicate";i:10;s:44:"AutoFormat.RemoveEmpty.RemoveNbsp.Exceptions";i:8;s:33:"AutoFormat.RemoveEmpty.RemoveNbsp";i:7;s:22:"AutoFormat.RemoveEmpty";i:7;s:39:"AutoFormat.RemoveSpansWithoutAttributes";i:7;s:19:"CSS.AllowDuplicates";i:7;s:18:"CSS.AllowImportant";i:7;s:15:"CSS.AllowTricky";i:7;s:16:"CSS.AllowedFonts";i:-8;s:21:"CSS.AllowedProperties";i:-8;s:17:"CSS.DefinitionRev";i:5;s:23:"CSS.ForbiddenProperties";i:8;s:16:"CSS.MaxImgLength";i:-1;s:15:"CSS.Proprietary";i:7;s:11:"CSS.Trusted";i:7;s:20:"Cache.DefinitionImpl";i:-1;s:20:"Core.DefinitionCache";O:8:"stdClass":2:{s:3:"key";s:20:"Cache.DefinitionImpl";s:7:"isAlias";b:1;}s:20:"Cache.SerializerPath";i:-1;s:27:"Cache.SerializerPermissions";i:-5;s:22:"Core.AggressivelyFixLt";i:7;s:29:"Core.AggressivelyRemoveScript";i:7;s:28:"Core.AllowHostnameUnderscore";i:7;s:23:"Core.AllowParseManyTags";i:7;s:18:"Core.CollectErrors";i:7;s:18:"Core.ColorKeywords";i:10;s:30:"Core.ConvertDocumentToFragment";i:7;s:24:"Core.AcceptFullDocuments";O:8:"stdClass":2:{s:3:"key";s:30:"Core.ConvertDocumentToFragment";s:7:"isAlias";b:1;}s:36:"Core.DirectLexLineNumberSyncInterval";i:5;s:20:"Core.DisableExcludes";i:7;s:15:"Core.EnableIDNA";i:7;s:13:"Core.Encoding";i:2;s:26:"Core.EscapeInvalidChildren";i:7;s:22:"Core.EscapeInvalidTags";i:7;s:29:"Core.EscapeNonASCIICharacters";i:7;s:19:"Core.HiddenElements";i:8;s:13:"Core.Language";i:1;s:24:"Core.LegacyEntityDecoder";i:7;s:14:"Core.LexerImpl";i:-11;s:24:"Core.MaintainLineNumbers";i:-7;s:22:"Core.NormalizeNewlines";i:7;s:21:"Core.RemoveInvalidImg";i:7;s:33:"Core.RemoveProcessingInstructions";i:7;s:25:"Core.RemoveScriptContents";i:-7;s:13:"Filter.Custom";i:9;s:34:"Filter.ExtractStyleBlocks.Escaping";i:7;s:33:"Filter.ExtractStyleBlocksEscaping";O:8:"stdClass":2:{s:3:"key";s:34:"Filter.ExtractStyleBlocks.Escaping";s:7:"isAlias";b:1;}s:38:"FilterParam.ExtractStyleBlocksEscaping";O:8:"stdClass":2:{s:3:"key";s:34:"Filter.ExtractStyleBlocks.Escaping";s:7:"isAlias";b:1;}s:31:"Filter.ExtractStyleBlocks.Scope";i:-1;s:30:"Filter.ExtractStyleBlocksScope";O:8:"stdClass":2:{s:3:"key";s:31:"Filter.ExtractStyleBlocks.Scope";s:7:"isAlias";b:1;}s:35:"FilterParam.ExtractStyleBlocksScope";O:8:"stdClass":2:{s:3:"key";s:31:"Filter.ExtractStyleBlocks.Scope";s:7:"isAlias";b:1;}s:34:"Filter.ExtractStyleBlocks.TidyImpl";i:-11;s:38:"FilterParam.ExtractStyleBlocksTidyImpl";O:8:"stdClass":2:{s:3:"key";s:34:"Filter.ExtractStyleBlocks.TidyImpl";s:7:"isAlias";b:1;}s:25:"Filter.ExtractStyleBlocks";i:7;s:14:"Filter.YouTube";i:7;s:12:"HTML.Allowed";i:-4;s:22:"HTML.AllowedAttributes";i:-8;s:20:"HTML.AllowedComments";i:8;s:26:"HTML.AllowedCommentsRegexp";i:-1;s:20:"HTML.AllowedElements";i:-8;s:19:"HTML.AllowedModules";i:-8;s:23:"HTML.Attr.Name.UseCDATA";i:7;s:17:"HTML.BlockWrapper";i:1;s:16:"HTML.CoreModules";i:8;s:18:"HTML.CustomDoctype";i:-1;s:17:"HTML.DefinitionID";i:-1;s:18:"HTML.DefinitionRev";i:5;s:12:"HTML.Doctype";O:8:"stdClass":3:{s:4:"type";i:1;s:10:"allow_null";b:1;s:7:"allowed";a:5:{s:22:"HTML 4.01 Transitional";b:1;s:16:"HTML 4.01 Strict";b:1;s:22:"XHTML 1.0 Transitional";b:1;s:16:"XHTML 1.0 Strict";b:1;s:9:"XHTML 1.1";b:1;}}s:25:"HTML.FlashAllowFullScreen";i:7;s:24:"HTML.ForbiddenAttributes";i:8;s:22:"HTML.ForbiddenElements";i:8;s:10:"HTML.Forms";i:7;s:17:"HTML.MaxImgLength";i:-5;s:13:"HTML.Nofollow";i:7;s:11:"HTML.Parent";i:1;s:16:"HTML.Proprietary";i:7;s:14:"HTML.SafeEmbed";i:7;s:15:"HTML.SafeIframe";i:7;s:15:"HTML.SafeObject";i:7;s:18:"HTML.SafeScripting";i:8;s:11:"HTML.Strict";i:7;s:16:"HTML.TargetBlank";i:7;s:19:"HTML.TargetNoopener";i:7;s:21:"HTML.TargetNoreferrer";i:7;s:12:"HTML.TidyAdd";i:8;s:14:"HTML.TidyLevel";O:8:"stdClass":2:{s:4:"type";i:1;s:7:"allowed";a:4:{s:4:"none";b:1;s:5:"light";b:1;s:6:"medium";b:1;s:5:"heavy";b:1;}}s:15:"HTML.TidyRemove";i:8;s:12:"HTML.Trusted";i:7;s:10:"HTML.XHTML";i:7;s:10:"Core.XHTML";O:8:"stdClass":2:{s:3:"key";s:10:"HTML.XHTML";s:7:"isAlias";b:1;}s:28:"Output.CommentScriptContents";i:7;s:26:"Core.CommentScriptContents";O:8:"stdClass":2:{s:3:"key";s:28:"Output.CommentScriptContents";s:7:"isAlias";b:1;}s:19:"Output.FixInnerHTML";i:7;s:18:"Output.FlashCompat";i:7;s:14:"Output.Newline";i:-1;s:15:"Output.SortAttr";i:7;s:17:"Output.TidyFormat";i:7;s:15:"Core.TidyFormat";O:8:"stdClass":2:{s:3:"key";s:17:"Output.TidyFormat";s:7:"isAlias";b:1;}s:17:"Test.ForceNoIconv";i:7;s:18:"URI.AllowedSchemes";i:8;s:8:"URI.Base";i:-1;s:17:"URI.DefaultScheme";i:-1;s:16:"URI.DefinitionID";i:-1;s:17:"URI.DefinitionRev";i:5;s:11:"URI.Disable";i:7;s:15:"Attr.DisableURI";O:8:"stdClass":2:{s:3:"key";s:11:"URI.Disable";s:7:"isAlias";b:1;}s:19:"URI.DisableExternal";i:7;s:28:"URI.DisableExternalResources";i:7;s:20:"URI.DisableResources";i:7;s:8:"URI.Host";i:-1;s:17:"URI.HostBlacklist";i:9;s:16:"URI.MakeAbsolute";i:7;s:9:"URI.Munge";i:-1;s:18:"URI.MungeResources";i:7;s:18:"URI.MungeSecretKey";i:-1;s:26:"URI.OverrideAllowedSchemes";i:7;s:20:"URI.SafeIframeRegexp";i:-1;}}
\ No newline at end of file
+O:25:"HTMLPurifier_ConfigSchema":3:{s:8:"defaults";a:128:{s:19:"Attr.AllowedClasses";N;s:24:"Attr.AllowedFrameTargets";a:0:{}s:15:"Attr.AllowedRel";a:0:{}s:15:"Attr.AllowedRev";a:0:{}s:18:"Attr.ClassUseCDATA";N;s:20:"Attr.DefaultImageAlt";N;s:24:"Attr.DefaultInvalidImage";s:0:"";s:27:"Attr.DefaultInvalidImageAlt";s:13:"Invalid image";s:19:"Attr.DefaultTextDir";s:3:"ltr";s:13:"Attr.EnableID";b:0;s:21:"Attr.ForbiddenClasses";a:0:{}s:13:"Attr.ID.HTML5";N;s:16:"Attr.IDBlacklist";a:0:{}s:22:"Attr.IDBlacklistRegexp";N;s:13:"Attr.IDPrefix";s:0:"";s:18:"Attr.IDPrefixLocal";s:0:"";s:24:"AutoFormat.AutoParagraph";b:0;s:17:"AutoFormat.Custom";a:0:{}s:25:"AutoFormat.DisplayLinkURI";b:0;s:18:"AutoFormat.Linkify";b:0;s:33:"AutoFormat.PurifierLinkify.DocURL";s:3:"#%s";s:26:"AutoFormat.PurifierLinkify";b:0;s:32:"AutoFormat.RemoveEmpty.Predicate";a:4:{s:8:"colgroup";a:0:{}s:2:"th";a:0:{}s:2:"td";a:0:{}s:6:"iframe";a:1:{i:0;s:3:"src";}}s:44:"AutoFormat.RemoveEmpty.RemoveNbsp.Exceptions";a:2:{s:2:"td";b:1;s:2:"th";b:1;}s:33:"AutoFormat.RemoveEmpty.RemoveNbsp";b:0;s:22:"AutoFormat.RemoveEmpty";b:0;s:39:"AutoFormat.RemoveSpansWithoutAttributes";b:0;s:19:"CSS.AllowDuplicates";b:0;s:18:"CSS.AllowImportant";b:0;s:15:"CSS.AllowTricky";b:0;s:16:"CSS.AllowedFonts";N;s:21:"CSS.AllowedProperties";N;s:17:"CSS.DefinitionRev";i:1;s:23:"CSS.ForbiddenProperties";a:0:{}s:16:"CSS.MaxImgLength";s:6:"1200px";s:15:"CSS.Proprietary";b:0;s:11:"CSS.Trusted";b:0;s:20:"Cache.DefinitionImpl";s:10:"Serializer";s:20:"Cache.SerializerPath";N;s:27:"Cache.SerializerPermissions";i:493;s:22:"Core.AggressivelyFixLt";b:1;s:29:"Core.AggressivelyRemoveScript";b:1;s:28:"Core.AllowHostnameUnderscore";b:0;s:23:"Core.AllowParseManyTags";b:0;s:18:"Core.CollectErrors";b:0;s:18:"Core.ColorKeywords";a:148:{s:9:"aliceblue";s:7:"#F0F8FF";s:12:"antiquewhite";s:7:"#FAEBD7";s:4:"aqua";s:7:"#00FFFF";s:10:"aquamarine";s:7:"#7FFFD4";s:5:"azure";s:7:"#F0FFFF";s:5:"beige";s:7:"#F5F5DC";s:6:"bisque";s:7:"#FFE4C4";s:5:"black";s:7:"#000000";s:14:"blanchedalmond";s:7:"#FFEBCD";s:4:"blue";s:7:"#0000FF";s:10:"blueviolet";s:7:"#8A2BE2";s:5:"brown";s:7:"#A52A2A";s:9:"burlywood";s:7:"#DEB887";s:9:"cadetblue";s:7:"#5F9EA0";s:10:"chartreuse";s:7:"#7FFF00";s:9:"chocolate";s:7:"#D2691E";s:5:"coral";s:7:"#FF7F50";s:14:"cornflowerblue";s:7:"#6495ED";s:8:"cornsilk";s:7:"#FFF8DC";s:7:"crimson";s:7:"#DC143C";s:4:"cyan";s:7:"#00FFFF";s:8:"darkblue";s:7:"#00008B";s:8:"darkcyan";s:7:"#008B8B";s:13:"darkgoldenrod";s:7:"#B8860B";s:8:"darkgray";s:7:"#A9A9A9";s:8:"darkgrey";s:7:"#A9A9A9";s:9:"darkgreen";s:7:"#006400";s:9:"darkkhaki";s:7:"#BDB76B";s:11:"darkmagenta";s:7:"#8B008B";s:14:"darkolivegreen";s:7:"#556B2F";s:10:"darkorange";s:7:"#FF8C00";s:10:"darkorchid";s:7:"#9932CC";s:7:"darkred";s:7:"#8B0000";s:10:"darksalmon";s:7:"#E9967A";s:12:"darkseagreen";s:7:"#8FBC8F";s:13:"darkslateblue";s:7:"#483D8B";s:13:"darkslategray";s:7:"#2F4F4F";s:13:"darkslategrey";s:7:"#2F4F4F";s:13:"darkturquoise";s:7:"#00CED1";s:10:"darkviolet";s:7:"#9400D3";s:8:"deeppink";s:7:"#FF1493";s:11:"deepskyblue";s:7:"#00BFFF";s:7:"dimgray";s:7:"#696969";s:7:"dimgrey";s:7:"#696969";s:10:"dodgerblue";s:7:"#1E90FF";s:9:"firebrick";s:7:"#B22222";s:11:"floralwhite";s:7:"#FFFAF0";s:11:"forestgreen";s:7:"#228B22";s:7:"fuchsia";s:7:"#FF00FF";s:9:"gainsboro";s:7:"#DCDCDC";s:10:"ghostwhite";s:7:"#F8F8FF";s:4:"gold";s:7:"#FFD700";s:9:"goldenrod";s:7:"#DAA520";s:4:"gray";s:7:"#808080";s:4:"grey";s:7:"#808080";s:5:"green";s:7:"#008000";s:11:"greenyellow";s:7:"#ADFF2F";s:8:"honeydew";s:7:"#F0FFF0";s:7:"hotpink";s:7:"#FF69B4";s:9:"indianred";s:7:"#CD5C5C";s:6:"indigo";s:7:"#4B0082";s:5:"ivory";s:7:"#FFFFF0";s:5:"khaki";s:7:"#F0E68C";s:8:"lavender";s:7:"#E6E6FA";s:13:"lavenderblush";s:7:"#FFF0F5";s:9:"lawngreen";s:7:"#7CFC00";s:12:"lemonchiffon";s:7:"#FFFACD";s:9:"lightblue";s:7:"#ADD8E6";s:10:"lightcoral";s:7:"#F08080";s:9:"lightcyan";s:7:"#E0FFFF";s:20:"lightgoldenrodyellow";s:7:"#FAFAD2";s:9:"lightgray";s:7:"#D3D3D3";s:9:"lightgrey";s:7:"#D3D3D3";s:10:"lightgreen";s:7:"#90EE90";s:9:"lightpink";s:7:"#FFB6C1";s:11:"lightsalmon";s:7:"#FFA07A";s:13:"lightseagreen";s:7:"#20B2AA";s:12:"lightskyblue";s:7:"#87CEFA";s:14:"lightslategray";s:7:"#778899";s:14:"lightslategrey";s:7:"#778899";s:14:"lightsteelblue";s:7:"#B0C4DE";s:11:"lightyellow";s:7:"#FFFFE0";s:4:"lime";s:7:"#00FF00";s:9:"limegreen";s:7:"#32CD32";s:5:"linen";s:7:"#FAF0E6";s:7:"magenta";s:7:"#FF00FF";s:6:"maroon";s:7:"#800000";s:16:"mediumaquamarine";s:7:"#66CDAA";s:10:"mediumblue";s:7:"#0000CD";s:12:"mediumorchid";s:7:"#BA55D3";s:12:"mediumpurple";s:7:"#9370DB";s:14:"mediumseagreen";s:7:"#3CB371";s:15:"mediumslateblue";s:7:"#7B68EE";s:17:"mediumspringgreen";s:7:"#00FA9A";s:15:"mediumturquoise";s:7:"#48D1CC";s:15:"mediumvioletred";s:7:"#C71585";s:12:"midnightblue";s:7:"#191970";s:9:"mintcream";s:7:"#F5FFFA";s:9:"mistyrose";s:7:"#FFE4E1";s:8:"moccasin";s:7:"#FFE4B5";s:11:"navajowhite";s:7:"#FFDEAD";s:4:"navy";s:7:"#000080";s:7:"oldlace";s:7:"#FDF5E6";s:5:"olive";s:7:"#808000";s:9:"olivedrab";s:7:"#6B8E23";s:6:"orange";s:7:"#FFA500";s:9:"orangered";s:7:"#FF4500";s:6:"orchid";s:7:"#DA70D6";s:13:"palegoldenrod";s:7:"#EEE8AA";s:9:"palegreen";s:7:"#98FB98";s:13:"paleturquoise";s:7:"#AFEEEE";s:13:"palevioletred";s:7:"#DB7093";s:10:"papayawhip";s:7:"#FFEFD5";s:9:"peachpuff";s:7:"#FFDAB9";s:4:"peru";s:7:"#CD853F";s:4:"pink";s:7:"#FFC0CB";s:4:"plum";s:7:"#DDA0DD";s:10:"powderblue";s:7:"#B0E0E6";s:6:"purple";s:7:"#800080";s:13:"rebeccapurple";s:7:"#663399";s:3:"red";s:7:"#FF0000";s:9:"rosybrown";s:7:"#BC8F8F";s:9:"royalblue";s:7:"#4169E1";s:11:"saddlebrown";s:7:"#8B4513";s:6:"salmon";s:7:"#FA8072";s:10:"sandybrown";s:7:"#F4A460";s:8:"seagreen";s:7:"#2E8B57";s:8:"seashell";s:7:"#FFF5EE";s:6:"sienna";s:7:"#A0522D";s:6:"silver";s:7:"#C0C0C0";s:7:"skyblue";s:7:"#87CEEB";s:9:"slateblue";s:7:"#6A5ACD";s:9:"slategray";s:7:"#708090";s:9:"slategrey";s:7:"#708090";s:4:"snow";s:7:"#FFFAFA";s:11:"springgreen";s:7:"#00FF7F";s:9:"steelblue";s:7:"#4682B4";s:3:"tan";s:7:"#D2B48C";s:4:"teal";s:7:"#008080";s:7:"thistle";s:7:"#D8BFD8";s:6:"tomato";s:7:"#FF6347";s:9:"turquoise";s:7:"#40E0D0";s:6:"violet";s:7:"#EE82EE";s:5:"wheat";s:7:"#F5DEB3";s:5:"white";s:7:"#FFFFFF";s:10:"whitesmoke";s:7:"#F5F5F5";s:6:"yellow";s:7:"#FFFF00";s:11:"yellowgreen";s:7:"#9ACD32";}s:30:"Core.ConvertDocumentToFragment";b:1;s:36:"Core.DirectLexLineNumberSyncInterval";i:0;s:20:"Core.DisableExcludes";b:0;s:15:"Core.EnableIDNA";b:0;s:13:"Core.Encoding";s:5:"utf-8";s:26:"Core.EscapeInvalidChildren";b:0;s:22:"Core.EscapeInvalidTags";b:0;s:29:"Core.EscapeNonASCIICharacters";b:0;s:19:"Core.HiddenElements";a:2:{s:6:"script";b:1;s:5:"style";b:1;}s:13:"Core.Language";s:2:"en";s:24:"Core.LegacyEntityDecoder";b:0;s:14:"Core.LexerImpl";N;s:24:"Core.MaintainLineNumbers";N;s:22:"Core.NormalizeNewlines";b:1;s:17:"Core.RemoveBlanks";b:0;s:21:"Core.RemoveInvalidImg";b:1;s:33:"Core.RemoveProcessingInstructions";b:0;s:25:"Core.RemoveScriptContents";N;s:13:"Filter.Custom";a:0:{}s:34:"Filter.ExtractStyleBlocks.Escaping";b:1;s:31:"Filter.ExtractStyleBlocks.Scope";N;s:34:"Filter.ExtractStyleBlocks.TidyImpl";N;s:25:"Filter.ExtractStyleBlocks";b:0;s:14:"Filter.YouTube";b:0;s:12:"HTML.Allowed";N;s:22:"HTML.AllowedAttributes";N;s:20:"HTML.AllowedComments";a:0:{}s:26:"HTML.AllowedCommentsRegexp";N;s:20:"HTML.AllowedElements";N;s:19:"HTML.AllowedModules";N;s:23:"HTML.Attr.Name.UseCDATA";b:0;s:17:"HTML.BlockWrapper";s:1:"p";s:16:"HTML.CoreModules";a:7:{s:9:"Structure";b:1;s:4:"Text";b:1;s:9:"Hypertext";b:1;s:4:"List";b:1;s:22:"NonXMLCommonAttributes";b:1;s:19:"XMLCommonAttributes";b:1;s:16:"CommonAttributes";b:1;}s:18:"HTML.CustomDoctype";N;s:17:"HTML.DefinitionID";N;s:18:"HTML.DefinitionRev";i:1;s:12:"HTML.Doctype";N;s:25:"HTML.FlashAllowFullScreen";b:0;s:24:"HTML.ForbiddenAttributes";a:0:{}s:22:"HTML.ForbiddenElements";a:0:{}s:10:"HTML.Forms";b:0;s:17:"HTML.MaxImgLength";i:1200;s:13:"HTML.Nofollow";b:0;s:11:"HTML.Parent";s:3:"div";s:16:"HTML.Proprietary";b:0;s:14:"HTML.SafeEmbed";b:0;s:15:"HTML.SafeIframe";b:0;s:15:"HTML.SafeObject";b:0;s:18:"HTML.SafeScripting";a:0:{}s:11:"HTML.Strict";b:0;s:16:"HTML.TargetBlank";b:0;s:19:"HTML.TargetNoopener";b:1;s:21:"HTML.TargetNoreferrer";b:1;s:12:"HTML.TidyAdd";a:0:{}s:14:"HTML.TidyLevel";s:6:"medium";s:15:"HTML.TidyRemove";a:0:{}s:12:"HTML.Trusted";b:0;s:10:"HTML.XHTML";b:1;s:28:"Output.CommentScriptContents";b:1;s:19:"Output.FixInnerHTML";b:1;s:18:"Output.FlashCompat";b:0;s:14:"Output.Newline";N;s:15:"Output.SortAttr";b:0;s:17:"Output.TidyFormat";b:0;s:17:"Test.ForceNoIconv";b:0;s:18:"URI.AllowedSchemes";a:7:{s:4:"http";b:1;s:5:"https";b:1;s:6:"mailto";b:1;s:3:"ftp";b:1;s:4:"nntp";b:1;s:4:"news";b:1;s:3:"tel";b:1;}s:8:"URI.Base";N;s:17:"URI.DefaultScheme";s:4:"http";s:16:"URI.DefinitionID";N;s:17:"URI.DefinitionRev";i:1;s:11:"URI.Disable";b:0;s:19:"URI.DisableExternal";b:0;s:28:"URI.DisableExternalResources";b:0;s:20:"URI.DisableResources";b:0;s:8:"URI.Host";N;s:17:"URI.HostBlacklist";a:0:{}s:16:"URI.MakeAbsolute";b:0;s:9:"URI.Munge";N;s:18:"URI.MungeResources";b:0;s:18:"URI.MungeSecretKey";N;s:26:"URI.OverrideAllowedSchemes";b:1;s:20:"URI.SafeIframeRegexp";N;}s:12:"defaultPlist";O:25:"HTMLPurifier_PropertyList":3:{s:7:" * data";a:128:{s:19:"Attr.AllowedClasses";N;s:24:"Attr.AllowedFrameTargets";a:0:{}s:15:"Attr.AllowedRel";a:0:{}s:15:"Attr.AllowedRev";a:0:{}s:18:"Attr.ClassUseCDATA";N;s:20:"Attr.DefaultImageAlt";N;s:24:"Attr.DefaultInvalidImage";s:0:"";s:27:"Attr.DefaultInvalidImageAlt";s:13:"Invalid image";s:19:"Attr.DefaultTextDir";s:3:"ltr";s:13:"Attr.EnableID";b:0;s:21:"Attr.ForbiddenClasses";a:0:{}s:13:"Attr.ID.HTML5";N;s:16:"Attr.IDBlacklist";a:0:{}s:22:"Attr.IDBlacklistRegexp";N;s:13:"Attr.IDPrefix";s:0:"";s:18:"Attr.IDPrefixLocal";s:0:"";s:24:"AutoFormat.AutoParagraph";b:0;s:17:"AutoFormat.Custom";a:0:{}s:25:"AutoFormat.DisplayLinkURI";b:0;s:18:"AutoFormat.Linkify";b:0;s:33:"AutoFormat.PurifierLinkify.DocURL";s:3:"#%s";s:26:"AutoFormat.PurifierLinkify";b:0;s:32:"AutoFormat.RemoveEmpty.Predicate";a:4:{s:8:"colgroup";a:0:{}s:2:"th";a:0:{}s:2:"td";a:0:{}s:6:"iframe";a:1:{i:0;s:3:"src";}}s:44:"AutoFormat.RemoveEmpty.RemoveNbsp.Exceptions";a:2:{s:2:"td";b:1;s:2:"th";b:1;}s:33:"AutoFormat.RemoveEmpty.RemoveNbsp";b:0;s:22:"AutoFormat.RemoveEmpty";b:0;s:39:"AutoFormat.RemoveSpansWithoutAttributes";b:0;s:19:"CSS.AllowDuplicates";b:0;s:18:"CSS.AllowImportant";b:0;s:15:"CSS.AllowTricky";b:0;s:16:"CSS.AllowedFonts";N;s:21:"CSS.AllowedProperties";N;s:17:"CSS.DefinitionRev";i:1;s:23:"CSS.ForbiddenProperties";a:0:{}s:16:"CSS.MaxImgLength";s:6:"1200px";s:15:"CSS.Proprietary";b:0;s:11:"CSS.Trusted";b:0;s:20:"Cache.DefinitionImpl";s:10:"Serializer";s:20:"Cache.SerializerPath";N;s:27:"Cache.SerializerPermissions";i:493;s:22:"Core.AggressivelyFixLt";b:1;s:29:"Core.AggressivelyRemoveScript";b:1;s:28:"Core.AllowHostnameUnderscore";b:0;s:23:"Core.AllowParseManyTags";b:0;s:18:"Core.CollectErrors";b:0;s:18:"Core.ColorKeywords";a:148:{s:9:"aliceblue";s:7:"#F0F8FF";s:12:"antiquewhite";s:7:"#FAEBD7";s:4:"aqua";s:7:"#00FFFF";s:10:"aquamarine";s:7:"#7FFFD4";s:5:"azure";s:7:"#F0FFFF";s:5:"beige";s:7:"#F5F5DC";s:6:"bisque";s:7:"#FFE4C4";s:5:"black";s:7:"#000000";s:14:"blanchedalmond";s:7:"#FFEBCD";s:4:"blue";s:7:"#0000FF";s:10:"blueviolet";s:7:"#8A2BE2";s:5:"brown";s:7:"#A52A2A";s:9:"burlywood";s:7:"#DEB887";s:9:"cadetblue";s:7:"#5F9EA0";s:10:"chartreuse";s:7:"#7FFF00";s:9:"chocolate";s:7:"#D2691E";s:5:"coral";s:7:"#FF7F50";s:14:"cornflowerblue";s:7:"#6495ED";s:8:"cornsilk";s:7:"#FFF8DC";s:7:"crimson";s:7:"#DC143C";s:4:"cyan";s:7:"#00FFFF";s:8:"darkblue";s:7:"#00008B";s:8:"darkcyan";s:7:"#008B8B";s:13:"darkgoldenrod";s:7:"#B8860B";s:8:"darkgray";s:7:"#A9A9A9";s:8:"darkgrey";s:7:"#A9A9A9";s:9:"darkgreen";s:7:"#006400";s:9:"darkkhaki";s:7:"#BDB76B";s:11:"darkmagenta";s:7:"#8B008B";s:14:"darkolivegreen";s:7:"#556B2F";s:10:"darkorange";s:7:"#FF8C00";s:10:"darkorchid";s:7:"#9932CC";s:7:"darkred";s:7:"#8B0000";s:10:"darksalmon";s:7:"#E9967A";s:12:"darkseagreen";s:7:"#8FBC8F";s:13:"darkslateblue";s:7:"#483D8B";s:13:"darkslategray";s:7:"#2F4F4F";s:13:"darkslategrey";s:7:"#2F4F4F";s:13:"darkturquoise";s:7:"#00CED1";s:10:"darkviolet";s:7:"#9400D3";s:8:"deeppink";s:7:"#FF1493";s:11:"deepskyblue";s:7:"#00BFFF";s:7:"dimgray";s:7:"#696969";s:7:"dimgrey";s:7:"#696969";s:10:"dodgerblue";s:7:"#1E90FF";s:9:"firebrick";s:7:"#B22222";s:11:"floralwhite";s:7:"#FFFAF0";s:11:"forestgreen";s:7:"#228B22";s:7:"fuchsia";s:7:"#FF00FF";s:9:"gainsboro";s:7:"#DCDCDC";s:10:"ghostwhite";s:7:"#F8F8FF";s:4:"gold";s:7:"#FFD700";s:9:"goldenrod";s:7:"#DAA520";s:4:"gray";s:7:"#808080";s:4:"grey";s:7:"#808080";s:5:"green";s:7:"#008000";s:11:"greenyellow";s:7:"#ADFF2F";s:8:"honeydew";s:7:"#F0FFF0";s:7:"hotpink";s:7:"#FF69B4";s:9:"indianred";s:7:"#CD5C5C";s:6:"indigo";s:7:"#4B0082";s:5:"ivory";s:7:"#FFFFF0";s:5:"khaki";s:7:"#F0E68C";s:8:"lavender";s:7:"#E6E6FA";s:13:"lavenderblush";s:7:"#FFF0F5";s:9:"lawngreen";s:7:"#7CFC00";s:12:"lemonchiffon";s:7:"#FFFACD";s:9:"lightblue";s:7:"#ADD8E6";s:10:"lightcoral";s:7:"#F08080";s:9:"lightcyan";s:7:"#E0FFFF";s:20:"lightgoldenrodyellow";s:7:"#FAFAD2";s:9:"lightgray";s:7:"#D3D3D3";s:9:"lightgrey";s:7:"#D3D3D3";s:10:"lightgreen";s:7:"#90EE90";s:9:"lightpink";s:7:"#FFB6C1";s:11:"lightsalmon";s:7:"#FFA07A";s:13:"lightseagreen";s:7:"#20B2AA";s:12:"lightskyblue";s:7:"#87CEFA";s:14:"lightslategray";s:7:"#778899";s:14:"lightslategrey";s:7:"#778899";s:14:"lightsteelblue";s:7:"#B0C4DE";s:11:"lightyellow";s:7:"#FFFFE0";s:4:"lime";s:7:"#00FF00";s:9:"limegreen";s:7:"#32CD32";s:5:"linen";s:7:"#FAF0E6";s:7:"magenta";s:7:"#FF00FF";s:6:"maroon";s:7:"#800000";s:16:"mediumaquamarine";s:7:"#66CDAA";s:10:"mediumblue";s:7:"#0000CD";s:12:"mediumorchid";s:7:"#BA55D3";s:12:"mediumpurple";s:7:"#9370DB";s:14:"mediumseagreen";s:7:"#3CB371";s:15:"mediumslateblue";s:7:"#7B68EE";s:17:"mediumspringgreen";s:7:"#00FA9A";s:15:"mediumturquoise";s:7:"#48D1CC";s:15:"mediumvioletred";s:7:"#C71585";s:12:"midnightblue";s:7:"#191970";s:9:"mintcream";s:7:"#F5FFFA";s:9:"mistyrose";s:7:"#FFE4E1";s:8:"moccasin";s:7:"#FFE4B5";s:11:"navajowhite";s:7:"#FFDEAD";s:4:"navy";s:7:"#000080";s:7:"oldlace";s:7:"#FDF5E6";s:5:"olive";s:7:"#808000";s:9:"olivedrab";s:7:"#6B8E23";s:6:"orange";s:7:"#FFA500";s:9:"orangered";s:7:"#FF4500";s:6:"orchid";s:7:"#DA70D6";s:13:"palegoldenrod";s:7:"#EEE8AA";s:9:"palegreen";s:7:"#98FB98";s:13:"paleturquoise";s:7:"#AFEEEE";s:13:"palevioletred";s:7:"#DB7093";s:10:"papayawhip";s:7:"#FFEFD5";s:9:"peachpuff";s:7:"#FFDAB9";s:4:"peru";s:7:"#CD853F";s:4:"pink";s:7:"#FFC0CB";s:4:"plum";s:7:"#DDA0DD";s:10:"powderblue";s:7:"#B0E0E6";s:6:"purple";s:7:"#800080";s:13:"rebeccapurple";s:7:"#663399";s:3:"red";s:7:"#FF0000";s:9:"rosybrown";s:7:"#BC8F8F";s:9:"royalblue";s:7:"#4169E1";s:11:"saddlebrown";s:7:"#8B4513";s:6:"salmon";s:7:"#FA8072";s:10:"sandybrown";s:7:"#F4A460";s:8:"seagreen";s:7:"#2E8B57";s:8:"seashell";s:7:"#FFF5EE";s:6:"sienna";s:7:"#A0522D";s:6:"silver";s:7:"#C0C0C0";s:7:"skyblue";s:7:"#87CEEB";s:9:"slateblue";s:7:"#6A5ACD";s:9:"slategray";s:7:"#708090";s:9:"slategrey";s:7:"#708090";s:4:"snow";s:7:"#FFFAFA";s:11:"springgreen";s:7:"#00FF7F";s:9:"steelblue";s:7:"#4682B4";s:3:"tan";s:7:"#D2B48C";s:4:"teal";s:7:"#008080";s:7:"thistle";s:7:"#D8BFD8";s:6:"tomato";s:7:"#FF6347";s:9:"turquoise";s:7:"#40E0D0";s:6:"violet";s:7:"#EE82EE";s:5:"wheat";s:7:"#F5DEB3";s:5:"white";s:7:"#FFFFFF";s:10:"whitesmoke";s:7:"#F5F5F5";s:6:"yellow";s:7:"#FFFF00";s:11:"yellowgreen";s:7:"#9ACD32";}s:30:"Core.ConvertDocumentToFragment";b:1;s:36:"Core.DirectLexLineNumberSyncInterval";i:0;s:20:"Core.DisableExcludes";b:0;s:15:"Core.EnableIDNA";b:0;s:13:"Core.Encoding";s:5:"utf-8";s:26:"Core.EscapeInvalidChildren";b:0;s:22:"Core.EscapeInvalidTags";b:0;s:29:"Core.EscapeNonASCIICharacters";b:0;s:19:"Core.HiddenElements";a:2:{s:6:"script";b:1;s:5:"style";b:1;}s:13:"Core.Language";s:2:"en";s:24:"Core.LegacyEntityDecoder";b:0;s:14:"Core.LexerImpl";N;s:24:"Core.MaintainLineNumbers";N;s:22:"Core.NormalizeNewlines";b:1;s:17:"Core.RemoveBlanks";b:0;s:21:"Core.RemoveInvalidImg";b:1;s:33:"Core.RemoveProcessingInstructions";b:0;s:25:"Core.RemoveScriptContents";N;s:13:"Filter.Custom";a:0:{}s:34:"Filter.ExtractStyleBlocks.Escaping";b:1;s:31:"Filter.ExtractStyleBlocks.Scope";N;s:34:"Filter.ExtractStyleBlocks.TidyImpl";N;s:25:"Filter.ExtractStyleBlocks";b:0;s:14:"Filter.YouTube";b:0;s:12:"HTML.Allowed";N;s:22:"HTML.AllowedAttributes";N;s:20:"HTML.AllowedComments";a:0:{}s:26:"HTML.AllowedCommentsRegexp";N;s:20:"HTML.AllowedElements";N;s:19:"HTML.AllowedModules";N;s:23:"HTML.Attr.Name.UseCDATA";b:0;s:17:"HTML.BlockWrapper";s:1:"p";s:16:"HTML.CoreModules";a:7:{s:9:"Structure";b:1;s:4:"Text";b:1;s:9:"Hypertext";b:1;s:4:"List";b:1;s:22:"NonXMLCommonAttributes";b:1;s:19:"XMLCommonAttributes";b:1;s:16:"CommonAttributes";b:1;}s:18:"HTML.CustomDoctype";N;s:17:"HTML.DefinitionID";N;s:18:"HTML.DefinitionRev";i:1;s:12:"HTML.Doctype";N;s:25:"HTML.FlashAllowFullScreen";b:0;s:24:"HTML.ForbiddenAttributes";a:0:{}s:22:"HTML.ForbiddenElements";a:0:{}s:10:"HTML.Forms";b:0;s:17:"HTML.MaxImgLength";i:1200;s:13:"HTML.Nofollow";b:0;s:11:"HTML.Parent";s:3:"div";s:16:"HTML.Proprietary";b:0;s:14:"HTML.SafeEmbed";b:0;s:15:"HTML.SafeIframe";b:0;s:15:"HTML.SafeObject";b:0;s:18:"HTML.SafeScripting";a:0:{}s:11:"HTML.Strict";b:0;s:16:"HTML.TargetBlank";b:0;s:19:"HTML.TargetNoopener";b:1;s:21:"HTML.TargetNoreferrer";b:1;s:12:"HTML.TidyAdd";a:0:{}s:14:"HTML.TidyLevel";s:6:"medium";s:15:"HTML.TidyRemove";a:0:{}s:12:"HTML.Trusted";b:0;s:10:"HTML.XHTML";b:1;s:28:"Output.CommentScriptContents";b:1;s:19:"Output.FixInnerHTML";b:1;s:18:"Output.FlashCompat";b:0;s:14:"Output.Newline";N;s:15:"Output.SortAttr";b:0;s:17:"Output.TidyFormat";b:0;s:17:"Test.ForceNoIconv";b:0;s:18:"URI.AllowedSchemes";a:7:{s:4:"http";b:1;s:5:"https";b:1;s:6:"mailto";b:1;s:3:"ftp";b:1;s:4:"nntp";b:1;s:4:"news";b:1;s:3:"tel";b:1;}s:8:"URI.Base";N;s:17:"URI.DefaultScheme";s:4:"http";s:16:"URI.DefinitionID";N;s:17:"URI.DefinitionRev";i:1;s:11:"URI.Disable";b:0;s:19:"URI.DisableExternal";b:0;s:28:"URI.DisableExternalResources";b:0;s:20:"URI.DisableResources";b:0;s:8:"URI.Host";N;s:17:"URI.HostBlacklist";a:0:{}s:16:"URI.MakeAbsolute";b:0;s:9:"URI.Munge";N;s:18:"URI.MungeResources";b:0;s:18:"URI.MungeSecretKey";N;s:26:"URI.OverrideAllowedSchemes";b:1;s:20:"URI.SafeIframeRegexp";N;}s:9:" * parent";N;s:8:" * cache";N;}s:4:"info";a:141:{s:19:"Attr.AllowedClasses";i:-8;s:24:"Attr.AllowedFrameTargets";i:8;s:15:"Attr.AllowedRel";i:8;s:15:"Attr.AllowedRev";i:8;s:18:"Attr.ClassUseCDATA";i:-7;s:20:"Attr.DefaultImageAlt";i:-1;s:24:"Attr.DefaultInvalidImage";i:1;s:27:"Attr.DefaultInvalidImageAlt";i:1;s:19:"Attr.DefaultTextDir";O:8:"stdClass":2:{s:4:"type";i:1;s:7:"allowed";a:2:{s:3:"ltr";b:1;s:3:"rtl";b:1;}}s:13:"Attr.EnableID";i:7;s:17:"HTML.EnableAttrID";O:8:"stdClass":2:{s:3:"key";s:13:"Attr.EnableID";s:7:"isAlias";b:1;}s:21:"Attr.ForbiddenClasses";i:8;s:13:"Attr.ID.HTML5";i:-7;s:16:"Attr.IDBlacklist";i:9;s:22:"Attr.IDBlacklistRegexp";i:-1;s:13:"Attr.IDPrefix";i:1;s:18:"Attr.IDPrefixLocal";i:1;s:24:"AutoFormat.AutoParagraph";i:7;s:17:"AutoFormat.Custom";i:9;s:25:"AutoFormat.DisplayLinkURI";i:7;s:18:"AutoFormat.Linkify";i:7;s:33:"AutoFormat.PurifierLinkify.DocURL";i:1;s:37:"AutoFormatParam.PurifierLinkifyDocURL";O:8:"stdClass":2:{s:3:"key";s:33:"AutoFormat.PurifierLinkify.DocURL";s:7:"isAlias";b:1;}s:26:"AutoFormat.PurifierLinkify";i:7;s:32:"AutoFormat.RemoveEmpty.Predicate";i:10;s:44:"AutoFormat.RemoveEmpty.RemoveNbsp.Exceptions";i:8;s:33:"AutoFormat.RemoveEmpty.RemoveNbsp";i:7;s:22:"AutoFormat.RemoveEmpty";i:7;s:39:"AutoFormat.RemoveSpansWithoutAttributes";i:7;s:19:"CSS.AllowDuplicates";i:7;s:18:"CSS.AllowImportant";i:7;s:15:"CSS.AllowTricky";i:7;s:16:"CSS.AllowedFonts";i:-8;s:21:"CSS.AllowedProperties";i:-8;s:17:"CSS.DefinitionRev";i:5;s:23:"CSS.ForbiddenProperties";i:8;s:16:"CSS.MaxImgLength";i:-1;s:15:"CSS.Proprietary";i:7;s:11:"CSS.Trusted";i:7;s:20:"Cache.DefinitionImpl";i:-1;s:20:"Core.DefinitionCache";O:8:"stdClass":2:{s:3:"key";s:20:"Cache.DefinitionImpl";s:7:"isAlias";b:1;}s:20:"Cache.SerializerPath";i:-1;s:27:"Cache.SerializerPermissions";i:-5;s:22:"Core.AggressivelyFixLt";i:7;s:29:"Core.AggressivelyRemoveScript";i:7;s:28:"Core.AllowHostnameUnderscore";i:7;s:23:"Core.AllowParseManyTags";i:7;s:18:"Core.CollectErrors";i:7;s:18:"Core.ColorKeywords";i:10;s:30:"Core.ConvertDocumentToFragment";i:7;s:24:"Core.AcceptFullDocuments";O:8:"stdClass":2:{s:3:"key";s:30:"Core.ConvertDocumentToFragment";s:7:"isAlias";b:1;}s:36:"Core.DirectLexLineNumberSyncInterval";i:5;s:20:"Core.DisableExcludes";i:7;s:15:"Core.EnableIDNA";i:7;s:13:"Core.Encoding";i:2;s:26:"Core.EscapeInvalidChildren";i:7;s:22:"Core.EscapeInvalidTags";i:7;s:29:"Core.EscapeNonASCIICharacters";i:7;s:19:"Core.HiddenElements";i:8;s:13:"Core.Language";i:1;s:24:"Core.LegacyEntityDecoder";i:7;s:14:"Core.LexerImpl";i:-11;s:24:"Core.MaintainLineNumbers";i:-7;s:22:"Core.NormalizeNewlines";i:7;s:17:"Core.RemoveBlanks";i:7;s:21:"Core.RemoveInvalidImg";i:7;s:33:"Core.RemoveProcessingInstructions";i:7;s:25:"Core.RemoveScriptContents";i:-7;s:13:"Filter.Custom";i:9;s:34:"Filter.ExtractStyleBlocks.Escaping";i:7;s:33:"Filter.ExtractStyleBlocksEscaping";O:8:"stdClass":2:{s:3:"key";s:34:"Filter.ExtractStyleBlocks.Escaping";s:7:"isAlias";b:1;}s:38:"FilterParam.ExtractStyleBlocksEscaping";O:8:"stdClass":2:{s:3:"key";s:34:"Filter.ExtractStyleBlocks.Escaping";s:7:"isAlias";b:1;}s:31:"Filter.ExtractStyleBlocks.Scope";i:-1;s:30:"Filter.ExtractStyleBlocksScope";O:8:"stdClass":2:{s:3:"key";s:31:"Filter.ExtractStyleBlocks.Scope";s:7:"isAlias";b:1;}s:35:"FilterParam.ExtractStyleBlocksScope";O:8:"stdClass":2:{s:3:"key";s:31:"Filter.ExtractStyleBlocks.Scope";s:7:"isAlias";b:1;}s:34:"Filter.ExtractStyleBlocks.TidyImpl";i:-11;s:38:"FilterParam.ExtractStyleBlocksTidyImpl";O:8:"stdClass":2:{s:3:"key";s:34:"Filter.ExtractStyleBlocks.TidyImpl";s:7:"isAlias";b:1;}s:25:"Filter.ExtractStyleBlocks";i:7;s:14:"Filter.YouTube";i:7;s:12:"HTML.Allowed";i:-4;s:22:"HTML.AllowedAttributes";i:-8;s:20:"HTML.AllowedComments";i:8;s:26:"HTML.AllowedCommentsRegexp";i:-1;s:20:"HTML.AllowedElements";i:-8;s:19:"HTML.AllowedModules";i:-8;s:23:"HTML.Attr.Name.UseCDATA";i:7;s:17:"HTML.BlockWrapper";i:1;s:16:"HTML.CoreModules";i:8;s:18:"HTML.CustomDoctype";i:-1;s:17:"HTML.DefinitionID";i:-1;s:18:"HTML.DefinitionRev";i:5;s:12:"HTML.Doctype";O:8:"stdClass":3:{s:4:"type";i:1;s:10:"allow_null";b:1;s:7:"allowed";a:5:{s:22:"HTML 4.01 Transitional";b:1;s:16:"HTML 4.01 Strict";b:1;s:22:"XHTML 1.0 Transitional";b:1;s:16:"XHTML 1.0 Strict";b:1;s:9:"XHTML 1.1";b:1;}}s:25:"HTML.FlashAllowFullScreen";i:7;s:24:"HTML.ForbiddenAttributes";i:8;s:22:"HTML.ForbiddenElements";i:8;s:10:"HTML.Forms";i:7;s:17:"HTML.MaxImgLength";i:-5;s:13:"HTML.Nofollow";i:7;s:11:"HTML.Parent";i:1;s:16:"HTML.Proprietary";i:7;s:14:"HTML.SafeEmbed";i:7;s:15:"HTML.SafeIframe";i:7;s:15:"HTML.SafeObject";i:7;s:18:"HTML.SafeScripting";i:8;s:11:"HTML.Strict";i:7;s:16:"HTML.TargetBlank";i:7;s:19:"HTML.TargetNoopener";i:7;s:21:"HTML.TargetNoreferrer";i:7;s:12:"HTML.TidyAdd";i:8;s:14:"HTML.TidyLevel";O:8:"stdClass":2:{s:4:"type";i:1;s:7:"allowed";a:4:{s:4:"none";b:1;s:5:"light";b:1;s:6:"medium";b:1;s:5:"heavy";b:1;}}s:15:"HTML.TidyRemove";i:8;s:12:"HTML.Trusted";i:7;s:10:"HTML.XHTML";i:7;s:10:"Core.XHTML";O:8:"stdClass":2:{s:3:"key";s:10:"HTML.XHTML";s:7:"isAlias";b:1;}s:28:"Output.CommentScriptContents";i:7;s:26:"Core.CommentScriptContents";O:8:"stdClass":2:{s:3:"key";s:28:"Output.CommentScriptContents";s:7:"isAlias";b:1;}s:19:"Output.FixInnerHTML";i:7;s:18:"Output.FlashCompat";i:7;s:14:"Output.Newline";i:-1;s:15:"Output.SortAttr";i:7;s:17:"Output.TidyFormat";i:7;s:15:"Core.TidyFormat";O:8:"stdClass":2:{s:3:"key";s:17:"Output.TidyFormat";s:7:"isAlias";b:1;}s:17:"Test.ForceNoIconv";i:7;s:18:"URI.AllowedSchemes";i:8;s:8:"URI.Base";i:-1;s:17:"URI.DefaultScheme";i:-1;s:16:"URI.DefinitionID";i:-1;s:17:"URI.DefinitionRev";i:5;s:11:"URI.Disable";i:7;s:15:"Attr.DisableURI";O:8:"stdClass":2:{s:3:"key";s:11:"URI.Disable";s:7:"isAlias";b:1;}s:19:"URI.DisableExternal";i:7;s:28:"URI.DisableExternalResources";i:7;s:20:"URI.DisableResources";i:7;s:8:"URI.Host";i:-1;s:17:"URI.HostBlacklist";i:9;s:16:"URI.MakeAbsolute";i:7;s:9:"URI.Munge";i:-1;s:18:"URI.MungeResources";i:7;s:18:"URI.MungeSecretKey";i:-1;s:26:"URI.OverrideAllowedSchemes";i:7;s:20:"URI.SafeIframeRegexp";i:-1;}}
\ No newline at end of file
diff --git a/tools/htmlpurifier/HTMLPurifier/ConfigSchema/schema/Core.RemoveBlanks.txt b/tools/htmlpurifier/HTMLPurifier/ConfigSchema/schema/Core.RemoveBlanks.txt
new file mode 100644
index 000000000..95e5285ca
--- /dev/null
+++ b/tools/htmlpurifier/HTMLPurifier/ConfigSchema/schema/Core.RemoveBlanks.txt
@@ -0,0 +1,10 @@
+Core.RemoveBlanks
+TYPE: bool
+DEFAULT: false
+VERSION: 4.18
+--DESCRIPTION--
+
+ If set to true, blank nodes will be removed. This can be useful for maintaining
+ backwards compatibility when upgrading from previous versions of PHP.
+
+--# vim: et sw=4 sts=4
diff --git a/tools/htmlpurifier/HTMLPurifier/ConfigSchema/schema/index.php b/tools/htmlpurifier/HTMLPurifier/ConfigSchema/schema/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/ConfigSchema/schema/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/DefinitionCache/Decorator/index.php b/tools/htmlpurifier/HTMLPurifier/DefinitionCache/Decorator/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/DefinitionCache/Decorator/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/DefinitionCache/Serializer.php b/tools/htmlpurifier/HTMLPurifier/DefinitionCache/Serializer.php
index b82c6bb20..bfad967fb 100644
--- a/tools/htmlpurifier/HTMLPurifier/DefinitionCache/Serializer.php
+++ b/tools/htmlpurifier/HTMLPurifier/DefinitionCache/Serializer.php
@@ -287,13 +287,14 @@ class HTMLPurifier_DefinitionCache_Serializer extends HTMLPurifier_DefinitionCac
} elseif (filegroup($dir) === posix_getgid()) {
$chmod = $chmod | 0070;
} else {
- // PHP's probably running as nobody, so we'll
- // need to give global permissions
- $chmod = $chmod | 0777;
+ // PHP's probably running as nobody, it is
+ // not obvious how to fix this (777 is probably
+ // bad if you are multi-user), let the user figure it out
+ $chmod = null;
}
trigger_error(
- 'Directory ' . $dir . ' not writable, ' .
- 'please chmod to ' . decoct($chmod),
+ 'Directory ' . $dir . ' not writable. ' .
+ ($chmod === null ? '' : 'Please chmod to ' . decoct($chmod)),
E_USER_WARNING
);
} else {
diff --git a/tools/htmlpurifier/HTMLPurifier/DefinitionCache/Serializer/index.php b/tools/htmlpurifier/HTMLPurifier/DefinitionCache/Serializer/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/DefinitionCache/Serializer/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/DefinitionCache/index.php b/tools/htmlpurifier/HTMLPurifier/DefinitionCache/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/DefinitionCache/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/DefinitionCacheFactory.php b/tools/htmlpurifier/HTMLPurifier/DefinitionCacheFactory.php
index fd1cc9be4..3a0f4616a 100644
--- a/tools/htmlpurifier/HTMLPurifier/DefinitionCacheFactory.php
+++ b/tools/htmlpurifier/HTMLPurifier/DefinitionCacheFactory.php
@@ -71,7 +71,7 @@ class HTMLPurifier_DefinitionCacheFactory
return $this->caches[$method][$type];
}
if (isset($this->implementations[$method]) &&
- class_exists($class = $this->implementations[$method], false)) {
+ class_exists($class = $this->implementations[$method])) {
$cache = new $class($type);
} else {
if ($method != 'Serializer') {
diff --git a/tools/htmlpurifier/HTMLPurifier/ElementDef.php b/tools/htmlpurifier/HTMLPurifier/ElementDef.php
index d5311cedc..57cfd2bb0 100644
--- a/tools/htmlpurifier/HTMLPurifier/ElementDef.php
+++ b/tools/htmlpurifier/HTMLPurifier/ElementDef.php
@@ -176,7 +176,7 @@ class HTMLPurifier_ElementDef
if (!empty($def->content_model)) {
$this->content_model =
- str_replace("#SUPER", $this->content_model, $def->content_model);
+ str_replace("#SUPER", (string)$this->content_model, $def->content_model);
$this->child = false;
}
if (!empty($def->content_model_type)) {
diff --git a/tools/htmlpurifier/HTMLPurifier/Encoder.php b/tools/htmlpurifier/HTMLPurifier/Encoder.php
index 40a24266a..d4791cc1b 100644
--- a/tools/htmlpurifier/HTMLPurifier/Encoder.php
+++ b/tools/htmlpurifier/HTMLPurifier/Encoder.php
@@ -398,8 +398,8 @@ class HTMLPurifier_Encoder
// characters to their true byte-wise ASCII/UTF-8 equivalents.
$str = strtr($str, self::testEncodingSupportsASCII($encoding));
return $str;
- } elseif ($encoding === 'iso-8859-1') {
- $str = utf8_encode($str);
+ } elseif ($encoding === 'iso-8859-1' && function_exists('mb_convert_encoding')) {
+ $str = mb_convert_encoding($str, 'UTF-8', 'ISO-8859-1');
return $str;
}
$bug = HTMLPurifier_Encoder::testIconvTruncateBug();
@@ -450,8 +450,8 @@ class HTMLPurifier_Encoder
// Normal stuff
$str = self::iconv('utf-8', $encoding . '//IGNORE', $str);
return $str;
- } elseif ($encoding === 'iso-8859-1') {
- $str = utf8_decode($str);
+ } elseif ($encoding === 'iso-8859-1' && function_exists('mb_convert_encoding')) {
+ $str = mb_convert_encoding($str, 'ISO-8859-1', 'UTF-8');
return $str;
}
trigger_error('Encoding not supported', E_USER_ERROR);
diff --git a/tools/htmlpurifier/HTMLPurifier/EntityLookup/index.php b/tools/htmlpurifier/HTMLPurifier/EntityLookup/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/EntityLookup/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/EntityParser.php b/tools/htmlpurifier/HTMLPurifier/EntityParser.php
index 3ef2d09ec..0f2b83dc8 100644
--- a/tools/htmlpurifier/HTMLPurifier/EntityParser.php
+++ b/tools/htmlpurifier/HTMLPurifier/EntityParser.php
@@ -116,8 +116,8 @@ class HTMLPurifier_EntityParser
protected function entityCallback($matches)
{
$entity = $matches[0];
- $hex_part = @$matches[1];
- $dec_part = @$matches[2];
+ $hex_part = isset($matches[1]) ? $matches[1] : null;
+ $dec_part = isset($matches[2]) ? $matches[2] : null;
$named_part = empty($matches[3]) ? (empty($matches[4]) ? "" : $matches[4]) : $matches[3];
if ($hex_part !== NULL && $hex_part !== "") {
return HTMLPurifier_Encoder::unichr(hexdec($hex_part));
diff --git a/tools/htmlpurifier/HTMLPurifier/Filter/ExtractStyleBlocks.php b/tools/htmlpurifier/HTMLPurifier/Filter/ExtractStyleBlocks.php
index 66f70b0fc..e7e3cac1a 100644
--- a/tools/htmlpurifier/HTMLPurifier/Filter/ExtractStyleBlocks.php
+++ b/tools/htmlpurifier/HTMLPurifier/Filter/ExtractStyleBlocks.php
@@ -54,6 +54,11 @@ class HTMLPurifier_Filter_ExtractStyleBlocks extends HTMLPurifier_Filter
*/
private $_enum_attrdef;
+ /**
+ * @type HTMLPurifier_AttrDef_Enum
+ */
+ private $_universal_attrdef;
+
public function __construct()
{
$this->_tidy = new csstidy();
@@ -70,6 +75,13 @@ class HTMLPurifier_Filter_ExtractStyleBlocks extends HTMLPurifier_Filter
'focus'
)
);
+ $this->_universal_attrdef = new HTMLPurifier_AttrDef_Enum(
+ array(
+ 'initial',
+ 'inherit',
+ 'unset',
+ )
+ );
}
/**
@@ -146,175 +158,184 @@ class HTMLPurifier_Filter_ExtractStyleBlocks extends HTMLPurifier_Filter
foreach ($this->_tidy->css as $k => $decls) {
// $decls are all CSS declarations inside an @ selector
$new_decls = array();
- foreach ($decls as $selector => $style) {
- $selector = trim($selector);
- if ($selector === '') {
- continue;
- } // should not happen
- // Parse the selector
- // Here is the relevant part of the CSS grammar:
- //
- // ruleset
- // : selector [ ',' S* selector ]* '{' ...
- // selector
- // : simple_selector [ combinator selector | S+ [ combinator? selector ]? ]?
- // combinator
- // : '+' S*
- // : '>' S*
- // simple_selector
- // : element_name [ HASH | class | attrib | pseudo ]*
- // | [ HASH | class | attrib | pseudo ]+
- // element_name
- // : IDENT | '*'
- // ;
- // class
- // : '.' IDENT
- // ;
- // attrib
- // : '[' S* IDENT S* [ [ '=' | INCLUDES | DASHMATCH ] S*
- // [ IDENT | STRING ] S* ]? ']'
- // ;
- // pseudo
- // : ':' [ IDENT | FUNCTION S* [IDENT S*]? ')' ]
- // ;
- //
- // For reference, here are the relevant tokens:
- //
- // HASH #{name}
- // IDENT {ident}
- // INCLUDES ==
- // DASHMATCH |=
- // STRING {string}
- // FUNCTION {ident}\(
- //
- // And the lexical scanner tokens
- //
- // name {nmchar}+
- // nmchar [_a-z0-9-]|{nonascii}|{escape}
- // nonascii [\240-\377]
- // escape {unicode}|\\[^\r\n\f0-9a-f]
- // unicode \\{h}}{1,6}(\r\n|[ \t\r\n\f])?
- // ident -?{nmstart}{nmchar*}
- // nmstart [_a-z]|{nonascii}|{escape}
- // string {string1}|{string2}
- // string1 \"([^\n\r\f\\"]|\\{nl}|{escape})*\"
- // string2 \'([^\n\r\f\\"]|\\{nl}|{escape})*\'
- //
- // We'll implement a subset (in order to reduce attack
- // surface); in particular:
- //
- // - No Unicode support
- // - No escapes support
- // - No string support (by proxy no attrib support)
- // - element_name is matched against allowed
- // elements (some people might find this
- // annoying...)
- // - Pseudo-elements one of :first-child, :link,
- // :visited, :active, :hover, :focus
+ if (is_array($decls)) {
+ foreach ($decls as $selector => $style) {
+ $selector = trim($selector);
+ if ($selector === '') {
+ continue;
+ } // should not happen
+ // Parse the selector
+ // Here is the relevant part of the CSS grammar:
+ //
+ // ruleset
+ // : selector [ ',' S* selector ]* '{' ...
+ // selector
+ // : simple_selector [ combinator selector | S+ [ combinator? selector ]? ]?
+ // combinator
+ // : '+' S*
+ // : '>' S*
+ // simple_selector
+ // : element_name [ HASH | class | attrib | pseudo ]*
+ // | [ HASH | class | attrib | pseudo ]+
+ // element_name
+ // : IDENT | '*'
+ // ;
+ // class
+ // : '.' IDENT
+ // ;
+ // attrib
+ // : '[' S* IDENT S* [ [ '=' | INCLUDES | DASHMATCH ] S*
+ // [ IDENT | STRING ] S* ]? ']'
+ // ;
+ // pseudo
+ // : ':' [ IDENT | FUNCTION S* [IDENT S*]? ')' ]
+ // ;
+ //
+ // For reference, here are the relevant tokens:
+ //
+ // HASH #{name}
+ // IDENT {ident}
+ // INCLUDES ==
+ // DASHMATCH |=
+ // STRING {string}
+ // FUNCTION {ident}\(
+ //
+ // And the lexical scanner tokens
+ //
+ // name {nmchar}+
+ // nmchar [_a-z0-9-]|{nonascii}|{escape}
+ // nonascii [\240-\377]
+ // escape {unicode}|\\[^\r\n\f0-9a-f]
+ // unicode \\{h}}{1,6}(\r\n|[ \t\r\n\f])?
+ // ident -?{nmstart}{nmchar*}
+ // nmstart [_a-z]|{nonascii}|{escape}
+ // string {string1}|{string2}
+ // string1 \"([^\n\r\f\\"]|\\{nl}|{escape})*\"
+ // string2 \'([^\n\r\f\\"]|\\{nl}|{escape})*\'
+ //
+ // We'll implement a subset (in order to reduce attack
+ // surface); in particular:
+ //
+ // - No Unicode support
+ // - No escapes support
+ // - No string support (by proxy no attrib support)
+ // - element_name is matched against allowed
+ // elements (some people might find this
+ // annoying...)
+ // - Pseudo-elements one of :first-child, :link,
+ // :visited, :active, :hover, :focus
- // handle ruleset
- $selectors = array_map('trim', explode(',', $selector));
- $new_selectors = array();
- foreach ($selectors as $sel) {
- // split on +, > and spaces
- $basic_selectors = preg_split('/\s*([+> ])\s*/', $sel, -1, PREG_SPLIT_DELIM_CAPTURE);
- // even indices are chunks, odd indices are
- // delimiters
- $nsel = null;
- $delim = null; // guaranteed to be non-null after
- // two loop iterations
- for ($i = 0, $c = count($basic_selectors); $i < $c; $i++) {
- $x = $basic_selectors[$i];
- if ($i % 2) {
- // delimiter
- if ($x === ' ') {
- $delim = ' ';
- } else {
- $delim = ' ' . $x . ' ';
- }
- } else {
- // simple selector
- $components = preg_split('/([#.:])/', $x, -1, PREG_SPLIT_DELIM_CAPTURE);
- $sdelim = null;
- $nx = null;
- for ($j = 0, $cc = count($components); $j < $cc; $j++) {
- $y = $components[$j];
- if ($j === 0) {
- if ($y === '*' || isset($html_definition->info[$y = strtolower($y)])) {
- $nx = $y;
- } else {
- // $nx stays null; this matters
- // if we don't manage to find
- // any valid selector content,
- // in which case we ignore the
- // outer $delim
- }
- } elseif ($j % 2) {
- // set delimiter
- $sdelim = $y;
+ // handle ruleset
+ $selectors = array_map('trim', explode(',', $selector));
+ $new_selectors = array();
+ foreach ($selectors as $sel) {
+ // split on +, > and spaces
+ $basic_selectors = preg_split('/\s*([+> ])\s*/', $sel, -1, PREG_SPLIT_DELIM_CAPTURE);
+ // even indices are chunks, odd indices are
+ // delimiters
+ $nsel = null;
+ $delim = null; // guaranteed to be non-null after
+ // two loop iterations
+ for ($i = 0, $c = count($basic_selectors); $i < $c; $i++) {
+ $x = $basic_selectors[$i];
+ if ($i % 2) {
+ // delimiter
+ if ($x === ' ') {
+ $delim = ' ';
} else {
- $attrdef = null;
- if ($sdelim === '#') {
- $attrdef = $this->_id_attrdef;
- } elseif ($sdelim === '.') {
- $attrdef = $this->_class_attrdef;
- } elseif ($sdelim === ':') {
- $attrdef = $this->_enum_attrdef;
- } else {
- throw new HTMLPurifier_Exception('broken invariant sdelim and preg_split');
- }
- $r = $attrdef->validate($y, $config, $context);
- if ($r !== false) {
- if ($r !== true) {
- $y = $r;
- }
- if ($nx === null) {
- $nx = '';
- }
- $nx .= $sdelim . $y;
- }
- }
- }
- if ($nx !== null) {
- if ($nsel === null) {
- $nsel = $nx;
- } else {
- $nsel .= $delim . $nx;
+ $delim = ' ' . $x . ' ';
}
} else {
- // delimiters to the left of invalid
- // basic selector ignored
+ // simple selector
+ $components = preg_split('/([#.:])/', $x, -1, PREG_SPLIT_DELIM_CAPTURE);
+ $sdelim = null;
+ $nx = null;
+ for ($j = 0, $cc = count($components); $j < $cc; $j++) {
+ $y = $components[$j];
+ if ($j === 0) {
+ if ($y === '*' || isset($html_definition->info[$y = strtolower($y)])) {
+ $nx = $y;
+ } else {
+ // $nx stays null; this matters
+ // if we don't manage to find
+ // any valid selector content,
+ // in which case we ignore the
+ // outer $delim
+ }
+ } elseif ($j % 2) {
+ // set delimiter
+ $sdelim = $y;
+ } else {
+ $attrdef = null;
+ if ($sdelim === '#') {
+ $attrdef = $this->_id_attrdef;
+ } elseif ($sdelim === '.') {
+ $attrdef = $this->_class_attrdef;
+ } elseif ($sdelim === ':') {
+ $attrdef = $this->_enum_attrdef;
+ } else {
+ throw new HTMLPurifier_Exception('broken invariant sdelim and preg_split');
+ }
+ $r = $attrdef->validate($y, $config, $context);
+ if ($r !== false) {
+ if ($r !== true) {
+ $y = $r;
+ }
+ if ($nx === null) {
+ $nx = '';
+ }
+ $nx .= $sdelim . $y;
+ }
+ }
+ }
+ if ($nx !== null) {
+ if ($nsel === null) {
+ $nsel = $nx;
+ } else {
+ $nsel .= $delim . $nx;
+ }
+ } else {
+ // delimiters to the left of invalid
+ // basic selector ignored
+ }
+ }
+ }
+ if ($nsel !== null) {
+ if (!empty($scopes)) {
+ foreach ($scopes as $s) {
+ $new_selectors[] = "$s $nsel";
+ }
+ } else {
+ $new_selectors[] = $nsel;
}
}
}
- if ($nsel !== null) {
- if (!empty($scopes)) {
- foreach ($scopes as $s) {
- $new_selectors[] = "$s $nsel";
- }
- } else {
- $new_selectors[] = $nsel;
- }
- }
- }
- if (empty($new_selectors)) {
- continue;
- }
- $selector = implode(', ', $new_selectors);
- foreach ($style as $name => $value) {
- if (!isset($css_definition->info[$name])) {
- unset($style[$name]);
+ if (empty($new_selectors)) {
continue;
}
- $def = $css_definition->info[$name];
- $ret = $def->validate($value, $config, $context);
- if ($ret === false) {
- unset($style[$name]);
- } else {
- $style[$name] = $ret;
+ $selector = implode(', ', $new_selectors);
+ foreach ($style as $name => $value) {
+ if (!isset($css_definition->info[$name])) {
+ unset($style[$name]);
+ continue;
+ }
+ $uni_ret = $this->_universal_attrdef->validate($value, $config, $context);
+ if ($uni_ret !== false) {
+ $style[$name] = $uni_ret;
+ continue;
+ }
+ $def = $css_definition->info[$name];
+ $ret = $def->validate($value, $config, $context);
+ if ($ret === false) {
+ unset($style[$name]);
+ } else {
+ $style[$name] = $ret;
+ }
}
+ $new_decls[$selector] = $style;
}
- $new_decls[$selector] = $style;
+ } else {
+ continue;
}
$new_css[$k] = $new_decls;
}
diff --git a/tools/htmlpurifier/HTMLPurifier/Filter/index.php b/tools/htmlpurifier/HTMLPurifier/Filter/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/Filter/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/HTMLModule.php b/tools/htmlpurifier/HTMLPurifier/HTMLModule.php
index 6d898f80c..9dbb98729 100644
--- a/tools/htmlpurifier/HTMLPurifier/HTMLModule.php
+++ b/tools/htmlpurifier/HTMLPurifier/HTMLModule.php
@@ -257,8 +257,9 @@ class HTMLPurifier_HTMLModule
*/
public function makeLookup($list)
{
+ $args = func_get_args();
if (is_string($list)) {
- $list = func_get_args();
+ $list = $args;
}
$ret = array();
foreach ($list as $value) {
diff --git a/tools/htmlpurifier/HTMLPurifier/HTMLModule/CommonAttributes.php b/tools/htmlpurifier/HTMLPurifier/HTMLModule/CommonAttributes.php
index a96ab1bef..7220c14cc 100644
--- a/tools/htmlpurifier/HTMLPurifier/HTMLModule/CommonAttributes.php
+++ b/tools/htmlpurifier/HTMLPurifier/HTMLModule/CommonAttributes.php
@@ -17,6 +17,7 @@ class HTMLPurifier_HTMLModule_CommonAttributes extends HTMLPurifier_HTMLModule
'class' => 'Class',
'id' => 'ID',
'title' => 'CDATA',
+ 'contenteditable' => 'ContentEditable',
),
'Lang' => array(),
'I18N' => array(
diff --git a/tools/htmlpurifier/HTMLPurifier/HTMLModule/Iframe.php b/tools/htmlpurifier/HTMLPurifier/HTMLModule/Iframe.php
index f7e7c91c0..71dfc7744 100644
--- a/tools/htmlpurifier/HTMLPurifier/HTMLModule/Iframe.php
+++ b/tools/htmlpurifier/HTMLPurifier/HTMLModule/Iframe.php
@@ -28,22 +28,28 @@ class HTMLPurifier_HTMLModule_Iframe extends HTMLPurifier_HTMLModule
if ($config->get('HTML.SafeIframe')) {
$this->safe = true;
}
+ $attrs = array(
+ 'src' => 'URI#embedded',
+ 'width' => 'Length',
+ 'height' => 'Length',
+ 'name' => 'ID',
+ 'scrolling' => 'Enum#yes,no,auto',
+ 'frameborder' => 'Enum#0,1',
+ 'longdesc' => 'URI',
+ 'marginheight' => 'Pixels',
+ 'marginwidth' => 'Pixels',
+ );
+
+ if ($config->get('HTML.Trusted')) {
+ $attrs['allowfullscreen'] = 'Bool#allowfullscreen';
+ }
+
$this->addElement(
'iframe',
'Inline',
'Flow',
'Common',
- array(
- 'src' => 'URI#embedded',
- 'width' => 'Length',
- 'height' => 'Length',
- 'name' => 'ID',
- 'scrolling' => 'Enum#yes,no,auto',
- 'frameborder' => 'Enum#0,1',
- 'longdesc' => 'URI',
- 'marginheight' => 'Pixels',
- 'marginwidth' => 'Pixels',
- )
+ $attrs
);
}
}
diff --git a/tools/htmlpurifier/HTMLPurifier/HTMLModule/Tidy.php b/tools/htmlpurifier/HTMLPurifier/HTMLModule/Tidy.php
index 08aa23247..76fd93a6c 100644
--- a/tools/htmlpurifier/HTMLPurifier/HTMLModule/Tidy.php
+++ b/tools/htmlpurifier/HTMLPurifier/HTMLModule/Tidy.php
@@ -146,10 +146,7 @@ class HTMLPurifier_HTMLModule_Tidy extends HTMLPurifier_HTMLModule
$type = "info_$type";
$e = $this;
}
- // PHP does some weird parsing when I do
- // $e->$type[$attr], so I have to assign a ref.
- $f =& $e->$type;
- $f[$attr] = $fix;
+ $e->{$type}[$attr] = $fix;
break;
case 'tag_transform':
$this->info_tag_transform[$params['element']] = $fix;
@@ -224,6 +221,7 @@ class HTMLPurifier_HTMLModule_Tidy extends HTMLPurifier_HTMLModule
*/
public function makeFixes()
{
+ return array();
}
}
diff --git a/tools/htmlpurifier/HTMLPurifier/HTMLModule/Tidy/XHTMLAndHTML4.php b/tools/htmlpurifier/HTMLPurifier/HTMLModule/Tidy/XHTMLAndHTML4.php
index 700a25dbc..9ee3ffcc9 100644
--- a/tools/htmlpurifier/HTMLPurifier/HTMLModule/Tidy/XHTMLAndHTML4.php
+++ b/tools/htmlpurifier/HTMLPurifier/HTMLModule/Tidy/XHTMLAndHTML4.php
@@ -168,9 +168,11 @@ class HTMLPurifier_HTMLModule_Tidy_XHTMLAndHTML4 extends HTMLPurifier_HTMLModule
// @vspace for img ------------------------------------------------
$r['img@vspace'] = new HTMLPurifier_AttrTransform_ImgSpace('vspace');
- // @width for hr, td, th ------------------------------------------
+ // @width for table, hr, td, th, col ------------------------------------------
+ $r['table@width'] =
$r['td@width'] =
$r['th@width'] =
+ $r['col@width'] =
$r['hr@width'] = new HTMLPurifier_AttrTransform_Length('width');
return $r;
diff --git a/tools/htmlpurifier/HTMLPurifier/HTMLModule/Tidy/index.php b/tools/htmlpurifier/HTMLPurifier/HTMLModule/Tidy/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/HTMLModule/Tidy/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/HTMLModule/index.php b/tools/htmlpurifier/HTMLPurifier/HTMLModule/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/HTMLModule/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/Injector/Linkify.php b/tools/htmlpurifier/HTMLPurifier/Injector/Linkify.php
index 74f83eaa7..3b6d70f6e 100644
--- a/tools/htmlpurifier/HTMLPurifier/Injector/Linkify.php
+++ b/tools/htmlpurifier/HTMLPurifier/Injector/Linkify.php
@@ -40,6 +40,9 @@ class HTMLPurifier_Injector_Linkify extends HTMLPurifier_Injector
'/\\b((?:[a-z][\\w\\-]+:(?:\\/{1,3}|[a-z0-9%])|www\\d{0,3}[.]|[a-z0-9.\\-]+[.][a-z]{2,4}\\/)(?:[^\\s()<>]|\\((?:[^\\s()<>]|(?:\\([^\\s()<>]+\\)))*\\))+(?:\\((?:[^\\s()<>]|(?:\\([^\\s()<>]+\\)))*\\)|[^\\s`!()\\[\\]{};:\'".,<>?\x{00ab}\x{00bb}\x{201c}\x{201d}\x{2018}\x{2019}]))/iu',
$token->data, -1, PREG_SPLIT_DELIM_CAPTURE);
+ if ($bits === false) {
+ return;
+ }
$token = array();
diff --git a/tools/htmlpurifier/HTMLPurifier/Injector/RemoveSpansWithoutAttributes.php b/tools/htmlpurifier/HTMLPurifier/Injector/RemoveSpansWithoutAttributes.php
index 9ee7aa84d..42d514447 100644
--- a/tools/htmlpurifier/HTMLPurifier/Injector/RemoveSpansWithoutAttributes.php
+++ b/tools/htmlpurifier/HTMLPurifier/Injector/RemoveSpansWithoutAttributes.php
@@ -31,6 +31,16 @@ class HTMLPurifier_Injector_RemoveSpansWithoutAttributes extends HTMLPurifier_In
*/
private $context;
+ /**
+ * @type SplObjectStorage
+ */
+ private $markForDeletion;
+
+ public function __construct()
+ {
+ $this->markForDeletion = new SplObjectStorage();
+ }
+
public function prepare($config, $context)
{
$this->attrValidator = new HTMLPurifier_AttrValidator();
@@ -64,7 +74,7 @@ class HTMLPurifier_Injector_RemoveSpansWithoutAttributes extends HTMLPurifier_In
if ($current instanceof HTMLPurifier_Token_End && $current->name === 'span') {
// Mark closing span tag for deletion
- $current->markForDeletion = true;
+ $this->markForDeletion->attach($current);
// Delete open span tag
$token = false;
}
@@ -75,7 +85,8 @@ class HTMLPurifier_Injector_RemoveSpansWithoutAttributes extends HTMLPurifier_In
*/
public function handleEnd(&$token)
{
- if ($token->markForDeletion) {
+ if ($this->markForDeletion->contains($token)) {
+ $this->markForDeletion->detach($token);
$token = false;
}
}
diff --git a/tools/htmlpurifier/HTMLPurifier/Injector/index.php b/tools/htmlpurifier/HTMLPurifier/Injector/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/Injector/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/Language/index.php b/tools/htmlpurifier/HTMLPurifier/Language/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/Language/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/Language/messages/index.php b/tools/htmlpurifier/HTMLPurifier/Language/messages/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/Language/messages/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/LanguageFactory.php b/tools/htmlpurifier/HTMLPurifier/LanguageFactory.php
index 4e35272d8..16a4f6932 100644
--- a/tools/htmlpurifier/HTMLPurifier/LanguageFactory.php
+++ b/tools/htmlpurifier/HTMLPurifier/LanguageFactory.php
@@ -109,7 +109,7 @@ class HTMLPurifier_LanguageFactory
} else {
$class = 'HTMLPurifier_Language_' . $pcode;
$file = $this->dir . '/Language/classes/' . $code . '.php';
- if (file_exists($file) || class_exists($class, false)) {
+ if (file_exists($file) || class_exists($class)) {
$lang = new $class($config, $context);
} else {
// Go fallback
diff --git a/tools/htmlpurifier/HTMLPurifier/Length.php b/tools/htmlpurifier/HTMLPurifier/Length.php
index e70da55a9..b6ea12345 100644
--- a/tools/htmlpurifier/HTMLPurifier/Length.php
+++ b/tools/htmlpurifier/HTMLPurifier/Length.php
@@ -78,7 +78,7 @@ class HTMLPurifier_Length
if ($this->n === '0' && $this->unit === false) {
return true;
}
- if (!ctype_lower($this->unit)) {
+ if ($this->unit === false || !ctype_lower($this->unit)) {
$this->unit = strtolower($this->unit);
}
if (!isset(HTMLPurifier_Length::$allowedUnits[$this->unit])) {
diff --git a/tools/htmlpurifier/HTMLPurifier/Lexer.php b/tools/htmlpurifier/HTMLPurifier/Lexer.php
index e9da3ed5e..fe87fa4ba 100644
--- a/tools/htmlpurifier/HTMLPurifier/Lexer.php
+++ b/tools/htmlpurifier/HTMLPurifier/Lexer.php
@@ -48,6 +48,11 @@ class HTMLPurifier_Lexer
*/
public $tracksLineNumbers = false;
+ /**
+ * @type HTMLPurifier_EntityParser
+ */
+ private $_entity_parser;
+
// -- STATIC ----------------------------------------------------------
/**
@@ -96,7 +101,7 @@ class HTMLPurifier_Lexer
break;
}
- if (class_exists('DOMDocument', false) &&
+ if (class_exists('DOMDocument') &&
method_exists('DOMDocument', 'loadHTML') &&
!extension_loaded('domxml')
) {
@@ -264,20 +269,6 @@ class HTMLPurifier_Lexer
);
}
- /**
- * Special Internet Explorer conditional comments should be removed.
- * @param string $string HTML string to process.
- * @return string HTML with conditional comments removed.
- */
- protected static function removeIEConditional($string)
- {
- return preg_replace(
- '##si', // probably should generalize for all strings
- '',
- $string
- );
- }
-
/**
* Callback function for escapeCDATA() that does the work.
*
@@ -306,8 +297,8 @@ class HTMLPurifier_Lexer
{
// normalize newlines to \n
if ($config->get('Core.NormalizeNewlines')) {
- $html = str_replace("\r\n", "\n", $html);
- $html = str_replace("\r", "\n", $html);
+ $html = str_replace("\r\n", "\n", (string)$html);
+ $html = str_replace("\r", "\n", (string)$html);
}
if ($config->get('HTML.Trusted')) {
@@ -318,8 +309,6 @@ class HTMLPurifier_Lexer
// escape CDATA
$html = $this->escapeCDATA($html);
- $html = $this->removeIEConditional($html);
-
// extract body from document if applicable
if ($config->get('Core.ConvertDocumentToFragment')) {
$e = false;
diff --git a/tools/htmlpurifier/HTMLPurifier/Lexer/DOMLex.php b/tools/htmlpurifier/HTMLPurifier/Lexer/DOMLex.php
index ca5f25b84..7d579837c 100644
--- a/tools/htmlpurifier/HTMLPurifier/Lexer/DOMLex.php
+++ b/tools/htmlpurifier/HTMLPurifier/Lexer/DOMLex.php
@@ -72,6 +72,9 @@ class HTMLPurifier_Lexer_DOMLex extends HTMLPurifier_Lexer
if ($config->get('Core.AllowParseManyTags') && defined('LIBXML_PARSEHUGE')) {
$options |= LIBXML_PARSEHUGE;
}
+ if ($config->get('Core.RemoveBlanks') && defined('LIBXML_NOBLANKS')) {
+ $options |= LIBXML_NOBLANKS;
+ }
set_error_handler(array($this, 'muteErrorHandler'));
// loadHTML() fails on PHP 5.3 when second parameter is given
@@ -104,7 +107,6 @@ class HTMLPurifier_Lexer_DOMLex extends HTMLPurifier_Lexer
* To iterate is human, to recurse divine - L. Peter Deutsch
* @param DOMNode $node DOMNode to be tokenized.
* @param HTMLPurifier_Token[] $tokens Array-list of already tokenized tokens.
- * @return HTMLPurifier_Token of node appended to previously passed tokens.
*/
protected function tokenizeDOM($node, &$tokens, $config)
{
diff --git a/tools/htmlpurifier/HTMLPurifier/Lexer/PH5P.php b/tools/htmlpurifier/HTMLPurifier/Lexer/PH5P.php
index 72476ddf3..1564f283d 100644
--- a/tools/htmlpurifier/HTMLPurifier/Lexer/PH5P.php
+++ b/tools/htmlpurifier/HTMLPurifier/Lexer/PH5P.php
@@ -4410,7 +4410,7 @@ class HTML5TreeConstructer
foreach ($token['attr'] as $attr) {
if (!$el->hasAttribute($attr['name'])) {
- $el->setAttribute($attr['name'], $attr['value']);
+ $el->setAttribute($attr['name'], (string)$attr['value']);
}
}
diff --git a/tools/htmlpurifier/HTMLPurifier/Lexer/index.php b/tools/htmlpurifier/HTMLPurifier/Lexer/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/Lexer/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/Node/index.php b/tools/htmlpurifier/HTMLPurifier/Node/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/Node/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/Printer/ConfigForm.php b/tools/htmlpurifier/HTMLPurifier/Printer/ConfigForm.php
index 33ae11397..4c3ce1758 100644
--- a/tools/htmlpurifier/HTMLPurifier/Printer/ConfigForm.php
+++ b/tools/htmlpurifier/HTMLPurifier/Printer/ConfigForm.php
@@ -32,6 +32,11 @@ class HTMLPurifier_Printer_ConfigForm extends HTMLPurifier_Printer
*/
protected $compress = false;
+ /**
+ * @var HTMLPurifier_Config
+ */
+ protected $genConfig;
+
/**
* @param string $name Form element name for directives to be stuffed into
* @param string $doc_url String documentation URL, will have fragment tagged on
diff --git a/tools/htmlpurifier/HTMLPurifier/Printer/index.php b/tools/htmlpurifier/HTMLPurifier/Printer/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/Printer/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/PropertyListIterator.php b/tools/htmlpurifier/HTMLPurifier/PropertyListIterator.php
index 15b330ea3..f68fc8c30 100644
--- a/tools/htmlpurifier/HTMLPurifier/PropertyListIterator.php
+++ b/tools/htmlpurifier/HTMLPurifier/PropertyListIterator.php
@@ -29,6 +29,7 @@ class HTMLPurifier_PropertyListIterator extends FilterIterator
/**
* @return bool
*/
+ #[\ReturnTypeWillChange]
public function accept()
{
$key = $this->getInnerIterator()->key();
diff --git a/tools/htmlpurifier/HTMLPurifier/Strategy/index.php b/tools/htmlpurifier/HTMLPurifier/Strategy/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/Strategy/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/StringHash.php b/tools/htmlpurifier/HTMLPurifier/StringHash.php
index c07370197..c41ae3a76 100644
--- a/tools/htmlpurifier/HTMLPurifier/StringHash.php
+++ b/tools/htmlpurifier/HTMLPurifier/StringHash.php
@@ -20,6 +20,7 @@ class HTMLPurifier_StringHash extends ArrayObject
* @param mixed $index
* @return mixed
*/
+ #[\ReturnTypeWillChange]
public function offsetGet($index)
{
$this->accessed[$index] = true;
diff --git a/tools/htmlpurifier/HTMLPurifier/TagTransform/index.php b/tools/htmlpurifier/HTMLPurifier/TagTransform/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/TagTransform/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/Token/Tag.php b/tools/htmlpurifier/HTMLPurifier/Token/Tag.php
index d643fa64e..dcf365589 100644
--- a/tools/htmlpurifier/HTMLPurifier/Token/Tag.php
+++ b/tools/htmlpurifier/HTMLPurifier/Token/Tag.php
@@ -44,7 +44,7 @@ abstract class HTMLPurifier_Token_Tag extends HTMLPurifier_Token
$this->name = ctype_lower($name) ? $name : strtolower($name);
foreach ($attr as $key => $value) {
// normalization only necessary when key is not lowercase
- if (!ctype_lower($key)) {
+ if (!ctype_lower((string)$key)) {
$new_key = strtolower($key);
if (!isset($attr[$new_key])) {
$attr[$new_key] = $attr[$key];
diff --git a/tools/htmlpurifier/HTMLPurifier/Token/index.php b/tools/htmlpurifier/HTMLPurifier/Token/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/Token/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/URIFilter/HostBlacklist.php b/tools/htmlpurifier/HTMLPurifier/URIFilter/HostBlacklist.php
index a6645c17e..32197c0e6 100644
--- a/tools/htmlpurifier/HTMLPurifier/URIFilter/HostBlacklist.php
+++ b/tools/htmlpurifier/HTMLPurifier/URIFilter/HostBlacklist.php
@@ -35,7 +35,7 @@ class HTMLPurifier_URIFilter_HostBlacklist extends HTMLPurifier_URIFilter
public function filter(&$uri, $config, $context)
{
foreach ($this->blacklist as $blacklisted_host_fragment) {
- if (strpos($uri->host, $blacklisted_host_fragment) !== false) {
+ if ($uri->host !== null && strpos($uri->host, $blacklisted_host_fragment) !== false) {
return false;
}
}
diff --git a/tools/htmlpurifier/HTMLPurifier/URIFilter/Munge.php b/tools/htmlpurifier/HTMLPurifier/URIFilter/Munge.php
index 6e03315a1..e1393deb7 100644
--- a/tools/htmlpurifier/HTMLPurifier/URIFilter/Munge.php
+++ b/tools/htmlpurifier/HTMLPurifier/URIFilter/Munge.php
@@ -100,11 +100,11 @@ class HTMLPurifier_URIFilter_Munge extends HTMLPurifier_URIFilter
$string = $uri->toString();
// always available
$this->replace['%s'] = $string;
- $this->replace['%r'] = $context->get('EmbeddedURI', true);
- $token = $context->get('CurrentToken', true);
- $this->replace['%n'] = $token ? $token->name : null;
- $this->replace['%m'] = $context->get('CurrentAttr', true);
- $this->replace['%p'] = $context->get('CurrentCSSProperty', true);
+ $this->replace['%r'] = $context->get('EmbeddedURI', true) ?: '';
+ $token = $context->get('CurrentToken', true) ?: '';
+ $this->replace['%n'] = $token ? $token->name : '';
+ $this->replace['%m'] = $context->get('CurrentAttr', true) ?: '';
+ $this->replace['%p'] = $context->get('CurrentCSSProperty', true) ?: '';
// not always available
if ($this->secretKey) {
$this->replace['%t'] = hash_hmac("sha256", $string, $this->secretKey);
diff --git a/tools/htmlpurifier/HTMLPurifier/URIFilter/index.php b/tools/htmlpurifier/HTMLPurifier/URIFilter/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/URIFilter/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/URIScheme/index.php b/tools/htmlpurifier/HTMLPurifier/URIScheme/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/URIScheme/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/URIScheme/tel.php b/tools/htmlpurifier/HTMLPurifier/URIScheme/tel.php
index 8cd193352..dfad8efcf 100644
--- a/tools/htmlpurifier/HTMLPurifier/URIScheme/tel.php
+++ b/tools/htmlpurifier/HTMLPurifier/URIScheme/tel.php
@@ -33,11 +33,11 @@ class HTMLPurifier_URIScheme_tel extends HTMLPurifier_URIScheme
$uri->host = null;
$uri->port = null;
- // Delete all non-numeric characters, non-x characters
+ // Delete all non-numeric characters, commas, and non-x characters
// from phone number, EXCEPT for a leading plus sign.
- $uri->path = preg_replace('/(?!^\+)[^\dx]/', '',
+ $uri->path = preg_replace('/(?!^\+)[^\dx,]/', '',
// Normalize e(x)tension to lower-case
- str_replace('X', 'x', $uri->path));
+ str_replace('X', 'x', rawurldecode($uri->path)));
return true;
}
diff --git a/tools/htmlpurifier/HTMLPurifier/UnitConverter.php b/tools/htmlpurifier/HTMLPurifier/UnitConverter.php
index 166f3bf30..b5a1eab5c 100644
--- a/tools/htmlpurifier/HTMLPurifier/UnitConverter.php
+++ b/tools/htmlpurifier/HTMLPurifier/UnitConverter.php
@@ -261,7 +261,7 @@ class HTMLPurifier_UnitConverter
*/
private function round($n, $sigfigs)
{
- $new_log = (int)floor(log(abs($n), 10)); // Number of digits left of decimal - 1
+ $new_log = (int)floor(log(abs((float)$n), 10)); // Number of digits left of decimal - 1
$rp = $sigfigs - $new_log - 1; // Number of decimal places needed
$neg = $n < 0 ? '-' : ''; // Negative sign
if ($this->bcmath) {
@@ -276,7 +276,7 @@ class HTMLPurifier_UnitConverter
}
return $n;
} else {
- return $this->scale(round($n, $sigfigs - $new_log - 1), $rp + 1);
+ return $this->scale(round((float)$n, $sigfigs - $new_log - 1), $rp + 1);
}
}
@@ -300,7 +300,7 @@ class HTMLPurifier_UnitConverter
// Now we return it, truncating the zero that was rounded off.
return substr($precise, 0, -1) . str_repeat('0', -$scale + 1);
}
- return sprintf('%.' . $scale . 'f', (float)$r);
+ return number_format((float)$r, $scale, '.', '');
}
}
diff --git a/tools/htmlpurifier/HTMLPurifier/VarParser/index.php b/tools/htmlpurifier/HTMLPurifier/VarParser/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/VarParser/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/HTMLPurifier/index.php b/tools/htmlpurifier/HTMLPurifier/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/HTMLPurifier/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/htmlpurifier/LICENSE b/tools/htmlpurifier/LICENSE
deleted file mode 100644
index 8c88a20d4..000000000
--- a/tools/htmlpurifier/LICENSE
+++ /dev/null
@@ -1,504 +0,0 @@
- GNU LESSER GENERAL PUBLIC LICENSE
- Version 2.1, February 1999
-
- Copyright (C) 1991, 1999 Free Software Foundation, Inc.
- 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-[This is the first released version of the Lesser GPL. It also counts
- as the successor of the GNU Library Public License, version 2, hence
- the version number 2.1.]
-
- Preamble
-
- The licenses for most software are designed to take away your
-freedom to share and change it. By contrast, the GNU General Public
-Licenses are intended to guarantee your freedom to share and change
-free software--to make sure the software is free for all its users.
-
- This license, the Lesser General Public License, applies to some
-specially designated software packages--typically libraries--of the
-Free Software Foundation and other authors who decide to use it. You
-can use it too, but we suggest you first think carefully about whether
-this license or the ordinary General Public License is the better
-strategy to use in any particular case, based on the explanations below.
-
- When we speak of free software, we are referring to freedom of use,
-not price. Our General Public Licenses are designed to make sure that
-you have the freedom to distribute copies of free software (and charge
-for this service if you wish); that you receive source code or can get
-it if you want it; that you can change the software and use pieces of
-it in new free programs; and that you are informed that you can do
-these things.
-
- To protect your rights, we need to make restrictions that forbid
-distributors to deny you these rights or to ask you to surrender these
-rights. These restrictions translate to certain responsibilities for
-you if you distribute copies of the library or if you modify it.
-
- For example, if you distribute copies of the library, whether gratis
-or for a fee, you must give the recipients all the rights that we gave
-you. You must make sure that they, too, receive or can get the source
-code. If you link other code with the library, you must provide
-complete object files to the recipients, so that they can relink them
-with the library after making changes to the library and recompiling
-it. And you must show them these terms so they know their rights.
-
- We protect your rights with a two-step method: (1) we copyright the
-library, and (2) we offer you this license, which gives you legal
-permission to copy, distribute and/or modify the library.
-
- To protect each distributor, we want to make it very clear that
-there is no warranty for the free library. Also, if the library is
-modified by someone else and passed on, the recipients should know
-that what they have is not the original version, so that the original
-author's reputation will not be affected by problems that might be
-introduced by others.
-
- Finally, software patents pose a constant threat to the existence of
-any free program. We wish to make sure that a company cannot
-effectively restrict the users of a free program by obtaining a
-restrictive license from a patent holder. Therefore, we insist that
-any patent license obtained for a version of the library must be
-consistent with the full freedom of use specified in this license.
-
- Most GNU software, including some libraries, is covered by the
-ordinary GNU General Public License. This license, the GNU Lesser
-General Public License, applies to certain designated libraries, and
-is quite different from the ordinary General Public License. We use
-this license for certain libraries in order to permit linking those
-libraries into non-free programs.
-
- When a program is linked with a library, whether statically or using
-a shared library, the combination of the two is legally speaking a
-combined work, a derivative of the original library. The ordinary
-General Public License therefore permits such linking only if the
-entire combination fits its criteria of freedom. The Lesser General
-Public License permits more lax criteria for linking other code with
-the library.
-
- We call this license the "Lesser" General Public License because it
-does Less to protect the user's freedom than the ordinary General
-Public License. It also provides other free software developers Less
-of an advantage over competing non-free programs. These disadvantages
-are the reason we use the ordinary General Public License for many
-libraries. However, the Lesser license provides advantages in certain
-special circumstances.
-
- For example, on rare occasions, there may be a special need to
-encourage the widest possible use of a certain library, so that it becomes
-a de-facto standard. To achieve this, non-free programs must be
-allowed to use the library. A more frequent case is that a free
-library does the same job as widely used non-free libraries. In this
-case, there is little to gain by limiting the free library to free
-software only, so we use the Lesser General Public License.
-
- In other cases, permission to use a particular library in non-free
-programs enables a greater number of people to use a large body of
-free software. For example, permission to use the GNU C Library in
-non-free programs enables many more people to use the whole GNU
-operating system, as well as its variant, the GNU/Linux operating
-system.
-
- Although the Lesser General Public License is Less protective of the
-users' freedom, it does ensure that the user of a program that is
-linked with the Library has the freedom and the wherewithal to run
-that program using a modified version of the Library.
-
- The precise terms and conditions for copying, distribution and
-modification follow. Pay close attention to the difference between a
-"work based on the library" and a "work that uses the library". The
-former contains code derived from the library, whereas the latter must
-be combined with the library in order to run.
-
- GNU LESSER GENERAL PUBLIC LICENSE
- TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-
- 0. This License Agreement applies to any software library or other
-program which contains a notice placed by the copyright holder or
-other authorized party saying it may be distributed under the terms of
-this Lesser General Public License (also called "this License").
-Each licensee is addressed as "you".
-
- A "library" means a collection of software functions and/or data
-prepared so as to be conveniently linked with application programs
-(which use some of those functions and data) to form executables.
-
- The "Library", below, refers to any such software library or work
-which has been distributed under these terms. A "work based on the
-Library" means either the Library or any derivative work under
-copyright law: that is to say, a work containing the Library or a
-portion of it, either verbatim or with modifications and/or translated
-straightforwardly into another language. (Hereinafter, translation is
-included without limitation in the term "modification".)
-
- "Source code" for a work means the preferred form of the work for
-making modifications to it. For a library, complete source code means
-all the source code for all modules it contains, plus any associated
-interface definition files, plus the scripts used to control compilation
-and installation of the library.
-
- Activities other than copying, distribution and modification are not
-covered by this License; they are outside its scope. The act of
-running a program using the Library is not restricted, and output from
-such a program is covered only if its contents constitute a work based
-on the Library (independent of the use of the Library in a tool for
-writing it). Whether that is true depends on what the Library does
-and what the program that uses the Library does.
-
- 1. You may copy and distribute verbatim copies of the Library's
-complete source code as you receive it, in any medium, provided that
-you conspicuously and appropriately publish on each copy an
-appropriate copyright notice and disclaimer of warranty; keep intact
-all the notices that refer to this License and to the absence of any
-warranty; and distribute a copy of this License along with the
-Library.
-
- You may charge a fee for the physical act of transferring a copy,
-and you may at your option offer warranty protection in exchange for a
-fee.
-
- 2. You may modify your copy or copies of the Library or any portion
-of it, thus forming a work based on the Library, and copy and
-distribute such modifications or work under the terms of Section 1
-above, provided that you also meet all of these conditions:
-
- a) The modified work must itself be a software library.
-
- b) You must cause the files modified to carry prominent notices
- stating that you changed the files and the date of any change.
-
- c) You must cause the whole of the work to be licensed at no
- charge to all third parties under the terms of this License.
-
- d) If a facility in the modified Library refers to a function or a
- table of data to be supplied by an application program that uses
- the facility, other than as an argument passed when the facility
- is invoked, then you must make a good faith effort to ensure that,
- in the event an application does not supply such function or
- table, the facility still operates, and performs whatever part of
- its purpose remains meaningful.
-
- (For example, a function in a library to compute square roots has
- a purpose that is entirely well-defined independent of the
- application. Therefore, Subsection 2d requires that any
- application-supplied function or table used by this function must
- be optional: if the application does not supply it, the square
- root function must still compute square roots.)
-
-These requirements apply to the modified work as a whole. If
-identifiable sections of that work are not derived from the Library,
-and can be reasonably considered independent and separate works in
-themselves, then this License, and its terms, do not apply to those
-sections when you distribute them as separate works. But when you
-distribute the same sections as part of a whole which is a work based
-on the Library, the distribution of the whole must be on the terms of
-this License, whose permissions for other licensees extend to the
-entire whole, and thus to each and every part regardless of who wrote
-it.
-
-Thus, it is not the intent of this section to claim rights or contest
-your rights to work written entirely by you; rather, the intent is to
-exercise the right to control the distribution of derivative or
-collective works based on the Library.
-
-In addition, mere aggregation of another work not based on the Library
-with the Library (or with a work based on the Library) on a volume of
-a storage or distribution medium does not bring the other work under
-the scope of this License.
-
- 3. You may opt to apply the terms of the ordinary GNU General Public
-License instead of this License to a given copy of the Library. To do
-this, you must alter all the notices that refer to this License, so
-that they refer to the ordinary GNU General Public License, version 2,
-instead of to this License. (If a newer version than version 2 of the
-ordinary GNU General Public License has appeared, then you can specify
-that version instead if you wish.) Do not make any other change in
-these notices.
-
- Once this change is made in a given copy, it is irreversible for
-that copy, so the ordinary GNU General Public License applies to all
-subsequent copies and derivative works made from that copy.
-
- This option is useful when you wish to copy part of the code of
-the Library into a program that is not a library.
-
- 4. You may copy and distribute the Library (or a portion or
-derivative of it, under Section 2) in object code or executable form
-under the terms of Sections 1 and 2 above provided that you accompany
-it with the complete corresponding machine-readable source code, which
-must be distributed under the terms of Sections 1 and 2 above on a
-medium customarily used for software interchange.
-
- If distribution of object code is made by offering access to copy
-from a designated place, then offering equivalent access to copy the
-source code from the same place satisfies the requirement to
-distribute the source code, even though third parties are not
-compelled to copy the source along with the object code.
-
- 5. A program that contains no derivative of any portion of the
-Library, but is designed to work with the Library by being compiled or
-linked with it, is called a "work that uses the Library". Such a
-work, in isolation, is not a derivative work of the Library, and
-therefore falls outside the scope of this License.
-
- However, linking a "work that uses the Library" with the Library
-creates an executable that is a derivative of the Library (because it
-contains portions of the Library), rather than a "work that uses the
-library". The executable is therefore covered by this License.
-Section 6 states terms for distribution of such executables.
-
- When a "work that uses the Library" uses material from a header file
-that is part of the Library, the object code for the work may be a
-derivative work of the Library even though the source code is not.
-Whether this is true is especially significant if the work can be
-linked without the Library, or if the work is itself a library. The
-threshold for this to be true is not precisely defined by law.
-
- If such an object file uses only numerical parameters, data
-structure layouts and accessors, and small macros and small inline
-functions (ten lines or less in length), then the use of the object
-file is unrestricted, regardless of whether it is legally a derivative
-work. (Executables containing this object code plus portions of the
-Library will still fall under Section 6.)
-
- Otherwise, if the work is a derivative of the Library, you may
-distribute the object code for the work under the terms of Section 6.
-Any executables containing that work also fall under Section 6,
-whether or not they are linked directly with the Library itself.
-
- 6. As an exception to the Sections above, you may also combine or
-link a "work that uses the Library" with the Library to produce a
-work containing portions of the Library, and distribute that work
-under terms of your choice, provided that the terms permit
-modification of the work for the customer's own use and reverse
-engineering for debugging such modifications.
-
- You must give prominent notice with each copy of the work that the
-Library is used in it and that the Library and its use are covered by
-this License. You must supply a copy of this License. If the work
-during execution displays copyright notices, you must include the
-copyright notice for the Library among them, as well as a reference
-directing the user to the copy of this License. Also, you must do one
-of these things:
-
- a) Accompany the work with the complete corresponding
- machine-readable source code for the Library including whatever
- changes were used in the work (which must be distributed under
- Sections 1 and 2 above); and, if the work is an executable linked
- with the Library, with the complete machine-readable "work that
- uses the Library", as object code and/or source code, so that the
- user can modify the Library and then relink to produce a modified
- executable containing the modified Library. (It is understood
- that the user who changes the contents of definitions files in the
- Library will not necessarily be able to recompile the application
- to use the modified definitions.)
-
- b) Use a suitable shared library mechanism for linking with the
- Library. A suitable mechanism is one that (1) uses at run time a
- copy of the library already present on the user's computer system,
- rather than copying library functions into the executable, and (2)
- will operate properly with a modified version of the library, if
- the user installs one, as long as the modified version is
- interface-compatible with the version that the work was made with.
-
- c) Accompany the work with a written offer, valid for at
- least three years, to give the same user the materials
- specified in Subsection 6a, above, for a charge no more
- than the cost of performing this distribution.
-
- d) If distribution of the work is made by offering access to copy
- from a designated place, offer equivalent access to copy the above
- specified materials from the same place.
-
- e) Verify that the user has already received a copy of these
- materials or that you have already sent this user a copy.
-
- For an executable, the required form of the "work that uses the
-Library" must include any data and utility programs needed for
-reproducing the executable from it. However, as a special exception,
-the materials to be distributed need not include anything that is
-normally distributed (in either source or binary form) with the major
-components (compiler, kernel, and so on) of the operating system on
-which the executable runs, unless that component itself accompanies
-the executable.
-
- It may happen that this requirement contradicts the license
-restrictions of other proprietary libraries that do not normally
-accompany the operating system. Such a contradiction means you cannot
-use both them and the Library together in an executable that you
-distribute.
-
- 7. You may place library facilities that are a work based on the
-Library side-by-side in a single library together with other library
-facilities not covered by this License, and distribute such a combined
-library, provided that the separate distribution of the work based on
-the Library and of the other library facilities is otherwise
-permitted, and provided that you do these two things:
-
- a) Accompany the combined library with a copy of the same work
- based on the Library, uncombined with any other library
- facilities. This must be distributed under the terms of the
- Sections above.
-
- b) Give prominent notice with the combined library of the fact
- that part of it is a work based on the Library, and explaining
- where to find the accompanying uncombined form of the same work.
-
- 8. You may not copy, modify, sublicense, link with, or distribute
-the Library except as expressly provided under this License. Any
-attempt otherwise to copy, modify, sublicense, link with, or
-distribute the Library is void, and will automatically terminate your
-rights under this License. However, parties who have received copies,
-or rights, from you under this License will not have their licenses
-terminated so long as such parties remain in full compliance.
-
- 9. You are not required to accept this License, since you have not
-signed it. However, nothing else grants you permission to modify or
-distribute the Library or its derivative works. These actions are
-prohibited by law if you do not accept this License. Therefore, by
-modifying or distributing the Library (or any work based on the
-Library), you indicate your acceptance of this License to do so, and
-all its terms and conditions for copying, distributing or modifying
-the Library or works based on it.
-
- 10. Each time you redistribute the Library (or any work based on the
-Library), the recipient automatically receives a license from the
-original licensor to copy, distribute, link with or modify the Library
-subject to these terms and conditions. You may not impose any further
-restrictions on the recipients' exercise of the rights granted herein.
-You are not responsible for enforcing compliance by third parties with
-this License.
-
- 11. If, as a consequence of a court judgment or allegation of patent
-infringement or for any other reason (not limited to patent issues),
-conditions are imposed on you (whether by court order, agreement or
-otherwise) that contradict the conditions of this License, they do not
-excuse you from the conditions of this License. If you cannot
-distribute so as to satisfy simultaneously your obligations under this
-License and any other pertinent obligations, then as a consequence you
-may not distribute the Library at all. For example, if a patent
-license would not permit royalty-free redistribution of the Library by
-all those who receive copies directly or indirectly through you, then
-the only way you could satisfy both it and this License would be to
-refrain entirely from distribution of the Library.
-
-If any portion of this section is held invalid or unenforceable under any
-particular circumstance, the balance of the section is intended to apply,
-and the section as a whole is intended to apply in other circumstances.
-
-It is not the purpose of this section to induce you to infringe any
-patents or other property right claims or to contest validity of any
-such claims; this section has the sole purpose of protecting the
-integrity of the free software distribution system which is
-implemented by public license practices. Many people have made
-generous contributions to the wide range of software distributed
-through that system in reliance on consistent application of that
-system; it is up to the author/donor to decide if he or she is willing
-to distribute software through any other system and a licensee cannot
-impose that choice.
-
-This section is intended to make thoroughly clear what is believed to
-be a consequence of the rest of this License.
-
- 12. If the distribution and/or use of the Library is restricted in
-certain countries either by patents or by copyrighted interfaces, the
-original copyright holder who places the Library under this License may add
-an explicit geographical distribution limitation excluding those countries,
-so that distribution is permitted only in or among countries not thus
-excluded. In such case, this License incorporates the limitation as if
-written in the body of this License.
-
- 13. The Free Software Foundation may publish revised and/or new
-versions of the Lesser General Public License from time to time.
-Such new versions will be similar in spirit to the present version,
-but may differ in detail to address new problems or concerns.
-
-Each version is given a distinguishing version number. If the Library
-specifies a version number of this License which applies to it and
-"any later version", you have the option of following the terms and
-conditions either of that version or of any later version published by
-the Free Software Foundation. If the Library does not specify a
-license version number, you may choose any version ever published by
-the Free Software Foundation.
-
- 14. If you wish to incorporate parts of the Library into other free
-programs whose distribution conditions are incompatible with these,
-write to the author to ask for permission. For software which is
-copyrighted by the Free Software Foundation, write to the Free
-Software Foundation; we sometimes make exceptions for this. Our
-decision will be guided by the two goals of preserving the free status
-of all derivatives of our free software and of promoting the sharing
-and reuse of software generally.
-
- NO WARRANTY
-
- 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
-WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
-EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
-OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
-KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
-LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
-THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
-
- 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
-WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
-AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
-FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
-CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
-LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
-RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
-FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
-SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
-DAMAGES.
-
- END OF TERMS AND CONDITIONS
-
- How to Apply These Terms to Your New Libraries
-
- If you develop a new library, and you want it to be of the greatest
-possible use to the public, we recommend making it free software that
-everyone can redistribute and change. You can do so by permitting
-redistribution under these terms (or, alternatively, under the terms of the
-ordinary General Public License).
-
- To apply these terms, attach the following notices to the library. It is
-safest to attach them to the start of each source file to most effectively
-convey the exclusion of warranty; and each file should have at least the
-"copyright" line and a pointer to where the full notice is found.
-
-
- Copyright (C)
-
- This library is free software; you can redistribute it and/or
- modify it under the terms of the GNU Lesser General Public
- License as published by the Free Software Foundation; either
- version 2.1 of the License, or (at your option) any later version.
-
- This library is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- Lesser General Public License for more details.
-
- You should have received a copy of the GNU Lesser General Public
- License along with this library; if not, write to the Free Software
- Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
-
-Also add information on how to contact you by electronic and paper mail.
-
-You should also get your employer (if you work as a programmer) or your
-school, if any, to sign a "copyright disclaimer" for the library, if
-necessary. Here is a sample; alter the names:
-
- Yoyodyne, Inc., hereby disclaims all copyright interest in the
- library `Frob' (a library for tweaking knobs) written by James Random Hacker.
-
- , 1 April 1990
- Ty Coon, President of Vice
-
-That's all there is to it!
-
- vim: et sw=4 sts=4
diff --git a/tools/htmlpurifier/index.php b/tools/htmlpurifier/index.php
deleted file mode 100644
index 051e0122d..000000000
--- a/tools/htmlpurifier/index.php
+++ /dev/null
@@ -1,29 +0,0 @@
-
-* @copyright 2010-2021 Webkul IN
-* @license https://store.webkul.com/license.html
-*/
-
-header('Expires: Mon, 26 Jul 1997 05:00:00 GMT');
-header('Last-Modified: '.gmdate('D, d M Y H:i:s').' GMT');
-
-header('Cache-Control: no-store, no-cache, must-revalidate');
-header('Cache-Control: post-check=0, pre-check=0', false);
-header('Pragma: no-cache');
-
-header('Location: ../../../');
-exit;
diff --git a/tools/http_build_url/http_build_url.php b/tools/http_build_url/http_build_url.php
index 388dda3af..49cbeaa6a 100644
--- a/tools/http_build_url/http_build_url.php
+++ b/tools/http_build_url/http_build_url.php
@@ -5,7 +5,6 @@
* http_build_url()".
*
* @see http://us2.php.net/manual/en/http.constants.php#http.constants.url
- * @see https://github.com/jakeasmith/http_build_url
*/
if (!defined('HTTP_URL_REPLACE')) {
define('HTTP_URL_REPLACE', 1);
@@ -93,6 +92,8 @@ if (!function_exists('http_build_url')) {
} else {
if (isset($parts['path']) && ($flags & HTTP_URL_JOIN_PATH)) {
if (isset($url['path']) && substr($parts['path'], 0, 1) !== '/') {
+ // Workaround for trailing slashes
+ $url['path'] .= 'a';
$url['path'] = rtrim(
str_replace(basename($url['path']), '', $url['path']),
'/'
@@ -119,6 +120,10 @@ if (!function_exists('http_build_url')) {
}
}
+ if (isset($url['path']) && $url['path'] !== '' && substr($url['path'], 0, 1) !== '/') {
+ $url['path'] = '/' . $url['path'];
+ }
+
foreach ($keys as $key) {
$strip = 'HTTP_URL_STRIP_' . strtoupper($key);
if ($flags & constant($strip)) {
@@ -128,11 +133,11 @@ if (!function_exists('http_build_url')) {
$parsed_string = '';
- if (isset($url['scheme'])) {
+ if (!empty($url['scheme'])) {
$parsed_string .= $url['scheme'] . '://';
}
- if (isset($url['user'])) {
+ if (!empty($url['user'])) {
$parsed_string .= $url['user'];
if (isset($url['pass'])) {
@@ -142,25 +147,23 @@ if (!function_exists('http_build_url')) {
$parsed_string .= '@';
}
- if (isset($url['host'])) {
+ if (!empty($url['host'])) {
$parsed_string .= $url['host'];
}
- if (isset($url['port'])) {
+ if (!empty($url['port'])) {
$parsed_string .= ':' . $url['port'];
}
if (!empty($url['path'])) {
$parsed_string .= $url['path'];
- } else {
- $parsed_string .= '/';
}
- if (isset($url['query'])) {
+ if (!empty($url['query'])) {
$parsed_string .= '?' . $url['query'];
}
- if (isset($url['fragment'])) {
+ if (!empty($url['fragment'])) {
$parsed_string .= '#' . $url['fragment'];
}
diff --git a/tools/js_minify/LICENSE b/tools/js_minify/LICENSE
index 1362c2a45..c6597d85c 100644
--- a/tools/js_minify/LICENSE
+++ b/tools/js_minify/LICENSE
@@ -1,21 +1,29 @@
-Copyright (c) 2002 Douglas Crockford (www.crockford.com)
+BSD 3-Clause License
-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:
+Copyright (c) 2009, Robert Hafner
+All rights reserved.
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
-The Software shall be used for Good, not Evil.
+1. Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
-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.
+2. Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+ contributors may be used to endorse or promote products derived from
+ this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/tools/js_minify/jsmin.php b/tools/js_minify/jsmin.php
index b6879f371..c85dd07f2 100644
--- a/tools/js_minify/jsmin.php
+++ b/tools/js_minify/jsmin.php
@@ -1,385 +1,721 @@
- * $minifiedJs = JSMin::minify($js);
- *
+ * (c) Robert Hafner
*
- * This is a modified port of jsmin.c. Improvements:
- *
- * Does not choke on some regexp literals containing quote characters. E.g. /'/
- *
- * Spaces are preserved after some add/sub operators, so they are not mistakenly
- * converted to post-inc/dec. E.g. a + ++b -> a+ ++b
- *
- * Preserves multi-line comments that begin with /*!
- *
- * PHP 5 or higher is required.
- *
- * Permission is hereby granted to use this version of the library under the
- * same terms as jsmin.c, which has the following license:
- *
- * --
- * Copyright (c) 2002 Douglas Crockford (www.crockford.com)
- *
- * 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 shall be used for Good, not Evil.
- *
- * 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.
- * --
- *
- * @package JSMin
- * @author Ryan Grove (PHP port)
- * @author Steve Clay (modifications + cleanup)
- * @author Andrea Giammarchi (spaceBeforeRegExp)
- * @copyright 2002 Douglas Crockford (jsmin.c)
- * @copyright 2008 Ryan Grove (PHP port)
- * @license http://opensource.org/licenses/mit-license.php MIT License
- * @link http://code.google.com/p/jsmin-php/
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
*/
-class JSMin {
- const ORD_LF = 10;
- const ORD_SPACE = 32;
- const ACTION_KEEP_A = 1;
- const ACTION_DELETE_A = 2;
- const ACTION_DELETE_A_B = 3;
+/**
+ * JShrink
+ *
+ *
+ * @package JShrink
+ * @author Robert Hafner
+ */
- protected $a = "\n";
- protected $b = '';
- protected $input = '';
- protected $inputIndex = 0;
- protected $inputLength = 0;
- protected $lookAhead = null;
- protected $output = '';
- protected $lastByteOut = '';
+namespace JShrink;
+
+/**
+ * Minifier
+ *
+ * Usage - Minifier::minify($js);
+ * Usage - Minifier::minify($js, $options);
+ * Usage - Minifier::minify($js, array('flaggedComments' => false));
+ *
+ * @package JShrink
+ * @author Robert Hafner
+ * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ */
+class Minifier
+{
+ /**
+ * The input javascript to be minified.
+ *
+ * @var string
+ */
+ protected $input;
/**
- * Minify Javascript.
+ * Length of input javascript.
*
- * @param string $js Javascript to be minified
- *
- * @return string
+ * @var int
*/
- public static function minify($js)
- {
- $jsmin = new JSMin($js);
- return $jsmin->min();
- }
+ protected $len = 0;
/**
- * @param string $input
+ * The location of the character (in the input string) that is next to be
+ * processed.
+ *
+ * @var int
*/
- public function __construct($input)
- {
- $this->input = $input;
- }
+ protected $index = 0;
/**
- * Perform minification, return result
+ * The first of the characters currently being looked at.
*
- * @return string
+ * @var string
*/
- public function min()
+ protected $a = '';
+
+ /**
+ * The next character being looked at (after a);
+ *
+ * @var string
+ */
+ protected $b = '';
+
+ /**
+ * This character is only active when certain look ahead actions take place.
+ *
+ * @var string
+ */
+ protected $c;
+
+ /**
+ * This character is only active when certain look ahead actions take place.
+ *
+ * @var string
+ */
+ protected $last_char;
+
+ /**
+ * This character is only active when certain look ahead actions take place.
+ *
+ * @var string
+ */
+ protected $output;
+
+ /**
+ * Contains the options for the current minification process.
+ *
+ * @var array
+ */
+ protected $options;
+
+ /**
+ * These characters are used to define strings.
+ */
+ protected $stringDelimiters = ['\'' => true, '"' => true, '`' => true];
+
+ /**
+ * Contains the default options for minification. This array is merged with
+ * the one passed in by the user to create the request specific set of
+ * options (stored in the $options attribute).
+ *
+ * @var array
+ */
+ protected static $defaultOptions = ['flaggedComments' => true];
+
+
+ protected static $keywords = ["delete", "do", "for", "in", "instanceof", "return", "typeof", "yield"];
+
+ protected $max_keyword_len;
+
+ /**
+ * Contains lock ids which are used to replace certain code patterns and
+ * prevent them from being minified
+ *
+ * @var array
+ */
+ protected $locks = [];
+
+ /**
+ * Takes a string containing javascript and removes unneeded characters in
+ * order to shrink the code without altering it's functionality.
+ *
+ * @param string $js The raw javascript to be minified
+ * @param array $options Various runtime options in an associative array
+ * @throws \Exception
+ * @return bool|string
+ */
+ public static function minify($js, $options = [])
{
- if ($this->output !== '') { // min already run
- return $this->output;
- }
-
- $mbIntEnc = null;
- if (function_exists('mb_strlen') && ((int)ini_get('mbstring.func_overload') & 2)) {
- $mbIntEnc = mb_internal_encoding();
- mb_internal_encoding('8bit');
- }
- $this->input = str_replace("\r\n", "\n", $this->input);
- $this->inputLength = strlen($this->input);
-
- $this->action(self::ACTION_DELETE_A_B);
-
- while ($this->a !== null) {
- // determine next command
- $command = self::ACTION_KEEP_A; // default
- if ($this->a === ' ') {
- if (($this->lastByteOut === '+' || $this->lastByteOut === '-')
- && ($this->b === $this->lastByteOut)) {
- // Don't delete this space. If we do, the addition/subtraction
- // could be parsed as a post-increment
- } elseif (! $this->isAlphaNum($this->b)) {
- $command = self::ACTION_DELETE_A;
- }
- } elseif ($this->a === "\n") {
- if ($this->b === ' ') {
- $command = self::ACTION_DELETE_A_B;
- // in case of mbstring.func_overload & 2, must check for null b,
- // otherwise mb_strpos will give WARNING
- } elseif ($this->b === null
- || (false === strpos('{[(+-', $this->b)
- && ! $this->isAlphaNum($this->b))) {
- $command = self::ACTION_DELETE_A;
- }
- } elseif (! $this->isAlphaNum($this->a)) {
- if ($this->b === ' '
- || ($this->b === "\n"
- && (false === strpos('}])+-"\'', $this->a)))) {
- $command = self::ACTION_DELETE_A_B;
- }
+ try {
+ $jshrink = new Minifier();
+ $js = $jshrink->lock($js);
+ $js = ltrim($jshrink->minifyToString($js, $options));
+ $js = $jshrink->unlock($js);
+ unset($jshrink);
+ return $js;
+ } catch (\Exception $e) {
+ if (isset($jshrink)) {
+ // Since the breakdownScript function probably wasn't finished
+ // we clean it out before discarding it.
+ $jshrink->clean();
+ unset($jshrink);
}
- $this->action($command);
+ throw $e;
}
- $this->output = trim($this->output);
+ }
- if ($mbIntEnc !== null) {
- mb_internal_encoding($mbIntEnc);
- }
+ /**
+ * Processes a javascript string and outputs only the required characters,
+ * stripping out all unneeded characters.
+ *
+ * @param string $js The raw javascript to be minified
+ * @param array $options Various runtime options in an associative array
+ */
+ protected function minifyToString($js, $options)
+ {
+ $this->initialize($js, $options);
+ $this->loop();
+ $this->clean();
return $this->output;
}
/**
- * ACTION_KEEP_A = Output A. Copy B to A. Get the next B.
- * ACTION_DELETE_A = Copy B to A. Get the next B.
- * ACTION_DELETE_A_B = Get the next B.
+ * Initializes internal variables, normalizes new lines,
*
- * @param int $command
- * @throws JSMin_UnterminatedRegExpException|JSMin_UnterminatedStringException
+ * @param string $js The raw javascript to be minified
+ * @param array $options Various runtime options in an associative array
*/
- protected function action($command)
+ protected function initialize($js, $options)
{
- if ($command === self::ACTION_DELETE_A_B
- && $this->b === ' '
- && ($this->a === '+' || $this->a === '-')) {
- // Note: we're at an addition/substraction operator; the inputIndex
- // will certainly be a valid index
- if ($this->input[$this->inputIndex] === $this->a) {
- // This is "+ +" or "- -". Don't delete the space.
- $command = self::ACTION_KEEP_A;
- }
- }
- switch ($command) {
- case self::ACTION_KEEP_A:
- $this->output .= $this->a;
- $this->lastByteOut = $this->a;
-
- // fallthrough
- case self::ACTION_DELETE_A:
- $this->a = $this->b;
- if ($this->a === "'" || $this->a === '"') { // string literal
- $str = $this->a; // in case needed for exception
- while (true) {
- $this->output .= $this->a;
- $this->lastByteOut = $this->a;
-
- $this->a = $this->get();
- if ($this->a === $this->b) { // end quote
+ $this->options = array_merge(static::$defaultOptions, $options);
+ $this->input = $js;
+
+ // We add a newline to the end of the script to make it easier to deal
+ // with comments at the bottom of the script- this prevents the unclosed
+ // comment error that can otherwise occur.
+ $this->input .= PHP_EOL;
+
+ // save input length to skip calculation every time
+ $this->len = strlen($this->input);
+
+ // Populate "a" with a new line, "b" with the first character, before
+ // entering the loop
+ $this->a = "\n";
+ $this->b = "\n";
+ $this->last_char = "\n";
+ $this->output = "";
+
+ $this->max_keyword_len = max(array_map('strlen', static::$keywords));
+ }
+
+ /**
+ * Characters that can't stand alone preserve the newline.
+ *
+ * @var array
+ */
+ protected $noNewLineCharacters = [
+ '(' => true,
+ '-' => true,
+ '+' => true,
+ '[' => true,
+ '#' => true,
+ '@' => true];
+
+
+ protected function echo($char) {
+ $this->output .= $char;
+ $this->last_char = $char[-1];
+ }
+
+
+ /**
+ * The primary action occurs here. This function loops through the input string,
+ * outputting anything that's relevant and discarding anything that is not.
+ */
+ protected function loop()
+ {
+ while ($this->a !== false && !is_null($this->a) && $this->a !== '') {
+ switch ($this->a) {
+ // new lines
+ case "\r":
+ case "\n":
+ // if the next line is something that can't stand alone preserve the newline
+ if ($this->b !== false && isset($this->noNewLineCharacters[$this->b])) {
+ $this->echo($this->a);
+ $this->saveString();
+ break;
+ }
+
+ // if B is a space we skip the rest of the switch block and go down to the
+ // string/regex check below, resetting $this->b with getReal
+ if ($this->b === ' ') {
+ break;
+ }
+
+ // otherwise we treat the newline like a space
+
+ // no break
+ case ' ':
+ if (static::isAlphaNumeric($this->b)) {
+ $this->echo($this->a);
+ }
+
+ $this->saveString();
+ break;
+
+ default:
+ switch ($this->b) {
+ case "\r":
+ case "\n":
+ if (strpos('}])+-"\'', $this->a) !== false) {
+ $this->echo($this->a);
+ $this->saveString();
+ break;
+ } else {
+ if (static::isAlphaNumeric($this->a)) {
+ $this->echo($this->a);
+ $this->saveString();
+ }
+ }
+ break;
+
+ case ' ':
+ if (!static::isAlphaNumeric($this->a)) {
+ break;
+ }
+
+ // no break
+ default:
+ // check for some regex that breaks stuff
+ if ($this->a === '/' && ($this->b === '\'' || $this->b === '"')) {
+ $this->saveRegex();
+ continue 3;
+ }
+
+ $this->echo($this->a);
+ $this->saveString();
break;
- }
- if (ord($this->a) <= self::ORD_LF) {
- throw new JSMin_UnterminatedStringException(
- "JSMin: Unterminated String at byte "
- . $this->inputIndex . ": {$str}");
- }
- $str .= $this->a;
- if ($this->a === '\\') {
- $this->output .= $this->a;
- $this->lastByteOut = $this->a;
-
- $this->a = $this->get();
- $str .= $this->a;
- }
}
+ }
+
+ // do reg check of doom
+ $this->b = $this->getReal();
+
+ if ($this->b == '/') {
+ $valid_tokens = "(,=:[!&|?\n";
+
+ # Find last "real" token, excluding spaces.
+ $last_token = $this->a;
+ if ($last_token == " ") {
+ $last_token = $this->last_char;
}
- // fallthrough
- case self::ACTION_DELETE_A_B:
- $this->b = $this->next();
- if ($this->b === '/' && $this->isRegexpLiteral()) { // RegExp literal
- $this->output .= $this->a . $this->b;
- $pattern = '/'; // in case needed for exception
- while (true) {
- $this->a = $this->get();
- $pattern .= $this->a;
- if ($this->a === '/') { // end pattern
- break; // while (true)
- } elseif ($this->a === '\\') {
- $this->output .= $this->a;
- $this->a = $this->get();
- $pattern .= $this->a;
- } elseif (ord($this->a) <= self::ORD_LF) {
- throw new JSMin_UnterminatedRegExpException(
- "JSMin: Unterminated RegExp at byte "
- . $this->inputIndex .": {$pattern}");
- }
- $this->output .= $this->a;
- $this->lastByteOut = $this->a;
- }
- $this->b = $this->next();
+
+ if (strpos($valid_tokens, $last_token) !== false) {
+ // Regex can appear unquoted after these symbols
+ $this->saveRegex();
+ } else if ($this->endsInKeyword()) {
+ // This block checks for the "return" token before the slash.
+ $this->saveRegex();
}
- // end case ACTION_DELETE_A_B
+ }
+
+ // if (($this->b == '/' && strpos('(,=:[!&|?', $this->a) !== false)) {
+ // $this->saveRegex();
+ // }
}
}
/**
+ * Resets attributes that do not need to be stored between requests so that
+ * the next request is ready to go. Another reason for this is to make sure
+ * the variables are cleared and are not taking up memory.
+ */
+ protected function clean()
+ {
+ unset($this->input);
+ $this->len = 0;
+ $this->index = 0;
+ $this->a = $this->b = '';
+ unset($this->c);
+ unset($this->options);
+ }
+
+ /**
+ * Returns the next string for processing based off of the current index.
+ *
+ * @return string
+ */
+ protected function getChar()
+ {
+ // Check to see if we had anything in the look ahead buffer and use that.
+ if (isset($this->c)) {
+ $char = $this->c;
+ unset($this->c);
+ } else {
+ // Otherwise we start pulling from the input.
+ $char = $this->index < $this->len ? $this->input[$this->index] : false;
+
+ // If the next character doesn't exist return false.
+ if (isset($char) && $char === false) {
+ return false;
+ }
+
+ // Otherwise increment the pointer and use this char.
+ $this->index++;
+ }
+
+ # Convert all line endings to unix standard.
+ # `\r\n` converts to `\n\n` and is minified.
+ if ($char == "\r") {
+ $char = "\n";
+ }
+
+ // Normalize all whitespace except for the newline character into a
+ // standard space.
+ if ($char !== "\n" && $char < "\x20") {
+ return ' ';
+ }
+
+ return $char;
+ }
+
+ /**
+ * This function returns the next character without moving the index forward.
+ *
+ *
+ * @return string The next character
+ * @throws \RuntimeException
+ */
+ protected function peek()
+ {
+ if ($this->index >= $this->len) {
+ return false;
+ }
+
+ $char = $this->input[$this->index];
+ # Convert all line endings to unix standard.
+ # `\r\n` converts to `\n\n` and is minified.
+ if ($char == "\r") {
+ $char = "\n";
+ }
+
+ // Normalize all whitespace except for the newline character into a
+ // standard space.
+ if ($char !== "\n" && $char < "\x20") {
+ return ' ';
+ }
+
+ # Return the next character but don't push the index.
+ return $char;
+ }
+
+ /**
+ * This function gets the next "real" character. It is essentially a wrapper
+ * around the getChar function that skips comments. This has significant
+ * performance benefits as the skipping is done using native functions (ie,
+ * c code) rather than in script php.
+ *
+ *
+ * @return string Next 'real' character to be processed.
+ * @throws \RuntimeException
+ */
+ protected function getReal()
+ {
+ $startIndex = $this->index;
+ $char = $this->getChar();
+
+ // Check to see if we're potentially in a comment
+ if ($char !== '/') {
+ return $char;
+ }
+
+ $this->c = $this->getChar();
+
+ if ($this->c === '/') {
+ $this->processOneLineComments($startIndex);
+
+ return $this->getReal();
+ } elseif ($this->c === '*') {
+ $this->processMultiLineComments($startIndex);
+
+ return $this->getReal();
+ }
+
+ return $char;
+ }
+
+ /**
+ * Removed one line comments, with the exception of some very specific types of
+ * conditional comments.
+ *
+ * @param int $startIndex The index point where "getReal" function started
+ * @return void
+ */
+ protected function processOneLineComments($startIndex)
+ {
+ $thirdCommentString = $this->index < $this->len ? $this->input[$this->index] : false;
+
+ // kill rest of line
+ $this->getNext("\n");
+
+ unset($this->c);
+
+ if ($thirdCommentString == '@') {
+ $endPoint = $this->index - $startIndex;
+ $this->c = "\n" . substr($this->input, $startIndex, $endPoint);
+ }
+ }
+
+ /**
+ * Skips multiline comments where appropriate, and includes them where needed.
+ * Conditional comments and "license" style blocks are preserved.
+ *
+ * @param int $startIndex The index point where "getReal" function started
+ * @return void
+ * @throws \RuntimeException Unclosed comments will throw an error
+ */
+ protected function processMultiLineComments($startIndex)
+ {
+ $this->getChar(); // current C
+ $thirdCommentString = $this->getChar();
+
+ // Detect a completely empty comment, ie `/**/`
+ if ($thirdCommentString == "*") {
+ $peekChar = $this->peek();
+ if ($peekChar == "/") {
+ $this->index++;
+ return;
+ }
+ }
+
+ // kill everything up to the next */ if it's there
+ if ($this->getNext('*/')) {
+ $this->getChar(); // get *
+ $this->getChar(); // get /
+ $char = $this->getChar(); // get next real character
+
+ // Now we reinsert conditional comments and YUI-style licensing comments
+ if (($this->options['flaggedComments'] && $thirdCommentString === '!')
+ || ($thirdCommentString === '@')) {
+
+ // If conditional comments or flagged comments are not the first thing in the script
+ // we need to echo a and fill it with a space before moving on.
+ if ($startIndex > 0) {
+ $this->echo($this->a);
+ $this->a = " ";
+
+ // If the comment started on a new line we let it stay on the new line
+ if ($this->input[($startIndex - 1)] === "\n") {
+ $this->echo("\n");
+ }
+ }
+
+ $endPoint = ($this->index - 1) - $startIndex;
+ $this->echo(substr($this->input, $startIndex, $endPoint));
+
+ $this->c = $char;
+
+ return;
+ }
+ } else {
+ $char = false;
+ }
+
+ if ($char === false) {
+ throw new \RuntimeException('Unclosed multiline comment at position: ' . ($this->index - 2));
+ }
+
+ // if we're here c is part of the comment and therefore tossed
+ $this->c = $char;
+ }
+
+ /**
+ * Pushes the index ahead to the next instance of the supplied string. If it
+ * is found the first character of the string is returned and the index is set
+ * to it's position.
+ *
+ * @param string $string
+ * @return string|false Returns the first character of the string or false.
+ */
+ protected function getNext($string)
+ {
+ // Find the next occurrence of "string" after the current position.
+ $pos = strpos($this->input, $string, $this->index);
+
+ // If it's not there return false.
+ if ($pos === false) {
+ return false;
+ }
+
+ // Adjust position of index to jump ahead to the asked for string
+ $this->index = $pos;
+
+ // Return the first character of that string.
+ return $this->index < $this->len ? $this->input[$this->index] : false;
+ }
+
+ /**
+ * When a javascript string is detected this function crawls for the end of
+ * it and saves the whole string.
+ *
+ * @throws \RuntimeException Unclosed strings will throw an error
+ */
+ protected function saveString()
+ {
+ $startpos = $this->index;
+
+ // saveString is always called after a gets cleared, so we push b into
+ // that spot.
+ $this->a = $this->b;
+
+ // If this isn't a string we don't need to do anything.
+ if (!isset($this->stringDelimiters[$this->a])) {
+ return;
+ }
+
+ // String type is the quote used, " or '
+ $stringType = $this->a;
+
+ // Echo out that starting quote
+ $this->echo($this->a);
+
+ // Loop until the string is done
+ // Grab the very next character and load it into a
+ while (($this->a = $this->getChar()) !== false) {
+ switch ($this->a) {
+
+ // If the string opener (single or double quote) is used
+ // output it and break out of the while loop-
+ // The string is finished!
+ case $stringType:
+ break 2;
+
+ // New lines in strings without line delimiters are bad- actual
+ // new lines will be represented by the string \n and not the actual
+ // character, so those will be treated just fine using the switch
+ // block below.
+ case "\n":
+ if ($stringType === '`') {
+ $this->echo($this->a);
+ } else {
+ throw new \RuntimeException('Unclosed string at position: ' . $startpos);
+ }
+ break;
+
+ // Escaped characters get picked up here. If it's an escaped new line it's not really needed
+ case '\\':
+
+ // a is a slash. We want to keep it, and the next character,
+ // unless it's a new line. New lines as actual strings will be
+ // preserved, but escaped new lines should be reduced.
+ $this->b = $this->getChar();
+
+ // If b is a new line we discard a and b and restart the loop.
+ if ($this->b === "\n") {
+ break;
+ }
+
+ // echo out the escaped character and restart the loop.
+ $this->echo($this->a . $this->b);
+ break;
+
+
+ // Since we're not dealing with any special cases we simply
+ // output the character and continue our loop.
+ default:
+ $this->echo($this->a);
+ }
+ }
+ }
+
+ /**
+ * When a regular expression is detected this function crawls for the end of
+ * it and saves the whole regex.
+ *
+ * @throws \RuntimeException Unclosed regex will throw an error
+ */
+ protected function saveRegex()
+ {
+ if ($this->a != " ") {
+ $this->echo($this->a);
+ }
+
+ $this->echo($this->b);
+
+ while (($this->a = $this->getChar()) !== false) {
+ if ($this->a === '/') {
+ break;
+ }
+
+ if ($this->a === '\\') {
+ $this->echo($this->a);
+ $this->a = $this->getChar();
+ }
+
+ if ($this->a === "\n") {
+ throw new \RuntimeException('Unclosed regex pattern at position: ' . $this->index);
+ }
+
+ $this->echo($this->a);
+ }
+ $this->b = $this->getReal();
+ }
+
+ /**
+ * Checks to see if a character is alphanumeric.
+ *
+ * @param string $char Just one character
* @return bool
*/
- protected function isRegexpLiteral()
+ protected static function isAlphaNumeric($char)
{
- if (false !== strpos("\n{;(,=:[!&|?", $this->a)) { // we aren't dividing
- return true;
- }
- if (' ' === $this->a) {
- $length = strlen($this->output);
- if ($length < 2) { // weird edge case
+ return preg_match('/^[\w\$\pL]$/', $char) === 1 || $char == '/';
+ }
+
+ protected function endsInKeyword() {
+
+ # When this function is called A is not yet assigned to output.
+ # Regular expression only needs to check final part of output for keyword.
+ $testOutput = substr($this->output . $this->a, -1 * ($this->max_keyword_len + 10));
+
+ foreach(static::$keywords as $keyword) {
+ if (preg_match('/[^\w]'.$keyword.'[ ]?$/i', $testOutput) === 1) {
return true;
}
- // you can't divide a keyword
- if (preg_match('/(?:case|else|in|return|typeof)$/', $this->output, $m)) {
- if ($this->output === $m[0]) { // odd but could happen
- return true;
- }
- // make sure it's a keyword, not end of an identifier
- $charBeforeKeyword = substr($this->output, $length - strlen($m[0]) - 1, 1);
- if (! $this->isAlphaNum($charBeforeKeyword)) {
- return true;
- }
- }
}
return false;
}
- /**
- * Get next char. Convert ctrl char to space.
- *
- * @return string
- */
- protected function get()
- {
- $c = $this->lookAhead;
- $this->lookAhead = null;
- if ($c === null) {
- if ($this->inputIndex < $this->inputLength) {
- $c = $this->input[$this->inputIndex];
- $this->inputIndex += 1;
- } else {
- return null;
- }
- }
- if ($c === "\r" || $c === "\n") {
- return "\n";
- }
- if (ord($c) < self::ORD_SPACE) { // control char
- return ' ';
- }
- return $c;
- }
+
/**
- * Get next char. If is ctrl character, translate to a space or newline.
- *
- * @return string
- */
- protected function peek()
- {
- $this->lookAhead = $this->get();
- return $this->lookAhead;
- }
-
- /**
- * Is $c a letter, digit, underscore, dollar sign, escape, or non-ASCII?
- *
- * @param string $c
+ * Replace patterns in the given string and store the replacement
*
+ * @param string $js The string to lock
* @return bool
*/
- protected function isAlphaNum($c)
+ protected function lock($js)
{
- return (preg_match('/^[0-9a-zA-Z_\\$\\\\]$/', $c) || ord($c) > 126);
- }
+ /* lock things like "asd" + ++x; */
+ $lock = '"LOCK---' . crc32(time()) . '"';
- /**
- * @return string
- */
- protected function singleLineComment()
- {
- $comment = '';
- while (true) {
- $get = $this->get();
- $comment .= $get;
- if (ord($get) <= self::ORD_LF) { // EOL reached
- // if IE conditional comment
- if (preg_match('/^\\/@(?:cc_on|if|elif|else|end)\\b/', $comment)) {
- return "/{$comment}";
- }
- return $get;
- }
+ $matches = [];
+ preg_match('/([+-])(\s+)([+-])/S', $js, $matches);
+ if (empty($matches)) {
+ return $js;
}
+
+ $this->locks[$lock] = $matches[2];
+
+ $js = preg_replace('/([+-])\s+([+-])/S', "$1{$lock}$2", $js);
+ /* -- */
+
+ return $js;
}
/**
- * @return string
- * @throws JSMin_UnterminatedCommentException
- */
- protected function multipleLineComment()
- {
- $this->get();
- $comment = '';
- while (true) {
- $get = $this->get();
- if ($get === '*') {
- if ($this->peek() === '/') { // end of comment reached
- $this->get();
- // if comment preserved by YUI Compressor
- if (0 === strpos($comment, '!')) {
- return "\n/*!" . substr($comment, 1) . "*/\n";
- }
- // if IE conditional comment
- if (preg_match('/^@(?:cc_on|if|elif|else|end)\\b/', $comment)) {
- return "/*{$comment}*/";
- }
- return ' ';
- }
- } elseif ($get === null) {
- throw new JSMin_UnterminatedCommentException(
- "JSMin: Unterminated comment at byte "
- . $this->inputIndex . ": /*{$comment}");
- }
- $comment .= $get;
- }
- }
-
- /**
- * Get the next character, skipping over comments.
- * Some comments may be preserved.
+ * Replace "locks" with the original characters
*
- * @return string
+ * @param string $js The string to unlock
+ * @return bool
*/
- protected function next()
+ protected function unlock($js)
{
- $get = $this->get();
- if ($get !== '/') {
- return $get;
+ if (empty($this->locks)) {
+ return $js;
}
- switch ($this->peek()) {
- case '/': return $this->singleLineComment();
- case '*': return $this->multipleLineComment();
- default: return $get;
- }
- }
-}
-class JSMin_UnterminatedStringException extends Exception {}
-class JSMin_UnterminatedCommentException extends Exception {}
-class JSMin_UnterminatedRegExpException extends Exception {}
+ foreach ($this->locks as $lock => $replacement) {
+ $js = str_replace($lock, $replacement, $js);
+ }
+
+ return $js;
+ }
+}
\ No newline at end of file
diff --git a/tools/mailer/autoload.php b/tools/mailer/autoload.php
new file mode 100644
index 000000000..bec346a85
--- /dev/null
+++ b/tools/mailer/autoload.php
@@ -0,0 +1,7 @@
+
+ * Jordi Boggiano
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Composer\Autoload;
+
+/**
+ * ClassLoader implements a PSR-0, PSR-4 and classmap class loader.
+ *
+ * $loader = new \Composer\Autoload\ClassLoader();
+ *
+ * // register classes with namespaces
+ * $loader->add('Symfony\Component', __DIR__.'/component');
+ * $loader->add('Symfony', __DIR__.'/framework');
+ *
+ * // activate the autoloader
+ * $loader->register();
+ *
+ * // to enable searching the include path (eg. for PEAR packages)
+ * $loader->setUseIncludePath(true);
+ *
+ * In this example, if you try to use a class in the Symfony\Component
+ * namespace or one of its children (Symfony\Component\Console for instance),
+ * the autoloader will first look for the class under the component/
+ * directory, and it will then fallback to the framework/ directory if not
+ * found before giving up.
+ *
+ * This class is loosely based on the Symfony UniversalClassLoader.
+ *
+ * @author Fabien Potencier
+ * @author Jordi Boggiano
+ * @see https://www.php-fig.org/psr/psr-0/
+ * @see https://www.php-fig.org/psr/psr-4/
+ */
+class ClassLoader
+{
+ /** @var ?string */
+ private $vendorDir;
+
+ // PSR-4
+ /**
+ * @var array[]
+ * @psalm-var array>
+ */
+ private $prefixLengthsPsr4 = array();
+ /**
+ * @var array[]
+ * @psalm-var array>
+ */
+ private $prefixDirsPsr4 = array();
+ /**
+ * @var array[]
+ * @psalm-var array
+ */
+ private $fallbackDirsPsr4 = array();
+
+ // PSR-0
+ /**
+ * @var array[]
+ * @psalm-var array>
+ */
+ private $prefixesPsr0 = array();
+ /**
+ * @var array[]
+ * @psalm-var array
+ */
+ private $fallbackDirsPsr0 = array();
+
+ /** @var bool */
+ private $useIncludePath = false;
+
+ /**
+ * @var string[]
+ * @psalm-var array
+ */
+ private $classMap = array();
+
+ /** @var bool */
+ private $classMapAuthoritative = false;
+
+ /**
+ * @var bool[]
+ * @psalm-var array
+ */
+ private $missingClasses = array();
+
+ /** @var ?string */
+ private $apcuPrefix;
+
+ /**
+ * @var self[]
+ */
+ private static $registeredLoaders = array();
+
+ /**
+ * @param ?string $vendorDir
+ */
+ public function __construct($vendorDir = null)
+ {
+ $this->vendorDir = $vendorDir;
+ }
+
+ /**
+ * @return string[]
+ */
+ public function getPrefixes()
+ {
+ if (!empty($this->prefixesPsr0)) {
+ return call_user_func_array('array_merge', array_values($this->prefixesPsr0));
+ }
+
+ return array();
+ }
+
+ /**
+ * @return array[]
+ * @psalm-return array>
+ */
+ public function getPrefixesPsr4()
+ {
+ return $this->prefixDirsPsr4;
+ }
+
+ /**
+ * @return array[]
+ * @psalm-return array
+ */
+ public function getFallbackDirs()
+ {
+ return $this->fallbackDirsPsr0;
+ }
+
+ /**
+ * @return array[]
+ * @psalm-return array
+ */
+ public function getFallbackDirsPsr4()
+ {
+ return $this->fallbackDirsPsr4;
+ }
+
+ /**
+ * @return string[] Array of classname => path
+ * @psalm-return array
+ */
+ public function getClassMap()
+ {
+ return $this->classMap;
+ }
+
+ /**
+ * @param string[] $classMap Class to filename map
+ * @psalm-param array $classMap
+ *
+ * @return void
+ */
+ public function addClassMap(array $classMap)
+ {
+ if ($this->classMap) {
+ $this->classMap = array_merge($this->classMap, $classMap);
+ } else {
+ $this->classMap = $classMap;
+ }
+ }
+
+ /**
+ * Registers a set of PSR-0 directories for a given prefix, either
+ * appending or prepending to the ones previously set for this prefix.
+ *
+ * @param string $prefix The prefix
+ * @param string[]|string $paths The PSR-0 root directories
+ * @param bool $prepend Whether to prepend the directories
+ *
+ * @return void
+ */
+ public function add($prefix, $paths, $prepend = false)
+ {
+ if (!$prefix) {
+ if ($prepend) {
+ $this->fallbackDirsPsr0 = array_merge(
+ (array) $paths,
+ $this->fallbackDirsPsr0
+ );
+ } else {
+ $this->fallbackDirsPsr0 = array_merge(
+ $this->fallbackDirsPsr0,
+ (array) $paths
+ );
+ }
+
+ return;
+ }
+
+ $first = $prefix[0];
+ if (!isset($this->prefixesPsr0[$first][$prefix])) {
+ $this->prefixesPsr0[$first][$prefix] = (array) $paths;
+
+ return;
+ }
+ if ($prepend) {
+ $this->prefixesPsr0[$first][$prefix] = array_merge(
+ (array) $paths,
+ $this->prefixesPsr0[$first][$prefix]
+ );
+ } else {
+ $this->prefixesPsr0[$first][$prefix] = array_merge(
+ $this->prefixesPsr0[$first][$prefix],
+ (array) $paths
+ );
+ }
+ }
+
+ /**
+ * Registers a set of PSR-4 directories for a given namespace, either
+ * appending or prepending to the ones previously set for this namespace.
+ *
+ * @param string $prefix The prefix/namespace, with trailing '\\'
+ * @param string[]|string $paths The PSR-4 base directories
+ * @param bool $prepend Whether to prepend the directories
+ *
+ * @throws \InvalidArgumentException
+ *
+ * @return void
+ */
+ public function addPsr4($prefix, $paths, $prepend = false)
+ {
+ if (!$prefix) {
+ // Register directories for the root namespace.
+ if ($prepend) {
+ $this->fallbackDirsPsr4 = array_merge(
+ (array) $paths,
+ $this->fallbackDirsPsr4
+ );
+ } else {
+ $this->fallbackDirsPsr4 = array_merge(
+ $this->fallbackDirsPsr4,
+ (array) $paths
+ );
+ }
+ } elseif (!isset($this->prefixDirsPsr4[$prefix])) {
+ // Register directories for a new namespace.
+ $length = strlen($prefix);
+ if ('\\' !== $prefix[$length - 1]) {
+ throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
+ }
+ $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
+ $this->prefixDirsPsr4[$prefix] = (array) $paths;
+ } elseif ($prepend) {
+ // Prepend directories for an already registered namespace.
+ $this->prefixDirsPsr4[$prefix] = array_merge(
+ (array) $paths,
+ $this->prefixDirsPsr4[$prefix]
+ );
+ } else {
+ // Append directories for an already registered namespace.
+ $this->prefixDirsPsr4[$prefix] = array_merge(
+ $this->prefixDirsPsr4[$prefix],
+ (array) $paths
+ );
+ }
+ }
+
+ /**
+ * Registers a set of PSR-0 directories for a given prefix,
+ * replacing any others previously set for this prefix.
+ *
+ * @param string $prefix The prefix
+ * @param string[]|string $paths The PSR-0 base directories
+ *
+ * @return void
+ */
+ public function set($prefix, $paths)
+ {
+ if (!$prefix) {
+ $this->fallbackDirsPsr0 = (array) $paths;
+ } else {
+ $this->prefixesPsr0[$prefix[0]][$prefix] = (array) $paths;
+ }
+ }
+
+ /**
+ * Registers a set of PSR-4 directories for a given namespace,
+ * replacing any others previously set for this namespace.
+ *
+ * @param string $prefix The prefix/namespace, with trailing '\\'
+ * @param string[]|string $paths The PSR-4 base directories
+ *
+ * @throws \InvalidArgumentException
+ *
+ * @return void
+ */
+ public function setPsr4($prefix, $paths)
+ {
+ if (!$prefix) {
+ $this->fallbackDirsPsr4 = (array) $paths;
+ } else {
+ $length = strlen($prefix);
+ if ('\\' !== $prefix[$length - 1]) {
+ throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
+ }
+ $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
+ $this->prefixDirsPsr4[$prefix] = (array) $paths;
+ }
+ }
+
+ /**
+ * Turns on searching the include path for class files.
+ *
+ * @param bool $useIncludePath
+ *
+ * @return void
+ */
+ public function setUseIncludePath($useIncludePath)
+ {
+ $this->useIncludePath = $useIncludePath;
+ }
+
+ /**
+ * Can be used to check if the autoloader uses the include path to check
+ * for classes.
+ *
+ * @return bool
+ */
+ public function getUseIncludePath()
+ {
+ return $this->useIncludePath;
+ }
+
+ /**
+ * Turns off searching the prefix and fallback directories for classes
+ * that have not been registered with the class map.
+ *
+ * @param bool $classMapAuthoritative
+ *
+ * @return void
+ */
+ public function setClassMapAuthoritative($classMapAuthoritative)
+ {
+ $this->classMapAuthoritative = $classMapAuthoritative;
+ }
+
+ /**
+ * Should class lookup fail if not found in the current class map?
+ *
+ * @return bool
+ */
+ public function isClassMapAuthoritative()
+ {
+ return $this->classMapAuthoritative;
+ }
+
+ /**
+ * APCu prefix to use to cache found/not-found classes, if the extension is enabled.
+ *
+ * @param string|null $apcuPrefix
+ *
+ * @return void
+ */
+ public function setApcuPrefix($apcuPrefix)
+ {
+ $this->apcuPrefix = function_exists('apcu_fetch') && filter_var(ini_get('apc.enabled'), FILTER_VALIDATE_BOOLEAN) ? $apcuPrefix : null;
+ }
+
+ /**
+ * The APCu prefix in use, or null if APCu caching is not enabled.
+ *
+ * @return string|null
+ */
+ public function getApcuPrefix()
+ {
+ return $this->apcuPrefix;
+ }
+
+ /**
+ * Registers this instance as an autoloader.
+ *
+ * @param bool $prepend Whether to prepend the autoloader or not
+ *
+ * @return void
+ */
+ public function register($prepend = false)
+ {
+ spl_autoload_register(array($this, 'loadClass'), true, $prepend);
+
+ if (null === $this->vendorDir) {
+ return;
+ }
+
+ if ($prepend) {
+ self::$registeredLoaders = array($this->vendorDir => $this) + self::$registeredLoaders;
+ } else {
+ unset(self::$registeredLoaders[$this->vendorDir]);
+ self::$registeredLoaders[$this->vendorDir] = $this;
+ }
+ }
+
+ /**
+ * Unregisters this instance as an autoloader.
+ *
+ * @return void
+ */
+ public function unregister()
+ {
+ spl_autoload_unregister(array($this, 'loadClass'));
+
+ if (null !== $this->vendorDir) {
+ unset(self::$registeredLoaders[$this->vendorDir]);
+ }
+ }
+
+ /**
+ * Loads the given class or interface.
+ *
+ * @param string $class The name of the class
+ * @return true|null True if loaded, null otherwise
+ */
+ public function loadClass($class)
+ {
+ if ($file = $this->findFile($class)) {
+ includeFile($file);
+
+ return true;
+ }
+
+ return null;
+ }
+
+ /**
+ * Finds the path to the file where the class is defined.
+ *
+ * @param string $class The name of the class
+ *
+ * @return string|false The path if found, false otherwise
+ */
+ public function findFile($class)
+ {
+ // class map lookup
+ if (isset($this->classMap[$class])) {
+ return $this->classMap[$class];
+ }
+ if ($this->classMapAuthoritative || isset($this->missingClasses[$class])) {
+ return false;
+ }
+ if (null !== $this->apcuPrefix) {
+ $file = apcu_fetch($this->apcuPrefix.$class, $hit);
+ if ($hit) {
+ return $file;
+ }
+ }
+
+ $file = $this->findFileWithExtension($class, '.php');
+
+ // Search for Hack files if we are running on HHVM
+ if (false === $file && defined('HHVM_VERSION')) {
+ $file = $this->findFileWithExtension($class, '.hh');
+ }
+
+ if (null !== $this->apcuPrefix) {
+ apcu_add($this->apcuPrefix.$class, $file);
+ }
+
+ if (false === $file) {
+ // Remember that this class does not exist.
+ $this->missingClasses[$class] = true;
+ }
+
+ return $file;
+ }
+
+ /**
+ * Returns the currently registered loaders indexed by their corresponding vendor directories.
+ *
+ * @return self[]
+ */
+ public static function getRegisteredLoaders()
+ {
+ return self::$registeredLoaders;
+ }
+
+ /**
+ * @param string $class
+ * @param string $ext
+ * @return string|false
+ */
+ private function findFileWithExtension($class, $ext)
+ {
+ // PSR-4 lookup
+ $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext;
+
+ $first = $class[0];
+ if (isset($this->prefixLengthsPsr4[$first])) {
+ $subPath = $class;
+ while (false !== $lastPos = strrpos($subPath, '\\')) {
+ $subPath = substr($subPath, 0, $lastPos);
+ $search = $subPath . '\\';
+ if (isset($this->prefixDirsPsr4[$search])) {
+ $pathEnd = DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $lastPos + 1);
+ foreach ($this->prefixDirsPsr4[$search] as $dir) {
+ if (file_exists($file = $dir . $pathEnd)) {
+ return $file;
+ }
+ }
+ }
+ }
+ }
+
+ // PSR-4 fallback dirs
+ foreach ($this->fallbackDirsPsr4 as $dir) {
+ if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) {
+ return $file;
+ }
+ }
+
+ // PSR-0 lookup
+ if (false !== $pos = strrpos($class, '\\')) {
+ // namespaced class name
+ $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1)
+ . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR);
+ } else {
+ // PEAR-like class name
+ $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext;
+ }
+
+ if (isset($this->prefixesPsr0[$first])) {
+ foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) {
+ if (0 === strpos($class, $prefix)) {
+ foreach ($dirs as $dir) {
+ if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
+ return $file;
+ }
+ }
+ }
+ }
+ }
+
+ // PSR-0 fallback dirs
+ foreach ($this->fallbackDirsPsr0 as $dir) {
+ if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
+ return $file;
+ }
+ }
+
+ // PSR-0 include paths.
+ if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) {
+ return $file;
+ }
+
+ return false;
+ }
+}
+
+/**
+ * Scope isolated include.
+ *
+ * Prevents access to $this/self from included files.
+ *
+ * @param string $file
+ * @return void
+ * @private
+ */
+function includeFile($file)
+{
+ include $file;
+}
diff --git a/tools/mailer/composer/InstalledVersions.php b/tools/mailer/composer/InstalledVersions.php
new file mode 100644
index 000000000..d50e0c9fc
--- /dev/null
+++ b/tools/mailer/composer/InstalledVersions.php
@@ -0,0 +1,350 @@
+
+ * Jordi Boggiano
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Composer;
+
+use Composer\Autoload\ClassLoader;
+use Composer\Semver\VersionParser;
+
+/**
+ * This class is copied in every Composer installed project and available to all
+ *
+ * See also https://getcomposer.org/doc/07-runtime.md#installed-versions
+ *
+ * To require its presence, you can require `composer-runtime-api ^2.0`
+ */
+class InstalledVersions
+{
+ /**
+ * @var mixed[]|null
+ * @psalm-var array{root: array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}, versions: array}|array{}|null
+ */
+ private static $installed;
+
+ /**
+ * @var bool|null
+ */
+ private static $canGetVendors;
+
+ /**
+ * @var array[]
+ * @psalm-var array}>
+ */
+ private static $installedByVendor = array();
+
+ /**
+ * Returns a list of all package names which are present, either by being installed, replaced or provided
+ *
+ * @return string[]
+ * @psalm-return list
+ */
+ public static function getInstalledPackages()
+ {
+ $packages = array();
+ foreach (self::getInstalled() as $installed) {
+ $packages[] = array_keys($installed['versions']);
+ }
+
+ if (1 === \count($packages)) {
+ return $packages[0];
+ }
+
+ return array_keys(array_flip(\call_user_func_array('array_merge', $packages)));
+ }
+
+ /**
+ * Returns a list of all package names with a specific type e.g. 'library'
+ *
+ * @param string $type
+ * @return string[]
+ * @psalm-return list
+ */
+ public static function getInstalledPackagesByType($type)
+ {
+ $packagesByType = array();
+
+ foreach (self::getInstalled() as $installed) {
+ foreach ($installed['versions'] as $name => $package) {
+ if (isset($package['type']) && $package['type'] === $type) {
+ $packagesByType[] = $name;
+ }
+ }
+ }
+
+ return $packagesByType;
+ }
+
+ /**
+ * Checks whether the given package is installed
+ *
+ * This also returns true if the package name is provided or replaced by another package
+ *
+ * @param string $packageName
+ * @param bool $includeDevRequirements
+ * @return bool
+ */
+ public static function isInstalled($packageName, $includeDevRequirements = true)
+ {
+ foreach (self::getInstalled() as $installed) {
+ if (isset($installed['versions'][$packageName])) {
+ return $includeDevRequirements || empty($installed['versions'][$packageName]['dev_requirement']);
+ }
+ }
+
+ return false;
+ }
+
+ /**
+ * Checks whether the given package satisfies a version constraint
+ *
+ * e.g. If you want to know whether version 2.3+ of package foo/bar is installed, you would call:
+ *
+ * Composer\InstalledVersions::satisfies(new VersionParser, 'foo/bar', '^2.3')
+ *
+ * @param VersionParser $parser Install composer/semver to have access to this class and functionality
+ * @param string $packageName
+ * @param string|null $constraint A version constraint to check for, if you pass one you have to make sure composer/semver is required by your package
+ * @return bool
+ */
+ public static function satisfies(VersionParser $parser, $packageName, $constraint)
+ {
+ $constraint = $parser->parseConstraints($constraint);
+ $provided = $parser->parseConstraints(self::getVersionRanges($packageName));
+
+ return $provided->matches($constraint);
+ }
+
+ /**
+ * Returns a version constraint representing all the range(s) which are installed for a given package
+ *
+ * It is easier to use this via isInstalled() with the $constraint argument if you need to check
+ * whether a given version of a package is installed, and not just whether it exists
+ *
+ * @param string $packageName
+ * @return string Version constraint usable with composer/semver
+ */
+ public static function getVersionRanges($packageName)
+ {
+ foreach (self::getInstalled() as $installed) {
+ if (!isset($installed['versions'][$packageName])) {
+ continue;
+ }
+
+ $ranges = array();
+ if (isset($installed['versions'][$packageName]['pretty_version'])) {
+ $ranges[] = $installed['versions'][$packageName]['pretty_version'];
+ }
+ if (array_key_exists('aliases', $installed['versions'][$packageName])) {
+ $ranges = array_merge($ranges, $installed['versions'][$packageName]['aliases']);
+ }
+ if (array_key_exists('replaced', $installed['versions'][$packageName])) {
+ $ranges = array_merge($ranges, $installed['versions'][$packageName]['replaced']);
+ }
+ if (array_key_exists('provided', $installed['versions'][$packageName])) {
+ $ranges = array_merge($ranges, $installed['versions'][$packageName]['provided']);
+ }
+
+ return implode(' || ', $ranges);
+ }
+
+ throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
+ }
+
+ /**
+ * @param string $packageName
+ * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as version, use satisfies or getVersionRanges if you need to know if a given version is present
+ */
+ public static function getVersion($packageName)
+ {
+ foreach (self::getInstalled() as $installed) {
+ if (!isset($installed['versions'][$packageName])) {
+ continue;
+ }
+
+ if (!isset($installed['versions'][$packageName]['version'])) {
+ return null;
+ }
+
+ return $installed['versions'][$packageName]['version'];
+ }
+
+ throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
+ }
+
+ /**
+ * @param string $packageName
+ * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as version, use satisfies or getVersionRanges if you need to know if a given version is present
+ */
+ public static function getPrettyVersion($packageName)
+ {
+ foreach (self::getInstalled() as $installed) {
+ if (!isset($installed['versions'][$packageName])) {
+ continue;
+ }
+
+ if (!isset($installed['versions'][$packageName]['pretty_version'])) {
+ return null;
+ }
+
+ return $installed['versions'][$packageName]['pretty_version'];
+ }
+
+ throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
+ }
+
+ /**
+ * @param string $packageName
+ * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as reference
+ */
+ public static function getReference($packageName)
+ {
+ foreach (self::getInstalled() as $installed) {
+ if (!isset($installed['versions'][$packageName])) {
+ continue;
+ }
+
+ if (!isset($installed['versions'][$packageName]['reference'])) {
+ return null;
+ }
+
+ return $installed['versions'][$packageName]['reference'];
+ }
+
+ throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
+ }
+
+ /**
+ * @param string $packageName
+ * @return string|null If the package is being replaced or provided but is not really installed, null will be returned as install path. Packages of type metapackages also have a null install path.
+ */
+ public static function getInstallPath($packageName)
+ {
+ foreach (self::getInstalled() as $installed) {
+ if (!isset($installed['versions'][$packageName])) {
+ continue;
+ }
+
+ return isset($installed['versions'][$packageName]['install_path']) ? $installed['versions'][$packageName]['install_path'] : null;
+ }
+
+ throw new \OutOfBoundsException('Package "' . $packageName . '" is not installed');
+ }
+
+ /**
+ * @return array
+ * @psalm-return array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}
+ */
+ public static function getRootPackage()
+ {
+ $installed = self::getInstalled();
+
+ return $installed[0]['root'];
+ }
+
+ /**
+ * Returns the raw installed.php data for custom implementations
+ *
+ * @deprecated Use getAllRawData() instead which returns all datasets for all autoloaders present in the process. getRawData only returns the first dataset loaded, which may not be what you expect.
+ * @return array[]
+ * @psalm-return array{root: array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}, versions: array}
+ */
+ public static function getRawData()
+ {
+ @trigger_error('getRawData only returns the first dataset loaded, which may not be what you expect. Use getAllRawData() instead which returns all datasets for all autoloaders present in the process.', E_USER_DEPRECATED);
+
+ if (null === self::$installed) {
+ // only require the installed.php file if this file is loaded from its dumped location,
+ // and not from its source location in the composer/composer package, see https://github.com/composer/composer/issues/9937
+ if (substr(__DIR__, -8, 1) !== 'C') {
+ self::$installed = include __DIR__ . '/installed.php';
+ } else {
+ self::$installed = array();
+ }
+ }
+
+ return self::$installed;
+ }
+
+ /**
+ * Returns the raw data of all installed.php which are currently loaded for custom implementations
+ *
+ * @return array[]
+ * @psalm-return list}>
+ */
+ public static function getAllRawData()
+ {
+ return self::getInstalled();
+ }
+
+ /**
+ * Lets you reload the static array from another file
+ *
+ * This is only useful for complex integrations in which a project needs to use
+ * this class but then also needs to execute another project's autoloader in process,
+ * and wants to ensure both projects have access to their version of installed.php.
+ *
+ * A typical case would be PHPUnit, where it would need to make sure it reads all
+ * the data it needs from this class, then call reload() with
+ * `require $CWD/vendor/composer/installed.php` (or similar) as input to make sure
+ * the project in which it runs can then also use this class safely, without
+ * interference between PHPUnit's dependencies and the project's dependencies.
+ *
+ * @param array[] $data A vendor/composer/installed.php data set
+ * @return void
+ *
+ * @psalm-param array{root: array{name: string, version: string, reference: string, pretty_version: string, aliases: string[], dev: bool, install_path: string, type: string}, versions: array} $data
+ */
+ public static function reload($data)
+ {
+ self::$installed = $data;
+ self::$installedByVendor = array();
+ }
+
+ /**
+ * @return array[]
+ * @psalm-return list}>
+ */
+ private static function getInstalled()
+ {
+ if (null === self::$canGetVendors) {
+ self::$canGetVendors = method_exists('Composer\Autoload\ClassLoader', 'getRegisteredLoaders');
+ }
+
+ $installed = array();
+
+ if (self::$canGetVendors) {
+ foreach (ClassLoader::getRegisteredLoaders() as $vendorDir => $loader) {
+ if (isset(self::$installedByVendor[$vendorDir])) {
+ $installed[] = self::$installedByVendor[$vendorDir];
+ } elseif (is_file($vendorDir.'/composer/installed.php')) {
+ $installed[] = self::$installedByVendor[$vendorDir] = require $vendorDir.'/composer/installed.php';
+ if (null === self::$installed && strtr($vendorDir.'/composer', '\\', '/') === strtr(__DIR__, '\\', '/')) {
+ self::$installed = $installed[count($installed) - 1];
+ }
+ }
+ }
+ }
+
+ if (null === self::$installed) {
+ // only require the installed.php file if this file is loaded from its dumped location,
+ // and not from its source location in the composer/composer package, see https://github.com/composer/composer/issues/9937
+ if (substr(__DIR__, -8, 1) !== 'C') {
+ self::$installed = require __DIR__ . '/installed.php';
+ } else {
+ self::$installed = array();
+ }
+ }
+ $installed[] = self::$installed;
+
+ return $installed;
+ }
+}
diff --git a/tools/mailer/composer/LICENSE b/tools/mailer/composer/LICENSE
new file mode 100644
index 000000000..f27399a04
--- /dev/null
+++ b/tools/mailer/composer/LICENSE
@@ -0,0 +1,21 @@
+
+Copyright (c) Nils Adermann, Jordi Boggiano
+
+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.
+
diff --git a/tools/mailer/composer/autoload_classmap.php b/tools/mailer/composer/autoload_classmap.php
new file mode 100644
index 000000000..fd407a3a1
--- /dev/null
+++ b/tools/mailer/composer/autoload_classmap.php
@@ -0,0 +1,11 @@
+ $vendorDir . '/composer/InstalledVersions.php',
+ 'Normalizer' => $vendorDir . '/symfony/polyfill-intl-normalizer/Resources/stubs/Normalizer.php',
+);
diff --git a/tools/mailer/composer/autoload_files.php b/tools/mailer/composer/autoload_files.php
new file mode 100644
index 000000000..9c8e6cfe3
--- /dev/null
+++ b/tools/mailer/composer/autoload_files.php
@@ -0,0 +1,13 @@
+ $vendorDir . '/symfony/polyfill-intl-normalizer/bootstrap.php',
+ 'f598d06aa772fa33d905e87be6398fb1' => $vendorDir . '/symfony/polyfill-intl-idn/bootstrap.php',
+ '6e3fae29631ef280660b3cdad06f25a8' => $vendorDir . '/symfony/deprecation-contracts/function.php',
+ '0e6d7bf4a5811bfa5cf40c5ccd6fae6a' => $vendorDir . '/symfony/polyfill-mbstring/bootstrap.php',
+);
diff --git a/tools/mailer/composer/autoload_namespaces.php b/tools/mailer/composer/autoload_namespaces.php
new file mode 100644
index 000000000..b7fc0125d
--- /dev/null
+++ b/tools/mailer/composer/autoload_namespaces.php
@@ -0,0 +1,9 @@
+ array($vendorDir . '/symfony/polyfill-mbstring'),
+ 'Symfony\\Polyfill\\Intl\\Normalizer\\' => array($vendorDir . '/symfony/polyfill-intl-normalizer'),
+ 'Symfony\\Polyfill\\Intl\\Idn\\' => array($vendorDir . '/symfony/polyfill-intl-idn'),
+ 'Symfony\\Contracts\\Service\\' => array($vendorDir . '/symfony/service-contracts'),
+ 'Symfony\\Contracts\\EventDispatcher\\' => array($vendorDir . '/symfony/event-dispatcher-contracts'),
+ 'Symfony\\Component\\Mime\\' => array($vendorDir . '/symfony/mime'),
+ 'Symfony\\Component\\Mailer\\' => array($vendorDir . '/symfony/mailer'),
+ 'Symfony\\Component\\EventDispatcher\\' => array($vendorDir . '/symfony/event-dispatcher'),
+ 'Psr\\Log\\' => array($vendorDir . '/psr/log/src'),
+ 'Psr\\EventDispatcher\\' => array($vendorDir . '/psr/event-dispatcher/src'),
+ 'Psr\\Container\\' => array($vendorDir . '/psr/container/src'),
+ 'Egulias\\EmailValidator\\' => array($vendorDir . '/egulias/email-validator/src'),
+ 'Doctrine\\Common\\Lexer\\' => array($vendorDir . '/doctrine/lexer/src'),
+);
diff --git a/tools/mailer/composer/autoload_real.php b/tools/mailer/composer/autoload_real.php
new file mode 100644
index 000000000..59416d97b
--- /dev/null
+++ b/tools/mailer/composer/autoload_real.php
@@ -0,0 +1,80 @@
+= 50600 && !defined('HHVM_VERSION') && (!function_exists('zend_loader_file_encoded') || !zend_loader_file_encoded());
+ if ($useStaticLoader) {
+ require __DIR__ . '/autoload_static.php';
+
+ call_user_func(\Composer\Autoload\ComposerStaticInite7be09a88df86ec7472e11aba80f87bc::getInitializer($loader));
+ } else {
+ $map = require __DIR__ . '/autoload_namespaces.php';
+ foreach ($map as $namespace => $path) {
+ $loader->set($namespace, $path);
+ }
+
+ $map = require __DIR__ . '/autoload_psr4.php';
+ foreach ($map as $namespace => $path) {
+ $loader->setPsr4($namespace, $path);
+ }
+
+ $classMap = require __DIR__ . '/autoload_classmap.php';
+ if ($classMap) {
+ $loader->addClassMap($classMap);
+ }
+ }
+
+ $loader->register(true);
+
+ if ($useStaticLoader) {
+ $includeFiles = Composer\Autoload\ComposerStaticInite7be09a88df86ec7472e11aba80f87bc::$files;
+ } else {
+ $includeFiles = require __DIR__ . '/autoload_files.php';
+ }
+ foreach ($includeFiles as $fileIdentifier => $file) {
+ composerRequiree7be09a88df86ec7472e11aba80f87bc($fileIdentifier, $file);
+ }
+
+ return $loader;
+ }
+}
+
+/**
+ * @param string $fileIdentifier
+ * @param string $file
+ * @return void
+ */
+function composerRequiree7be09a88df86ec7472e11aba80f87bc($fileIdentifier, $file)
+{
+ if (empty($GLOBALS['__composer_autoload_files'][$fileIdentifier])) {
+ $GLOBALS['__composer_autoload_files'][$fileIdentifier] = true;
+
+ require $file;
+ }
+}
diff --git a/tools/mailer/composer/autoload_static.php b/tools/mailer/composer/autoload_static.php
new file mode 100644
index 000000000..ee19c4b40
--- /dev/null
+++ b/tools/mailer/composer/autoload_static.php
@@ -0,0 +1,113 @@
+ __DIR__ . '/..' . '/symfony/polyfill-intl-normalizer/bootstrap.php',
+ 'f598d06aa772fa33d905e87be6398fb1' => __DIR__ . '/..' . '/symfony/polyfill-intl-idn/bootstrap.php',
+ '6e3fae29631ef280660b3cdad06f25a8' => __DIR__ . '/..' . '/symfony/deprecation-contracts/function.php',
+ '0e6d7bf4a5811bfa5cf40c5ccd6fae6a' => __DIR__ . '/..' . '/symfony/polyfill-mbstring/bootstrap.php',
+ );
+
+ public static $prefixLengthsPsr4 = array (
+ 'S' =>
+ array (
+ 'Symfony\\Polyfill\\Mbstring\\' => 26,
+ 'Symfony\\Polyfill\\Intl\\Normalizer\\' => 33,
+ 'Symfony\\Polyfill\\Intl\\Idn\\' => 26,
+ 'Symfony\\Contracts\\Service\\' => 26,
+ 'Symfony\\Contracts\\EventDispatcher\\' => 34,
+ 'Symfony\\Component\\Mime\\' => 23,
+ 'Symfony\\Component\\Mailer\\' => 25,
+ 'Symfony\\Component\\EventDispatcher\\' => 34,
+ ),
+ 'P' =>
+ array (
+ 'Psr\\Log\\' => 8,
+ 'Psr\\EventDispatcher\\' => 20,
+ 'Psr\\Container\\' => 14,
+ ),
+ 'E' =>
+ array (
+ 'Egulias\\EmailValidator\\' => 23,
+ ),
+ 'D' =>
+ array (
+ 'Doctrine\\Common\\Lexer\\' => 22,
+ ),
+ );
+
+ public static $prefixDirsPsr4 = array (
+ 'Symfony\\Polyfill\\Mbstring\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/symfony/polyfill-mbstring',
+ ),
+ 'Symfony\\Polyfill\\Intl\\Normalizer\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/symfony/polyfill-intl-normalizer',
+ ),
+ 'Symfony\\Polyfill\\Intl\\Idn\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/symfony/polyfill-intl-idn',
+ ),
+ 'Symfony\\Contracts\\Service\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/symfony/service-contracts',
+ ),
+ 'Symfony\\Contracts\\EventDispatcher\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/symfony/event-dispatcher-contracts',
+ ),
+ 'Symfony\\Component\\Mime\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/symfony/mime',
+ ),
+ 'Symfony\\Component\\Mailer\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/symfony/mailer',
+ ),
+ 'Symfony\\Component\\EventDispatcher\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/symfony/event-dispatcher',
+ ),
+ 'Psr\\Log\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/psr/log/src',
+ ),
+ 'Psr\\EventDispatcher\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/psr/event-dispatcher/src',
+ ),
+ 'Psr\\Container\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/psr/container/src',
+ ),
+ 'Egulias\\EmailValidator\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/egulias/email-validator/src',
+ ),
+ 'Doctrine\\Common\\Lexer\\' =>
+ array (
+ 0 => __DIR__ . '/..' . '/doctrine/lexer/src',
+ ),
+ );
+
+ public static $classMap = array (
+ 'Composer\\InstalledVersions' => __DIR__ . '/..' . '/composer/InstalledVersions.php',
+ 'Normalizer' => __DIR__ . '/..' . '/symfony/polyfill-intl-normalizer/Resources/stubs/Normalizer.php',
+ );
+
+ public static function getInitializer(ClassLoader $loader)
+ {
+ return \Closure::bind(function () use ($loader) {
+ $loader->prefixLengthsPsr4 = ComposerStaticInite7be09a88df86ec7472e11aba80f87bc::$prefixLengthsPsr4;
+ $loader->prefixDirsPsr4 = ComposerStaticInite7be09a88df86ec7472e11aba80f87bc::$prefixDirsPsr4;
+ $loader->classMap = ComposerStaticInite7be09a88df86ec7472e11aba80f87bc::$classMap;
+
+ }, null, ClassLoader::class);
+ }
+}
diff --git a/tools/mailer/composer/installed.json b/tools/mailer/composer/installed.json
new file mode 100644
index 000000000..665c1ae10
--- /dev/null
+++ b/tools/mailer/composer/installed.json
@@ -0,0 +1,1059 @@
+{
+ "packages": [
+ {
+ "name": "doctrine/lexer",
+ "version": "3.0.1",
+ "version_normalized": "3.0.1.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/doctrine/lexer.git",
+ "reference": "31ad66abc0fc9e1a1f2d9bc6a42668d2fbbcd6dd"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/doctrine/lexer/zipball/31ad66abc0fc9e1a1f2d9bc6a42668d2fbbcd6dd",
+ "reference": "31ad66abc0fc9e1a1f2d9bc6a42668d2fbbcd6dd",
+ "shasum": ""
+ },
+ "require": {
+ "php": "^8.1"
+ },
+ "require-dev": {
+ "doctrine/coding-standard": "^12",
+ "phpstan/phpstan": "^1.10",
+ "phpunit/phpunit": "^10.5",
+ "psalm/plugin-phpunit": "^0.18.3",
+ "vimeo/psalm": "^5.21"
+ },
+ "time": "2024-02-05T11:56:58+00:00",
+ "type": "library",
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Doctrine\\Common\\Lexer\\": "src"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Guilherme Blanco",
+ "email": "guilhermeblanco@gmail.com"
+ },
+ {
+ "name": "Roman Borschel",
+ "email": "roman@code-factory.org"
+ },
+ {
+ "name": "Johannes Schmitt",
+ "email": "schmittjoh@gmail.com"
+ }
+ ],
+ "description": "PHP Doctrine Lexer parser library that can be used in Top-Down, Recursive Descent Parsers.",
+ "homepage": "https://www.doctrine-project.org/projects/lexer.html",
+ "keywords": [
+ "annotations",
+ "docblock",
+ "lexer",
+ "parser",
+ "php"
+ ],
+ "support": {
+ "issues": "https://github.com/doctrine/lexer/issues",
+ "source": "https://github.com/doctrine/lexer/tree/3.0.1"
+ },
+ "funding": [
+ {
+ "url": "https://www.doctrine-project.org/sponsorship.html",
+ "type": "custom"
+ },
+ {
+ "url": "https://www.patreon.com/phpdoctrine",
+ "type": "patreon"
+ },
+ {
+ "url": "https://tidelift.com/funding/github/packagist/doctrine%2Flexer",
+ "type": "tidelift"
+ }
+ ],
+ "install-path": "../doctrine/lexer"
+ },
+ {
+ "name": "egulias/email-validator",
+ "version": "4.0.2",
+ "version_normalized": "4.0.2.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/egulias/EmailValidator.git",
+ "reference": "ebaaf5be6c0286928352e054f2d5125608e5405e"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/egulias/EmailValidator/zipball/ebaaf5be6c0286928352e054f2d5125608e5405e",
+ "reference": "ebaaf5be6c0286928352e054f2d5125608e5405e",
+ "shasum": ""
+ },
+ "require": {
+ "doctrine/lexer": "^2.0 || ^3.0",
+ "php": ">=8.1",
+ "symfony/polyfill-intl-idn": "^1.26"
+ },
+ "require-dev": {
+ "phpunit/phpunit": "^10.2",
+ "vimeo/psalm": "^5.12"
+ },
+ "suggest": {
+ "ext-intl": "PHP Internationalization Libraries are required to use the SpoofChecking validation"
+ },
+ "time": "2023-10-06T06:47:41+00:00",
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-master": "4.0.x-dev"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Egulias\\EmailValidator\\": "src"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Eduardo Gulias Davis"
+ }
+ ],
+ "description": "A library for validating emails against several RFCs",
+ "homepage": "https://github.com/egulias/EmailValidator",
+ "keywords": [
+ "email",
+ "emailvalidation",
+ "emailvalidator",
+ "validation",
+ "validator"
+ ],
+ "support": {
+ "issues": "https://github.com/egulias/EmailValidator/issues",
+ "source": "https://github.com/egulias/EmailValidator/tree/4.0.2"
+ },
+ "funding": [
+ {
+ "url": "https://github.com/egulias",
+ "type": "github"
+ }
+ ],
+ "install-path": "../egulias/email-validator"
+ },
+ {
+ "name": "psr/container",
+ "version": "2.0.2",
+ "version_normalized": "2.0.2.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/php-fig/container.git",
+ "reference": "c71ecc56dfe541dbd90c5360474fbc405f8d5963"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/php-fig/container/zipball/c71ecc56dfe541dbd90c5360474fbc405f8d5963",
+ "reference": "c71ecc56dfe541dbd90c5360474fbc405f8d5963",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=7.4.0"
+ },
+ "time": "2021-11-05T16:47:00+00:00",
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-master": "2.0.x-dev"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Psr\\Container\\": "src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "PHP-FIG",
+ "homepage": "https://www.php-fig.org/"
+ }
+ ],
+ "description": "Common Container Interface (PHP FIG PSR-11)",
+ "homepage": "https://github.com/php-fig/container",
+ "keywords": [
+ "PSR-11",
+ "container",
+ "container-interface",
+ "container-interop",
+ "psr"
+ ],
+ "support": {
+ "issues": "https://github.com/php-fig/container/issues",
+ "source": "https://github.com/php-fig/container/tree/2.0.2"
+ },
+ "install-path": "../psr/container"
+ },
+ {
+ "name": "psr/event-dispatcher",
+ "version": "1.0.0",
+ "version_normalized": "1.0.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/php-fig/event-dispatcher.git",
+ "reference": "dbefd12671e8a14ec7f180cab83036ed26714bb0"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/php-fig/event-dispatcher/zipball/dbefd12671e8a14ec7f180cab83036ed26714bb0",
+ "reference": "dbefd12671e8a14ec7f180cab83036ed26714bb0",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=7.2.0"
+ },
+ "time": "2019-01-08T18:20:26+00:00",
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-master": "1.0.x-dev"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Psr\\EventDispatcher\\": "src/"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "PHP-FIG",
+ "homepage": "http://www.php-fig.org/"
+ }
+ ],
+ "description": "Standard interfaces for event handling.",
+ "keywords": [
+ "events",
+ "psr",
+ "psr-14"
+ ],
+ "support": {
+ "issues": "https://github.com/php-fig/event-dispatcher/issues",
+ "source": "https://github.com/php-fig/event-dispatcher/tree/1.0.0"
+ },
+ "install-path": "../psr/event-dispatcher"
+ },
+ {
+ "name": "psr/log",
+ "version": "3.0.2",
+ "version_normalized": "3.0.2.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/php-fig/log.git",
+ "reference": "f16e1d5863e37f8d8c2a01719f5b34baa2b714d3"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/php-fig/log/zipball/f16e1d5863e37f8d8c2a01719f5b34baa2b714d3",
+ "reference": "f16e1d5863e37f8d8c2a01719f5b34baa2b714d3",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=8.0.0"
+ },
+ "time": "2024-09-11T13:17:53+00:00",
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-master": "3.x-dev"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Psr\\Log\\": "src"
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "PHP-FIG",
+ "homepage": "https://www.php-fig.org/"
+ }
+ ],
+ "description": "Common interface for logging libraries",
+ "homepage": "https://github.com/php-fig/log",
+ "keywords": [
+ "log",
+ "psr",
+ "psr-3"
+ ],
+ "support": {
+ "source": "https://github.com/php-fig/log/tree/3.0.2"
+ },
+ "install-path": "../psr/log"
+ },
+ {
+ "name": "symfony/deprecation-contracts",
+ "version": "v3.5.0",
+ "version_normalized": "3.5.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/symfony/deprecation-contracts.git",
+ "reference": "0e0d29ce1f20deffb4ab1b016a7257c4f1e789a1"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/0e0d29ce1f20deffb4ab1b016a7257c4f1e789a1",
+ "reference": "0e0d29ce1f20deffb4ab1b016a7257c4f1e789a1",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=8.1"
+ },
+ "time": "2024-04-18T09:32:20+00:00",
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-main": "3.5-dev"
+ },
+ "thanks": {
+ "name": "symfony/contracts",
+ "url": "https://github.com/symfony/contracts"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "files": [
+ "function.php"
+ ]
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Nicolas Grekas",
+ "email": "p@tchwork.com"
+ },
+ {
+ "name": "Symfony Community",
+ "homepage": "https://symfony.com/contributors"
+ }
+ ],
+ "description": "A generic function and convention to trigger deprecation notices",
+ "homepage": "https://symfony.com",
+ "support": {
+ "source": "https://github.com/symfony/deprecation-contracts/tree/v3.5.0"
+ },
+ "funding": [
+ {
+ "url": "https://symfony.com/sponsor",
+ "type": "custom"
+ },
+ {
+ "url": "https://github.com/fabpot",
+ "type": "github"
+ },
+ {
+ "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+ "type": "tidelift"
+ }
+ ],
+ "install-path": "../symfony/deprecation-contracts"
+ },
+ {
+ "name": "symfony/event-dispatcher",
+ "version": "v7.1.6",
+ "version_normalized": "7.1.6.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/symfony/event-dispatcher.git",
+ "reference": "87254c78dd50721cfd015b62277a8281c5589702"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/symfony/event-dispatcher/zipball/87254c78dd50721cfd015b62277a8281c5589702",
+ "reference": "87254c78dd50721cfd015b62277a8281c5589702",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=8.2",
+ "symfony/event-dispatcher-contracts": "^2.5|^3"
+ },
+ "conflict": {
+ "symfony/dependency-injection": "<6.4",
+ "symfony/service-contracts": "<2.5"
+ },
+ "provide": {
+ "psr/event-dispatcher-implementation": "1.0",
+ "symfony/event-dispatcher-implementation": "2.0|3.0"
+ },
+ "require-dev": {
+ "psr/log": "^1|^2|^3",
+ "symfony/config": "^6.4|^7.0",
+ "symfony/dependency-injection": "^6.4|^7.0",
+ "symfony/error-handler": "^6.4|^7.0",
+ "symfony/expression-language": "^6.4|^7.0",
+ "symfony/http-foundation": "^6.4|^7.0",
+ "symfony/service-contracts": "^2.5|^3",
+ "symfony/stopwatch": "^6.4|^7.0"
+ },
+ "time": "2024-09-25T14:20:29+00:00",
+ "type": "library",
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Symfony\\Component\\EventDispatcher\\": ""
+ },
+ "exclude-from-classmap": [
+ "/Tests/"
+ ]
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Fabien Potencier",
+ "email": "fabien@symfony.com"
+ },
+ {
+ "name": "Symfony Community",
+ "homepage": "https://symfony.com/contributors"
+ }
+ ],
+ "description": "Provides tools that allow your application components to communicate with each other by dispatching events and listening to them",
+ "homepage": "https://symfony.com",
+ "support": {
+ "source": "https://github.com/symfony/event-dispatcher/tree/v7.1.6"
+ },
+ "funding": [
+ {
+ "url": "https://symfony.com/sponsor",
+ "type": "custom"
+ },
+ {
+ "url": "https://github.com/fabpot",
+ "type": "github"
+ },
+ {
+ "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+ "type": "tidelift"
+ }
+ ],
+ "install-path": "../symfony/event-dispatcher"
+ },
+ {
+ "name": "symfony/event-dispatcher-contracts",
+ "version": "v3.5.0",
+ "version_normalized": "3.5.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/symfony/event-dispatcher-contracts.git",
+ "reference": "8f93aec25d41b72493c6ddff14e916177c9efc50"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/symfony/event-dispatcher-contracts/zipball/8f93aec25d41b72493c6ddff14e916177c9efc50",
+ "reference": "8f93aec25d41b72493c6ddff14e916177c9efc50",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=8.1",
+ "psr/event-dispatcher": "^1"
+ },
+ "time": "2024-04-18T09:32:20+00:00",
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-main": "3.5-dev"
+ },
+ "thanks": {
+ "name": "symfony/contracts",
+ "url": "https://github.com/symfony/contracts"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Symfony\\Contracts\\EventDispatcher\\": ""
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Nicolas Grekas",
+ "email": "p@tchwork.com"
+ },
+ {
+ "name": "Symfony Community",
+ "homepage": "https://symfony.com/contributors"
+ }
+ ],
+ "description": "Generic abstractions related to dispatching event",
+ "homepage": "https://symfony.com",
+ "keywords": [
+ "abstractions",
+ "contracts",
+ "decoupling",
+ "interfaces",
+ "interoperability",
+ "standards"
+ ],
+ "support": {
+ "source": "https://github.com/symfony/event-dispatcher-contracts/tree/v3.5.0"
+ },
+ "funding": [
+ {
+ "url": "https://symfony.com/sponsor",
+ "type": "custom"
+ },
+ {
+ "url": "https://github.com/fabpot",
+ "type": "github"
+ },
+ {
+ "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+ "type": "tidelift"
+ }
+ ],
+ "install-path": "../symfony/event-dispatcher-contracts"
+ },
+ {
+ "name": "symfony/mailer",
+ "version": "v6.4.13",
+ "version_normalized": "6.4.13.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/symfony/mailer.git",
+ "reference": "c2f7e0d8d7ac8fe25faccf5d8cac462805db2663"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/symfony/mailer/zipball/c2f7e0d8d7ac8fe25faccf5d8cac462805db2663",
+ "reference": "c2f7e0d8d7ac8fe25faccf5d8cac462805db2663",
+ "shasum": ""
+ },
+ "require": {
+ "egulias/email-validator": "^2.1.10|^3|^4",
+ "php": ">=8.1",
+ "psr/event-dispatcher": "^1",
+ "psr/log": "^1|^2|^3",
+ "symfony/event-dispatcher": "^5.4|^6.0|^7.0",
+ "symfony/mime": "^6.2|^7.0",
+ "symfony/service-contracts": "^2.5|^3"
+ },
+ "conflict": {
+ "symfony/http-client-contracts": "<2.5",
+ "symfony/http-kernel": "<5.4",
+ "symfony/messenger": "<6.2",
+ "symfony/mime": "<6.2",
+ "symfony/twig-bridge": "<6.2.1"
+ },
+ "require-dev": {
+ "symfony/console": "^5.4|^6.0|^7.0",
+ "symfony/http-client": "^5.4|^6.0|^7.0",
+ "symfony/messenger": "^6.2|^7.0",
+ "symfony/twig-bridge": "^6.2|^7.0"
+ },
+ "time": "2024-09-25T14:18:03+00:00",
+ "type": "library",
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Symfony\\Component\\Mailer\\": ""
+ },
+ "exclude-from-classmap": [
+ "/Tests/"
+ ]
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Fabien Potencier",
+ "email": "fabien@symfony.com"
+ },
+ {
+ "name": "Symfony Community",
+ "homepage": "https://symfony.com/contributors"
+ }
+ ],
+ "description": "Helps sending emails",
+ "homepage": "https://symfony.com",
+ "support": {
+ "source": "https://github.com/symfony/mailer/tree/v6.4.13"
+ },
+ "funding": [
+ {
+ "url": "https://symfony.com/sponsor",
+ "type": "custom"
+ },
+ {
+ "url": "https://github.com/fabpot",
+ "type": "github"
+ },
+ {
+ "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+ "type": "tidelift"
+ }
+ ],
+ "install-path": "../symfony/mailer"
+ },
+ {
+ "name": "symfony/mime",
+ "version": "v7.1.6",
+ "version_normalized": "7.1.6.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/symfony/mime.git",
+ "reference": "caa1e521edb2650b8470918dfe51708c237f0598"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/symfony/mime/zipball/caa1e521edb2650b8470918dfe51708c237f0598",
+ "reference": "caa1e521edb2650b8470918dfe51708c237f0598",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=8.2",
+ "symfony/polyfill-intl-idn": "^1.10",
+ "symfony/polyfill-mbstring": "^1.0"
+ },
+ "conflict": {
+ "egulias/email-validator": "~3.0.0",
+ "phpdocumentor/reflection-docblock": "<3.2.2",
+ "phpdocumentor/type-resolver": "<1.4.0",
+ "symfony/mailer": "<6.4",
+ "symfony/serializer": "<6.4.3|>7.0,<7.0.3"
+ },
+ "require-dev": {
+ "egulias/email-validator": "^2.1.10|^3.1|^4",
+ "league/html-to-markdown": "^5.0",
+ "phpdocumentor/reflection-docblock": "^3.0|^4.0|^5.0",
+ "symfony/dependency-injection": "^6.4|^7.0",
+ "symfony/process": "^6.4|^7.0",
+ "symfony/property-access": "^6.4|^7.0",
+ "symfony/property-info": "^6.4|^7.0",
+ "symfony/serializer": "^6.4.3|^7.0.3"
+ },
+ "time": "2024-10-25T15:11:02+00:00",
+ "type": "library",
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Symfony\\Component\\Mime\\": ""
+ },
+ "exclude-from-classmap": [
+ "/Tests/"
+ ]
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Fabien Potencier",
+ "email": "fabien@symfony.com"
+ },
+ {
+ "name": "Symfony Community",
+ "homepage": "https://symfony.com/contributors"
+ }
+ ],
+ "description": "Allows manipulating MIME messages",
+ "homepage": "https://symfony.com",
+ "keywords": [
+ "mime",
+ "mime-type"
+ ],
+ "support": {
+ "source": "https://github.com/symfony/mime/tree/v7.1.6"
+ },
+ "funding": [
+ {
+ "url": "https://symfony.com/sponsor",
+ "type": "custom"
+ },
+ {
+ "url": "https://github.com/fabpot",
+ "type": "github"
+ },
+ {
+ "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+ "type": "tidelift"
+ }
+ ],
+ "install-path": "../symfony/mime"
+ },
+ {
+ "name": "symfony/polyfill-intl-idn",
+ "version": "v1.31.0",
+ "version_normalized": "1.31.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/symfony/polyfill-intl-idn.git",
+ "reference": "c36586dcf89a12315939e00ec9b4474adcb1d773"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/symfony/polyfill-intl-idn/zipball/c36586dcf89a12315939e00ec9b4474adcb1d773",
+ "reference": "c36586dcf89a12315939e00ec9b4474adcb1d773",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=7.2",
+ "symfony/polyfill-intl-normalizer": "^1.10"
+ },
+ "suggest": {
+ "ext-intl": "For best performance"
+ },
+ "time": "2024-09-09T11:45:10+00:00",
+ "type": "library",
+ "extra": {
+ "thanks": {
+ "name": "symfony/polyfill",
+ "url": "https://github.com/symfony/polyfill"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "files": [
+ "bootstrap.php"
+ ],
+ "psr-4": {
+ "Symfony\\Polyfill\\Intl\\Idn\\": ""
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Laurent Bassin",
+ "email": "laurent@bassin.info"
+ },
+ {
+ "name": "Trevor Rowbotham",
+ "email": "trevor.rowbotham@pm.me"
+ },
+ {
+ "name": "Symfony Community",
+ "homepage": "https://symfony.com/contributors"
+ }
+ ],
+ "description": "Symfony polyfill for intl's idn_to_ascii and idn_to_utf8 functions",
+ "homepage": "https://symfony.com",
+ "keywords": [
+ "compatibility",
+ "idn",
+ "intl",
+ "polyfill",
+ "portable",
+ "shim"
+ ],
+ "support": {
+ "source": "https://github.com/symfony/polyfill-intl-idn/tree/v1.31.0"
+ },
+ "funding": [
+ {
+ "url": "https://symfony.com/sponsor",
+ "type": "custom"
+ },
+ {
+ "url": "https://github.com/fabpot",
+ "type": "github"
+ },
+ {
+ "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+ "type": "tidelift"
+ }
+ ],
+ "install-path": "../symfony/polyfill-intl-idn"
+ },
+ {
+ "name": "symfony/polyfill-intl-normalizer",
+ "version": "v1.31.0",
+ "version_normalized": "1.31.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/symfony/polyfill-intl-normalizer.git",
+ "reference": "3833d7255cc303546435cb650316bff708a1c75c"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/3833d7255cc303546435cb650316bff708a1c75c",
+ "reference": "3833d7255cc303546435cb650316bff708a1c75c",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=7.2"
+ },
+ "suggest": {
+ "ext-intl": "For best performance"
+ },
+ "time": "2024-09-09T11:45:10+00:00",
+ "type": "library",
+ "extra": {
+ "thanks": {
+ "name": "symfony/polyfill",
+ "url": "https://github.com/symfony/polyfill"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "files": [
+ "bootstrap.php"
+ ],
+ "psr-4": {
+ "Symfony\\Polyfill\\Intl\\Normalizer\\": ""
+ },
+ "classmap": [
+ "Resources/stubs"
+ ]
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Nicolas Grekas",
+ "email": "p@tchwork.com"
+ },
+ {
+ "name": "Symfony Community",
+ "homepage": "https://symfony.com/contributors"
+ }
+ ],
+ "description": "Symfony polyfill for intl's Normalizer class and related functions",
+ "homepage": "https://symfony.com",
+ "keywords": [
+ "compatibility",
+ "intl",
+ "normalizer",
+ "polyfill",
+ "portable",
+ "shim"
+ ],
+ "support": {
+ "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.31.0"
+ },
+ "funding": [
+ {
+ "url": "https://symfony.com/sponsor",
+ "type": "custom"
+ },
+ {
+ "url": "https://github.com/fabpot",
+ "type": "github"
+ },
+ {
+ "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+ "type": "tidelift"
+ }
+ ],
+ "install-path": "../symfony/polyfill-intl-normalizer"
+ },
+ {
+ "name": "symfony/polyfill-mbstring",
+ "version": "v1.31.0",
+ "version_normalized": "1.31.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/symfony/polyfill-mbstring.git",
+ "reference": "85181ba99b2345b0ef10ce42ecac37612d9fd341"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/85181ba99b2345b0ef10ce42ecac37612d9fd341",
+ "reference": "85181ba99b2345b0ef10ce42ecac37612d9fd341",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=7.2"
+ },
+ "provide": {
+ "ext-mbstring": "*"
+ },
+ "suggest": {
+ "ext-mbstring": "For best performance"
+ },
+ "time": "2024-09-09T11:45:10+00:00",
+ "type": "library",
+ "extra": {
+ "thanks": {
+ "name": "symfony/polyfill",
+ "url": "https://github.com/symfony/polyfill"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "files": [
+ "bootstrap.php"
+ ],
+ "psr-4": {
+ "Symfony\\Polyfill\\Mbstring\\": ""
+ }
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Nicolas Grekas",
+ "email": "p@tchwork.com"
+ },
+ {
+ "name": "Symfony Community",
+ "homepage": "https://symfony.com/contributors"
+ }
+ ],
+ "description": "Symfony polyfill for the Mbstring extension",
+ "homepage": "https://symfony.com",
+ "keywords": [
+ "compatibility",
+ "mbstring",
+ "polyfill",
+ "portable",
+ "shim"
+ ],
+ "support": {
+ "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.31.0"
+ },
+ "funding": [
+ {
+ "url": "https://symfony.com/sponsor",
+ "type": "custom"
+ },
+ {
+ "url": "https://github.com/fabpot",
+ "type": "github"
+ },
+ {
+ "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+ "type": "tidelift"
+ }
+ ],
+ "install-path": "../symfony/polyfill-mbstring"
+ },
+ {
+ "name": "symfony/service-contracts",
+ "version": "v3.5.0",
+ "version_normalized": "3.5.0.0",
+ "source": {
+ "type": "git",
+ "url": "https://github.com/symfony/service-contracts.git",
+ "reference": "bd1d9e59a81d8fa4acdcea3f617c581f7475a80f"
+ },
+ "dist": {
+ "type": "zip",
+ "url": "https://api.github.com/repos/symfony/service-contracts/zipball/bd1d9e59a81d8fa4acdcea3f617c581f7475a80f",
+ "reference": "bd1d9e59a81d8fa4acdcea3f617c581f7475a80f",
+ "shasum": ""
+ },
+ "require": {
+ "php": ">=8.1",
+ "psr/container": "^1.1|^2.0",
+ "symfony/deprecation-contracts": "^2.5|^3"
+ },
+ "conflict": {
+ "ext-psr": "<1.1|>=2"
+ },
+ "time": "2024-04-18T09:32:20+00:00",
+ "type": "library",
+ "extra": {
+ "branch-alias": {
+ "dev-main": "3.5-dev"
+ },
+ "thanks": {
+ "name": "symfony/contracts",
+ "url": "https://github.com/symfony/contracts"
+ }
+ },
+ "installation-source": "dist",
+ "autoload": {
+ "psr-4": {
+ "Symfony\\Contracts\\Service\\": ""
+ },
+ "exclude-from-classmap": [
+ "/Test/"
+ ]
+ },
+ "notification-url": "https://packagist.org/downloads/",
+ "license": [
+ "MIT"
+ ],
+ "authors": [
+ {
+ "name": "Nicolas Grekas",
+ "email": "p@tchwork.com"
+ },
+ {
+ "name": "Symfony Community",
+ "homepage": "https://symfony.com/contributors"
+ }
+ ],
+ "description": "Generic abstractions related to writing services",
+ "homepage": "https://symfony.com",
+ "keywords": [
+ "abstractions",
+ "contracts",
+ "decoupling",
+ "interfaces",
+ "interoperability",
+ "standards"
+ ],
+ "support": {
+ "source": "https://github.com/symfony/service-contracts/tree/v3.5.0"
+ },
+ "funding": [
+ {
+ "url": "https://symfony.com/sponsor",
+ "type": "custom"
+ },
+ {
+ "url": "https://github.com/fabpot",
+ "type": "github"
+ },
+ {
+ "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+ "type": "tidelift"
+ }
+ ],
+ "install-path": "../symfony/service-contracts"
+ }
+ ],
+ "dev": true,
+ "dev-package-names": []
+}
diff --git a/tools/mailer/composer/installed.php b/tools/mailer/composer/installed.php
new file mode 100644
index 000000000..424ecaafa
--- /dev/null
+++ b/tools/mailer/composer/installed.php
@@ -0,0 +1,161 @@
+ array(
+ 'pretty_version' => '1.0.0+no-version-set',
+ 'version' => '1.0.0.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../../',
+ 'aliases' => array(),
+ 'reference' => NULL,
+ 'name' => '__root__',
+ 'dev' => true,
+ ),
+ 'versions' => array(
+ '__root__' => array(
+ 'pretty_version' => '1.0.0+no-version-set',
+ 'version' => '1.0.0.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../../',
+ 'aliases' => array(),
+ 'reference' => NULL,
+ 'dev_requirement' => false,
+ ),
+ 'doctrine/lexer' => array(
+ 'pretty_version' => '3.0.1',
+ 'version' => '3.0.1.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../doctrine/lexer',
+ 'aliases' => array(),
+ 'reference' => '31ad66abc0fc9e1a1f2d9bc6a42668d2fbbcd6dd',
+ 'dev_requirement' => false,
+ ),
+ 'egulias/email-validator' => array(
+ 'pretty_version' => '4.0.2',
+ 'version' => '4.0.2.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../egulias/email-validator',
+ 'aliases' => array(),
+ 'reference' => 'ebaaf5be6c0286928352e054f2d5125608e5405e',
+ 'dev_requirement' => false,
+ ),
+ 'psr/container' => array(
+ 'pretty_version' => '2.0.2',
+ 'version' => '2.0.2.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../psr/container',
+ 'aliases' => array(),
+ 'reference' => 'c71ecc56dfe541dbd90c5360474fbc405f8d5963',
+ 'dev_requirement' => false,
+ ),
+ 'psr/event-dispatcher' => array(
+ 'pretty_version' => '1.0.0',
+ 'version' => '1.0.0.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../psr/event-dispatcher',
+ 'aliases' => array(),
+ 'reference' => 'dbefd12671e8a14ec7f180cab83036ed26714bb0',
+ 'dev_requirement' => false,
+ ),
+ 'psr/event-dispatcher-implementation' => array(
+ 'dev_requirement' => false,
+ 'provided' => array(
+ 0 => '1.0',
+ ),
+ ),
+ 'psr/log' => array(
+ 'pretty_version' => '3.0.2',
+ 'version' => '3.0.2.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../psr/log',
+ 'aliases' => array(),
+ 'reference' => 'f16e1d5863e37f8d8c2a01719f5b34baa2b714d3',
+ 'dev_requirement' => false,
+ ),
+ 'symfony/deprecation-contracts' => array(
+ 'pretty_version' => 'v3.5.0',
+ 'version' => '3.5.0.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../symfony/deprecation-contracts',
+ 'aliases' => array(),
+ 'reference' => '0e0d29ce1f20deffb4ab1b016a7257c4f1e789a1',
+ 'dev_requirement' => false,
+ ),
+ 'symfony/event-dispatcher' => array(
+ 'pretty_version' => 'v7.1.6',
+ 'version' => '7.1.6.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../symfony/event-dispatcher',
+ 'aliases' => array(),
+ 'reference' => '87254c78dd50721cfd015b62277a8281c5589702',
+ 'dev_requirement' => false,
+ ),
+ 'symfony/event-dispatcher-contracts' => array(
+ 'pretty_version' => 'v3.5.0',
+ 'version' => '3.5.0.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../symfony/event-dispatcher-contracts',
+ 'aliases' => array(),
+ 'reference' => '8f93aec25d41b72493c6ddff14e916177c9efc50',
+ 'dev_requirement' => false,
+ ),
+ 'symfony/event-dispatcher-implementation' => array(
+ 'dev_requirement' => false,
+ 'provided' => array(
+ 0 => '2.0|3.0',
+ ),
+ ),
+ 'symfony/mailer' => array(
+ 'pretty_version' => 'v6.4.13',
+ 'version' => '6.4.13.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../symfony/mailer',
+ 'aliases' => array(),
+ 'reference' => 'c2f7e0d8d7ac8fe25faccf5d8cac462805db2663',
+ 'dev_requirement' => false,
+ ),
+ 'symfony/mime' => array(
+ 'pretty_version' => 'v7.1.6',
+ 'version' => '7.1.6.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../symfony/mime',
+ 'aliases' => array(),
+ 'reference' => 'caa1e521edb2650b8470918dfe51708c237f0598',
+ 'dev_requirement' => false,
+ ),
+ 'symfony/polyfill-intl-idn' => array(
+ 'pretty_version' => 'v1.31.0',
+ 'version' => '1.31.0.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../symfony/polyfill-intl-idn',
+ 'aliases' => array(),
+ 'reference' => 'c36586dcf89a12315939e00ec9b4474adcb1d773',
+ 'dev_requirement' => false,
+ ),
+ 'symfony/polyfill-intl-normalizer' => array(
+ 'pretty_version' => 'v1.31.0',
+ 'version' => '1.31.0.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../symfony/polyfill-intl-normalizer',
+ 'aliases' => array(),
+ 'reference' => '3833d7255cc303546435cb650316bff708a1c75c',
+ 'dev_requirement' => false,
+ ),
+ 'symfony/polyfill-mbstring' => array(
+ 'pretty_version' => 'v1.31.0',
+ 'version' => '1.31.0.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../symfony/polyfill-mbstring',
+ 'aliases' => array(),
+ 'reference' => '85181ba99b2345b0ef10ce42ecac37612d9fd341',
+ 'dev_requirement' => false,
+ ),
+ 'symfony/service-contracts' => array(
+ 'pretty_version' => 'v3.5.0',
+ 'version' => '3.5.0.0',
+ 'type' => 'library',
+ 'install_path' => __DIR__ . '/../symfony/service-contracts',
+ 'aliases' => array(),
+ 'reference' => 'bd1d9e59a81d8fa4acdcea3f617c581f7475a80f',
+ 'dev_requirement' => false,
+ ),
+ ),
+);
diff --git a/tools/mailer/composer/platform_check.php b/tools/mailer/composer/platform_check.php
new file mode 100644
index 000000000..adfb472fb
--- /dev/null
+++ b/tools/mailer/composer/platform_check.php
@@ -0,0 +1,26 @@
+= 80000)) {
+ $issues[] = 'Your Composer dependencies require a PHP version ">= 8.0.0". You are running ' . PHP_VERSION . '.';
+}
+
+if ($issues) {
+ if (!headers_sent()) {
+ header('HTTP/1.1 500 Internal Server Error');
+ }
+ if (!ini_get('display_errors')) {
+ if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') {
+ fwrite(STDERR, 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . implode(PHP_EOL, $issues) . PHP_EOL.PHP_EOL);
+ } elseif (!headers_sent()) {
+ echo 'Composer detected issues in your platform:' . PHP_EOL.PHP_EOL . str_replace('You are running '.PHP_VERSION.'.', '', implode(PHP_EOL, $issues)) . PHP_EOL.PHP_EOL;
+ }
+ }
+ trigger_error(
+ 'Composer detected issues in your platform: ' . implode(' ', $issues),
+ E_USER_ERROR
+ );
+}
diff --git a/tools/mailer/doctrine/lexer/LICENSE b/tools/mailer/doctrine/lexer/LICENSE
new file mode 100644
index 000000000..e8fdec4af
--- /dev/null
+++ b/tools/mailer/doctrine/lexer/LICENSE
@@ -0,0 +1,19 @@
+Copyright (c) 2006-2018 Doctrine Project
+
+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.
diff --git a/tools/mailer/doctrine/lexer/README.md b/tools/mailer/doctrine/lexer/README.md
new file mode 100644
index 000000000..784f2a271
--- /dev/null
+++ b/tools/mailer/doctrine/lexer/README.md
@@ -0,0 +1,9 @@
+# Doctrine Lexer
+
+[](https://github.com/doctrine/lexer/actions)
+
+Base library for a lexer that can be used in Top-Down, Recursive Descent Parsers.
+
+This lexer is used in Doctrine Annotations and in Doctrine ORM (DQL).
+
+https://www.doctrine-project.org/projects/lexer.html
diff --git a/tools/mailer/doctrine/lexer/UPGRADE.md b/tools/mailer/doctrine/lexer/UPGRADE.md
new file mode 100644
index 000000000..1933fcb2e
--- /dev/null
+++ b/tools/mailer/doctrine/lexer/UPGRADE.md
@@ -0,0 +1,22 @@
+Note about upgrading: Doctrine uses static and runtime mechanisms to raise
+awareness about deprecated code.
+
+- Use of `@deprecated` docblock that is detected by IDEs (like PHPStorm) or
+ Static Analysis tools (like Psalm, phpstan)
+- Use of our low-overhead runtime deprecation API, details:
+ https://github.com/doctrine/deprecations/
+
+# Upgrade to 3.0.0
+
+`Doctrine\Common\Lexer\Token` no longer implements `ArrayAccess`.
+Parameter type declarations have been added to
+`Doctrine\Common\Lexer\AbstractLexer` and `Doctrine\Common\Lexer\Token`.
+You should add both parameter type declarations and return type declarations to
+your lexers, based on the `@return` phpdoc.
+
+# Upgrade to 2.0.0
+
+`AbstractLexer::glimpse()` and `AbstractLexer::peek()` now return
+instances of `Doctrine\Common\Lexer\Token`, which is an array-like class
+Using it as an array is deprecated in favor of using properties of that class.
+Using `count()` on it is deprecated with no replacement.
diff --git a/tools/mailer/doctrine/lexer/composer.json b/tools/mailer/doctrine/lexer/composer.json
new file mode 100644
index 000000000..995dafa0d
--- /dev/null
+++ b/tools/mailer/doctrine/lexer/composer.json
@@ -0,0 +1,55 @@
+{
+ "name": "doctrine/lexer",
+ "description": "PHP Doctrine Lexer parser library that can be used in Top-Down, Recursive Descent Parsers.",
+ "license": "MIT",
+ "type": "library",
+ "keywords": [
+ "php",
+ "parser",
+ "lexer",
+ "annotations",
+ "docblock"
+ ],
+ "authors": [
+ {
+ "name": "Guilherme Blanco",
+ "email": "guilhermeblanco@gmail.com"
+ },
+ {
+ "name": "Roman Borschel",
+ "email": "roman@code-factory.org"
+ },
+ {
+ "name": "Johannes Schmitt",
+ "email": "schmittjoh@gmail.com"
+ }
+ ],
+ "homepage": "https://www.doctrine-project.org/projects/lexer.html",
+ "require": {
+ "php": "^8.1"
+ },
+ "require-dev": {
+ "doctrine/coding-standard": "^12",
+ "phpstan/phpstan": "^1.10",
+ "phpunit/phpunit": "^10.5",
+ "psalm/plugin-phpunit": "^0.18.3",
+ "vimeo/psalm": "^5.21"
+ },
+ "autoload": {
+ "psr-4": {
+ "Doctrine\\Common\\Lexer\\": "src"
+ }
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "Doctrine\\Tests\\Common\\Lexer\\": "tests"
+ }
+ },
+ "config": {
+ "allow-plugins": {
+ "composer/package-versions-deprecated": true,
+ "dealerdirect/phpcodesniffer-composer-installer": true
+ },
+ "sort-packages": true
+ }
+}
diff --git a/tools/mailer/doctrine/lexer/src/AbstractLexer.php b/tools/mailer/doctrine/lexer/src/AbstractLexer.php
new file mode 100644
index 000000000..2436885e4
--- /dev/null
+++ b/tools/mailer/doctrine/lexer/src/AbstractLexer.php
@@ -0,0 +1,328 @@
+>
+ */
+ private array $tokens = [];
+
+ /**
+ * Current lexer position in input string.
+ */
+ private int $position = 0;
+
+ /**
+ * Current peek of current lexer position.
+ */
+ private int $peek = 0;
+
+ /**
+ * The next token in the input.
+ *
+ * @var Token|null
+ */
+ public Token|null $lookahead;
+
+ /**
+ * The last matched/seen token.
+ *
+ * @var Token|null
+ */
+ public Token|null $token;
+
+ /**
+ * Composed regex for input parsing.
+ *
+ * @var non-empty-string|null
+ */
+ private string|null $regex = null;
+
+ /**
+ * Sets the input data to be tokenized.
+ *
+ * The Lexer is immediately reset and the new input tokenized.
+ * Any unprocessed tokens from any previous input are lost.
+ *
+ * @param string $input The input to be tokenized.
+ *
+ * @return void
+ */
+ public function setInput(string $input)
+ {
+ $this->input = $input;
+ $this->tokens = [];
+
+ $this->reset();
+ $this->scan($input);
+ }
+
+ /**
+ * Resets the lexer.
+ *
+ * @return void
+ */
+ public function reset()
+ {
+ $this->lookahead = null;
+ $this->token = null;
+ $this->peek = 0;
+ $this->position = 0;
+ }
+
+ /**
+ * Resets the peek pointer to 0.
+ *
+ * @return void
+ */
+ public function resetPeek()
+ {
+ $this->peek = 0;
+ }
+
+ /**
+ * Resets the lexer position on the input to the given position.
+ *
+ * @param int $position Position to place the lexical scanner.
+ *
+ * @return void
+ */
+ public function resetPosition(int $position = 0)
+ {
+ $this->position = $position;
+ }
+
+ /**
+ * Retrieve the original lexer's input until a given position.
+ *
+ * @return string
+ */
+ public function getInputUntilPosition(int $position)
+ {
+ return substr($this->input, 0, $position);
+ }
+
+ /**
+ * Checks whether a given token matches the current lookahead.
+ *
+ * @param T $type
+ *
+ * @return bool
+ *
+ * @psalm-assert-if-true !=null $this->lookahead
+ */
+ public function isNextToken(int|string|UnitEnum $type)
+ {
+ return $this->lookahead !== null && $this->lookahead->isA($type);
+ }
+
+ /**
+ * Checks whether any of the given tokens matches the current lookahead.
+ *
+ * @param list $types
+ *
+ * @return bool
+ *
+ * @psalm-assert-if-true !=null $this->lookahead
+ */
+ public function isNextTokenAny(array $types)
+ {
+ return $this->lookahead !== null && $this->lookahead->isA(...$types);
+ }
+
+ /**
+ * Moves to the next token in the input string.
+ *
+ * @return bool
+ *
+ * @psalm-assert-if-true !null $this->lookahead
+ */
+ public function moveNext()
+ {
+ $this->peek = 0;
+ $this->token = $this->lookahead;
+ $this->lookahead = isset($this->tokens[$this->position])
+ ? $this->tokens[$this->position++] : null;
+
+ return $this->lookahead !== null;
+ }
+
+ /**
+ * Tells the lexer to skip input tokens until it sees a token with the given value.
+ *
+ * @param T $type The token type to skip until.
+ *
+ * @return void
+ */
+ public function skipUntil(int|string|UnitEnum $type)
+ {
+ while ($this->lookahead !== null && ! $this->lookahead->isA($type)) {
+ $this->moveNext();
+ }
+ }
+
+ /**
+ * Checks if given value is identical to the given token.
+ *
+ * @return bool
+ */
+ public function isA(string $value, int|string|UnitEnum $token)
+ {
+ return $this->getType($value) === $token;
+ }
+
+ /**
+ * Moves the lookahead token forward.
+ *
+ * @return Token|null The next token or NULL if there are no more tokens ahead.
+ */
+ public function peek()
+ {
+ if (isset($this->tokens[$this->position + $this->peek])) {
+ return $this->tokens[$this->position + $this->peek++];
+ }
+
+ return null;
+ }
+
+ /**
+ * Peeks at the next token, returns it and immediately resets the peek.
+ *
+ * @return Token|null The next token or NULL if there are no more tokens ahead.
+ */
+ public function glimpse()
+ {
+ $peek = $this->peek();
+ $this->peek = 0;
+
+ return $peek;
+ }
+
+ /**
+ * Scans the input string for tokens.
+ *
+ * @param string $input A query string.
+ *
+ * @return void
+ */
+ protected function scan(string $input)
+ {
+ if (! isset($this->regex)) {
+ $this->regex = sprintf(
+ '/(%s)|%s/%s',
+ implode(')|(', $this->getCatchablePatterns()),
+ implode('|', $this->getNonCatchablePatterns()),
+ $this->getModifiers(),
+ );
+ }
+
+ $flags = PREG_SPLIT_NO_EMPTY | PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_OFFSET_CAPTURE;
+ $matches = preg_split($this->regex, $input, -1, $flags);
+
+ if ($matches === false) {
+ // Work around https://bugs.php.net/78122
+ $matches = [[$input, 0]];
+ }
+
+ foreach ($matches as $match) {
+ // Must remain before 'value' assignment since it can change content
+ $firstMatch = $match[0];
+ $type = $this->getType($firstMatch);
+
+ $this->tokens[] = new Token(
+ $firstMatch,
+ $type,
+ $match[1],
+ );
+ }
+ }
+
+ /**
+ * Gets the literal for a given token.
+ *
+ * @param T $token
+ *
+ * @return int|string
+ */
+ public function getLiteral(int|string|UnitEnum $token)
+ {
+ if ($token instanceof UnitEnum) {
+ return $token::class . '::' . $token->name;
+ }
+
+ $className = static::class;
+
+ $reflClass = new ReflectionClass($className);
+ $constants = $reflClass->getConstants();
+
+ foreach ($constants as $name => $value) {
+ if ($value === $token) {
+ return $className . '::' . $name;
+ }
+ }
+
+ return $token;
+ }
+
+ /**
+ * Regex modifiers
+ *
+ * @return string
+ */
+ protected function getModifiers()
+ {
+ return 'iu';
+ }
+
+ /**
+ * Lexical catchable patterns.
+ *
+ * @return string[]
+ */
+ abstract protected function getCatchablePatterns();
+
+ /**
+ * Lexical non-catchable patterns.
+ *
+ * @return string[]
+ */
+ abstract protected function getNonCatchablePatterns();
+
+ /**
+ * Retrieve token type. Also processes the token value if necessary.
+ *
+ * @return T|null
+ *
+ * @param-out V $value
+ */
+ abstract protected function getType(string &$value);
+}
diff --git a/tools/mailer/doctrine/lexer/src/Token.php b/tools/mailer/doctrine/lexer/src/Token.php
new file mode 100644
index 000000000..b6df69465
--- /dev/null
+++ b/tools/mailer/doctrine/lexer/src/Token.php
@@ -0,0 +1,56 @@
+value = $value;
+ $this->type = $type;
+ $this->position = $position;
+ }
+
+ /** @param T ...$types */
+ public function isA(...$types): bool
+ {
+ return in_array($this->type, $types, true);
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/CHANGELOG.md b/tools/mailer/egulias/email-validator/CHANGELOG.md
new file mode 100644
index 000000000..39f5a8a05
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/CHANGELOG.md
@@ -0,0 +1,32 @@
+# EmailValidator Changelog
+
+## New Features
+
+* Access to local part and domain part from EmailParser
+* Validations outside of the scope of the RFC will be considered "extra" validations, thus opening the door for adding new; will live in their own folder "extra" (as requested in #248, #195, #183).
+
+## Breaking changes
+
+* PHP version upgraded to match Symfony's (as of 12/2020).
+* DNSCheckValidation now fails for missing MX records. While the RFC argues that the existence of only A records to be valid, starting in v3 they will be considered invalid.
+* Emails domain part are now intenteded to be RFC 1035 compliant, rendering previous valid emails (e.g example@examp&) invalid.
+
+## PHP versions upgrade policy
+PHP version upgrade requirement will happen via MINOR (3.x) version upgrades of the library, following the adoption level by major frameworks.
+
+## Changes
+* #235
+* #215
+* #130
+* #258
+* #188
+* #181
+* #217
+* #214
+* #249
+* #236
+* #257
+* #210
+
+## Thanks
+To contributors, be it with PRs, reporting issues or supporting otherwise.
diff --git a/tools/mailer/egulias/email-validator/CONTRIBUTING.md b/tools/mailer/egulias/email-validator/CONTRIBUTING.md
new file mode 100644
index 000000000..907bc2c9b
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/CONTRIBUTING.md
@@ -0,0 +1,153 @@
+# Contributing
+
+When contributing to this repository make sure to follow the Pull request process below.
+Reduce to the minimum 3rd party dependencies.
+
+Please note we have a [code of conduct](#Code of Conduct), please follow it in all your interactions with the project.
+
+## Pull Request Process
+
+When doing a PR to v2 remember that you also have to do the PR port to v3, or tests confirming the bug is not reproducible.
+
+1. Supported version is v3. If you are fixing a bug in v2, please port to v3
+2. Use the title as a brief description of the changes
+3. Describe the changes you are proposing
+ 1. If adding an extra validation state the benefits of adding it and the problem is solving
+ 2. Document in the readme, by adding it to the list
+4. Provide appropriate tests for the code you are submitting: aim to keep the existing coverage percentage.
+5. Add your Twitter handle (if you have) so we can thank you there.
+
+## License
+By contributing, you agree that your contributions will be licensed under its MIT License.
+
+## Code of Conduct
+
+### Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+### Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+ and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+ overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+ advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+ address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+### Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+### Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+### Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at .
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+#### Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+#### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+#### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+#### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+#### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+### Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+[https://www.contributor-covenant.org/version/2/0/code_of_conduct.html][v2.0].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available
+at [https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.0]: https://www.contributor-covenant.org/version/2/0/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations
diff --git a/tools/mailer/egulias/email-validator/LICENSE b/tools/mailer/egulias/email-validator/LICENSE
new file mode 100644
index 000000000..b1902a4e9
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/LICENSE
@@ -0,0 +1,19 @@
+Copyright (c) 2013-2023 Eduardo Gulias Davis
+
+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.
diff --git a/tools/mailer/egulias/email-validator/composer.json b/tools/mailer/egulias/email-validator/composer.json
new file mode 100644
index 000000000..bf1b3f4c9
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/composer.json
@@ -0,0 +1,37 @@
+{
+ "name": "egulias/email-validator",
+ "description": "A library for validating emails against several RFCs",
+ "homepage": "https://github.com/egulias/EmailValidator",
+ "keywords": ["email", "validation", "validator", "emailvalidation", "emailvalidator"],
+ "license": "MIT",
+ "authors": [
+ {"name": "Eduardo Gulias Davis"}
+ ],
+ "extra": {
+ "branch-alias": {
+ "dev-master": "4.0.x-dev"
+ }
+ },
+ "require": {
+ "php": ">=8.1",
+ "doctrine/lexer": "^2.0 || ^3.0",
+ "symfony/polyfill-intl-idn": "^1.26"
+ },
+ "require-dev": {
+ "phpunit/phpunit": "^10.2",
+ "vimeo/psalm": "^5.12"
+ },
+ "suggest": {
+ "ext-intl": "PHP Internationalization Libraries are required to use the SpoofChecking validation"
+ },
+ "autoload": {
+ "psr-4": {
+ "Egulias\\EmailValidator\\": "src"
+ }
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "Egulias\\EmailValidator\\Tests\\": "tests"
+ }
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/EmailLexer.php b/tools/mailer/egulias/email-validator/src/EmailLexer.php
new file mode 100644
index 000000000..969c049f8
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/EmailLexer.php
@@ -0,0 +1,330 @@
+ */
+class EmailLexer extends AbstractLexer
+{
+ //ASCII values
+ public const S_EMPTY = -1;
+ public const C_NUL = 0;
+ public const S_HTAB = 9;
+ public const S_LF = 10;
+ public const S_CR = 13;
+ public const S_SP = 32;
+ public const EXCLAMATION = 33;
+ public const S_DQUOTE = 34;
+ public const NUMBER_SIGN = 35;
+ public const DOLLAR = 36;
+ public const PERCENTAGE = 37;
+ public const AMPERSAND = 38;
+ public const S_SQUOTE = 39;
+ public const S_OPENPARENTHESIS = 40;
+ public const S_CLOSEPARENTHESIS = 41;
+ public const ASTERISK = 42;
+ public const S_PLUS = 43;
+ public const S_COMMA = 44;
+ public const S_HYPHEN = 45;
+ public const S_DOT = 46;
+ public const S_SLASH = 47;
+ public const S_COLON = 58;
+ public const S_SEMICOLON = 59;
+ public const S_LOWERTHAN = 60;
+ public const S_EQUAL = 61;
+ public const S_GREATERTHAN = 62;
+ public const QUESTIONMARK = 63;
+ public const S_AT = 64;
+ public const S_OPENBRACKET = 91;
+ public const S_BACKSLASH = 92;
+ public const S_CLOSEBRACKET = 93;
+ public const CARET = 94;
+ public const S_UNDERSCORE = 95;
+ public const S_BACKTICK = 96;
+ public const S_OPENCURLYBRACES = 123;
+ public const S_PIPE = 124;
+ public const S_CLOSECURLYBRACES = 125;
+ public const S_TILDE = 126;
+ public const C_DEL = 127;
+ public const INVERT_QUESTIONMARK = 168;
+ public const INVERT_EXCLAMATION = 173;
+ public const GENERIC = 300;
+ public const S_IPV6TAG = 301;
+ public const INVALID = 302;
+ public const CRLF = 1310;
+ public const S_DOUBLECOLON = 5858;
+ public const ASCII_INVALID_FROM = 127;
+ public const ASCII_INVALID_TO = 199;
+
+ /**
+ * US-ASCII visible characters not valid for atext (@link http://tools.ietf.org/html/rfc5322#section-3.2.3)
+ *
+ * @var array
+ */
+ protected $charValue = [
+ '{' => self::S_OPENCURLYBRACES,
+ '}' => self::S_CLOSECURLYBRACES,
+ '(' => self::S_OPENPARENTHESIS,
+ ')' => self::S_CLOSEPARENTHESIS,
+ '<' => self::S_LOWERTHAN,
+ '>' => self::S_GREATERTHAN,
+ '[' => self::S_OPENBRACKET,
+ ']' => self::S_CLOSEBRACKET,
+ ':' => self::S_COLON,
+ ';' => self::S_SEMICOLON,
+ '@' => self::S_AT,
+ '\\' => self::S_BACKSLASH,
+ '/' => self::S_SLASH,
+ ',' => self::S_COMMA,
+ '.' => self::S_DOT,
+ "'" => self::S_SQUOTE,
+ "`" => self::S_BACKTICK,
+ '"' => self::S_DQUOTE,
+ '-' => self::S_HYPHEN,
+ '::' => self::S_DOUBLECOLON,
+ ' ' => self::S_SP,
+ "\t" => self::S_HTAB,
+ "\r" => self::S_CR,
+ "\n" => self::S_LF,
+ "\r\n" => self::CRLF,
+ 'IPv6' => self::S_IPV6TAG,
+ '' => self::S_EMPTY,
+ '\0' => self::C_NUL,
+ '*' => self::ASTERISK,
+ '!' => self::EXCLAMATION,
+ '&' => self::AMPERSAND,
+ '^' => self::CARET,
+ '$' => self::DOLLAR,
+ '%' => self::PERCENTAGE,
+ '~' => self::S_TILDE,
+ '|' => self::S_PIPE,
+ '_' => self::S_UNDERSCORE,
+ '=' => self::S_EQUAL,
+ '+' => self::S_PLUS,
+ '¿' => self::INVERT_QUESTIONMARK,
+ '?' => self::QUESTIONMARK,
+ '#' => self::NUMBER_SIGN,
+ '¡' => self::INVERT_EXCLAMATION,
+ ];
+
+ public const INVALID_CHARS_REGEX = "/[^\p{S}\p{C}\p{Cc}]+/iu";
+
+ public const VALID_UTF8_REGEX = '/\p{Cc}+/u';
+
+ public const CATCHABLE_PATTERNS = [
+ '[a-zA-Z]+[46]?', //ASCII and domain literal
+ '[^\x00-\x7F]', //UTF-8
+ '[0-9]+',
+ '\r\n',
+ '::',
+ '\s+?',
+ '.',
+ ];
+
+ public const NON_CATCHABLE_PATTERNS = [
+ '[\xA0-\xff]+',
+ ];
+
+ public const MODIFIERS = 'iu';
+
+ /** @var bool */
+ protected $hasInvalidTokens = false;
+
+ /**
+ * @var Token
+ */
+ protected Token $previous;
+
+ /**
+ * The last matched/seen token.
+ *
+ * @var Token
+ */
+ public Token $current;
+
+ /**
+ * @var Token
+ */
+ private Token $nullToken;
+
+ /** @var string */
+ private $accumulator = '';
+
+ /** @var bool */
+ private $hasToRecord = false;
+
+ public function __construct()
+ {
+ /** @var Token $nullToken */
+ $nullToken = new Token('', self::S_EMPTY, 0);
+ $this->nullToken = $nullToken;
+
+ $this->current = $this->previous = $this->nullToken;
+ $this->lookahead = null;
+ }
+
+ public function reset(): void
+ {
+ $this->hasInvalidTokens = false;
+ parent::reset();
+ $this->current = $this->previous = $this->nullToken;
+ }
+
+ /**
+ * @param int $type
+ * @throws \UnexpectedValueException
+ * @return boolean
+ *
+ * @psalm-suppress InvalidScalarArgument
+ */
+ public function find($type): bool
+ {
+ $search = clone $this;
+ $search->skipUntil($type);
+
+ if (!$search->lookahead) {
+ throw new \UnexpectedValueException($type . ' not found');
+ }
+ return true;
+ }
+
+ /**
+ * moveNext
+ *
+ * @return boolean
+ */
+ public function moveNext(): bool
+ {
+ if ($this->hasToRecord && $this->previous === $this->nullToken) {
+ $this->accumulator .= $this->current->value;
+ }
+
+ $this->previous = $this->current;
+
+ if ($this->lookahead === null) {
+ $this->lookahead = $this->nullToken;
+ }
+
+ $hasNext = parent::moveNext();
+ $this->current = $this->token ?? $this->nullToken;
+
+ if ($this->hasToRecord) {
+ $this->accumulator .= $this->current->value;
+ }
+
+ return $hasNext;
+ }
+
+ /**
+ * Retrieve token type. Also processes the token value if necessary.
+ *
+ * @param string $value
+ * @throws \InvalidArgumentException
+ * @return integer
+ */
+ protected function getType(&$value): int
+ {
+ $encoded = $value;
+
+ if (mb_detect_encoding($value, 'auto', true) !== 'UTF-8') {
+ $encoded = mb_convert_encoding($value, 'UTF-8', 'Windows-1252');
+ }
+
+ if ($this->isValid($encoded)) {
+ return $this->charValue[$encoded];
+ }
+
+ if ($this->isNullType($encoded)) {
+ return self::C_NUL;
+ }
+
+ if ($this->isInvalidChar($encoded)) {
+ $this->hasInvalidTokens = true;
+ return self::INVALID;
+ }
+
+ return self::GENERIC;
+ }
+
+ protected function isValid(string $value): bool
+ {
+ return isset($this->charValue[$value]);
+ }
+
+ protected function isNullType(string $value): bool
+ {
+ return $value === "\0";
+ }
+
+ protected function isInvalidChar(string $value): bool
+ {
+ return !preg_match(self::INVALID_CHARS_REGEX, $value);
+ }
+
+ protected function isUTF8Invalid(string $value): bool
+ {
+ return preg_match(self::VALID_UTF8_REGEX, $value) !== false;
+ }
+
+ public function hasInvalidTokens(): bool
+ {
+ return $this->hasInvalidTokens;
+ }
+
+ /**
+ * getPrevious
+ *
+ * @return Token
+ */
+ public function getPrevious(): Token
+ {
+ return $this->previous;
+ }
+
+ /**
+ * Lexical catchable patterns.
+ *
+ * @return string[]
+ */
+ protected function getCatchablePatterns(): array
+ {
+ return self::CATCHABLE_PATTERNS;
+ }
+
+ /**
+ * Lexical non-catchable patterns.
+ *
+ * @return string[]
+ */
+ protected function getNonCatchablePatterns(): array
+ {
+ return self::NON_CATCHABLE_PATTERNS;
+ }
+
+ protected function getModifiers(): string
+ {
+ return self::MODIFIERS;
+ }
+
+ public function getAccumulatedValues(): string
+ {
+ return $this->accumulator;
+ }
+
+ public function startRecording(): void
+ {
+ $this->hasToRecord = true;
+ }
+
+ public function stopRecording(): void
+ {
+ $this->hasToRecord = false;
+ }
+
+ public function clearRecorded(): void
+ {
+ $this->accumulator = '';
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/EmailParser.php b/tools/mailer/egulias/email-validator/src/EmailParser.php
new file mode 100644
index 000000000..fc449c76f
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/EmailParser.php
@@ -0,0 +1,90 @@
+addLongEmailWarning($this->localPart, $this->domainPart);
+
+ return $result;
+ }
+
+ protected function preLeftParsing(): Result
+ {
+ if (!$this->hasAtToken()) {
+ return new InvalidEmail(new NoLocalPart(), $this->lexer->current->value);
+ }
+ return new ValidEmail();
+ }
+
+ protected function parseLeftFromAt(): Result
+ {
+ return $this->processLocalPart();
+ }
+
+ protected function parseRightFromAt(): Result
+ {
+ return $this->processDomainPart();
+ }
+
+ private function processLocalPart(): Result
+ {
+ $localPartParser = new LocalPart($this->lexer);
+ $localPartResult = $localPartParser->parse();
+ $this->localPart = $localPartParser->localPart();
+ $this->warnings = [...$localPartParser->getWarnings(), ...$this->warnings];
+
+ return $localPartResult;
+ }
+
+ private function processDomainPart(): Result
+ {
+ $domainPartParser = new DomainPart($this->lexer);
+ $domainPartResult = $domainPartParser->parse();
+ $this->domainPart = $domainPartParser->domainPart();
+ $this->warnings = [...$domainPartParser->getWarnings(), ...$this->warnings];
+
+ return $domainPartResult;
+ }
+
+ public function getDomainPart(): string
+ {
+ return $this->domainPart;
+ }
+
+ public function getLocalPart(): string
+ {
+ return $this->localPart;
+ }
+
+ private function addLongEmailWarning(string $localPart, string $parsedDomainPart): void
+ {
+ if (strlen($localPart . '@' . $parsedDomainPart) > self::EMAIL_MAX_LENGTH) {
+ $this->warnings[EmailTooLong::CODE] = new EmailTooLong();
+ }
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/EmailValidator.php b/tools/mailer/egulias/email-validator/src/EmailValidator.php
new file mode 100644
index 000000000..5a2e5c822
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/EmailValidator.php
@@ -0,0 +1,67 @@
+lexer = new EmailLexer();
+ }
+
+ /**
+ * @param string $email
+ * @param EmailValidation $emailValidation
+ * @return bool
+ */
+ public function isValid(string $email, EmailValidation $emailValidation)
+ {
+ $isValid = $emailValidation->isValid($email, $this->lexer);
+ $this->warnings = $emailValidation->getWarnings();
+ $this->error = $emailValidation->getError();
+
+ return $isValid;
+ }
+
+ /**
+ * @return boolean
+ */
+ public function hasWarnings()
+ {
+ return !empty($this->warnings);
+ }
+
+ /**
+ * @return array
+ */
+ public function getWarnings()
+ {
+ return $this->warnings;
+ }
+
+ /**
+ * @return InvalidEmail|null
+ */
+ public function getError()
+ {
+ return $this->error;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/MessageIDParser.php b/tools/mailer/egulias/email-validator/src/MessageIDParser.php
new file mode 100644
index 000000000..35bd0a7f1
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/MessageIDParser.php
@@ -0,0 +1,91 @@
+addLongEmailWarning($this->idLeft, $this->idRight);
+
+ return $result;
+ }
+
+ protected function preLeftParsing(): Result
+ {
+ if (!$this->hasAtToken()) {
+ return new InvalidEmail(new NoLocalPart(), $this->lexer->current->value);
+ }
+ return new ValidEmail();
+ }
+
+ protected function parseLeftFromAt(): Result
+ {
+ return $this->processIDLeft();
+ }
+
+ protected function parseRightFromAt(): Result
+ {
+ return $this->processIDRight();
+ }
+
+ private function processIDLeft(): Result
+ {
+ $localPartParser = new IDLeftPart($this->lexer);
+ $localPartResult = $localPartParser->parse();
+ $this->idLeft = $localPartParser->localPart();
+ $this->warnings = [...$localPartParser->getWarnings(), ...$this->warnings];
+
+ return $localPartResult;
+ }
+
+ private function processIDRight(): Result
+ {
+ $domainPartParser = new IDRightPart($this->lexer);
+ $domainPartResult = $domainPartParser->parse();
+ $this->idRight = $domainPartParser->domainPart();
+ $this->warnings = [...$domainPartParser->getWarnings(), ...$this->warnings];
+
+ return $domainPartResult;
+ }
+
+ public function getLeftPart(): string
+ {
+ return $this->idLeft;
+ }
+
+ public function getRightPart(): string
+ {
+ return $this->idRight;
+ }
+
+ private function addLongEmailWarning(string $localPart, string $parsedDomainPart): void
+ {
+ if (strlen($localPart . '@' . $parsedDomainPart) > self::EMAILID_MAX_LENGTH) {
+ $this->warnings[EmailTooLong::CODE] = new EmailTooLong();
+ }
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Parser.php b/tools/mailer/egulias/email-validator/src/Parser.php
new file mode 100644
index 000000000..d577e3eae
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Parser.php
@@ -0,0 +1,78 @@
+lexer = $lexer;
+ }
+
+ public function parse(string $str): Result
+ {
+ $this->lexer->setInput($str);
+
+ if ($this->lexer->hasInvalidTokens()) {
+ return new InvalidEmail(new ExpectingATEXT("Invalid tokens found"), $this->lexer->current->value);
+ }
+
+ $preParsingResult = $this->preLeftParsing();
+ if ($preParsingResult->isInvalid()) {
+ return $preParsingResult;
+ }
+
+ $localPartResult = $this->parseLeftFromAt();
+
+ if ($localPartResult->isInvalid()) {
+ return $localPartResult;
+ }
+
+ $domainPartResult = $this->parseRightFromAt();
+
+ if ($domainPartResult->isInvalid()) {
+ return $domainPartResult;
+ }
+
+ return new ValidEmail();
+ }
+
+ /**
+ * @return Warning\Warning[]
+ */
+ public function getWarnings(): array
+ {
+ return $this->warnings;
+ }
+
+ protected function hasAtToken(): bool
+ {
+ $this->lexer->moveNext();
+ $this->lexer->moveNext();
+
+ return !$this->lexer->current->isA(EmailLexer::S_AT);
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Parser/Comment.php b/tools/mailer/egulias/email-validator/src/Parser/Comment.php
new file mode 100644
index 000000000..7b5b47e29
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Parser/Comment.php
@@ -0,0 +1,102 @@
+lexer = $lexer;
+ $this->commentStrategy = $commentStrategy;
+ }
+
+ public function parse(): Result
+ {
+ if ($this->lexer->current->isA(EmailLexer::S_OPENPARENTHESIS)) {
+ $this->openedParenthesis++;
+ if ($this->noClosingParenthesis()) {
+ return new InvalidEmail(new UnclosedComment(), $this->lexer->current->value);
+ }
+ }
+
+ if ($this->lexer->current->isA(EmailLexer::S_CLOSEPARENTHESIS)) {
+ return new InvalidEmail(new UnOpenedComment(), $this->lexer->current->value);
+ }
+
+ $this->warnings[WarningComment::CODE] = new WarningComment();
+
+ $moreTokens = true;
+ while ($this->commentStrategy->exitCondition($this->lexer, $this->openedParenthesis) && $moreTokens) {
+
+ if ($this->lexer->isNextToken(EmailLexer::S_OPENPARENTHESIS)) {
+ $this->openedParenthesis++;
+ }
+ $this->warnEscaping();
+ if ($this->lexer->isNextToken(EmailLexer::S_CLOSEPARENTHESIS)) {
+ $this->openedParenthesis--;
+ }
+ $moreTokens = $this->lexer->moveNext();
+ }
+
+ if ($this->openedParenthesis >= 1) {
+ return new InvalidEmail(new UnclosedComment(), $this->lexer->current->value);
+ }
+ if ($this->openedParenthesis < 0) {
+ return new InvalidEmail(new UnOpenedComment(), $this->lexer->current->value);
+ }
+
+ $finalValidations = $this->commentStrategy->endOfLoopValidations($this->lexer);
+
+ $this->warnings = [...$this->warnings, ...$this->commentStrategy->getWarnings()];
+
+ return $finalValidations;
+ }
+
+
+ /**
+ * @return void
+ */
+ private function warnEscaping(): void
+ {
+ //Backslash found
+ if (!$this->lexer->current->isA(EmailLexer::S_BACKSLASH)) {
+ return;
+ }
+
+ if (!$this->lexer->isNextTokenAny(array(EmailLexer::S_SP, EmailLexer::S_HTAB, EmailLexer::C_DEL))) {
+ return;
+ }
+
+ $this->warnings[QuotedPart::CODE] =
+ new QuotedPart($this->lexer->getPrevious()->type, $this->lexer->current->type);
+ }
+
+ private function noClosingParenthesis(): bool
+ {
+ try {
+ $this->lexer->find(EmailLexer::S_CLOSEPARENTHESIS);
+ return false;
+ } catch (\RuntimeException $e) {
+ return true;
+ }
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Parser/CommentStrategy/CommentStrategy.php b/tools/mailer/egulias/email-validator/src/Parser/CommentStrategy/CommentStrategy.php
new file mode 100644
index 000000000..8834db04c
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Parser/CommentStrategy/CommentStrategy.php
@@ -0,0 +1,22 @@
+isNextToken(EmailLexer::S_DOT));
+ }
+
+ public function endOfLoopValidations(EmailLexer $lexer): Result
+ {
+ //test for end of string
+ if (!$lexer->isNextToken(EmailLexer::S_DOT)) {
+ return new InvalidEmail(new ExpectingATEXT('DOT not found near CLOSEPARENTHESIS'), $lexer->current->value);
+ }
+ //add warning
+ //Address is valid within the message but cannot be used unmodified for the envelope
+ return new ValidEmail();
+ }
+
+ public function getWarnings(): array
+ {
+ return [];
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Parser/CommentStrategy/LocalComment.php b/tools/mailer/egulias/email-validator/src/Parser/CommentStrategy/LocalComment.php
new file mode 100644
index 000000000..5c18b440b
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Parser/CommentStrategy/LocalComment.php
@@ -0,0 +1,37 @@
+isNextToken(EmailLexer::S_AT);
+ }
+
+ public function endOfLoopValidations(EmailLexer $lexer): Result
+ {
+ if (!$lexer->isNextToken(EmailLexer::S_AT)) {
+ return new InvalidEmail(new ExpectingATEXT('ATEX is not expected after closing comments'), $lexer->current->value);
+ }
+ $this->warnings[CFWSNearAt::CODE] = new CFWSNearAt();
+ return new ValidEmail();
+ }
+
+ public function getWarnings(): array
+ {
+ return $this->warnings;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Parser/DomainLiteral.php b/tools/mailer/egulias/email-validator/src/Parser/DomainLiteral.php
new file mode 100644
index 000000000..5093e5083
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Parser/DomainLiteral.php
@@ -0,0 +1,210 @@
+addTagWarnings();
+
+ $IPv6TAG = false;
+ $addressLiteral = '';
+
+ do {
+ if ($this->lexer->current->isA(EmailLexer::C_NUL)) {
+ return new InvalidEmail(new ExpectingDTEXT(), $this->lexer->current->value);
+ }
+
+ $this->addObsoleteWarnings();
+
+ if ($this->lexer->isNextTokenAny(array(EmailLexer::S_OPENBRACKET, EmailLexer::S_OPENBRACKET))) {
+ return new InvalidEmail(new ExpectingDTEXT(), $this->lexer->current->value);
+ }
+
+ if ($this->lexer->isNextTokenAny(
+ array(EmailLexer::S_HTAB, EmailLexer::S_SP, EmailLexer::CRLF)
+ )) {
+ $this->warnings[CFWSWithFWS::CODE] = new CFWSWithFWS();
+ $this->parseFWS();
+ }
+
+ if ($this->lexer->isNextToken(EmailLexer::S_CR)) {
+ return new InvalidEmail(new CRNoLF(), $this->lexer->current->value);
+ }
+
+ if ($this->lexer->current->isA(EmailLexer::S_BACKSLASH)) {
+ return new InvalidEmail(new UnusualElements($this->lexer->current->value), $this->lexer->current->value);
+ }
+ if ($this->lexer->current->isA(EmailLexer::S_IPV6TAG)) {
+ $IPv6TAG = true;
+ }
+
+ if ($this->lexer->current->isA(EmailLexer::S_CLOSEBRACKET)) {
+ break;
+ }
+
+ $addressLiteral .= $this->lexer->current->value;
+ } while ($this->lexer->moveNext());
+
+
+ //Encapsulate
+ $addressLiteral = str_replace('[', '', $addressLiteral);
+ $isAddressLiteralIPv4 = $this->checkIPV4Tag($addressLiteral);
+
+ if (!$isAddressLiteralIPv4) {
+ return new ValidEmail();
+ }
+
+ $addressLiteral = $this->convertIPv4ToIPv6($addressLiteral);
+
+ if (!$IPv6TAG) {
+ $this->warnings[WarningDomainLiteral::CODE] = new WarningDomainLiteral();
+ return new ValidEmail();
+ }
+
+ $this->warnings[AddressLiteral::CODE] = new AddressLiteral();
+
+ $this->checkIPV6Tag($addressLiteral);
+
+ return new ValidEmail();
+ }
+
+ /**
+ * @param string $addressLiteral
+ * @param int $maxGroups
+ */
+ public function checkIPV6Tag($addressLiteral, $maxGroups = 8): void
+ {
+ $prev = $this->lexer->getPrevious();
+ if ($prev->isA(EmailLexer::S_COLON)) {
+ $this->warnings[IPV6ColonEnd::CODE] = new IPV6ColonEnd();
+ }
+
+ $IPv6 = substr($addressLiteral, 5);
+ //Daniel Marschall's new IPv6 testing strategy
+ $matchesIP = explode(':', $IPv6);
+ $groupCount = count($matchesIP);
+ $colons = strpos($IPv6, '::');
+
+ if (count(preg_grep('/^[0-9A-Fa-f]{0,4}$/', $matchesIP, PREG_GREP_INVERT)) !== 0) {
+ $this->warnings[IPV6BadChar::CODE] = new IPV6BadChar();
+ }
+
+ if ($colons === false) {
+ // We need exactly the right number of groups
+ if ($groupCount !== $maxGroups) {
+ $this->warnings[IPV6GroupCount::CODE] = new IPV6GroupCount();
+ }
+ return;
+ }
+
+ if ($colons !== strrpos($IPv6, '::')) {
+ $this->warnings[IPV6DoubleColon::CODE] = new IPV6DoubleColon();
+ return;
+ }
+
+ if ($colons === 0 || $colons === (strlen($IPv6) - 2)) {
+ // RFC 4291 allows :: at the start or end of an address
+ //with 7 other groups in addition
+ ++$maxGroups;
+ }
+
+ if ($groupCount > $maxGroups) {
+ $this->warnings[IPV6MaxGroups::CODE] = new IPV6MaxGroups();
+ } elseif ($groupCount === $maxGroups) {
+ $this->warnings[IPV6Deprecated::CODE] = new IPV6Deprecated();
+ }
+ }
+
+ public function convertIPv4ToIPv6(string $addressLiteralIPv4): string
+ {
+ $matchesIP = [];
+ $IPv4Match = preg_match(self::IPV4_REGEX, $addressLiteralIPv4, $matchesIP);
+
+ // Extract IPv4 part from the end of the address-literal (if there is one)
+ if ($IPv4Match > 0) {
+ $index = (int) strrpos($addressLiteralIPv4, $matchesIP[0]);
+ //There's a match but it is at the start
+ if ($index > 0) {
+ // Convert IPv4 part to IPv6 format for further testing
+ return substr($addressLiteralIPv4, 0, $index) . '0:0';
+ }
+ }
+
+ return $addressLiteralIPv4;
+ }
+
+ /**
+ * @param string $addressLiteral
+ *
+ * @return bool
+ */
+ protected function checkIPV4Tag($addressLiteral): bool
+ {
+ $matchesIP = [];
+ $IPv4Match = preg_match(self::IPV4_REGEX, $addressLiteral, $matchesIP);
+
+ // Extract IPv4 part from the end of the address-literal (if there is one)
+
+ if ($IPv4Match > 0) {
+ $index = strrpos($addressLiteral, $matchesIP[0]);
+ //There's a match but it is at the start
+ if ($index === 0) {
+ $this->warnings[AddressLiteral::CODE] = new AddressLiteral();
+ return false;
+ }
+ }
+
+ return true;
+ }
+
+ private function addObsoleteWarnings(): void
+ {
+ if (in_array($this->lexer->current->type, self::OBSOLETE_WARNINGS)) {
+ $this->warnings[ObsoleteDTEXT::CODE] = new ObsoleteDTEXT();
+ }
+ }
+
+ private function addTagWarnings(): void
+ {
+ if ($this->lexer->isNextToken(EmailLexer::S_COLON)) {
+ $this->warnings[IPV6ColonStart::CODE] = new IPV6ColonStart();
+ }
+ if ($this->lexer->isNextToken(EmailLexer::S_IPV6TAG)) {
+ $lexer = clone $this->lexer;
+ $lexer->moveNext();
+ if ($lexer->isNextToken(EmailLexer::S_DOUBLECOLON)) {
+ $this->warnings[IPV6ColonStart::CODE] = new IPV6ColonStart();
+ }
+ }
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Parser/DomainPart.php b/tools/mailer/egulias/email-validator/src/Parser/DomainPart.php
new file mode 100644
index 000000000..a1a56cf3d
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Parser/DomainPart.php
@@ -0,0 +1,326 @@
+lexer->clearRecorded();
+ $this->lexer->startRecording();
+
+ $this->lexer->moveNext();
+
+ $domainChecks = $this->performDomainStartChecks();
+ if ($domainChecks->isInvalid()) {
+ return $domainChecks;
+ }
+
+ if ($this->lexer->current->isA(EmailLexer::S_AT)) {
+ return new InvalidEmail(new ConsecutiveAt(), $this->lexer->current->value);
+ }
+
+ $result = $this->doParseDomainPart();
+ if ($result->isInvalid()) {
+ return $result;
+ }
+
+ $end = $this->checkEndOfDomain();
+ if ($end->isInvalid()) {
+ return $end;
+ }
+
+ $this->lexer->stopRecording();
+ $this->domainPart = $this->lexer->getAccumulatedValues();
+
+ $length = strlen($this->domainPart);
+ if ($length > self::DOMAIN_MAX_LENGTH) {
+ return new InvalidEmail(new DomainTooLong(), $this->lexer->current->value);
+ }
+
+ return new ValidEmail();
+ }
+
+ private function checkEndOfDomain(): Result
+ {
+ $prev = $this->lexer->getPrevious();
+ if ($prev->isA(EmailLexer::S_DOT)) {
+ return new InvalidEmail(new DotAtEnd(), $this->lexer->current->value);
+ }
+ if ($prev->isA(EmailLexer::S_HYPHEN)) {
+ return new InvalidEmail(new DomainHyphened('Hypen found at the end of the domain'), $prev->value);
+ }
+
+ if ($this->lexer->current->isA(EmailLexer::S_SP)) {
+ return new InvalidEmail(new CRLFAtTheEnd(), $prev->value);
+ }
+ return new ValidEmail();
+ }
+
+ private function performDomainStartChecks(): Result
+ {
+ $invalidTokens = $this->checkInvalidTokensAfterAT();
+ if ($invalidTokens->isInvalid()) {
+ return $invalidTokens;
+ }
+
+ $missingDomain = $this->checkEmptyDomain();
+ if ($missingDomain->isInvalid()) {
+ return $missingDomain;
+ }
+
+ if ($this->lexer->current->isA(EmailLexer::S_OPENPARENTHESIS)) {
+ $this->warnings[DeprecatedComment::CODE] = new DeprecatedComment();
+ }
+ return new ValidEmail();
+ }
+
+ private function checkEmptyDomain(): Result
+ {
+ $thereIsNoDomain = $this->lexer->current->isA(EmailLexer::S_EMPTY) ||
+ ($this->lexer->current->isA(EmailLexer::S_SP) &&
+ !$this->lexer->isNextToken(EmailLexer::GENERIC));
+
+ if ($thereIsNoDomain) {
+ return new InvalidEmail(new NoDomainPart(), $this->lexer->current->value);
+ }
+
+ return new ValidEmail();
+ }
+
+ private function checkInvalidTokensAfterAT(): Result
+ {
+ if ($this->lexer->current->isA(EmailLexer::S_DOT)) {
+ return new InvalidEmail(new DotAtStart(), $this->lexer->current->value);
+ }
+ if ($this->lexer->current->isA(EmailLexer::S_HYPHEN)) {
+ return new InvalidEmail(new DomainHyphened('After AT'), $this->lexer->current->value);
+ }
+ return new ValidEmail();
+ }
+
+ protected function parseComments(): Result
+ {
+ $commentParser = new Comment($this->lexer, new DomainComment());
+ $result = $commentParser->parse();
+ $this->warnings = [...$this->warnings, ...$commentParser->getWarnings()];
+
+ return $result;
+ }
+
+ protected function doParseDomainPart(): Result
+ {
+ $tldMissing = true;
+ $hasComments = false;
+ $domain = '';
+ do {
+ $prev = $this->lexer->getPrevious();
+
+ $notAllowedChars = $this->checkNotAllowedChars($this->lexer->current);
+ if ($notAllowedChars->isInvalid()) {
+ return $notAllowedChars;
+ }
+
+ if (
+ $this->lexer->current->isA(EmailLexer::S_OPENPARENTHESIS) ||
+ $this->lexer->current->isA(EmailLexer::S_CLOSEPARENTHESIS)
+ ) {
+ $hasComments = true;
+ $commentsResult = $this->parseComments();
+
+ //Invalid comment parsing
+ if ($commentsResult->isInvalid()) {
+ return $commentsResult;
+ }
+ }
+
+ $dotsResult = $this->checkConsecutiveDots();
+ if ($dotsResult->isInvalid()) {
+ return $dotsResult;
+ }
+
+ if ($this->lexer->current->isA(EmailLexer::S_OPENBRACKET)) {
+ $literalResult = $this->parseDomainLiteral();
+
+ $this->addTLDWarnings($tldMissing);
+ return $literalResult;
+ }
+
+ $labelCheck = $this->checkLabelLength();
+ if ($labelCheck->isInvalid()) {
+ return $labelCheck;
+ }
+
+ $FwsResult = $this->parseFWS();
+ if ($FwsResult->isInvalid()) {
+ return $FwsResult;
+ }
+
+ $domain .= $this->lexer->current->value;
+
+ if ($this->lexer->current->isA(EmailLexer::S_DOT) && $this->lexer->isNextToken(EmailLexer::GENERIC)) {
+ $tldMissing = false;
+ }
+
+ $exceptionsResult = $this->checkDomainPartExceptions($prev, $hasComments);
+ if ($exceptionsResult->isInvalid()) {
+ return $exceptionsResult;
+ }
+ $this->lexer->moveNext();
+ } while (!$this->lexer->current->isA(EmailLexer::S_EMPTY));
+
+ $labelCheck = $this->checkLabelLength(true);
+ if ($labelCheck->isInvalid()) {
+ return $labelCheck;
+ }
+ $this->addTLDWarnings($tldMissing);
+
+ $this->domainPart = $domain;
+ return new ValidEmail();
+ }
+
+ /**
+ * @param Token $token
+ *
+ * @return Result
+ */
+ private function checkNotAllowedChars(Token $token): Result
+ {
+ $notAllowed = [EmailLexer::S_BACKSLASH => true, EmailLexer::S_SLASH => true];
+ if (isset($notAllowed[$token->type])) {
+ return new InvalidEmail(new CharNotAllowed(), $token->value);
+ }
+ return new ValidEmail();
+ }
+
+ /**
+ * @return Result
+ */
+ protected function parseDomainLiteral(): Result
+ {
+ try {
+ $this->lexer->find(EmailLexer::S_CLOSEBRACKET);
+ } catch (\RuntimeException $e) {
+ return new InvalidEmail(new ExpectingDomainLiteralClose(), $this->lexer->current->value);
+ }
+
+ $domainLiteralParser = new DomainLiteralParser($this->lexer);
+ $result = $domainLiteralParser->parse();
+ $this->warnings = [...$this->warnings, ...$domainLiteralParser->getWarnings()];
+ return $result;
+ }
+
+ /**
+ * @param Token $prev
+ * @param bool $hasComments
+ *
+ * @return Result
+ */
+ protected function checkDomainPartExceptions(Token $prev, bool $hasComments): Result
+ {
+ if ($this->lexer->current->isA(EmailLexer::S_OPENBRACKET) && $prev->type !== EmailLexer::S_AT) {
+ return new InvalidEmail(new ExpectingATEXT('OPENBRACKET not after AT'), $this->lexer->current->value);
+ }
+
+ if ($this->lexer->current->isA(EmailLexer::S_HYPHEN) && $this->lexer->isNextToken(EmailLexer::S_DOT)) {
+ return new InvalidEmail(new DomainHyphened('Hypen found near DOT'), $this->lexer->current->value);
+ }
+
+ if (
+ $this->lexer->current->isA(EmailLexer::S_BACKSLASH)
+ && $this->lexer->isNextToken(EmailLexer::GENERIC)
+ ) {
+ return new InvalidEmail(new ExpectingATEXT('Escaping following "ATOM"'), $this->lexer->current->value);
+ }
+
+ return $this->validateTokens($hasComments);
+ }
+
+ protected function validateTokens(bool $hasComments): Result
+ {
+ $validDomainTokens = array(
+ EmailLexer::GENERIC => true,
+ EmailLexer::S_HYPHEN => true,
+ EmailLexer::S_DOT => true,
+ );
+
+ if ($hasComments) {
+ $validDomainTokens[EmailLexer::S_OPENPARENTHESIS] = true;
+ $validDomainTokens[EmailLexer::S_CLOSEPARENTHESIS] = true;
+ }
+
+ if (!isset($validDomainTokens[$this->lexer->current->type])) {
+ return new InvalidEmail(new ExpectingATEXT('Invalid token in domain: ' . $this->lexer->current->value), $this->lexer->current->value);
+ }
+
+ return new ValidEmail();
+ }
+
+ private function checkLabelLength(bool $isEndOfDomain = false): Result
+ {
+ if ($this->lexer->current->isA(EmailLexer::S_DOT) || $isEndOfDomain) {
+ if ($this->isLabelTooLong($this->label)) {
+ return new InvalidEmail(new LabelTooLong(), $this->lexer->current->value);
+ }
+ $this->label = '';
+ }
+ $this->label .= $this->lexer->current->value;
+ return new ValidEmail();
+ }
+
+
+ private function isLabelTooLong(string $label): bool
+ {
+ if (preg_match('/[^\x00-\x7F]/', $label)) {
+ idn_to_ascii($label, IDNA_DEFAULT, INTL_IDNA_VARIANT_UTS46, $idnaInfo);
+ return (bool) ($idnaInfo['errors'] & IDNA_ERROR_LABEL_TOO_LONG);
+ }
+ return strlen($label) > self::LABEL_MAX_LENGTH;
+ }
+
+ private function addTLDWarnings(bool $isTLDMissing): void
+ {
+ if ($isTLDMissing) {
+ $this->warnings[TLD::CODE] = new TLD();
+ }
+ }
+
+ public function domainPart(): string
+ {
+ return $this->domainPart;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Parser/DoubleQuote.php b/tools/mailer/egulias/email-validator/src/Parser/DoubleQuote.php
new file mode 100644
index 000000000..b5335d300
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Parser/DoubleQuote.php
@@ -0,0 +1,91 @@
+checkDQUOTE();
+ if ($validQuotedString->isInvalid()) {
+ return $validQuotedString;
+ }
+
+ $special = [
+ EmailLexer::S_CR => true,
+ EmailLexer::S_HTAB => true,
+ EmailLexer::S_LF => true
+ ];
+
+ $invalid = [
+ EmailLexer::C_NUL => true,
+ EmailLexer::S_HTAB => true,
+ EmailLexer::S_CR => true,
+ EmailLexer::S_LF => true
+ ];
+
+ $setSpecialsWarning = true;
+
+ $this->lexer->moveNext();
+
+ while (!$this->lexer->current->isA(EmailLexer::S_DQUOTE) && !$this->lexer->current->isA(EmailLexer::S_EMPTY)) {
+ if (isset($special[$this->lexer->current->type]) && $setSpecialsWarning) {
+ $this->warnings[CFWSWithFWS::CODE] = new CFWSWithFWS();
+ $setSpecialsWarning = false;
+ }
+ if ($this->lexer->current->isA(EmailLexer::S_BACKSLASH) && $this->lexer->isNextToken(EmailLexer::S_DQUOTE)) {
+ $this->lexer->moveNext();
+ }
+
+ $this->lexer->moveNext();
+
+ if (!$this->escaped() && isset($invalid[$this->lexer->current->type])) {
+ return new InvalidEmail(new ExpectingATEXT("Expecting ATEXT between DQUOTE"), $this->lexer->current->value);
+ }
+ }
+
+ $prev = $this->lexer->getPrevious();
+
+ if ($prev->isA(EmailLexer::S_BACKSLASH)) {
+ $validQuotedString = $this->checkDQUOTE();
+ if ($validQuotedString->isInvalid()) {
+ return $validQuotedString;
+ }
+ }
+
+ if (!$this->lexer->isNextToken(EmailLexer::S_AT) && !$prev->isA(EmailLexer::S_BACKSLASH)) {
+ return new InvalidEmail(new ExpectingATEXT("Expecting ATEXT between DQUOTE"), $this->lexer->current->value);
+ }
+
+ return new ValidEmail();
+ }
+
+ protected function checkDQUOTE(): Result
+ {
+ $previous = $this->lexer->getPrevious();
+
+ if ($this->lexer->isNextToken(EmailLexer::GENERIC) && $previous->isA(EmailLexer::GENERIC)) {
+ $description = 'https://tools.ietf.org/html/rfc5322#section-3.2.4 - quoted string should be a unit';
+ return new InvalidEmail(new ExpectingATEXT($description), $this->lexer->current->value);
+ }
+
+ try {
+ $this->lexer->find(EmailLexer::S_DQUOTE);
+ } catch (\Exception $e) {
+ return new InvalidEmail(new UnclosedQuotedString(), $this->lexer->current->value);
+ }
+ $this->warnings[QuotedString::CODE] = new QuotedString($previous->value, $this->lexer->current->value);
+
+ return new ValidEmail();
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Parser/FoldingWhiteSpace.php b/tools/mailer/egulias/email-validator/src/Parser/FoldingWhiteSpace.php
new file mode 100644
index 000000000..348a7af44
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Parser/FoldingWhiteSpace.php
@@ -0,0 +1,87 @@
+isFWS()) {
+ return new ValidEmail();
+ }
+
+ $previous = $this->lexer->getPrevious();
+
+ $resultCRLF = $this->checkCRLFInFWS();
+ if ($resultCRLF->isInvalid()) {
+ return $resultCRLF;
+ }
+
+ if ($this->lexer->current->isA(EmailLexer::S_CR)) {
+ return new InvalidEmail(new CRNoLF(), $this->lexer->current->value);
+ }
+
+ if ($this->lexer->isNextToken(EmailLexer::GENERIC) && !$previous->isA(EmailLexer::S_AT)) {
+ return new InvalidEmail(new AtextAfterCFWS(), $this->lexer->current->value);
+ }
+
+ if ($this->lexer->current->isA(EmailLexer::S_LF) || $this->lexer->current->isA(EmailLexer::C_NUL)) {
+ return new InvalidEmail(new ExpectingCTEXT(), $this->lexer->current->value);
+ }
+
+ if ($this->lexer->isNextToken(EmailLexer::S_AT) || $previous->isA(EmailLexer::S_AT)) {
+ $this->warnings[CFWSNearAt::CODE] = new CFWSNearAt();
+ } else {
+ $this->warnings[CFWSWithFWS::CODE] = new CFWSWithFWS();
+ }
+
+ return new ValidEmail();
+ }
+
+ protected function checkCRLFInFWS(): Result
+ {
+ if (!$this->lexer->current->isA(EmailLexer::CRLF)) {
+ return new ValidEmail();
+ }
+
+ if (!$this->lexer->isNextTokenAny(array(EmailLexer::S_SP, EmailLexer::S_HTAB))) {
+ return new InvalidEmail(new CRLFX2(), $this->lexer->current->value);
+ }
+
+ //this has no coverage. Condition is repeated from above one
+ if (!$this->lexer->isNextTokenAny(array(EmailLexer::S_SP, EmailLexer::S_HTAB))) {
+ return new InvalidEmail(new CRLFAtTheEnd(), $this->lexer->current->value);
+ }
+
+ return new ValidEmail();
+ }
+
+ protected function isFWS(): bool
+ {
+ if ($this->escaped()) {
+ return false;
+ }
+
+ return in_array($this->lexer->current->type, self::FWS_TYPES);
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Parser/IDLeftPart.php b/tools/mailer/egulias/email-validator/src/Parser/IDLeftPart.php
new file mode 100644
index 000000000..bedcf7b20
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Parser/IDLeftPart.php
@@ -0,0 +1,15 @@
+lexer->current->value);
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Parser/IDRightPart.php b/tools/mailer/egulias/email-validator/src/Parser/IDRightPart.php
new file mode 100644
index 000000000..d2fc1d748
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Parser/IDRightPart.php
@@ -0,0 +1,29 @@
+ true,
+ EmailLexer::S_SQUOTE => true,
+ EmailLexer::S_BACKTICK => true,
+ EmailLexer::S_SEMICOLON => true,
+ EmailLexer::S_GREATERTHAN => true,
+ EmailLexer::S_LOWERTHAN => true,
+ ];
+
+ if (isset($invalidDomainTokens[$this->lexer->current->type])) {
+ return new InvalidEmail(new ExpectingATEXT('Invalid token in domain: ' . $this->lexer->current->value), $this->lexer->current->value);
+ }
+ return new ValidEmail();
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Parser/LocalPart.php b/tools/mailer/egulias/email-validator/src/Parser/LocalPart.php
new file mode 100644
index 000000000..5ed29d606
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Parser/LocalPart.php
@@ -0,0 +1,162 @@
+ EmailLexer::S_COMMA,
+ EmailLexer::S_CLOSEBRACKET => EmailLexer::S_CLOSEBRACKET,
+ EmailLexer::S_OPENBRACKET => EmailLexer::S_OPENBRACKET,
+ EmailLexer::S_GREATERTHAN => EmailLexer::S_GREATERTHAN,
+ EmailLexer::S_LOWERTHAN => EmailLexer::S_LOWERTHAN,
+ EmailLexer::S_COLON => EmailLexer::S_COLON,
+ EmailLexer::S_SEMICOLON => EmailLexer::S_SEMICOLON,
+ EmailLexer::INVALID => EmailLexer::INVALID
+ ];
+
+ /**
+ * @var string
+ */
+ private $localPart = '';
+
+
+ public function parse(): Result
+ {
+ $this->lexer->startRecording();
+
+ while (!$this->lexer->current->isA(EmailLexer::S_AT) && !$this->lexer->current->isA(EmailLexer::S_EMPTY)) {
+ if ($this->hasDotAtStart()) {
+ return new InvalidEmail(new DotAtStart(), $this->lexer->current->value);
+ }
+
+ if ($this->lexer->current->isA(EmailLexer::S_DQUOTE)) {
+ $dquoteParsingResult = $this->parseDoubleQuote();
+
+ //Invalid double quote parsing
+ if ($dquoteParsingResult->isInvalid()) {
+ return $dquoteParsingResult;
+ }
+ }
+
+ if (
+ $this->lexer->current->isA(EmailLexer::S_OPENPARENTHESIS) ||
+ $this->lexer->current->isA(EmailLexer::S_CLOSEPARENTHESIS)
+ ) {
+ $commentsResult = $this->parseComments();
+
+ //Invalid comment parsing
+ if ($commentsResult->isInvalid()) {
+ return $commentsResult;
+ }
+ }
+
+ if ($this->lexer->current->isA(EmailLexer::S_DOT) && $this->lexer->isNextToken(EmailLexer::S_DOT)) {
+ return new InvalidEmail(new ConsecutiveDot(), $this->lexer->current->value);
+ }
+
+ if (
+ $this->lexer->current->isA(EmailLexer::S_DOT) &&
+ $this->lexer->isNextToken(EmailLexer::S_AT)
+ ) {
+ return new InvalidEmail(new DotAtEnd(), $this->lexer->current->value);
+ }
+
+ $resultEscaping = $this->validateEscaping();
+ if ($resultEscaping->isInvalid()) {
+ return $resultEscaping;
+ }
+
+ $resultToken = $this->validateTokens(false);
+ if ($resultToken->isInvalid()) {
+ return $resultToken;
+ }
+
+ $resultFWS = $this->parseLocalFWS();
+ if ($resultFWS->isInvalid()) {
+ return $resultFWS;
+ }
+
+ $this->lexer->moveNext();
+ }
+
+ $this->lexer->stopRecording();
+ $this->localPart = rtrim($this->lexer->getAccumulatedValues(), '@');
+ if (strlen($this->localPart) > LocalTooLong::LOCAL_PART_LENGTH) {
+ $this->warnings[LocalTooLong::CODE] = new LocalTooLong();
+ }
+
+ return new ValidEmail();
+ }
+
+ protected function validateTokens(bool $hasComments): Result
+ {
+ if (isset(self::INVALID_TOKENS[$this->lexer->current->type])) {
+ return new InvalidEmail(new ExpectingATEXT('Invalid token found'), $this->lexer->current->value);
+ }
+ return new ValidEmail();
+ }
+
+ public function localPart(): string
+ {
+ return $this->localPart;
+ }
+
+ private function parseLocalFWS(): Result
+ {
+ $foldingWS = new FoldingWhiteSpace($this->lexer);
+ $resultFWS = $foldingWS->parse();
+ if ($resultFWS->isValid()) {
+ $this->warnings = [...$this->warnings, ...$foldingWS->getWarnings()];
+ }
+ return $resultFWS;
+ }
+
+ private function hasDotAtStart(): bool
+ {
+ return $this->lexer->current->isA(EmailLexer::S_DOT) && $this->lexer->getPrevious()->isA(EmailLexer::S_EMPTY);
+ }
+
+ private function parseDoubleQuote(): Result
+ {
+ $dquoteParser = new DoubleQuote($this->lexer);
+ $parseAgain = $dquoteParser->parse();
+ $this->warnings = [...$this->warnings, ...$dquoteParser->getWarnings()];
+
+ return $parseAgain;
+ }
+
+ protected function parseComments(): Result
+ {
+ $commentParser = new Comment($this->lexer, new LocalComment());
+ $result = $commentParser->parse();
+ $this->warnings = [...$this->warnings, ...$commentParser->getWarnings()];
+
+ return $result;
+ }
+
+ private function validateEscaping(): Result
+ {
+ //Backslash found
+ if (!$this->lexer->current->isA(EmailLexer::S_BACKSLASH)) {
+ return new ValidEmail();
+ }
+
+ if ($this->lexer->isNextToken(EmailLexer::GENERIC)) {
+ return new InvalidEmail(new ExpectingATEXT('Found ATOM after escaping'), $this->lexer->current->value);
+ }
+
+ return new ValidEmail();
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Parser/PartParser.php b/tools/mailer/egulias/email-validator/src/Parser/PartParser.php
new file mode 100644
index 000000000..53afb2575
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Parser/PartParser.php
@@ -0,0 +1,63 @@
+lexer = $lexer;
+ }
+
+ abstract public function parse(): Result;
+
+ /**
+ * @return Warning[]
+ */
+ public function getWarnings()
+ {
+ return $this->warnings;
+ }
+
+ protected function parseFWS(): Result
+ {
+ $foldingWS = new FoldingWhiteSpace($this->lexer);
+ $resultFWS = $foldingWS->parse();
+ $this->warnings = [...$this->warnings, ...$foldingWS->getWarnings()];
+ return $resultFWS;
+ }
+
+ protected function checkConsecutiveDots(): Result
+ {
+ if ($this->lexer->current->isA(EmailLexer::S_DOT) && $this->lexer->isNextToken(EmailLexer::S_DOT)) {
+ return new InvalidEmail(new ConsecutiveDot(), $this->lexer->current->value);
+ }
+
+ return new ValidEmail();
+ }
+
+ protected function escaped(): bool
+ {
+ $previous = $this->lexer->getPrevious();
+
+ return $previous->isA(EmailLexer::S_BACKSLASH)
+ && !$this->lexer->current->isA(EmailLexer::GENERIC);
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Result/InvalidEmail.php b/tools/mailer/egulias/email-validator/src/Result/InvalidEmail.php
new file mode 100644
index 000000000..82699acc6
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Result/InvalidEmail.php
@@ -0,0 +1,49 @@
+token = $token;
+ $this->reason = $reason;
+ }
+
+ public function isValid(): bool
+ {
+ return false;
+ }
+
+ public function isInvalid(): bool
+ {
+ return true;
+ }
+
+ public function description(): string
+ {
+ return $this->reason->description() . " in char " . $this->token;
+ }
+
+ public function code(): int
+ {
+ return $this->reason->code();
+ }
+
+ public function reason(): Reason
+ {
+ return $this->reason;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Result/MultipleErrors.php b/tools/mailer/egulias/email-validator/src/Result/MultipleErrors.php
new file mode 100644
index 000000000..5fa85afc9
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Result/MultipleErrors.php
@@ -0,0 +1,56 @@
+reasons[$reason->code()] = $reason;
+ }
+
+ /**
+ * @return Reason[]
+ */
+ public function getReasons() : array
+ {
+ return $this->reasons;
+ }
+
+ public function reason() : Reason
+ {
+ return 0 !== count($this->reasons)
+ ? current($this->reasons)
+ : new EmptyReason();
+ }
+
+ public function description() : string
+ {
+ $description = '';
+ foreach($this->reasons as $reason) {
+ $description .= $reason->description() . PHP_EOL;
+ }
+
+ return $description;
+ }
+
+ public function code() : int
+ {
+ return 0;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Result/Reason/AtextAfterCFWS.php b/tools/mailer/egulias/email-validator/src/Result/Reason/AtextAfterCFWS.php
new file mode 100644
index 000000000..96e22842f
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Result/Reason/AtextAfterCFWS.php
@@ -0,0 +1,16 @@
+detailedDescription = $details;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Result/Reason/DomainAcceptsNoMail.php b/tools/mailer/egulias/email-validator/src/Result/Reason/DomainAcceptsNoMail.php
new file mode 100644
index 000000000..bcaefb68a
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Result/Reason/DomainAcceptsNoMail.php
@@ -0,0 +1,16 @@
+exception = $exception;
+
+ }
+ public function code() : int
+ {
+ return 999;
+ }
+
+ public function description() : string
+ {
+ return $this->exception->getMessage();
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Result/Reason/ExpectingATEXT.php b/tools/mailer/egulias/email-validator/src/Result/Reason/ExpectingATEXT.php
new file mode 100644
index 000000000..07ea8d238
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Result/Reason/ExpectingATEXT.php
@@ -0,0 +1,16 @@
+detailedDescription;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Result/Reason/ExpectingCTEXT.php b/tools/mailer/egulias/email-validator/src/Result/Reason/ExpectingCTEXT.php
new file mode 100644
index 000000000..64f5f7c3e
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Result/Reason/ExpectingCTEXT.php
@@ -0,0 +1,16 @@
+element = $element;
+ }
+
+ public function code() : int
+ {
+ return 201;
+ }
+
+ public function description() : string
+ {
+ return 'Unusual element found, wourld render invalid in majority of cases. Element found: ' . $this->element;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Result/Result.php b/tools/mailer/egulias/email-validator/src/Result/Result.php
new file mode 100644
index 000000000..fd13e6c68
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Result/Result.php
@@ -0,0 +1,27 @@
+reason = new ReasonSpoofEmail();
+ parent::__construct($this->reason, '');
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Result/ValidEmail.php b/tools/mailer/egulias/email-validator/src/Result/ValidEmail.php
new file mode 100644
index 000000000..fdc882fac
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Result/ValidEmail.php
@@ -0,0 +1,27 @@
+dnsGetRecord = $dnsGetRecord;
+ }
+
+ public function isValid(string $email, EmailLexer $emailLexer): bool
+ {
+ // use the input to check DNS if we cannot extract something similar to a domain
+ $host = $email;
+
+ // Arguable pattern to extract the domain. Not aiming to validate the domain nor the email
+ if (false !== $lastAtPos = strrpos($email, '@')) {
+ $host = substr($email, $lastAtPos + 1);
+ }
+
+ // Get the domain parts
+ $hostParts = explode('.', $host);
+
+ $isLocalDomain = count($hostParts) <= 1;
+ $isReservedTopLevel = in_array($hostParts[(count($hostParts) - 1)], self::RESERVED_DNS_TOP_LEVEL_NAMES, true);
+
+ // Exclude reserved top level DNS names
+ if ($isLocalDomain || $isReservedTopLevel) {
+ $this->error = new InvalidEmail(new LocalOrReservedDomain(), $host);
+ return false;
+ }
+
+ return $this->checkDns($host);
+ }
+
+ public function getError(): ?InvalidEmail
+ {
+ return $this->error;
+ }
+
+ /**
+ * @return Warning[]
+ */
+ public function getWarnings(): array
+ {
+ return $this->warnings;
+ }
+
+ /**
+ * @param string $host
+ *
+ * @return bool
+ */
+ protected function checkDns($host)
+ {
+ $variant = INTL_IDNA_VARIANT_UTS46;
+
+ $host = rtrim(idn_to_ascii($host, IDNA_DEFAULT, $variant), '.');
+
+ $hostParts = explode('.', $host);
+ $host = array_pop($hostParts);
+
+ while (count($hostParts) > 0) {
+ $host = array_pop($hostParts) . '.' . $host;
+
+ if ($this->validateDnsRecords($host)) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+
+ /**
+ * Validate the DNS records for given host.
+ *
+ * @param string $host A set of DNS records in the format returned by dns_get_record.
+ *
+ * @return bool True on success.
+ */
+ private function validateDnsRecords($host): bool
+ {
+ $dnsRecordsResult = $this->dnsGetRecord->getRecords($host, DNS_A + DNS_MX);
+
+ if ($dnsRecordsResult->withError()) {
+ $this->error = new InvalidEmail(new UnableToGetDNSRecord(), '');
+ return false;
+ }
+
+ $dnsRecords = $dnsRecordsResult->getRecords();
+
+ // Combined check for A+MX+AAAA can fail with SERVFAIL, even in the presence of valid A/MX records
+ $aaaaRecordsResult = $this->dnsGetRecord->getRecords($host, DNS_AAAA);
+
+ if (! $aaaaRecordsResult->withError()) {
+ $dnsRecords = array_merge($dnsRecords, $aaaaRecordsResult->getRecords());
+ }
+
+ // No MX, A or AAAA DNS records
+ if ($dnsRecords === []) {
+ $this->error = new InvalidEmail(new ReasonNoDNSRecord(), '');
+ return false;
+ }
+
+ // For each DNS record
+ foreach ($dnsRecords as $dnsRecord) {
+ if (!$this->validateMXRecord($dnsRecord)) {
+ // No MX records (fallback to A or AAAA records)
+ if (empty($this->mxRecords)) {
+ $this->warnings[NoDNSMXRecord::CODE] = new NoDNSMXRecord();
+ }
+ return false;
+ }
+ }
+ return true;
+ }
+
+ /**
+ * Validate an MX record
+ *
+ * @param array $dnsRecord Given DNS record.
+ *
+ * @return bool True if valid.
+ */
+ private function validateMxRecord($dnsRecord): bool
+ {
+ if (!isset($dnsRecord['type'])) {
+ $this->error = new InvalidEmail(new ReasonNoDNSRecord(), '');
+ return false;
+ }
+
+ if ($dnsRecord['type'] !== 'MX') {
+ return true;
+ }
+
+ // "Null MX" record indicates the domain accepts no mail (https://tools.ietf.org/html/rfc7505)
+ if (empty($dnsRecord['target']) || $dnsRecord['target'] === '.') {
+ $this->error = new InvalidEmail(new DomainAcceptsNoMail(), "");
+ return false;
+ }
+
+ $this->mxRecords[] = $dnsRecord;
+
+ return true;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Validation/DNSGetRecordWrapper.php b/tools/mailer/egulias/email-validator/src/Validation/DNSGetRecordWrapper.php
new file mode 100644
index 000000000..25e2fa06c
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Validation/DNSGetRecordWrapper.php
@@ -0,0 +1,31 @@
+records;
+ }
+
+ public function withError(): bool
+ {
+ return $this->error;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Validation/EmailValidation.php b/tools/mailer/egulias/email-validator/src/Validation/EmailValidation.php
new file mode 100644
index 000000000..1bcc0a70b
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Validation/EmailValidation.php
@@ -0,0 +1,34 @@
+setChecks(Spoofchecker::SINGLE_SCRIPT);
+
+ if ($checker->isSuspicious($email)) {
+ $this->error = new SpoofEmail();
+ }
+
+ return $this->error === null;
+ }
+
+ public function getError() : ?InvalidEmail
+ {
+ return $this->error;
+ }
+
+ public function getWarnings() : array
+ {
+ return [];
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Validation/MessageIDValidation.php b/tools/mailer/egulias/email-validator/src/Validation/MessageIDValidation.php
new file mode 100644
index 000000000..97d1ea7a7
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Validation/MessageIDValidation.php
@@ -0,0 +1,55 @@
+parse($email);
+ $this->warnings = $parser->getWarnings();
+ if ($result->isInvalid()) {
+ /** @psalm-suppress PropertyTypeCoercion */
+ $this->error = $result;
+ return false;
+ }
+ } catch (\Exception $invalid) {
+ $this->error = new InvalidEmail(new ExceptionFound($invalid), '');
+ return false;
+ }
+
+ return true;
+ }
+
+ /**
+ * @return Warning[]
+ */
+ public function getWarnings(): array
+ {
+ return $this->warnings;
+ }
+
+ public function getError(): ?InvalidEmail
+ {
+ return $this->error;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Validation/MultipleValidationWithAnd.php b/tools/mailer/egulias/email-validator/src/Validation/MultipleValidationWithAnd.php
new file mode 100644
index 000000000..c908053f3
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Validation/MultipleValidationWithAnd.php
@@ -0,0 +1,105 @@
+validations as $validation) {
+ $emailLexer->reset();
+ $validationResult = $validation->isValid($email, $emailLexer);
+ $result = $result && $validationResult;
+ $this->warnings = [...$this->warnings, ...$validation->getWarnings()];
+ if (!$validationResult) {
+ $this->processError($validation);
+ }
+
+ if ($this->shouldStop($result)) {
+ break;
+ }
+ }
+
+ return $result;
+ }
+
+ private function initErrorStorage(): void
+ {
+ if (null === $this->error) {
+ $this->error = new MultipleErrors();
+ }
+ }
+
+ private function processError(EmailValidation $validation): void
+ {
+ if (null !== $validation->getError()) {
+ $this->initErrorStorage();
+ /** @psalm-suppress PossiblyNullReference */
+ $this->error->addReason($validation->getError()->reason());
+ }
+ }
+
+ private function shouldStop(bool $result): bool
+ {
+ return !$result && $this->mode === self::STOP_ON_ERROR;
+ }
+
+ /**
+ * Returns the validation errors.
+ */
+ public function getError(): ?InvalidEmail
+ {
+ return $this->error;
+ }
+
+ /**
+ * @return Warning[]
+ */
+ public function getWarnings(): array
+ {
+ return $this->warnings;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Validation/NoRFCWarningsValidation.php b/tools/mailer/egulias/email-validator/src/Validation/NoRFCWarningsValidation.php
new file mode 100644
index 000000000..06885ed71
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Validation/NoRFCWarningsValidation.php
@@ -0,0 +1,41 @@
+getWarnings())) {
+ return true;
+ }
+
+ $this->error = new InvalidEmail(new RFCWarnings(), '');
+
+ return false;
+ }
+
+ /**
+ * {@inheritdoc}
+ */
+ public function getError() : ?InvalidEmail
+ {
+ return $this->error ?: parent::getError();
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Validation/RFCValidation.php b/tools/mailer/egulias/email-validator/src/Validation/RFCValidation.php
new file mode 100644
index 000000000..f59cbfc80
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Validation/RFCValidation.php
@@ -0,0 +1,54 @@
+parse($email);
+ $this->warnings = $parser->getWarnings();
+ if ($result->isInvalid()) {
+ /** @psalm-suppress PropertyTypeCoercion */
+ $this->error = $result;
+ return false;
+ }
+ } catch (\Exception $invalid) {
+ $this->error = new InvalidEmail(new ExceptionFound($invalid), '');
+ return false;
+ }
+
+ return true;
+ }
+
+ public function getError(): ?InvalidEmail
+ {
+ return $this->error;
+ }
+
+ /**
+ * @return Warning[]
+ */
+ public function getWarnings(): array
+ {
+ return $this->warnings;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/AddressLiteral.php b/tools/mailer/egulias/email-validator/src/Warning/AddressLiteral.php
new file mode 100644
index 000000000..474ff0e75
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/AddressLiteral.php
@@ -0,0 +1,14 @@
+message = 'Address literal in domain part';
+ $this->rfcNumber = 5321;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/CFWSNearAt.php b/tools/mailer/egulias/email-validator/src/Warning/CFWSNearAt.php
new file mode 100644
index 000000000..8bac12b1e
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/CFWSNearAt.php
@@ -0,0 +1,13 @@
+message = "Deprecated folding white space near @";
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/CFWSWithFWS.php b/tools/mailer/egulias/email-validator/src/Warning/CFWSWithFWS.php
new file mode 100644
index 000000000..ba57601c8
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/CFWSWithFWS.php
@@ -0,0 +1,13 @@
+message = 'Folding whites space followed by folding white space';
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/Comment.php b/tools/mailer/egulias/email-validator/src/Warning/Comment.php
new file mode 100644
index 000000000..6508295e3
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/Comment.php
@@ -0,0 +1,13 @@
+message = "Comments found in this email";
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/DeprecatedComment.php b/tools/mailer/egulias/email-validator/src/Warning/DeprecatedComment.php
new file mode 100644
index 000000000..a2578076e
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/DeprecatedComment.php
@@ -0,0 +1,13 @@
+message = 'Deprecated comments';
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/DomainLiteral.php b/tools/mailer/egulias/email-validator/src/Warning/DomainLiteral.php
new file mode 100644
index 000000000..034388c47
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/DomainLiteral.php
@@ -0,0 +1,14 @@
+message = 'Domain Literal';
+ $this->rfcNumber = 5322;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/EmailTooLong.php b/tools/mailer/egulias/email-validator/src/Warning/EmailTooLong.php
new file mode 100644
index 000000000..d25ad1234
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/EmailTooLong.php
@@ -0,0 +1,15 @@
+message = 'Email is too long, exceeds ' . EmailParser::EMAIL_MAX_LENGTH;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/IPV6BadChar.php b/tools/mailer/egulias/email-validator/src/Warning/IPV6BadChar.php
new file mode 100644
index 000000000..3ecd5bcca
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/IPV6BadChar.php
@@ -0,0 +1,14 @@
+message = 'Bad char in IPV6 domain literal';
+ $this->rfcNumber = 5322;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/IPV6ColonEnd.php b/tools/mailer/egulias/email-validator/src/Warning/IPV6ColonEnd.php
new file mode 100644
index 000000000..3f0c2f2df
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/IPV6ColonEnd.php
@@ -0,0 +1,14 @@
+message = ':: found at the end of the domain literal';
+ $this->rfcNumber = 5322;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/IPV6ColonStart.php b/tools/mailer/egulias/email-validator/src/Warning/IPV6ColonStart.php
new file mode 100644
index 000000000..742fb3bd1
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/IPV6ColonStart.php
@@ -0,0 +1,14 @@
+message = ':: found at the start of the domain literal';
+ $this->rfcNumber = 5322;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/IPV6Deprecated.php b/tools/mailer/egulias/email-validator/src/Warning/IPV6Deprecated.php
new file mode 100644
index 000000000..59c3037a5
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/IPV6Deprecated.php
@@ -0,0 +1,14 @@
+message = 'Deprecated form of IPV6';
+ $this->rfcNumber = 5321;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/IPV6DoubleColon.php b/tools/mailer/egulias/email-validator/src/Warning/IPV6DoubleColon.php
new file mode 100644
index 000000000..d40660264
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/IPV6DoubleColon.php
@@ -0,0 +1,14 @@
+message = 'Double colon found after IPV6 tag';
+ $this->rfcNumber = 5322;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/IPV6GroupCount.php b/tools/mailer/egulias/email-validator/src/Warning/IPV6GroupCount.php
new file mode 100644
index 000000000..551bc3af1
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/IPV6GroupCount.php
@@ -0,0 +1,14 @@
+message = 'Group count is not IPV6 valid';
+ $this->rfcNumber = 5322;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/IPV6MaxGroups.php b/tools/mailer/egulias/email-validator/src/Warning/IPV6MaxGroups.php
new file mode 100644
index 000000000..7f8a410a8
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/IPV6MaxGroups.php
@@ -0,0 +1,14 @@
+message = 'Reached the maximum number of IPV6 groups allowed';
+ $this->rfcNumber = 5321;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/LocalTooLong.php b/tools/mailer/egulias/email-validator/src/Warning/LocalTooLong.php
new file mode 100644
index 000000000..b46b874c0
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/LocalTooLong.php
@@ -0,0 +1,15 @@
+message = 'Local part is too long, exceeds 64 chars (octets)';
+ $this->rfcNumber = 5322;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/NoDNSMXRecord.php b/tools/mailer/egulias/email-validator/src/Warning/NoDNSMXRecord.php
new file mode 100644
index 000000000..bddb96be7
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/NoDNSMXRecord.php
@@ -0,0 +1,14 @@
+message = 'No MX DSN record was found for this email';
+ $this->rfcNumber = 5321;
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/ObsoleteDTEXT.php b/tools/mailer/egulias/email-validator/src/Warning/ObsoleteDTEXT.php
new file mode 100644
index 000000000..412fd499e
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/ObsoleteDTEXT.php
@@ -0,0 +1,14 @@
+rfcNumber = 5322;
+ $this->message = 'Obsolete DTEXT in domain literal';
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/QuotedPart.php b/tools/mailer/egulias/email-validator/src/Warning/QuotedPart.php
new file mode 100644
index 000000000..c3e017d94
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/QuotedPart.php
@@ -0,0 +1,17 @@
+message = "Deprecated Quoted String found between $prevToken and $postToken";
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/QuotedString.php b/tools/mailer/egulias/email-validator/src/Warning/QuotedString.php
new file mode 100644
index 000000000..c152ec2e2
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/QuotedString.php
@@ -0,0 +1,17 @@
+message = "Quoted String found between $prevToken and $postToken";
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/TLD.php b/tools/mailer/egulias/email-validator/src/Warning/TLD.php
new file mode 100644
index 000000000..10cec2816
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/TLD.php
@@ -0,0 +1,13 @@
+message = "RFC5321, TLD";
+ }
+}
diff --git a/tools/mailer/egulias/email-validator/src/Warning/Warning.php b/tools/mailer/egulias/email-validator/src/Warning/Warning.php
new file mode 100644
index 000000000..7adb3b85c
--- /dev/null
+++ b/tools/mailer/egulias/email-validator/src/Warning/Warning.php
@@ -0,0 +1,53 @@
+message;
+ }
+
+ /**
+ * @return int
+ */
+ public function code()
+ {
+ return self::CODE;
+ }
+
+ /**
+ * @return int
+ */
+ public function RFCNumber()
+ {
+ return $this->rfcNumber;
+ }
+
+ /**
+ * @return string
+ */
+ public function __toString(): string
+ {
+ return $this->message() . " rfc: " . $this->rfcNumber . "internal code: " . static::CODE;
+ }
+}
diff --git a/tools/mailer/psr/container/.gitignore b/tools/mailer/psr/container/.gitignore
new file mode 100644
index 000000000..b2395aa05
--- /dev/null
+++ b/tools/mailer/psr/container/.gitignore
@@ -0,0 +1,3 @@
+composer.lock
+composer.phar
+/vendor/
diff --git a/tools/mailer/psr/container/LICENSE b/tools/mailer/psr/container/LICENSE
new file mode 100644
index 000000000..2877a4894
--- /dev/null
+++ b/tools/mailer/psr/container/LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2013-2016 container-interop
+Copyright (c) 2016 PHP Framework Interoperability Group
+
+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.
diff --git a/tools/mailer/psr/container/README.md b/tools/mailer/psr/container/README.md
new file mode 100644
index 000000000..1b9d9e570
--- /dev/null
+++ b/tools/mailer/psr/container/README.md
@@ -0,0 +1,13 @@
+Container interface
+==============
+
+This repository holds all interfaces related to [PSR-11 (Container Interface)][psr-url].
+
+Note that this is not a Container implementation of its own. It is merely abstractions that describe the components of a Dependency Injection Container.
+
+The installable [package][package-url] and [implementations][implementation-url] are listed on Packagist.
+
+[psr-url]: https://www.php-fig.org/psr/psr-11/
+[package-url]: https://packagist.org/packages/psr/container
+[implementation-url]: https://packagist.org/providers/psr/container-implementation
+
diff --git a/tools/mailer/psr/container/composer.json b/tools/mailer/psr/container/composer.json
new file mode 100644
index 000000000..baf6cd1a0
--- /dev/null
+++ b/tools/mailer/psr/container/composer.json
@@ -0,0 +1,27 @@
+{
+ "name": "psr/container",
+ "type": "library",
+ "description": "Common Container Interface (PHP FIG PSR-11)",
+ "keywords": ["psr", "psr-11", "container", "container-interop", "container-interface"],
+ "homepage": "https://github.com/php-fig/container",
+ "license": "MIT",
+ "authors": [
+ {
+ "name": "PHP-FIG",
+ "homepage": "https://www.php-fig.org/"
+ }
+ ],
+ "require": {
+ "php": ">=7.4.0"
+ },
+ "autoload": {
+ "psr-4": {
+ "Psr\\Container\\": "src/"
+ }
+ },
+ "extra": {
+ "branch-alias": {
+ "dev-master": "2.0.x-dev"
+ }
+ }
+}
diff --git a/tools/mailer/psr/container/src/ContainerExceptionInterface.php b/tools/mailer/psr/container/src/ContainerExceptionInterface.php
new file mode 100644
index 000000000..0f213f2fe
--- /dev/null
+++ b/tools/mailer/psr/container/src/ContainerExceptionInterface.php
@@ -0,0 +1,12 @@
+=7.2.0"
+ },
+ "autoload": {
+ "psr-4": {
+ "Psr\\EventDispatcher\\": "src/"
+ }
+ },
+ "extra": {
+ "branch-alias": {
+ "dev-master": "1.0.x-dev"
+ }
+ }
+}
diff --git a/tools/mailer/psr/event-dispatcher/src/EventDispatcherInterface.php b/tools/mailer/psr/event-dispatcher/src/EventDispatcherInterface.php
new file mode 100644
index 000000000..4306fa915
--- /dev/null
+++ b/tools/mailer/psr/event-dispatcher/src/EventDispatcherInterface.php
@@ -0,0 +1,21 @@
+logger = $logger;
+ }
+
+ public function doSomething()
+ {
+ if ($this->logger) {
+ $this->logger->info('Doing work');
+ }
+
+ try {
+ $this->doSomethingElse();
+ } catch (Exception $exception) {
+ $this->logger->error('Oh no!', array('exception' => $exception));
+ }
+
+ // do something useful
+ }
+}
+```
+
+You can then pick one of the implementations of the interface to get a logger.
+
+If you want to implement the interface, you can require this package and
+implement `Psr\Log\LoggerInterface` in your code. Please read the
+[specification text](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-3-logger-interface.md)
+for details.
diff --git a/tools/mailer/psr/log/composer.json b/tools/mailer/psr/log/composer.json
new file mode 100644
index 000000000..879fc6f53
--- /dev/null
+++ b/tools/mailer/psr/log/composer.json
@@ -0,0 +1,26 @@
+{
+ "name": "psr/log",
+ "description": "Common interface for logging libraries",
+ "keywords": ["psr", "psr-3", "log"],
+ "homepage": "https://github.com/php-fig/log",
+ "license": "MIT",
+ "authors": [
+ {
+ "name": "PHP-FIG",
+ "homepage": "https://www.php-fig.org/"
+ }
+ ],
+ "require": {
+ "php": ">=8.0.0"
+ },
+ "autoload": {
+ "psr-4": {
+ "Psr\\Log\\": "src"
+ }
+ },
+ "extra": {
+ "branch-alias": {
+ "dev-master": "3.x-dev"
+ }
+ }
+}
diff --git a/tools/mailer/psr/log/src/AbstractLogger.php b/tools/mailer/psr/log/src/AbstractLogger.php
new file mode 100644
index 000000000..d60a091af
--- /dev/null
+++ b/tools/mailer/psr/log/src/AbstractLogger.php
@@ -0,0 +1,15 @@
+logger = $logger;
+ }
+}
diff --git a/tools/mailer/psr/log/src/LoggerInterface.php b/tools/mailer/psr/log/src/LoggerInterface.php
new file mode 100644
index 000000000..cb4cf648b
--- /dev/null
+++ b/tools/mailer/psr/log/src/LoggerInterface.php
@@ -0,0 +1,98 @@
+log(LogLevel::EMERGENCY, $message, $context);
+ }
+
+ /**
+ * Action must be taken immediately.
+ *
+ * Example: Entire website down, database unavailable, etc. This should
+ * trigger the SMS alerts and wake you up.
+ */
+ public function alert(string|\Stringable $message, array $context = []): void
+ {
+ $this->log(LogLevel::ALERT, $message, $context);
+ }
+
+ /**
+ * Critical conditions.
+ *
+ * Example: Application component unavailable, unexpected exception.
+ */
+ public function critical(string|\Stringable $message, array $context = []): void
+ {
+ $this->log(LogLevel::CRITICAL, $message, $context);
+ }
+
+ /**
+ * Runtime errors that do not require immediate action but should typically
+ * be logged and monitored.
+ */
+ public function error(string|\Stringable $message, array $context = []): void
+ {
+ $this->log(LogLevel::ERROR, $message, $context);
+ }
+
+ /**
+ * Exceptional occurrences that are not errors.
+ *
+ * Example: Use of deprecated APIs, poor use of an API, undesirable things
+ * that are not necessarily wrong.
+ */
+ public function warning(string|\Stringable $message, array $context = []): void
+ {
+ $this->log(LogLevel::WARNING, $message, $context);
+ }
+
+ /**
+ * Normal but significant events.
+ */
+ public function notice(string|\Stringable $message, array $context = []): void
+ {
+ $this->log(LogLevel::NOTICE, $message, $context);
+ }
+
+ /**
+ * Interesting events.
+ *
+ * Example: User logs in, SQL logs.
+ */
+ public function info(string|\Stringable $message, array $context = []): void
+ {
+ $this->log(LogLevel::INFO, $message, $context);
+ }
+
+ /**
+ * Detailed debug information.
+ */
+ public function debug(string|\Stringable $message, array $context = []): void
+ {
+ $this->log(LogLevel::DEBUG, $message, $context);
+ }
+
+ /**
+ * Logs with an arbitrary level.
+ *
+ * @param mixed $level
+ *
+ * @throws \Psr\Log\InvalidArgumentException
+ */
+ abstract public function log($level, string|\Stringable $message, array $context = []): void;
+}
diff --git a/tools/mailer/psr/log/src/NullLogger.php b/tools/mailer/psr/log/src/NullLogger.php
new file mode 100644
index 000000000..de0561e2a
--- /dev/null
+++ b/tools/mailer/psr/log/src/NullLogger.php
@@ -0,0 +1,26 @@
+logger) { }`
+ * blocks.
+ */
+class NullLogger extends AbstractLogger
+{
+ /**
+ * Logs with an arbitrary level.
+ *
+ * @param mixed[] $context
+ *
+ * @throws \Psr\Log\InvalidArgumentException
+ */
+ public function log($level, string|\Stringable $message, array $context = []): void
+ {
+ // noop
+ }
+}
diff --git a/tools/mailer/symfony/deprecation-contracts/CHANGELOG.md b/tools/mailer/symfony/deprecation-contracts/CHANGELOG.md
new file mode 100644
index 000000000..7932e2613
--- /dev/null
+++ b/tools/mailer/symfony/deprecation-contracts/CHANGELOG.md
@@ -0,0 +1,5 @@
+CHANGELOG
+=========
+
+The changelog is maintained for all Symfony contracts at the following URL:
+https://github.com/symfony/contracts/blob/main/CHANGELOG.md
diff --git a/tools/swift/LICENSE b/tools/mailer/symfony/deprecation-contracts/LICENSE
similarity index 95%
rename from tools/swift/LICENSE
rename to tools/mailer/symfony/deprecation-contracts/LICENSE
index 485f1d6d6..0ed3a2465 100644
--- a/tools/swift/LICENSE
+++ b/tools/mailer/symfony/deprecation-contracts/LICENSE
@@ -1,4 +1,4 @@
-Copyright (c) 2013-2016 Fabien Potencier
+Copyright (c) 2020-present Fabien Potencier
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
diff --git a/tools/mailer/symfony/deprecation-contracts/README.md b/tools/mailer/symfony/deprecation-contracts/README.md
new file mode 100644
index 000000000..9814864c0
--- /dev/null
+++ b/tools/mailer/symfony/deprecation-contracts/README.md
@@ -0,0 +1,26 @@
+Symfony Deprecation Contracts
+=============================
+
+A generic function and convention to trigger deprecation notices.
+
+This package provides a single global function named `trigger_deprecation()` that triggers silenced deprecation notices.
+
+By using a custom PHP error handler such as the one provided by the Symfony ErrorHandler component,
+the triggered deprecations can be caught and logged for later discovery, both on dev and prod environments.
+
+The function requires at least 3 arguments:
+ - the name of the Composer package that is triggering the deprecation
+ - the version of the package that introduced the deprecation
+ - the message of the deprecation
+ - more arguments can be provided: they will be inserted in the message using `printf()` formatting
+
+Example:
+```php
+trigger_deprecation('symfony/blockchain', '8.9', 'Using "%s" is deprecated, use "%s" instead.', 'bitcoin', 'fabcoin');
+```
+
+This will generate the following message:
+`Since symfony/blockchain 8.9: Using "bitcoin" is deprecated, use "fabcoin" instead.`
+
+While not recommended, the deprecation notices can be completely ignored by declaring an empty
+`function trigger_deprecation() {}` in your application.
diff --git a/tools/mailer/symfony/deprecation-contracts/composer.json b/tools/mailer/symfony/deprecation-contracts/composer.json
new file mode 100644
index 000000000..ceb6c0796
--- /dev/null
+++ b/tools/mailer/symfony/deprecation-contracts/composer.json
@@ -0,0 +1,35 @@
+{
+ "name": "symfony/deprecation-contracts",
+ "type": "library",
+ "description": "A generic function and convention to trigger deprecation notices",
+ "homepage": "https://symfony.com",
+ "license": "MIT",
+ "authors": [
+ {
+ "name": "Nicolas Grekas",
+ "email": "p@tchwork.com"
+ },
+ {
+ "name": "Symfony Community",
+ "homepage": "https://symfony.com/contributors"
+ }
+ ],
+ "require": {
+ "php": ">=8.1"
+ },
+ "autoload": {
+ "files": [
+ "function.php"
+ ]
+ },
+ "minimum-stability": "dev",
+ "extra": {
+ "branch-alias": {
+ "dev-main": "3.5-dev"
+ },
+ "thanks": {
+ "name": "symfony/contracts",
+ "url": "https://github.com/symfony/contracts"
+ }
+ }
+}
diff --git a/tools/mailer/symfony/deprecation-contracts/function.php b/tools/mailer/symfony/deprecation-contracts/function.php
new file mode 100644
index 000000000..2d56512ba
--- /dev/null
+++ b/tools/mailer/symfony/deprecation-contracts/function.php
@@ -0,0 +1,27 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+if (!function_exists('trigger_deprecation')) {
+ /**
+ * Triggers a silenced deprecation notice.
+ *
+ * @param string $package The name of the Composer package that is triggering the deprecation
+ * @param string $version The version of the package that introduced the deprecation
+ * @param string $message The message of the deprecation
+ * @param mixed ...$args Values to insert in the message using printf() formatting
+ *
+ * @author Nicolas Grekas
+ */
+ function trigger_deprecation(string $package, string $version, string $message, mixed ...$args): void
+ {
+ @trigger_error(($package || $version ? "Since $package $version: " : '').($args ? vsprintf($message, $args) : $message), \E_USER_DEPRECATED);
+ }
+}
diff --git a/tools/mailer/symfony/event-dispatcher-contracts/CHANGELOG.md b/tools/mailer/symfony/event-dispatcher-contracts/CHANGELOG.md
new file mode 100644
index 000000000..7932e2613
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher-contracts/CHANGELOG.md
@@ -0,0 +1,5 @@
+CHANGELOG
+=========
+
+The changelog is maintained for all Symfony contracts at the following URL:
+https://github.com/symfony/contracts/blob/main/CHANGELOG.md
diff --git a/tools/mailer/symfony/event-dispatcher-contracts/Event.php b/tools/mailer/symfony/event-dispatcher-contracts/Event.php
new file mode 100644
index 000000000..2e7f99890
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher-contracts/Event.php
@@ -0,0 +1,51 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Contracts\EventDispatcher;
+
+use Psr\EventDispatcher\StoppableEventInterface;
+
+/**
+ * Event is the base class for classes containing event data.
+ *
+ * This class contains no event data. It is used by events that do not pass
+ * state information to an event handler when an event is raised.
+ *
+ * You can call the method stopPropagation() to abort the execution of
+ * further listeners in your event listener.
+ *
+ * @author Guilherme Blanco
+ * @author Jonathan Wage
+ * @author Roman Borschel
+ * @author Bernhard Schussek
+ * @author Nicolas Grekas
+ */
+class Event implements StoppableEventInterface
+{
+ private bool $propagationStopped = false;
+
+ public function isPropagationStopped(): bool
+ {
+ return $this->propagationStopped;
+ }
+
+ /**
+ * Stops the propagation of the event to further event listeners.
+ *
+ * If multiple event listeners are connected to the same event, no
+ * further event listener will be triggered once any trigger calls
+ * stopPropagation().
+ */
+ public function stopPropagation(): void
+ {
+ $this->propagationStopped = true;
+ }
+}
diff --git a/tools/mailer/symfony/event-dispatcher-contracts/EventDispatcherInterface.php b/tools/mailer/symfony/event-dispatcher-contracts/EventDispatcherInterface.php
new file mode 100644
index 000000000..2d7840d32
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher-contracts/EventDispatcherInterface.php
@@ -0,0 +1,33 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Contracts\EventDispatcher;
+
+use Psr\EventDispatcher\EventDispatcherInterface as PsrEventDispatcherInterface;
+
+/**
+ * Allows providing hooks on domain-specific lifecycles by dispatching events.
+ */
+interface EventDispatcherInterface extends PsrEventDispatcherInterface
+{
+ /**
+ * Dispatches an event to all registered listeners.
+ *
+ * @template T of object
+ *
+ * @param T $event The event to pass to the event handlers/listeners
+ * @param string|null $eventName The name of the event to dispatch. If not supplied,
+ * the class of $event should be used instead.
+ *
+ * @return T The passed $event MUST be returned
+ */
+ public function dispatch(object $event, ?string $eventName = null): object;
+}
diff --git a/tools/mailer/symfony/event-dispatcher-contracts/LICENSE b/tools/mailer/symfony/event-dispatcher-contracts/LICENSE
new file mode 100644
index 000000000..7536caeae
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher-contracts/LICENSE
@@ -0,0 +1,19 @@
+Copyright (c) 2018-present Fabien Potencier
+
+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.
diff --git a/tools/mailer/symfony/event-dispatcher-contracts/README.md b/tools/mailer/symfony/event-dispatcher-contracts/README.md
new file mode 100644
index 000000000..332b961cb
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher-contracts/README.md
@@ -0,0 +1,9 @@
+Symfony EventDispatcher Contracts
+=================================
+
+A set of abstractions extracted out of the Symfony components.
+
+Can be used to build on semantics that the Symfony components proved useful and
+that already have battle tested implementations.
+
+See https://github.com/symfony/contracts/blob/main/README.md for more information.
diff --git a/tools/mailer/symfony/event-dispatcher-contracts/composer.json b/tools/mailer/symfony/event-dispatcher-contracts/composer.json
new file mode 100644
index 000000000..35956eb80
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher-contracts/composer.json
@@ -0,0 +1,35 @@
+{
+ "name": "symfony/event-dispatcher-contracts",
+ "type": "library",
+ "description": "Generic abstractions related to dispatching event",
+ "keywords": ["abstractions", "contracts", "decoupling", "interfaces", "interoperability", "standards"],
+ "homepage": "https://symfony.com",
+ "license": "MIT",
+ "authors": [
+ {
+ "name": "Nicolas Grekas",
+ "email": "p@tchwork.com"
+ },
+ {
+ "name": "Symfony Community",
+ "homepage": "https://symfony.com/contributors"
+ }
+ ],
+ "require": {
+ "php": ">=8.1",
+ "psr/event-dispatcher": "^1"
+ },
+ "autoload": {
+ "psr-4": { "Symfony\\Contracts\\EventDispatcher\\": "" }
+ },
+ "minimum-stability": "dev",
+ "extra": {
+ "branch-alias": {
+ "dev-main": "3.5-dev"
+ },
+ "thanks": {
+ "name": "symfony/contracts",
+ "url": "https://github.com/symfony/contracts"
+ }
+ }
+}
diff --git a/tools/mailer/symfony/event-dispatcher/Attribute/AsEventListener.php b/tools/mailer/symfony/event-dispatcher/Attribute/AsEventListener.php
new file mode 100644
index 000000000..590ada9e8
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher/Attribute/AsEventListener.php
@@ -0,0 +1,35 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\EventDispatcher\Attribute;
+
+/**
+ * Service tag to autoconfigure event listeners.
+ *
+ * @author Alexander M. Turek
+ */
+#[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
+class AsEventListener
+{
+ /**
+ * @param string|null $event The event name to listen to
+ * @param string|null $method The method to run when the listened event is triggered
+ * @param int $priority The priority of this listener if several are declared for the same event
+ * @param string|null $dispatcher The service id of the event dispatcher to listen to
+ */
+ public function __construct(
+ public ?string $event = null,
+ public ?string $method = null,
+ public int $priority = 0,
+ public ?string $dispatcher = null,
+ ) {
+ }
+}
diff --git a/tools/mailer/symfony/event-dispatcher/CHANGELOG.md b/tools/mailer/symfony/event-dispatcher/CHANGELOG.md
new file mode 100644
index 000000000..76b2eab6b
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher/CHANGELOG.md
@@ -0,0 +1,96 @@
+CHANGELOG
+=========
+
+6.0
+---
+
+ * Remove `LegacyEventDispatcherProxy`
+
+5.4
+---
+
+ * Allow `#[AsEventListener]` attribute on methods
+
+5.3
+---
+
+ * Add `#[AsEventListener]` attribute for declaring listeners on PHP 8
+
+5.1.0
+-----
+
+ * The `LegacyEventDispatcherProxy` class has been deprecated.
+ * Added an optional `dispatcher` attribute to the listener and subscriber tags in `RegisterListenerPass`.
+
+5.0.0
+-----
+
+ * The signature of the `EventDispatcherInterface::dispatch()` method has been changed to `dispatch($event, string $eventName = null): object`.
+ * The `Event` class has been removed in favor of `Symfony\Contracts\EventDispatcher\Event`.
+ * The `TraceableEventDispatcherInterface` has been removed.
+ * The `WrappedListener` class is now final.
+
+4.4.0
+-----
+
+ * `AddEventAliasesPass` has been added, allowing applications and bundles to extend the event alias mapping used by `RegisterListenersPass`.
+ * Made the `event` attribute of the `kernel.event_listener` tag optional for FQCN events.
+
+4.3.0
+-----
+
+ * The signature of the `EventDispatcherInterface::dispatch()` method should be updated to `dispatch($event, string $eventName = null)`, not doing so is deprecated
+ * deprecated the `Event` class, use `Symfony\Contracts\EventDispatcher\Event` instead
+
+4.1.0
+-----
+
+ * added support for invokable event listeners tagged with `kernel.event_listener` by default
+ * The `TraceableEventDispatcher::getOrphanedEvents()` method has been added.
+ * The `TraceableEventDispatcherInterface` has been deprecated.
+
+4.0.0
+-----
+
+ * removed the `ContainerAwareEventDispatcher` class
+ * added the `reset()` method to the `TraceableEventDispatcherInterface`
+
+3.4.0
+-----
+
+ * Implementing `TraceableEventDispatcherInterface` without the `reset()` method has been deprecated.
+
+3.3.0
+-----
+
+ * The ContainerAwareEventDispatcher class has been deprecated. Use EventDispatcher with closure factories instead.
+
+3.0.0
+-----
+
+ * The method `getListenerPriority($eventName, $listener)` has been added to the
+ `EventDispatcherInterface`.
+ * The methods `Event::setDispatcher()`, `Event::getDispatcher()`, `Event::setName()`
+ and `Event::getName()` have been removed.
+ The event dispatcher and the event name are passed to the listener call.
+
+2.5.0
+-----
+
+ * added Debug\TraceableEventDispatcher (originally in HttpKernel)
+ * changed Debug\TraceableEventDispatcherInterface to extend EventDispatcherInterface
+ * added RegisterListenersPass (originally in HttpKernel)
+
+2.1.0
+-----
+
+ * added TraceableEventDispatcherInterface
+ * added ContainerAwareEventDispatcher
+ * added a reference to the EventDispatcher on the Event
+ * added a reference to the Event name on the event
+ * added fluid interface to the dispatch() method which now returns the Event
+ object
+ * added GenericEvent event class
+ * added the possibility for subscribers to subscribe several times for the
+ same event
+ * added ImmutableEventDispatcher
diff --git a/tools/mailer/symfony/event-dispatcher/Debug/TraceableEventDispatcher.php b/tools/mailer/symfony/event-dispatcher/Debug/TraceableEventDispatcher.php
new file mode 100644
index 000000000..72ce52658
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher/Debug/TraceableEventDispatcher.php
@@ -0,0 +1,351 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\EventDispatcher\Debug;
+
+use Psr\EventDispatcher\StoppableEventInterface;
+use Psr\Log\LoggerInterface;
+use Symfony\Component\EventDispatcher\EventDispatcher;
+use Symfony\Component\EventDispatcher\EventDispatcherInterface;
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\RequestStack;
+use Symfony\Component\Stopwatch\Stopwatch;
+use Symfony\Contracts\Service\ResetInterface;
+
+/**
+ * Collects some data about event listeners.
+ *
+ * This event dispatcher delegates the dispatching to another one.
+ *
+ * @author Fabien Potencier
+ */
+class TraceableEventDispatcher implements EventDispatcherInterface, ResetInterface
+{
+ /**
+ * @var \SplObjectStorage|null
+ */
+ private ?\SplObjectStorage $callStack = null;
+ private array $wrappedListeners = [];
+ private array $orphanedEvents = [];
+ private string $currentRequestHash = '';
+
+ public function __construct(
+ private EventDispatcherInterface $dispatcher,
+ protected Stopwatch $stopwatch,
+ protected ?LoggerInterface $logger = null,
+ private ?RequestStack $requestStack = null,
+ ) {
+ }
+
+ public function addListener(string $eventName, callable|array $listener, int $priority = 0): void
+ {
+ $this->dispatcher->addListener($eventName, $listener, $priority);
+ }
+
+ public function addSubscriber(EventSubscriberInterface $subscriber): void
+ {
+ $this->dispatcher->addSubscriber($subscriber);
+ }
+
+ public function removeListener(string $eventName, callable|array $listener): void
+ {
+ if (isset($this->wrappedListeners[$eventName])) {
+ foreach ($this->wrappedListeners[$eventName] as $index => $wrappedListener) {
+ if ($wrappedListener->getWrappedListener() === $listener || ($listener instanceof \Closure && $wrappedListener->getWrappedListener() == $listener)) {
+ $listener = $wrappedListener;
+ unset($this->wrappedListeners[$eventName][$index]);
+ break;
+ }
+ }
+ }
+
+ $this->dispatcher->removeListener($eventName, $listener);
+ }
+
+ public function removeSubscriber(EventSubscriberInterface $subscriber): void
+ {
+ $this->dispatcher->removeSubscriber($subscriber);
+ }
+
+ public function getListeners(?string $eventName = null): array
+ {
+ return $this->dispatcher->getListeners($eventName);
+ }
+
+ public function getListenerPriority(string $eventName, callable|array $listener): ?int
+ {
+ // we might have wrapped listeners for the event (if called while dispatching)
+ // in that case get the priority by wrapper
+ if (isset($this->wrappedListeners[$eventName])) {
+ foreach ($this->wrappedListeners[$eventName] as $wrappedListener) {
+ if ($wrappedListener->getWrappedListener() === $listener || ($listener instanceof \Closure && $wrappedListener->getWrappedListener() == $listener)) {
+ return $this->dispatcher->getListenerPriority($eventName, $wrappedListener);
+ }
+ }
+ }
+
+ return $this->dispatcher->getListenerPriority($eventName, $listener);
+ }
+
+ public function hasListeners(?string $eventName = null): bool
+ {
+ return $this->dispatcher->hasListeners($eventName);
+ }
+
+ public function dispatch(object $event, ?string $eventName = null): object
+ {
+ $eventName ??= $event::class;
+
+ $this->callStack ??= new \SplObjectStorage();
+
+ $currentRequestHash = $this->currentRequestHash = $this->requestStack && ($request = $this->requestStack->getCurrentRequest()) ? spl_object_hash($request) : '';
+
+ if (null !== $this->logger && $event instanceof StoppableEventInterface && $event->isPropagationStopped()) {
+ $this->logger->debug(sprintf('The "%s" event is already stopped. No listeners have been called.', $eventName));
+ }
+
+ $this->preProcess($eventName);
+ try {
+ $this->beforeDispatch($eventName, $event);
+ try {
+ $e = $this->stopwatch->start($eventName, 'section');
+ try {
+ $this->dispatcher->dispatch($event, $eventName);
+ } finally {
+ if ($e->isStarted()) {
+ $e->stop();
+ }
+ }
+ } finally {
+ $this->afterDispatch($eventName, $event);
+ }
+ } finally {
+ $this->currentRequestHash = $currentRequestHash;
+ $this->postProcess($eventName);
+ }
+
+ return $event;
+ }
+
+ public function getCalledListeners(?Request $request = null): array
+ {
+ if (null === $this->callStack) {
+ return [];
+ }
+
+ $hash = $request ? spl_object_hash($request) : null;
+ $called = [];
+ foreach ($this->callStack as $listener) {
+ [$eventName, $requestHash] = $this->callStack->getInfo();
+ if (null === $hash || $hash === $requestHash) {
+ $called[] = $listener->getInfo($eventName);
+ }
+ }
+
+ return $called;
+ }
+
+ public function getNotCalledListeners(?Request $request = null): array
+ {
+ try {
+ $allListeners = $this->dispatcher instanceof EventDispatcher ? $this->getListenersWithPriority() : $this->getListenersWithoutPriority();
+ } catch (\Exception $e) {
+ $this->logger?->info('An exception was thrown while getting the uncalled listeners.', ['exception' => $e]);
+
+ // unable to retrieve the uncalled listeners
+ return [];
+ }
+
+ $hash = $request ? spl_object_hash($request) : null;
+ $calledListeners = [];
+
+ if (null !== $this->callStack) {
+ foreach ($this->callStack as $calledListener) {
+ [, $requestHash] = $this->callStack->getInfo();
+
+ if (null === $hash || $hash === $requestHash) {
+ $calledListeners[] = $calledListener->getWrappedListener();
+ }
+ }
+ }
+
+ $notCalled = [];
+
+ foreach ($allListeners as $eventName => $listeners) {
+ foreach ($listeners as [$listener, $priority]) {
+ if (!\in_array($listener, $calledListeners, true)) {
+ if (!$listener instanceof WrappedListener) {
+ $listener = new WrappedListener($listener, null, $this->stopwatch, $this, $priority);
+ }
+ $notCalled[] = $listener->getInfo($eventName);
+ }
+ }
+ }
+
+ uasort($notCalled, $this->sortNotCalledListeners(...));
+
+ return $notCalled;
+ }
+
+ public function getOrphanedEvents(?Request $request = null): array
+ {
+ if ($request) {
+ return $this->orphanedEvents[spl_object_hash($request)] ?? [];
+ }
+
+ if (!$this->orphanedEvents) {
+ return [];
+ }
+
+ return array_merge(...array_values($this->orphanedEvents));
+ }
+
+ public function reset(): void
+ {
+ $this->callStack = null;
+ $this->orphanedEvents = [];
+ $this->currentRequestHash = '';
+ }
+
+ /**
+ * Proxies all method calls to the original event dispatcher.
+ *
+ * @param string $method The method name
+ * @param array $arguments The method arguments
+ */
+ public function __call(string $method, array $arguments): mixed
+ {
+ return $this->dispatcher->{$method}(...$arguments);
+ }
+
+ /**
+ * Called before dispatching the event.
+ */
+ protected function beforeDispatch(string $eventName, object $event): void
+ {
+ }
+
+ /**
+ * Called after dispatching the event.
+ */
+ protected function afterDispatch(string $eventName, object $event): void
+ {
+ }
+
+ private function preProcess(string $eventName): void
+ {
+ if (!$this->dispatcher->hasListeners($eventName)) {
+ $this->orphanedEvents[$this->currentRequestHash][] = $eventName;
+
+ return;
+ }
+
+ foreach ($this->dispatcher->getListeners($eventName) as $listener) {
+ $priority = $this->getListenerPriority($eventName, $listener);
+ $wrappedListener = new WrappedListener($listener instanceof WrappedListener ? $listener->getWrappedListener() : $listener, null, $this->stopwatch, $this);
+ $this->wrappedListeners[$eventName][] = $wrappedListener;
+ $this->dispatcher->removeListener($eventName, $listener);
+ $this->dispatcher->addListener($eventName, $wrappedListener, $priority);
+ $this->callStack->attach($wrappedListener, [$eventName, $this->currentRequestHash]);
+ }
+ }
+
+ private function postProcess(string $eventName): void
+ {
+ unset($this->wrappedListeners[$eventName]);
+ $skipped = false;
+ foreach ($this->dispatcher->getListeners($eventName) as $listener) {
+ if (!$listener instanceof WrappedListener) { // #12845: a new listener was added during dispatch.
+ continue;
+ }
+ // Unwrap listener
+ $priority = $this->getListenerPriority($eventName, $listener);
+ $this->dispatcher->removeListener($eventName, $listener);
+ $this->dispatcher->addListener($eventName, $listener->getWrappedListener(), $priority);
+
+ if (null !== $this->logger) {
+ $context = ['event' => $eventName, 'listener' => $listener->getPretty()];
+ }
+
+ if ($listener->wasCalled()) {
+ $this->logger?->debug('Notified event "{event}" to listener "{listener}".', $context);
+ } else {
+ $this->callStack->detach($listener);
+ }
+
+ if (null !== $this->logger && $skipped) {
+ $this->logger->debug('Listener "{listener}" was not called for event "{event}".', $context);
+ }
+
+ if ($listener->stoppedPropagation()) {
+ $this->logger?->debug('Listener "{listener}" stopped propagation of the event "{event}".', $context);
+
+ $skipped = true;
+ }
+ }
+ }
+
+ private function sortNotCalledListeners(array $a, array $b): int
+ {
+ if (0 !== $cmp = strcmp($a['event'], $b['event'])) {
+ return $cmp;
+ }
+
+ if (\is_int($a['priority']) && !\is_int($b['priority'])) {
+ return 1;
+ }
+
+ if (!\is_int($a['priority']) && \is_int($b['priority'])) {
+ return -1;
+ }
+
+ if ($a['priority'] === $b['priority']) {
+ return 0;
+ }
+
+ if ($a['priority'] > $b['priority']) {
+ return -1;
+ }
+
+ return 1;
+ }
+
+ private function getListenersWithPriority(): array
+ {
+ $result = [];
+
+ $allListeners = new \ReflectionProperty(EventDispatcher::class, 'listeners');
+
+ foreach ($allListeners->getValue($this->dispatcher) as $eventName => $listenersByPriority) {
+ foreach ($listenersByPriority as $priority => $listeners) {
+ foreach ($listeners as $listener) {
+ $result[$eventName][] = [$listener, $priority];
+ }
+ }
+ }
+
+ return $result;
+ }
+
+ private function getListenersWithoutPriority(): array
+ {
+ $result = [];
+
+ foreach ($this->getListeners() as $eventName => $listeners) {
+ foreach ($listeners as $listener) {
+ $result[$eventName][] = [$listener, null];
+ }
+ }
+
+ return $result;
+ }
+}
diff --git a/tools/mailer/symfony/event-dispatcher/Debug/WrappedListener.php b/tools/mailer/symfony/event-dispatcher/Debug/WrappedListener.php
new file mode 100644
index 000000000..b83115bbe
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher/Debug/WrappedListener.php
@@ -0,0 +1,143 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\EventDispatcher\Debug;
+
+use Psr\EventDispatcher\StoppableEventInterface;
+use Symfony\Component\EventDispatcher\EventDispatcherInterface;
+use Symfony\Component\Stopwatch\Stopwatch;
+use Symfony\Component\VarDumper\Caster\ClassStub;
+
+/**
+ * @author Fabien Potencier
+ */
+final class WrappedListener
+{
+ private string|array|object $listener;
+ private ?\Closure $optimizedListener;
+ private string $name;
+ private bool $called = false;
+ private bool $stoppedPropagation = false;
+ private string $pretty;
+ private string $callableRef;
+ private ClassStub|string $stub;
+ private static bool $hasClassStub;
+
+ public function __construct(
+ callable|array $listener,
+ ?string $name,
+ private Stopwatch $stopwatch,
+ private ?EventDispatcherInterface $dispatcher = null,
+ private ?int $priority = null,
+ ) {
+ $this->listener = $listener;
+ $this->optimizedListener = $listener instanceof \Closure ? $listener : (\is_callable($listener) ? $listener(...) : null);
+
+ if (\is_array($listener)) {
+ [$this->name, $this->callableRef] = $this->parseListener($listener);
+ $this->pretty = $this->name.'::'.$listener[1];
+ $this->callableRef .= '::'.$listener[1];
+ } elseif ($listener instanceof \Closure) {
+ $r = new \ReflectionFunction($listener);
+ if ($r->isAnonymous()) {
+ $this->pretty = $this->name = 'closure';
+ } elseif ($class = $r->getClosureCalledClass()) {
+ $this->name = $class->name;
+ $this->pretty = $this->name.'::'.$r->name;
+ } else {
+ $this->pretty = $this->name = $r->name;
+ }
+ } elseif (\is_string($listener)) {
+ $this->pretty = $this->name = $listener;
+ } else {
+ $this->name = get_debug_type($listener);
+ $this->pretty = $this->name.'::__invoke';
+ $this->callableRef = $listener::class.'::__invoke';
+ }
+
+ if (null !== $name) {
+ $this->name = $name;
+ }
+
+ self::$hasClassStub ??= class_exists(ClassStub::class);
+ }
+
+ public function getWrappedListener(): callable|array
+ {
+ return $this->listener;
+ }
+
+ public function wasCalled(): bool
+ {
+ return $this->called;
+ }
+
+ public function stoppedPropagation(): bool
+ {
+ return $this->stoppedPropagation;
+ }
+
+ public function getPretty(): string
+ {
+ return $this->pretty;
+ }
+
+ public function getInfo(string $eventName): array
+ {
+ $this->stub ??= self::$hasClassStub ? new ClassStub($this->pretty.'()', $this->callableRef ?? $this->listener) : $this->pretty.'()';
+
+ return [
+ 'event' => $eventName,
+ 'priority' => $this->priority ??= $this->dispatcher?->getListenerPriority($eventName, $this->listener),
+ 'pretty' => $this->pretty,
+ 'stub' => $this->stub,
+ ];
+ }
+
+ public function __invoke(object $event, string $eventName, EventDispatcherInterface $dispatcher): void
+ {
+ $dispatcher = $this->dispatcher ?: $dispatcher;
+
+ $this->called = true;
+ $this->priority ??= $dispatcher->getListenerPriority($eventName, $this->listener);
+
+ $e = $this->stopwatch->start($this->name, 'event_listener');
+
+ try {
+ ($this->optimizedListener ?? $this->listener)($event, $eventName, $dispatcher);
+ } finally {
+ if ($e->isStarted()) {
+ $e->stop();
+ }
+ }
+
+ if ($event instanceof StoppableEventInterface && $event->isPropagationStopped()) {
+ $this->stoppedPropagation = true;
+ }
+ }
+
+ private function parseListener(array $listener): array
+ {
+ if ($listener[0] instanceof \Closure) {
+ foreach ((new \ReflectionFunction($listener[0]))->getAttributes(\Closure::class) as $attribute) {
+ if ($name = $attribute->getArguments()['name'] ?? false) {
+ return [$name, $attribute->getArguments()['class'] ?? $name];
+ }
+ }
+ }
+
+ if (\is_object($listener[0])) {
+ return [get_debug_type($listener[0]), $listener[0]::class];
+ }
+
+ return [$listener[0], $listener[0]];
+ }
+}
diff --git a/tools/mailer/symfony/event-dispatcher/DependencyInjection/AddEventAliasesPass.php b/tools/mailer/symfony/event-dispatcher/DependencyInjection/AddEventAliasesPass.php
new file mode 100644
index 000000000..530899201
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher/DependencyInjection/AddEventAliasesPass.php
@@ -0,0 +1,38 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\EventDispatcher\DependencyInjection;
+
+use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+
+/**
+ * This pass allows bundles to extend the list of event aliases.
+ *
+ * @author Alexander M. Turek
+ */
+class AddEventAliasesPass implements CompilerPassInterface
+{
+ public function __construct(
+ private array $eventAliases,
+ ) {
+ }
+
+ public function process(ContainerBuilder $container): void
+ {
+ $eventAliases = $container->hasParameter('event_dispatcher.event_aliases') ? $container->getParameter('event_dispatcher.event_aliases') : [];
+
+ $container->setParameter(
+ 'event_dispatcher.event_aliases',
+ array_merge($eventAliases, $this->eventAliases)
+ );
+ }
+}
diff --git a/tools/mailer/symfony/event-dispatcher/DependencyInjection/RegisterListenersPass.php b/tools/mailer/symfony/event-dispatcher/DependencyInjection/RegisterListenersPass.php
new file mode 100644
index 000000000..29a76bbc7
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher/DependencyInjection/RegisterListenersPass.php
@@ -0,0 +1,213 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\EventDispatcher\DependencyInjection;
+
+use Symfony\Component\DependencyInjection\Argument\ServiceClosureArgument;
+use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+use Symfony\Component\DependencyInjection\Exception\InvalidArgumentException;
+use Symfony\Component\DependencyInjection\Reference;
+use Symfony\Component\EventDispatcher\EventDispatcher;
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+use Symfony\Contracts\EventDispatcher\Event;
+
+/**
+ * Compiler pass to register tagged services for an event dispatcher.
+ */
+class RegisterListenersPass implements CompilerPassInterface
+{
+ private array $hotPathEvents = [];
+ private array $noPreloadEvents = [];
+
+ /**
+ * @return $this
+ */
+ public function setHotPathEvents(array $hotPathEvents): static
+ {
+ $this->hotPathEvents = array_flip($hotPathEvents);
+
+ return $this;
+ }
+
+ /**
+ * @return $this
+ */
+ public function setNoPreloadEvents(array $noPreloadEvents): static
+ {
+ $this->noPreloadEvents = array_flip($noPreloadEvents);
+
+ return $this;
+ }
+
+ public function process(ContainerBuilder $container): void
+ {
+ if (!$container->hasDefinition('event_dispatcher') && !$container->hasAlias('event_dispatcher')) {
+ return;
+ }
+
+ $aliases = [];
+
+ if ($container->hasParameter('event_dispatcher.event_aliases')) {
+ $aliases = $container->getParameter('event_dispatcher.event_aliases');
+ }
+
+ $globalDispatcherDefinition = $container->findDefinition('event_dispatcher');
+
+ foreach ($container->findTaggedServiceIds('kernel.event_listener', true) as $id => $events) {
+ $noPreload = 0;
+
+ foreach ($events as $event) {
+ $priority = $event['priority'] ?? 0;
+
+ if (!isset($event['event'])) {
+ if ($container->getDefinition($id)->hasTag('kernel.event_subscriber')) {
+ continue;
+ }
+
+ $event['method'] ??= '__invoke';
+ $event['event'] = $this->getEventFromTypeDeclaration($container, $id, $event['method']);
+ }
+
+ $event['event'] = $aliases[$event['event']] ?? $event['event'];
+
+ if (!isset($event['method'])) {
+ $event['method'] = 'on'.preg_replace_callback([
+ '/(?<=\b|_)[a-z]/i',
+ '/[^a-z0-9]/i',
+ ], fn ($matches) => strtoupper($matches[0]), $event['event']);
+ $event['method'] = preg_replace('/[^a-z0-9]/i', '', $event['method']);
+
+ if (null !== ($class = $container->getDefinition($id)->getClass()) && ($r = $container->getReflectionClass($class, false)) && !$r->hasMethod($event['method'])) {
+ if (!$r->hasMethod('__invoke')) {
+ throw new InvalidArgumentException(sprintf('None of the "%s" or "__invoke" methods exist for the service "%s". Please define the "method" attribute on "kernel.event_listener" tags.', $event['method'], $id));
+ }
+
+ $event['method'] = '__invoke';
+ }
+ }
+
+ $dispatcherDefinition = $globalDispatcherDefinition;
+ if (isset($event['dispatcher'])) {
+ $dispatcherDefinition = $container->findDefinition($event['dispatcher']);
+ }
+
+ $dispatcherDefinition->addMethodCall('addListener', [$event['event'], [new ServiceClosureArgument(new Reference($id)), $event['method']], $priority]);
+
+ if (isset($this->hotPathEvents[$event['event']])) {
+ $container->getDefinition($id)->addTag('container.hot_path');
+ } elseif (isset($this->noPreloadEvents[$event['event']])) {
+ ++$noPreload;
+ }
+ }
+
+ if ($noPreload && \count($events) === $noPreload) {
+ $container->getDefinition($id)->addTag('container.no_preload');
+ }
+ }
+
+ $extractingDispatcher = new ExtractingEventDispatcher();
+
+ foreach ($container->findTaggedServiceIds('kernel.event_subscriber', true) as $id => $tags) {
+ $def = $container->getDefinition($id);
+
+ // We must assume that the class value has been correctly filled, even if the service is created by a factory
+ $class = $def->getClass();
+
+ if (!$r = $container->getReflectionClass($class)) {
+ throw new InvalidArgumentException(sprintf('Class "%s" used for service "%s" cannot be found.', $class, $id));
+ }
+ if (!$r->isSubclassOf(EventSubscriberInterface::class)) {
+ throw new InvalidArgumentException(sprintf('Service "%s" must implement interface "%s".', $id, EventSubscriberInterface::class));
+ }
+ $class = $r->name;
+
+ $dispatcherDefinitions = [];
+ foreach ($tags as $attributes) {
+ if (!isset($attributes['dispatcher']) || isset($dispatcherDefinitions[$attributes['dispatcher']])) {
+ continue;
+ }
+
+ $dispatcherDefinitions[$attributes['dispatcher']] = $container->findDefinition($attributes['dispatcher']);
+ }
+
+ if (!$dispatcherDefinitions) {
+ $dispatcherDefinitions = [$globalDispatcherDefinition];
+ }
+
+ $noPreload = 0;
+ ExtractingEventDispatcher::$aliases = $aliases;
+ ExtractingEventDispatcher::$subscriber = $class;
+ $extractingDispatcher->addSubscriber($extractingDispatcher);
+ foreach ($extractingDispatcher->listeners as $args) {
+ $args[1] = [new ServiceClosureArgument(new Reference($id)), $args[1]];
+ foreach ($dispatcherDefinitions as $dispatcherDefinition) {
+ $dispatcherDefinition->addMethodCall('addListener', $args);
+ }
+
+ if (isset($this->hotPathEvents[$args[0]])) {
+ $container->getDefinition($id)->addTag('container.hot_path');
+ } elseif (isset($this->noPreloadEvents[$args[0]])) {
+ ++$noPreload;
+ }
+ }
+ if ($noPreload && \count($extractingDispatcher->listeners) === $noPreload) {
+ $container->getDefinition($id)->addTag('container.no_preload');
+ }
+ $extractingDispatcher->listeners = [];
+ ExtractingEventDispatcher::$aliases = [];
+ }
+ }
+
+ private function getEventFromTypeDeclaration(ContainerBuilder $container, string $id, string $method): string
+ {
+ if (
+ null === ($class = $container->getDefinition($id)->getClass())
+ || !($r = $container->getReflectionClass($class, false))
+ || !$r->hasMethod($method)
+ || 1 > ($m = $r->getMethod($method))->getNumberOfParameters()
+ || !($type = $m->getParameters()[0]->getType()) instanceof \ReflectionNamedType
+ || $type->isBuiltin()
+ || Event::class === ($name = $type->getName())
+ ) {
+ throw new InvalidArgumentException(sprintf('Service "%s" must define the "event" attribute on "kernel.event_listener" tags.', $id));
+ }
+
+ return $name;
+ }
+}
+
+/**
+ * @internal
+ */
+class ExtractingEventDispatcher extends EventDispatcher implements EventSubscriberInterface
+{
+ public array $listeners = [];
+
+ public static array $aliases = [];
+ public static string $subscriber;
+
+ public function addListener(string $eventName, callable|array $listener, int $priority = 0): void
+ {
+ $this->listeners[] = [$eventName, $listener[1], $priority];
+ }
+
+ public static function getSubscribedEvents(): array
+ {
+ $events = [];
+
+ foreach ([self::$subscriber, 'getSubscribedEvents']() as $eventName => $params) {
+ $events[self::$aliases[$eventName] ?? $eventName] = $params;
+ }
+
+ return $events;
+ }
+}
diff --git a/tools/mailer/symfony/event-dispatcher/EventDispatcher.php b/tools/mailer/symfony/event-dispatcher/EventDispatcher.php
new file mode 100644
index 000000000..43bc16b85
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher/EventDispatcher.php
@@ -0,0 +1,256 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\EventDispatcher;
+
+use Psr\EventDispatcher\StoppableEventInterface;
+use Symfony\Component\EventDispatcher\Debug\WrappedListener;
+
+/**
+ * The EventDispatcherInterface is the central point of Symfony's event listener system.
+ *
+ * Listeners are registered on the manager and events are dispatched through the
+ * manager.
+ *
+ * @author Guilherme Blanco
+ * @author Jonathan Wage
+ * @author Roman Borschel
+ * @author Bernhard Schussek
+ * @author Fabien Potencier
+ * @author Jordi Boggiano
+ * @author Jordan Alliot
+ * @author Nicolas Grekas
+ */
+class EventDispatcher implements EventDispatcherInterface
+{
+ private array $listeners = [];
+ private array $sorted = [];
+ private array $optimized;
+
+ public function __construct()
+ {
+ if (__CLASS__ === static::class) {
+ $this->optimized = [];
+ }
+ }
+
+ public function dispatch(object $event, ?string $eventName = null): object
+ {
+ $eventName ??= $event::class;
+
+ if (isset($this->optimized)) {
+ $listeners = $this->optimized[$eventName] ?? (empty($this->listeners[$eventName]) ? [] : $this->optimizeListeners($eventName));
+ } else {
+ $listeners = $this->getListeners($eventName);
+ }
+
+ if ($listeners) {
+ $this->callListeners($listeners, $eventName, $event);
+ }
+
+ return $event;
+ }
+
+ public function getListeners(?string $eventName = null): array
+ {
+ if (null !== $eventName) {
+ if (empty($this->listeners[$eventName])) {
+ return [];
+ }
+
+ if (!isset($this->sorted[$eventName])) {
+ $this->sortListeners($eventName);
+ }
+
+ return $this->sorted[$eventName];
+ }
+
+ foreach ($this->listeners as $eventName => $eventListeners) {
+ if (!isset($this->sorted[$eventName])) {
+ $this->sortListeners($eventName);
+ }
+ }
+
+ return array_filter($this->sorted);
+ }
+
+ public function getListenerPriority(string $eventName, callable|array $listener): ?int
+ {
+ if (empty($this->listeners[$eventName])) {
+ return null;
+ }
+
+ if (\is_array($listener) && isset($listener[0]) && $listener[0] instanceof \Closure && 2 >= \count($listener)) {
+ $listener[0] = $listener[0]();
+ $listener[1] ??= '__invoke';
+ }
+
+ foreach ($this->listeners[$eventName] as $priority => &$listeners) {
+ foreach ($listeners as &$v) {
+ if ($v !== $listener && \is_array($v) && isset($v[0]) && $v[0] instanceof \Closure && 2 >= \count($v)) {
+ $v[0] = $v[0]();
+ $v[1] ??= '__invoke';
+ }
+ if ($v === $listener || ($listener instanceof \Closure && $v == $listener)) {
+ return $priority;
+ }
+ }
+ }
+
+ return null;
+ }
+
+ public function hasListeners(?string $eventName = null): bool
+ {
+ if (null !== $eventName) {
+ return !empty($this->listeners[$eventName]);
+ }
+
+ foreach ($this->listeners as $eventListeners) {
+ if ($eventListeners) {
+ return true;
+ }
+ }
+
+ return false;
+ }
+
+ public function addListener(string $eventName, callable|array $listener, int $priority = 0): void
+ {
+ $this->listeners[$eventName][$priority][] = $listener;
+ unset($this->sorted[$eventName], $this->optimized[$eventName]);
+ }
+
+ public function removeListener(string $eventName, callable|array $listener): void
+ {
+ if (empty($this->listeners[$eventName])) {
+ return;
+ }
+
+ if (\is_array($listener) && isset($listener[0]) && $listener[0] instanceof \Closure && 2 >= \count($listener)) {
+ $listener[0] = $listener[0]();
+ $listener[1] ??= '__invoke';
+ }
+
+ foreach ($this->listeners[$eventName] as $priority => &$listeners) {
+ foreach ($listeners as $k => &$v) {
+ if ($v !== $listener && \is_array($v) && isset($v[0]) && $v[0] instanceof \Closure && 2 >= \count($v)) {
+ $v[0] = $v[0]();
+ $v[1] ??= '__invoke';
+ }
+ if ($v === $listener || ($listener instanceof \Closure && $v == $listener)) {
+ unset($listeners[$k], $this->sorted[$eventName], $this->optimized[$eventName]);
+ }
+ }
+
+ if (!$listeners) {
+ unset($this->listeners[$eventName][$priority]);
+ }
+ }
+ }
+
+ public function addSubscriber(EventSubscriberInterface $subscriber): void
+ {
+ foreach ($subscriber->getSubscribedEvents() as $eventName => $params) {
+ if (\is_string($params)) {
+ $this->addListener($eventName, [$subscriber, $params]);
+ } elseif (\is_string($params[0])) {
+ $this->addListener($eventName, [$subscriber, $params[0]], $params[1] ?? 0);
+ } else {
+ foreach ($params as $listener) {
+ $this->addListener($eventName, [$subscriber, $listener[0]], $listener[1] ?? 0);
+ }
+ }
+ }
+ }
+
+ public function removeSubscriber(EventSubscriberInterface $subscriber): void
+ {
+ foreach ($subscriber->getSubscribedEvents() as $eventName => $params) {
+ if (\is_array($params) && \is_array($params[0])) {
+ foreach ($params as $listener) {
+ $this->removeListener($eventName, [$subscriber, $listener[0]]);
+ }
+ } else {
+ $this->removeListener($eventName, [$subscriber, \is_string($params) ? $params : $params[0]]);
+ }
+ }
+ }
+
+ /**
+ * Triggers the listeners of an event.
+ *
+ * This method can be overridden to add functionality that is executed
+ * for each listener.
+ *
+ * @param callable[] $listeners The event listeners
+ * @param string $eventName The name of the event to dispatch
+ * @param object $event The event object to pass to the event handlers/listeners
+ */
+ protected function callListeners(iterable $listeners, string $eventName, object $event): void
+ {
+ $stoppable = $event instanceof StoppableEventInterface;
+
+ foreach ($listeners as $listener) {
+ if ($stoppable && $event->isPropagationStopped()) {
+ break;
+ }
+ $listener($event, $eventName, $this);
+ }
+ }
+
+ /**
+ * Sorts the internal list of listeners for the given event by priority.
+ */
+ private function sortListeners(string $eventName): void
+ {
+ krsort($this->listeners[$eventName]);
+ $this->sorted[$eventName] = [];
+
+ foreach ($this->listeners[$eventName] as &$listeners) {
+ foreach ($listeners as &$listener) {
+ if (\is_array($listener) && isset($listener[0]) && $listener[0] instanceof \Closure && 2 >= \count($listener)) {
+ $listener[0] = $listener[0]();
+ $listener[1] ??= '__invoke';
+ }
+ $this->sorted[$eventName][] = $listener;
+ }
+ }
+ }
+
+ /**
+ * Optimizes the internal list of listeners for the given event by priority.
+ */
+ private function optimizeListeners(string $eventName): array
+ {
+ krsort($this->listeners[$eventName]);
+ $this->optimized[$eventName] = [];
+
+ foreach ($this->listeners[$eventName] as &$listeners) {
+ foreach ($listeners as &$listener) {
+ $closure = &$this->optimized[$eventName][];
+ if (\is_array($listener) && isset($listener[0]) && $listener[0] instanceof \Closure && 2 >= \count($listener)) {
+ $closure = static function (...$args) use (&$listener, &$closure) {
+ if ($listener[0] instanceof \Closure) {
+ $listener[0] = $listener[0]();
+ $listener[1] ??= '__invoke';
+ }
+ ($closure = $listener(...))(...$args);
+ };
+ } else {
+ $closure = $listener instanceof WrappedListener ? $listener : $listener(...);
+ }
+ }
+ }
+
+ return $this->optimized[$eventName];
+ }
+}
diff --git a/tools/mailer/symfony/event-dispatcher/EventDispatcherInterface.php b/tools/mailer/symfony/event-dispatcher/EventDispatcherInterface.php
new file mode 100644
index 000000000..99f8b1a03
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher/EventDispatcherInterface.php
@@ -0,0 +1,66 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\EventDispatcher;
+
+use Symfony\Contracts\EventDispatcher\EventDispatcherInterface as ContractsEventDispatcherInterface;
+
+/**
+ * The EventDispatcherInterface is the central point of Symfony's event listener system.
+ * Listeners are registered on the manager and events are dispatched through the
+ * manager.
+ *
+ * @author Bernhard Schussek
+ */
+interface EventDispatcherInterface extends ContractsEventDispatcherInterface
+{
+ /**
+ * Adds an event listener that listens on the specified events.
+ *
+ * @param int $priority The higher this value, the earlier an event
+ * listener will be triggered in the chain (defaults to 0)
+ */
+ public function addListener(string $eventName, callable $listener, int $priority = 0): void;
+
+ /**
+ * Adds an event subscriber.
+ *
+ * The subscriber is asked for all the events it is
+ * interested in and added as a listener for these events.
+ */
+ public function addSubscriber(EventSubscriberInterface $subscriber): void;
+
+ /**
+ * Removes an event listener from the specified events.
+ */
+ public function removeListener(string $eventName, callable $listener): void;
+
+ public function removeSubscriber(EventSubscriberInterface $subscriber): void;
+
+ /**
+ * Gets the listeners of a specific event or all listeners sorted by descending priority.
+ *
+ * @return array
+ */
+ public function getListeners(?string $eventName = null): array;
+
+ /**
+ * Gets the listener priority for a specific event.
+ *
+ * Returns null if the event or the listener does not exist.
+ */
+ public function getListenerPriority(string $eventName, callable $listener): ?int;
+
+ /**
+ * Checks whether an event has any registered listeners.
+ */
+ public function hasListeners(?string $eventName = null): bool;
+}
diff --git a/tools/mailer/symfony/event-dispatcher/EventSubscriberInterface.php b/tools/mailer/symfony/event-dispatcher/EventSubscriberInterface.php
new file mode 100644
index 000000000..2085e428e
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher/EventSubscriberInterface.php
@@ -0,0 +1,49 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\EventDispatcher;
+
+/**
+ * An EventSubscriber knows itself what events it is interested in.
+ * If an EventSubscriber is added to an EventDispatcherInterface, the manager invokes
+ * {@link getSubscribedEvents} and registers the subscriber as a listener for all
+ * returned events.
+ *
+ * @author Guilherme Blanco
+ * @author Jonathan Wage
+ * @author Roman Borschel
+ * @author Bernhard Schussek
+ */
+interface EventSubscriberInterface
+{
+ /**
+ * Returns an array of event names this subscriber wants to listen to.
+ *
+ * The array keys are event names and the value can be:
+ *
+ * * The method name to call (priority defaults to 0)
+ * * An array composed of the method name to call and the priority
+ * * An array of arrays composed of the method names to call and respective
+ * priorities, or 0 if unset
+ *
+ * For instance:
+ *
+ * * ['eventName' => 'methodName']
+ * * ['eventName' => ['methodName', $priority]]
+ * * ['eventName' => [['methodName1', $priority], ['methodName2']]]
+ *
+ * The code must not depend on runtime state as it will only be called at compile time.
+ * All logic depending on runtime state must be put into the individual methods handling the events.
+ *
+ * @return array>
+ */
+ public static function getSubscribedEvents();
+}
diff --git a/tools/mailer/symfony/event-dispatcher/GenericEvent.php b/tools/mailer/symfony/event-dispatcher/GenericEvent.php
new file mode 100644
index 000000000..2ac654fb1
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher/GenericEvent.php
@@ -0,0 +1,155 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\EventDispatcher;
+
+use Symfony\Contracts\EventDispatcher\Event;
+
+/**
+ * Event encapsulation class.
+ *
+ * Encapsulates events thus decoupling the observer from the subject they encapsulate.
+ *
+ * @author Drak
+ *
+ * @implements \ArrayAccess
+ * @implements \IteratorAggregate
+ */
+class GenericEvent extends Event implements \ArrayAccess, \IteratorAggregate
+{
+ /**
+ * Encapsulate an event with $subject and $arguments.
+ *
+ * @param mixed $subject The subject of the event, usually an object or a callable
+ * @param array $arguments Arguments to store in the event
+ */
+ public function __construct(
+ protected mixed $subject = null,
+ protected array $arguments = [],
+ ) {
+ }
+
+ /**
+ * Getter for subject property.
+ */
+ public function getSubject(): mixed
+ {
+ return $this->subject;
+ }
+
+ /**
+ * Get argument by key.
+ *
+ * @throws \InvalidArgumentException if key is not found
+ */
+ public function getArgument(string $key): mixed
+ {
+ if ($this->hasArgument($key)) {
+ return $this->arguments[$key];
+ }
+
+ throw new \InvalidArgumentException(sprintf('Argument "%s" not found.', $key));
+ }
+
+ /**
+ * Add argument to event.
+ *
+ * @return $this
+ */
+ public function setArgument(string $key, mixed $value): static
+ {
+ $this->arguments[$key] = $value;
+
+ return $this;
+ }
+
+ /**
+ * Getter for all arguments.
+ */
+ public function getArguments(): array
+ {
+ return $this->arguments;
+ }
+
+ /**
+ * Set args property.
+ *
+ * @return $this
+ */
+ public function setArguments(array $args = []): static
+ {
+ $this->arguments = $args;
+
+ return $this;
+ }
+
+ /**
+ * Has argument.
+ */
+ public function hasArgument(string $key): bool
+ {
+ return \array_key_exists($key, $this->arguments);
+ }
+
+ /**
+ * ArrayAccess for argument getter.
+ *
+ * @param string $key Array key
+ *
+ * @throws \InvalidArgumentException if key does not exist in $this->args
+ */
+ public function offsetGet(mixed $key): mixed
+ {
+ return $this->getArgument($key);
+ }
+
+ /**
+ * ArrayAccess for argument setter.
+ *
+ * @param string $key Array key to set
+ */
+ public function offsetSet(mixed $key, mixed $value): void
+ {
+ $this->setArgument($key, $value);
+ }
+
+ /**
+ * ArrayAccess for unset argument.
+ *
+ * @param string $key Array key
+ */
+ public function offsetUnset(mixed $key): void
+ {
+ if ($this->hasArgument($key)) {
+ unset($this->arguments[$key]);
+ }
+ }
+
+ /**
+ * ArrayAccess has argument.
+ *
+ * @param string $key Array key
+ */
+ public function offsetExists(mixed $key): bool
+ {
+ return $this->hasArgument($key);
+ }
+
+ /**
+ * IteratorAggregate for iterating over the object like an array.
+ *
+ * @return \ArrayIterator
+ */
+ public function getIterator(): \ArrayIterator
+ {
+ return new \ArrayIterator($this->arguments);
+ }
+}
diff --git a/tools/mailer/symfony/event-dispatcher/ImmutableEventDispatcher.php b/tools/mailer/symfony/event-dispatcher/ImmutableEventDispatcher.php
new file mode 100644
index 000000000..a6d078e9b
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher/ImmutableEventDispatcher.php
@@ -0,0 +1,65 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\EventDispatcher;
+
+/**
+ * A read-only proxy for an event dispatcher.
+ *
+ * @author Bernhard Schussek
+ */
+class ImmutableEventDispatcher implements EventDispatcherInterface
+{
+ public function __construct(
+ private EventDispatcherInterface $dispatcher,
+ ) {
+ }
+
+ public function dispatch(object $event, ?string $eventName = null): object
+ {
+ return $this->dispatcher->dispatch($event, $eventName);
+ }
+
+ public function addListener(string $eventName, callable|array $listener, int $priority = 0): never
+ {
+ throw new \BadMethodCallException('Unmodifiable event dispatchers must not be modified.');
+ }
+
+ public function addSubscriber(EventSubscriberInterface $subscriber): never
+ {
+ throw new \BadMethodCallException('Unmodifiable event dispatchers must not be modified.');
+ }
+
+ public function removeListener(string $eventName, callable|array $listener): never
+ {
+ throw new \BadMethodCallException('Unmodifiable event dispatchers must not be modified.');
+ }
+
+ public function removeSubscriber(EventSubscriberInterface $subscriber): never
+ {
+ throw new \BadMethodCallException('Unmodifiable event dispatchers must not be modified.');
+ }
+
+ public function getListeners(?string $eventName = null): array
+ {
+ return $this->dispatcher->getListeners($eventName);
+ }
+
+ public function getListenerPriority(string $eventName, callable|array $listener): ?int
+ {
+ return $this->dispatcher->getListenerPriority($eventName, $listener);
+ }
+
+ public function hasListeners(?string $eventName = null): bool
+ {
+ return $this->dispatcher->hasListeners($eventName);
+ }
+}
diff --git a/tools/mailer/symfony/event-dispatcher/LICENSE b/tools/mailer/symfony/event-dispatcher/LICENSE
new file mode 100644
index 000000000..0138f8f07
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher/LICENSE
@@ -0,0 +1,19 @@
+Copyright (c) 2004-present Fabien Potencier
+
+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.
diff --git a/tools/mailer/symfony/event-dispatcher/README.md b/tools/mailer/symfony/event-dispatcher/README.md
new file mode 100644
index 000000000..dcdb68d21
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher/README.md
@@ -0,0 +1,15 @@
+EventDispatcher Component
+=========================
+
+The EventDispatcher component provides tools that allow your application
+components to communicate with each other by dispatching events and listening to
+them.
+
+Resources
+---------
+
+ * [Documentation](https://symfony.com/doc/current/components/event_dispatcher.html)
+ * [Contributing](https://symfony.com/doc/current/contributing/index.html)
+ * [Report issues](https://github.com/symfony/symfony/issues) and
+ [send Pull Requests](https://github.com/symfony/symfony/pulls)
+ in the [main Symfony repository](https://github.com/symfony/symfony)
diff --git a/tools/mailer/symfony/event-dispatcher/composer.json b/tools/mailer/symfony/event-dispatcher/composer.json
new file mode 100644
index 000000000..598bbdc54
--- /dev/null
+++ b/tools/mailer/symfony/event-dispatcher/composer.json
@@ -0,0 +1,47 @@
+{
+ "name": "symfony/event-dispatcher",
+ "type": "library",
+ "description": "Provides tools that allow your application components to communicate with each other by dispatching events and listening to them",
+ "keywords": [],
+ "homepage": "https://symfony.com",
+ "license": "MIT",
+ "authors": [
+ {
+ "name": "Fabien Potencier",
+ "email": "fabien@symfony.com"
+ },
+ {
+ "name": "Symfony Community",
+ "homepage": "https://symfony.com/contributors"
+ }
+ ],
+ "require": {
+ "php": ">=8.2",
+ "symfony/event-dispatcher-contracts": "^2.5|^3"
+ },
+ "require-dev": {
+ "symfony/dependency-injection": "^6.4|^7.0",
+ "symfony/expression-language": "^6.4|^7.0",
+ "symfony/config": "^6.4|^7.0",
+ "symfony/error-handler": "^6.4|^7.0",
+ "symfony/http-foundation": "^6.4|^7.0",
+ "symfony/service-contracts": "^2.5|^3",
+ "symfony/stopwatch": "^6.4|^7.0",
+ "psr/log": "^1|^2|^3"
+ },
+ "conflict": {
+ "symfony/dependency-injection": "<6.4",
+ "symfony/service-contracts": "<2.5"
+ },
+ "provide": {
+ "psr/event-dispatcher-implementation": "1.0",
+ "symfony/event-dispatcher-implementation": "2.0|3.0"
+ },
+ "autoload": {
+ "psr-4": { "Symfony\\Component\\EventDispatcher\\": "" },
+ "exclude-from-classmap": [
+ "/Tests/"
+ ]
+ },
+ "minimum-stability": "dev"
+}
diff --git a/tools/mailer/symfony/mailer/CHANGELOG.md b/tools/mailer/symfony/mailer/CHANGELOG.md
new file mode 100644
index 000000000..6ef846cc8
--- /dev/null
+++ b/tools/mailer/symfony/mailer/CHANGELOG.md
@@ -0,0 +1,98 @@
+CHANGELOG
+=========
+
+6.4
+---
+
+ * Add DSN parameter `peer_fingerprint` to verify TLS certificate fingerprint
+ * Change the default port for the `mailjet+smtp` transport from 465 to 587
+
+6.3
+---
+
+ * Add `MessageEvent::reject()` to allow rejecting an email before sending it
+ * Change the default port for the `mailgun+smtp` transport from 465 to 587
+ * Add `$authenticators` parameter in `EsmtpTransport` constructor and `EsmtpTransport::setAuthenticators()`
+ to allow overriding of default eSMTP authenticators
+
+6.2.7
+-----
+
+ * [BC BREAK] The following data providers for `TransportFactoryTestCase` are now static:
+ `supportsProvider()`, `createProvider()`, `unsupportedSchemeProvider()`and `incompleteDsnProvider()`
+
+6.2
+---
+
+ * Add a `mailer:test` command
+ * Add `SentMessageEvent` and `FailedMessageEvent` events
+
+6.1
+---
+
+ * Make `start()` and `stop()` methods public on `SmtpTransport`
+ * Improve extensibility of `EsmtpTransport`
+
+6.0
+---
+
+ * The `HttpTransportException` class takes a string at first argument
+
+5.4
+---
+
+ * Enable the mailer to operate on any PSR-14-compatible event dispatcher
+
+5.3
+---
+
+ * added the `mailer` monolog channel and set it on all transport definitions
+
+5.2.0
+-----
+
+ * added `NativeTransportFactory` to configure a transport based on php.ini settings
+ * added `local_domain`, `restart_threshold`, `restart_threshold_sleep` and `ping_threshold` options for `smtp`
+ * added `command` option for `sendmail`
+
+4.4.0
+-----
+
+ * [BC BREAK] changed the `NullTransport` DSN from `smtp://null` to `null://null`
+ * [BC BREAK] renamed `SmtpEnvelope` to `Envelope`, renamed `DelayedSmtpEnvelope` to
+ `DelayedEnvelope`
+ * [BC BREAK] changed the syntax for failover and roundrobin DSNs
+
+ Before:
+
+ dummy://a || dummy://b (for failover)
+ dummy://a && dummy://b (for roundrobin)
+
+ After:
+
+ failover(dummy://a dummy://b)
+ roundrobin(dummy://a dummy://b)
+
+ * added support for multiple transports on a `Mailer` instance
+ * [BC BREAK] removed the `auth_mode` DSN option (it is now always determined automatically)
+ * STARTTLS cannot be enabled anymore (it is used automatically if TLS is disabled and the server supports STARTTLS)
+ * [BC BREAK] Removed the `encryption` DSN option (use `smtps` instead)
+ * Added support for the `smtps` protocol (does the same as using `smtp` and port `465`)
+ * Added PHPUnit constraints
+ * Added `MessageDataCollector`
+ * Added `MessageEvents` and `MessageLoggerListener` to allow collecting sent emails
+ * [BC BREAK] `TransportInterface` has a new `__toString()` method
+ * [BC BREAK] Classes `AbstractApiTransport` and `AbstractHttpTransport` moved under `Transport` sub-namespace.
+ * [BC BREAK] Transports depend on `Symfony\Contracts\EventDispatcher\EventDispatcherInterface`
+ instead of `Symfony\Component\EventDispatcher\EventDispatcherInterface`.
+ * Added possibility to register custom transport for dsn by implementing
+ `Symfony\Component\Mailer\Transport\TransportFactoryInterface` and tagging with `mailer.transport_factory` tag in DI.
+ * Added `Symfony\Component\Mailer\Test\TransportFactoryTestCase` to ease testing custom transport factories.
+ * Added `SentMessage::getDebug()` and `TransportExceptionInterface::getDebug` to help debugging
+ * Made `MessageEvent` final
+ * add DSN parameter `verify_peer` to disable TLS peer verification for SMTP transport
+
+4.3.0
+-----
+
+ * Added the component.
diff --git a/tools/mailer/symfony/mailer/Command/MailerTestCommand.php b/tools/mailer/symfony/mailer/Command/MailerTestCommand.php
new file mode 100644
index 000000000..bfc2779e3
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Command/MailerTestCommand.php
@@ -0,0 +1,75 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Command;
+
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\Mailer\Transport\TransportInterface;
+use Symfony\Component\Mime\Email;
+
+/**
+ * A console command to test Mailer transports.
+ */
+#[AsCommand(name: 'mailer:test', description: 'Test Mailer transports by sending an email')]
+final class MailerTestCommand extends Command
+{
+ public function __construct(private TransportInterface $transport)
+ {
+ $this->transport = $transport;
+
+ parent::__construct();
+ }
+
+ protected function configure(): void
+ {
+ $this
+ ->addArgument('to', InputArgument::REQUIRED, 'The recipient of the message')
+ ->addOption('from', null, InputOption::VALUE_OPTIONAL, 'The sender of the message', 'from@example.org')
+ ->addOption('subject', null, InputOption::VALUE_OPTIONAL, 'The subject of the message', 'Testing transport')
+ ->addOption('body', null, InputOption::VALUE_OPTIONAL, 'The body of the message', 'Testing body')
+ ->addOption('transport', null, InputOption::VALUE_OPTIONAL, 'The transport to be used')
+ ->setHelp(<<<'EOF'
+The %command.name% command tests a Mailer transport by sending a simple email message:
+
+php %command.full_name% to@example.com
+
+You can also specify a specific transport:
+
+ php %command.full_name% to@example.com --transport=transport_name
+
+Note that this command bypasses the Messenger bus if configured.
+
+EOF
+ );
+ }
+
+ protected function execute(InputInterface $input, OutputInterface $output): int
+ {
+ $message = (new Email())
+ ->to($input->getArgument('to'))
+ ->from($input->getOption('from'))
+ ->subject($input->getOption('subject'))
+ ->text($input->getOption('body'))
+ ;
+ if ($transport = $input->getOption('transport')) {
+ $message->getHeaders()->addTextHeader('X-Transport', $transport);
+ }
+
+ $this->transport->send($message);
+
+ return 0;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/DataCollector/MessageDataCollector.php b/tools/mailer/symfony/mailer/DataCollector/MessageDataCollector.php
new file mode 100644
index 000000000..5c9ac3544
--- /dev/null
+++ b/tools/mailer/symfony/mailer/DataCollector/MessageDataCollector.php
@@ -0,0 +1,59 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\DataCollector;
+
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\HttpKernel\DataCollector\DataCollector;
+use Symfony\Component\Mailer\Event\MessageEvents;
+use Symfony\Component\Mailer\EventListener\MessageLoggerListener;
+
+/**
+ * @author Fabien Potencier
+ */
+final class MessageDataCollector extends DataCollector
+{
+ private MessageEvents $events;
+
+ public function __construct(MessageLoggerListener $logger)
+ {
+ $this->events = $logger->getEvents();
+ }
+
+ public function collect(Request $request, Response $response, ?\Throwable $exception = null): void
+ {
+ $this->data['events'] = $this->events;
+ }
+
+ public function getEvents(): MessageEvents
+ {
+ return $this->data['events'];
+ }
+
+ /**
+ * @internal
+ */
+ public function base64Encode(string $data): string
+ {
+ return base64_encode($data);
+ }
+
+ public function reset(): void
+ {
+ $this->data = [];
+ }
+
+ public function getName(): string
+ {
+ return 'mailer';
+ }
+}
diff --git a/tools/mailer/symfony/mailer/DelayedEnvelope.php b/tools/mailer/symfony/mailer/DelayedEnvelope.php
new file mode 100644
index 000000000..7458db2f0
--- /dev/null
+++ b/tools/mailer/symfony/mailer/DelayedEnvelope.php
@@ -0,0 +1,98 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer;
+
+use Symfony\Component\Mailer\Exception\LogicException;
+use Symfony\Component\Mime\Address;
+use Symfony\Component\Mime\Header\Headers;
+use Symfony\Component\Mime\Message;
+
+/**
+ * @author Fabien Potencier
+ *
+ * @internal
+ */
+final class DelayedEnvelope extends Envelope
+{
+ private bool $senderSet = false;
+ private bool $recipientsSet = false;
+ private Message $message;
+
+ public function __construct(Message $message)
+ {
+ $this->message = $message;
+ }
+
+ public function setSender(Address $sender): void
+ {
+ parent::setSender($sender);
+
+ $this->senderSet = true;
+ }
+
+ public function getSender(): Address
+ {
+ if (!$this->senderSet) {
+ parent::setSender(self::getSenderFromHeaders($this->message->getHeaders()));
+ }
+
+ return parent::getSender();
+ }
+
+ public function setRecipients(array $recipients): void
+ {
+ parent::setRecipients($recipients);
+
+ $this->recipientsSet = (bool) parent::getRecipients();
+ }
+
+ /**
+ * @return Address[]
+ */
+ public function getRecipients(): array
+ {
+ if ($this->recipientsSet) {
+ return parent::getRecipients();
+ }
+
+ return self::getRecipientsFromHeaders($this->message->getHeaders());
+ }
+
+ private static function getRecipientsFromHeaders(Headers $headers): array
+ {
+ $recipients = [];
+ foreach (['to', 'cc', 'bcc'] as $name) {
+ foreach ($headers->all($name) as $header) {
+ foreach ($header->getAddresses() as $address) {
+ $recipients[] = $address;
+ }
+ }
+ }
+
+ return $recipients;
+ }
+
+ private static function getSenderFromHeaders(Headers $headers): Address
+ {
+ if ($sender = $headers->get('Sender')) {
+ return $sender->getAddress();
+ }
+ if ($return = $headers->get('Return-Path')) {
+ return $return->getAddress();
+ }
+ if ($from = $headers->get('From')) {
+ return $from->getAddresses()[0];
+ }
+
+ throw new LogicException('Unable to determine the sender of the message.');
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Envelope.php b/tools/mailer/symfony/mailer/Envelope.php
new file mode 100644
index 000000000..0a4af2eda
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Envelope.php
@@ -0,0 +1,88 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer;
+
+use Symfony\Component\Mailer\Exception\InvalidArgumentException;
+use Symfony\Component\Mailer\Exception\LogicException;
+use Symfony\Component\Mime\Address;
+use Symfony\Component\Mime\RawMessage;
+
+/**
+ * @author Fabien Potencier
+ */
+class Envelope
+{
+ private Address $sender;
+ private array $recipients = [];
+
+ /**
+ * @param Address[] $recipients
+ */
+ public function __construct(Address $sender, array $recipients)
+ {
+ $this->setSender($sender);
+ $this->setRecipients($recipients);
+ }
+
+ public static function create(RawMessage $message): self
+ {
+ if (RawMessage::class === $message::class) {
+ throw new LogicException('Cannot send a RawMessage instance without an explicit Envelope.');
+ }
+
+ return new DelayedEnvelope($message);
+ }
+
+ public function setSender(Address $sender): void
+ {
+ // to ensure deliverability of bounce emails independent of UTF-8 capabilities of SMTP servers
+ if (!preg_match('/^[^@\x80-\xFF]++@/', $sender->getAddress())) {
+ throw new InvalidArgumentException(sprintf('Invalid sender "%s": non-ASCII characters not supported in local-part of email.', $sender->getAddress()));
+ }
+ $this->sender = $sender;
+ }
+
+ /**
+ * @return Address Returns a "mailbox" as specified by RFC 2822
+ * Must be converted to an "addr-spec" when used as a "MAIL FROM" value in SMTP (use getAddress())
+ */
+ public function getSender(): Address
+ {
+ return $this->sender;
+ }
+
+ /**
+ * @param Address[] $recipients
+ */
+ public function setRecipients(array $recipients): void
+ {
+ if (!$recipients) {
+ throw new InvalidArgumentException('An envelope must have at least one recipient.');
+ }
+
+ $this->recipients = [];
+ foreach ($recipients as $recipient) {
+ if (!$recipient instanceof Address) {
+ throw new InvalidArgumentException(sprintf('A recipient must be an instance of "%s" (got "%s").', Address::class, get_debug_type($recipient)));
+ }
+ $this->recipients[] = new Address($recipient->getAddress());
+ }
+ }
+
+ /**
+ * @return Address[]
+ */
+ public function getRecipients(): array
+ {
+ return $this->recipients;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Event/FailedMessageEvent.php b/tools/mailer/symfony/mailer/Event/FailedMessageEvent.php
new file mode 100644
index 000000000..4808c659d
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Event/FailedMessageEvent.php
@@ -0,0 +1,37 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Event;
+
+use Symfony\Component\Mime\RawMessage;
+use Symfony\Contracts\EventDispatcher\Event;
+
+/**
+ * @author Fabien Potencier
+ */
+final class FailedMessageEvent extends Event
+{
+ public function __construct(
+ private RawMessage $message,
+ private \Throwable $error,
+ ) {
+ }
+
+ public function getMessage(): RawMessage
+ {
+ return $this->message;
+ }
+
+ public function getError(): \Throwable
+ {
+ return $this->error;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Event/MessageEvent.php b/tools/mailer/symfony/mailer/Event/MessageEvent.php
new file mode 100644
index 000000000..f00fdd52c
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Event/MessageEvent.php
@@ -0,0 +1,105 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Event;
+
+use Symfony\Component\Mailer\Envelope;
+use Symfony\Component\Mailer\Exception\LogicException;
+use Symfony\Component\Messenger\Stamp\StampInterface;
+use Symfony\Component\Mime\RawMessage;
+use Symfony\Contracts\EventDispatcher\Event;
+
+/**
+ * Allows the transformation of a Message and the Envelope before the email is sent.
+ *
+ * @author Fabien Potencier
+ */
+final class MessageEvent extends Event
+{
+ private RawMessage $message;
+ private Envelope $envelope;
+ private string $transport;
+ private bool $queued;
+ private bool $rejected = false;
+
+ /** @var StampInterface[] */
+ private array $stamps = [];
+
+ public function __construct(RawMessage $message, Envelope $envelope, string $transport, bool $queued = false)
+ {
+ $this->message = $message;
+ $this->envelope = $envelope;
+ $this->transport = $transport;
+ $this->queued = $queued;
+ }
+
+ public function getMessage(): RawMessage
+ {
+ return $this->message;
+ }
+
+ public function setMessage(RawMessage $message): void
+ {
+ $this->message = $message;
+ }
+
+ public function getEnvelope(): Envelope
+ {
+ return $this->envelope;
+ }
+
+ public function setEnvelope(Envelope $envelope): void
+ {
+ $this->envelope = $envelope;
+ }
+
+ public function getTransport(): string
+ {
+ return $this->transport;
+ }
+
+ public function isQueued(): bool
+ {
+ return $this->queued;
+ }
+
+ public function isRejected(): bool
+ {
+ return $this->rejected;
+ }
+
+ public function reject(): void
+ {
+ $this->rejected = true;
+ $this->stopPropagation();
+ }
+
+ public function addStamp(StampInterface $stamp): void
+ {
+ if (!$this->queued) {
+ throw new LogicException(sprintf('Cannot call "%s()" on a message that is not meant to be queued.', __METHOD__));
+ }
+
+ $this->stamps[] = $stamp;
+ }
+
+ /**
+ * @return StampInterface[]
+ */
+ public function getStamps(): array
+ {
+ if (!$this->queued) {
+ throw new LogicException(sprintf('Cannot call "%s()" on a message that is not meant to be queued.', __METHOD__));
+ }
+
+ return $this->stamps;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Event/MessageEvents.php b/tools/mailer/symfony/mailer/Event/MessageEvents.php
new file mode 100644
index 000000000..2b438e382
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Event/MessageEvents.php
@@ -0,0 +1,74 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Event;
+
+use Symfony\Component\Mime\RawMessage;
+
+/**
+ * @author Fabien Potencier
+ */
+class MessageEvents
+{
+ /**
+ * @var MessageEvent[]
+ */
+ private array $events = [];
+
+ /**
+ * @var array
+ */
+ private array $transports = [];
+
+ public function add(MessageEvent $event): void
+ {
+ $this->events[] = $event;
+ $this->transports[$event->getTransport()] = true;
+ }
+
+ public function getTransports(): array
+ {
+ return array_keys($this->transports);
+ }
+
+ /**
+ * @return MessageEvent[]
+ */
+ public function getEvents(?string $name = null): array
+ {
+ if (null === $name) {
+ return $this->events;
+ }
+
+ $events = [];
+ foreach ($this->events as $event) {
+ if ($name === $event->getTransport()) {
+ $events[] = $event;
+ }
+ }
+
+ return $events;
+ }
+
+ /**
+ * @return RawMessage[]
+ */
+ public function getMessages(?string $name = null): array
+ {
+ $events = $this->getEvents($name);
+ $messages = [];
+ foreach ($events as $event) {
+ $messages[] = $event->getMessage();
+ }
+
+ return $messages;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Event/SentMessageEvent.php b/tools/mailer/symfony/mailer/Event/SentMessageEvent.php
new file mode 100644
index 000000000..a412a9f46
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Event/SentMessageEvent.php
@@ -0,0 +1,30 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Event;
+
+use Symfony\Component\Mailer\SentMessage;
+use Symfony\Contracts\EventDispatcher\Event;
+
+/**
+ * @author Fabien Potencier
+ */
+final class SentMessageEvent extends Event
+{
+ public function __construct(private SentMessage $message)
+ {
+ }
+
+ public function getMessage(): SentMessage
+ {
+ return $this->message;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/EventListener/EnvelopeListener.php b/tools/mailer/symfony/mailer/EventListener/EnvelopeListener.php
new file mode 100644
index 000000000..db9dd723a
--- /dev/null
+++ b/tools/mailer/symfony/mailer/EventListener/EnvelopeListener.php
@@ -0,0 +1,71 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\EventListener;
+
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+use Symfony\Component\Mailer\Event\MessageEvent;
+use Symfony\Component\Mime\Address;
+use Symfony\Component\Mime\Message;
+
+/**
+ * Manipulates the Envelope of a Message.
+ *
+ * @author Fabien Potencier
+ */
+class EnvelopeListener implements EventSubscriberInterface
+{
+ private ?Address $sender = null;
+
+ /**
+ * @var Address[]|null
+ */
+ private ?array $recipients = null;
+
+ /**
+ * @param array $recipients
+ */
+ public function __construct(Address|string|null $sender = null, ?array $recipients = null)
+ {
+ if (null !== $sender) {
+ $this->sender = Address::create($sender);
+ }
+ if (null !== $recipients) {
+ $this->recipients = Address::createArray($recipients);
+ }
+ }
+
+ public function onMessage(MessageEvent $event): void
+ {
+ if ($this->sender) {
+ $event->getEnvelope()->setSender($this->sender);
+
+ $message = $event->getMessage();
+ if ($message instanceof Message) {
+ if (!$message->getHeaders()->has('Sender') && !$message->getHeaders()->has('From')) {
+ $message->getHeaders()->addMailboxHeader('Sender', $this->sender);
+ }
+ }
+ }
+
+ if ($this->recipients) {
+ $event->getEnvelope()->setRecipients($this->recipients);
+ }
+ }
+
+ public static function getSubscribedEvents(): array
+ {
+ return [
+ // should be the last one to allow header changes by other listeners first
+ MessageEvent::class => ['onMessage', -255],
+ ];
+ }
+}
diff --git a/tools/mailer/symfony/mailer/EventListener/MessageListener.php b/tools/mailer/symfony/mailer/EventListener/MessageListener.php
new file mode 100644
index 000000000..ec822d9c6
--- /dev/null
+++ b/tools/mailer/symfony/mailer/EventListener/MessageListener.php
@@ -0,0 +1,134 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\EventListener;
+
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+use Symfony\Component\Mailer\Event\MessageEvent;
+use Symfony\Component\Mailer\Exception\InvalidArgumentException;
+use Symfony\Component\Mailer\Exception\RuntimeException;
+use Symfony\Component\Mime\BodyRendererInterface;
+use Symfony\Component\Mime\Header\Headers;
+use Symfony\Component\Mime\Header\MailboxListHeader;
+use Symfony\Component\Mime\Message;
+
+/**
+ * Manipulates the headers and the body of a Message.
+ *
+ * @author Fabien Potencier
+ */
+class MessageListener implements EventSubscriberInterface
+{
+ public const HEADER_SET_IF_EMPTY = 1;
+ public const HEADER_ADD = 2;
+ public const HEADER_REPLACE = 3;
+ public const DEFAULT_RULES = [
+ 'from' => self::HEADER_SET_IF_EMPTY,
+ 'return-path' => self::HEADER_SET_IF_EMPTY,
+ 'reply-to' => self::HEADER_ADD,
+ 'to' => self::HEADER_SET_IF_EMPTY,
+ 'cc' => self::HEADER_ADD,
+ 'bcc' => self::HEADER_ADD,
+ ];
+
+ private ?Headers $headers;
+ private array $headerRules = [];
+ private ?BodyRendererInterface $renderer;
+
+ public function __construct(?Headers $headers = null, ?BodyRendererInterface $renderer = null, array $headerRules = self::DEFAULT_RULES)
+ {
+ $this->headers = $headers;
+ $this->renderer = $renderer;
+ foreach ($headerRules as $headerName => $rule) {
+ $this->addHeaderRule($headerName, $rule);
+ }
+ }
+
+ public function addHeaderRule(string $headerName, int $rule): void
+ {
+ if ($rule < 1 || $rule > 3) {
+ throw new InvalidArgumentException(sprintf('The "%d" rule is not supported.', $rule));
+ }
+
+ $this->headerRules[strtolower($headerName)] = $rule;
+ }
+
+ public function onMessage(MessageEvent $event): void
+ {
+ $message = $event->getMessage();
+ if (!$message instanceof Message) {
+ return;
+ }
+
+ $this->setHeaders($message);
+ $this->renderMessage($message);
+ }
+
+ private function setHeaders(Message $message): void
+ {
+ if (!$this->headers) {
+ return;
+ }
+
+ $headers = $message->getHeaders();
+ foreach ($this->headers->all() as $name => $header) {
+ if (!$headers->has($name)) {
+ $headers->add($header);
+
+ continue;
+ }
+
+ switch ($this->headerRules[$name] ?? self::HEADER_SET_IF_EMPTY) {
+ case self::HEADER_SET_IF_EMPTY:
+ break;
+
+ case self::HEADER_REPLACE:
+ $headers->remove($name);
+ $headers->add($header);
+
+ break;
+
+ case self::HEADER_ADD:
+ if (!Headers::isUniqueHeader($name)) {
+ $headers->add($header);
+
+ break;
+ }
+
+ $h = $headers->get($name);
+ if (!$h instanceof MailboxListHeader) {
+ throw new RuntimeException(sprintf('Unable to set header "%s".', $name));
+ }
+
+ Headers::checkHeaderClass($header);
+ foreach ($header->getAddresses() as $address) {
+ $h->addAddress($address);
+ }
+ }
+ }
+ }
+
+ private function renderMessage(Message $message): void
+ {
+ if (!$this->renderer) {
+ return;
+ }
+
+ $this->renderer->render($message);
+ }
+
+ public static function getSubscribedEvents(): array
+ {
+ return [
+ MessageEvent::class => 'onMessage',
+ ];
+ }
+}
diff --git a/tools/mailer/symfony/mailer/EventListener/MessageLoggerListener.php b/tools/mailer/symfony/mailer/EventListener/MessageLoggerListener.php
new file mode 100644
index 000000000..6c5605fa8
--- /dev/null
+++ b/tools/mailer/symfony/mailer/EventListener/MessageLoggerListener.php
@@ -0,0 +1,57 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\EventListener;
+
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+use Symfony\Component\Mailer\Event\MessageEvent;
+use Symfony\Component\Mailer\Event\MessageEvents;
+use Symfony\Contracts\Service\ResetInterface;
+
+/**
+ * Logs Messages.
+ *
+ * @author Fabien Potencier
+ */
+class MessageLoggerListener implements EventSubscriberInterface, ResetInterface
+{
+ private MessageEvents $events;
+
+ public function __construct()
+ {
+ $this->events = new MessageEvents();
+ }
+
+ /**
+ * @return void
+ */
+ public function reset()
+ {
+ $this->events = new MessageEvents();
+ }
+
+ public function onMessage(MessageEvent $event): void
+ {
+ $this->events->add($event);
+ }
+
+ public function getEvents(): MessageEvents
+ {
+ return $this->events;
+ }
+
+ public static function getSubscribedEvents(): array
+ {
+ return [
+ MessageEvent::class => ['onMessage', -255],
+ ];
+ }
+}
diff --git a/tools/mailer/symfony/mailer/EventListener/MessengerTransportListener.php b/tools/mailer/symfony/mailer/EventListener/MessengerTransportListener.php
new file mode 100644
index 000000000..8cf8cc800
--- /dev/null
+++ b/tools/mailer/symfony/mailer/EventListener/MessengerTransportListener.php
@@ -0,0 +1,49 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\EventListener;
+
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+use Symfony\Component\Mailer\Event\MessageEvent;
+use Symfony\Component\Messenger\Stamp\TransportNamesStamp;
+use Symfony\Component\Mime\Message;
+
+/**
+ * Allows messages to be sent to specific Messenger transports via the "X-Bus-Transport" MIME header.
+ *
+ * @author Fabien Potencier
+ */
+final class MessengerTransportListener implements EventSubscriberInterface
+{
+ public function onMessage(MessageEvent $event): void
+ {
+ if (!$event->isQueued()) {
+ return;
+ }
+
+ $message = $event->getMessage();
+ if (!$message instanceof Message || !$message->getHeaders()->has('X-Bus-Transport')) {
+ return;
+ }
+
+ $names = $message->getHeaders()->get('X-Bus-Transport')->getBody();
+ $names = array_map('trim', explode(',', $names));
+ $event->addStamp(new TransportNamesStamp($names));
+ $message->getHeaders()->remove('X-Bus-Transport');
+ }
+
+ public static function getSubscribedEvents(): array
+ {
+ return [
+ MessageEvent::class => 'onMessage',
+ ];
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Exception/ExceptionInterface.php b/tools/mailer/symfony/mailer/Exception/ExceptionInterface.php
new file mode 100644
index 000000000..2f0f3a6f9
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Exception/ExceptionInterface.php
@@ -0,0 +1,21 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+/**
+ * Exception interface for all exceptions thrown by the component.
+ *
+ * @author Fabien Potencier
+ */
+interface ExceptionInterface extends \Throwable
+{
+}
diff --git a/tools/mailer/symfony/mailer/Exception/HttpTransportException.php b/tools/mailer/symfony/mailer/Exception/HttpTransportException.php
new file mode 100644
index 000000000..ad10910f3
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Exception/HttpTransportException.php
@@ -0,0 +1,34 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * @author Fabien Potencier
+ */
+class HttpTransportException extends TransportException
+{
+ private ResponseInterface $response;
+
+ public function __construct(string $message, ResponseInterface $response, int $code = 0, ?\Throwable $previous = null)
+ {
+ parent::__construct($message, $code, $previous);
+
+ $this->response = $response;
+ }
+
+ public function getResponse(): ResponseInterface
+ {
+ return $this->response;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Exception/IncompleteDsnException.php b/tools/mailer/symfony/mailer/Exception/IncompleteDsnException.php
new file mode 100644
index 000000000..f2618b65d
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Exception/IncompleteDsnException.php
@@ -0,0 +1,19 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+/**
+ * @author Konstantin Myakshin
+ */
+class IncompleteDsnException extends InvalidArgumentException
+{
+}
diff --git a/tools/mailer/symfony/mailer/Exception/InvalidArgumentException.php b/tools/mailer/symfony/mailer/Exception/InvalidArgumentException.php
new file mode 100644
index 000000000..ba5333456
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Exception/InvalidArgumentException.php
@@ -0,0 +1,19 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+/**
+ * @author Fabien Potencier
+ */
+class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface
+{
+}
diff --git a/tools/mailer/symfony/mailer/Exception/LogicException.php b/tools/mailer/symfony/mailer/Exception/LogicException.php
new file mode 100644
index 000000000..487c0a34f
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Exception/LogicException.php
@@ -0,0 +1,19 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+/**
+ * @author Fabien Potencier
+ */
+class LogicException extends \LogicException implements ExceptionInterface
+{
+}
diff --git a/tools/mailer/symfony/mailer/Exception/RuntimeException.php b/tools/mailer/symfony/mailer/Exception/RuntimeException.php
new file mode 100644
index 000000000..44b79cc64
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Exception/RuntimeException.php
@@ -0,0 +1,19 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+/**
+ * @author Fabien Potencier
+ */
+class RuntimeException extends \RuntimeException implements ExceptionInterface
+{
+}
diff --git a/tools/mailer/symfony/mailer/Exception/TransportException.php b/tools/mailer/symfony/mailer/Exception/TransportException.php
new file mode 100644
index 000000000..ea538d6fa
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Exception/TransportException.php
@@ -0,0 +1,30 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+/**
+ * @author Fabien Potencier
+ */
+class TransportException extends RuntimeException implements TransportExceptionInterface
+{
+ private string $debug = '';
+
+ public function getDebug(): string
+ {
+ return $this->debug;
+ }
+
+ public function appendDebug(string $debug): void
+ {
+ $this->debug .= $debug;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Exception/TransportExceptionInterface.php b/tools/mailer/symfony/mailer/Exception/TransportExceptionInterface.php
new file mode 100644
index 000000000..4318f5ce1
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Exception/TransportExceptionInterface.php
@@ -0,0 +1,22 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+/**
+ * @author Fabien Potencier
+ */
+interface TransportExceptionInterface extends ExceptionInterface
+{
+ public function getDebug(): string;
+
+ public function appendDebug(string $debug): void;
+}
diff --git a/tools/mailer/symfony/mailer/Exception/UnexpectedResponseException.php b/tools/mailer/symfony/mailer/Exception/UnexpectedResponseException.php
new file mode 100644
index 000000000..e779df122
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Exception/UnexpectedResponseException.php
@@ -0,0 +1,16 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+class UnexpectedResponseException extends TransportException
+{
+}
diff --git a/tools/mailer/symfony/mailer/Exception/UnsupportedSchemeException.php b/tools/mailer/symfony/mailer/Exception/UnsupportedSchemeException.php
new file mode 100644
index 000000000..257fd47db
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Exception/UnsupportedSchemeException.php
@@ -0,0 +1,101 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+use Symfony\Component\Mailer\Bridge;
+use Symfony\Component\Mailer\Transport\Dsn;
+
+/**
+ * @author Konstantin Myakshin
+ */
+class UnsupportedSchemeException extends LogicException
+{
+ private const SCHEME_TO_PACKAGE_MAP = [
+ 'brevo' => [
+ 'class' => Bridge\Brevo\Transport\BrevoTransportFactory::class,
+ 'package' => 'symfony/brevo-mailer',
+ ],
+ 'gmail' => [
+ 'class' => Bridge\Google\Transport\GmailTransportFactory::class,
+ 'package' => 'symfony/google-mailer',
+ ],
+ 'infobip' => [
+ 'class' => Bridge\Infobip\Transport\InfobipTransportFactory::class,
+ 'package' => 'symfony/infobip-mailer',
+ ],
+ 'mailersend' => [
+ 'class' => Bridge\MailerSend\Transport\MailerSendTransportFactory::class,
+ 'package' => 'symfony/mailersend-mailer',
+ ],
+ 'mailgun' => [
+ 'class' => Bridge\Mailgun\Transport\MailgunTransportFactory::class,
+ 'package' => 'symfony/mailgun-mailer',
+ ],
+ 'mailjet' => [
+ 'class' => Bridge\Mailjet\Transport\MailjetTransportFactory::class,
+ 'package' => 'symfony/mailjet-mailer',
+ ],
+ 'mailpace' => [
+ 'class' => Bridge\MailPace\Transport\MailPaceTransportFactory::class,
+ 'package' => 'symfony/mail-pace-mailer',
+ ],
+ 'mandrill' => [
+ 'class' => Bridge\Mailchimp\Transport\MandrillTransportFactory::class,
+ 'package' => 'symfony/mailchimp-mailer',
+ ],
+ 'ohmysmtp' => [
+ 'class' => Bridge\OhMySmtp\Transport\OhMySmtpTransportFactory::class,
+ 'package' => 'symfony/oh-my-smtp-mailer',
+ ],
+ 'postmark' => [
+ 'class' => Bridge\Postmark\Transport\PostmarkTransportFactory::class,
+ 'package' => 'symfony/postmark-mailer',
+ ],
+ 'scaleway' => [
+ 'class' => Bridge\Scaleway\Transport\ScalewayTransportFactory::class,
+ 'package' => 'symfony/scaleway-mailer',
+ ],
+ 'sendgrid' => [
+ 'class' => Bridge\Sendgrid\Transport\SendgridTransportFactory::class,
+ 'package' => 'symfony/sendgrid-mailer',
+ ],
+ 'sendinblue' => [
+ 'class' => Bridge\Sendinblue\Transport\SendinblueTransportFactory::class,
+ 'package' => 'symfony/sendinblue-mailer',
+ ],
+ 'ses' => [
+ 'class' => Bridge\Amazon\Transport\SesTransportFactory::class,
+ 'package' => 'symfony/amazon-mailer',
+ ],
+ ];
+
+ public function __construct(Dsn $dsn, ?string $name = null, array $supported = [])
+ {
+ $provider = $dsn->getScheme();
+ if (false !== $pos = strpos($provider, '+')) {
+ $provider = substr($provider, 0, $pos);
+ }
+ $package = self::SCHEME_TO_PACKAGE_MAP[$provider] ?? null;
+ if ($package && !class_exists($package['class'])) {
+ parent::__construct(sprintf('Unable to send emails via "%s" as the bridge is not installed. Try running "composer require %s".', $provider, $package['package']));
+
+ return;
+ }
+
+ $message = sprintf('The "%s" scheme is not supported', $dsn->getScheme());
+ if ($name && $supported) {
+ $message .= sprintf('; supported schemes for mailer "%s" are: "%s"', $name, implode('", "', $supported));
+ }
+
+ parent::__construct($message.'.');
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Header/MetadataHeader.php b/tools/mailer/symfony/mailer/Header/MetadataHeader.php
new file mode 100644
index 000000000..d6ee5440d
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Header/MetadataHeader.php
@@ -0,0 +1,34 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Header;
+
+use Symfony\Component\Mime\Header\UnstructuredHeader;
+
+/**
+ * @author Kevin Bond
+ */
+final class MetadataHeader extends UnstructuredHeader
+{
+ private string $key;
+
+ public function __construct(string $key, string $value)
+ {
+ $this->key = $key;
+
+ parent::__construct('X-Metadata-'.$key, $value);
+ }
+
+ public function getKey(): string
+ {
+ return $this->key;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Header/TagHeader.php b/tools/mailer/symfony/mailer/Header/TagHeader.php
new file mode 100644
index 000000000..7115caebe
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Header/TagHeader.php
@@ -0,0 +1,25 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Header;
+
+use Symfony\Component\Mime\Header\UnstructuredHeader;
+
+/**
+ * @author Kevin Bond
+ */
+final class TagHeader extends UnstructuredHeader
+{
+ public function __construct(string $value)
+ {
+ parent::__construct('X-Tag', $value);
+ }
+}
diff --git a/tools/mailer/symfony/mailer/LICENSE b/tools/mailer/symfony/mailer/LICENSE
new file mode 100644
index 000000000..f37c76b59
--- /dev/null
+++ b/tools/mailer/symfony/mailer/LICENSE
@@ -0,0 +1,19 @@
+Copyright (c) 2019-present Fabien Potencier
+
+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.
diff --git a/tools/mailer/symfony/mailer/Mailer.php b/tools/mailer/symfony/mailer/Mailer.php
new file mode 100644
index 000000000..6df99091a
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Mailer.php
@@ -0,0 +1,76 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer;
+
+use Psr\EventDispatcher\EventDispatcherInterface;
+use Symfony\Component\Mailer\Event\MessageEvent;
+use Symfony\Component\Mailer\Exception\TransportExceptionInterface;
+use Symfony\Component\Mailer\Messenger\SendEmailMessage;
+use Symfony\Component\Mailer\Transport\TransportInterface;
+use Symfony\Component\Messenger\Exception\HandlerFailedException;
+use Symfony\Component\Messenger\MessageBusInterface;
+use Symfony\Component\Mime\RawMessage;
+
+/**
+ * @author Fabien Potencier
+ */
+final class Mailer implements MailerInterface
+{
+ private TransportInterface $transport;
+ private ?MessageBusInterface $bus;
+ private ?EventDispatcherInterface $dispatcher;
+
+ public function __construct(TransportInterface $transport, ?MessageBusInterface $bus = null, ?EventDispatcherInterface $dispatcher = null)
+ {
+ $this->transport = $transport;
+ $this->bus = $bus;
+ $this->dispatcher = $dispatcher;
+ }
+
+ public function send(RawMessage $message, ?Envelope $envelope = null): void
+ {
+ if (null === $this->bus) {
+ $this->transport->send($message, $envelope);
+
+ return;
+ }
+
+ $stamps = [];
+ if (null !== $this->dispatcher) {
+ // The dispatched event here has `queued` set to `true`; the goal is NOT to render the message, but to let
+ // listeners do something before a message is sent to the queue.
+ // We are using a cloned message as we still want to dispatch the **original** message, not the one modified by listeners.
+ // That's because the listeners will run again when the email is sent via Messenger by the transport (see `AbstractTransport`).
+ // Listeners should act depending on the `$queued` argument of the `MessageEvent` instance.
+ $clonedMessage = clone $message;
+ $clonedEnvelope = null !== $envelope ? clone $envelope : Envelope::create($clonedMessage);
+ $event = new MessageEvent($clonedMessage, $clonedEnvelope, (string) $this->transport, true);
+ $this->dispatcher->dispatch($event);
+ $stamps = $event->getStamps();
+
+ if ($event->isRejected()) {
+ return;
+ }
+ }
+
+ try {
+ $this->bus->dispatch(new SendEmailMessage($message, $envelope), $stamps);
+ } catch (HandlerFailedException $e) {
+ foreach ($e->getWrappedExceptions() as $nested) {
+ if ($nested instanceof TransportExceptionInterface) {
+ throw $nested;
+ }
+ }
+ throw $e;
+ }
+ }
+}
diff --git a/tools/mailer/symfony/mailer/MailerInterface.php b/tools/mailer/symfony/mailer/MailerInterface.php
new file mode 100644
index 000000000..ebac4b53e
--- /dev/null
+++ b/tools/mailer/symfony/mailer/MailerInterface.php
@@ -0,0 +1,30 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer;
+
+use Symfony\Component\Mailer\Exception\TransportExceptionInterface;
+use Symfony\Component\Mime\RawMessage;
+
+/**
+ * Interface for mailers able to send emails synchronously and/or asynchronously.
+ *
+ * Implementations must support synchronous and asynchronous sending.
+ *
+ * @author Fabien Potencier
+ */
+interface MailerInterface
+{
+ /**
+ * @throws TransportExceptionInterface
+ */
+ public function send(RawMessage $message, ?Envelope $envelope = null): void;
+}
diff --git a/tools/mailer/symfony/mailer/Messenger/MessageHandler.php b/tools/mailer/symfony/mailer/Messenger/MessageHandler.php
new file mode 100644
index 000000000..f8fb14fce
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Messenger/MessageHandler.php
@@ -0,0 +1,33 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Messenger;
+
+use Symfony\Component\Mailer\SentMessage;
+use Symfony\Component\Mailer\Transport\TransportInterface;
+
+/**
+ * @author Fabien Potencier
+ */
+class MessageHandler
+{
+ private TransportInterface $transport;
+
+ public function __construct(TransportInterface $transport)
+ {
+ $this->transport = $transport;
+ }
+
+ public function __invoke(SendEmailMessage $message): ?SentMessage
+ {
+ return $this->transport->send($message->getMessage(), $message->getEnvelope());
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Messenger/SendEmailMessage.php b/tools/mailer/symfony/mailer/Messenger/SendEmailMessage.php
new file mode 100644
index 000000000..18bd50620
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Messenger/SendEmailMessage.php
@@ -0,0 +1,40 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Messenger;
+
+use Symfony\Component\Mailer\Envelope;
+use Symfony\Component\Mime\RawMessage;
+
+/**
+ * @author Fabien Potencier
+ */
+class SendEmailMessage
+{
+ private RawMessage $message;
+ private ?Envelope $envelope;
+
+ public function __construct(RawMessage $message, ?Envelope $envelope = null)
+ {
+ $this->message = $message;
+ $this->envelope = $envelope;
+ }
+
+ public function getMessage(): RawMessage
+ {
+ return $this->message;
+ }
+
+ public function getEnvelope(): ?Envelope
+ {
+ return $this->envelope;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/README.md b/tools/mailer/symfony/mailer/README.md
new file mode 100644
index 000000000..43e7dfe05
--- /dev/null
+++ b/tools/mailer/symfony/mailer/README.md
@@ -0,0 +1,74 @@
+Mailer Component
+================
+
+The Mailer component helps sending emails.
+
+Getting Started
+---------------
+
+```
+$ composer require symfony/mailer
+```
+
+```php
+use Symfony\Component\Mailer\Transport;
+use Symfony\Component\Mailer\Mailer;
+use Symfony\Component\Mime\Email;
+
+$transport = Transport::fromDsn('smtp://localhost');
+$mailer = new Mailer($transport);
+
+$email = (new Email())
+ ->from('hello@example.com')
+ ->to('you@example.com')
+ //->cc('cc@example.com')
+ //->bcc('bcc@example.com')
+ //->replyTo('fabien@example.com')
+ //->priority(Email::PRIORITY_HIGH)
+ ->subject('Time for Symfony Mailer!')
+ ->text('Sending emails is fun again!')
+ ->html('See Twig integration for better HTML integration!
');
+
+$mailer->send($email);
+```
+
+To enable the Twig integration of the Mailer, require `symfony/twig-bridge` and
+set up the `BodyRenderer`:
+
+```php
+use Symfony\Bridge\Twig\Mime\BodyRenderer;
+use Symfony\Bridge\Twig\Mime\TemplatedEmail;
+use Symfony\Component\EventDispatcher\EventDispatcher;
+use Symfony\Component\Mailer\EventListener\MessageListener;
+use Symfony\Component\Mailer\Mailer;
+use Symfony\Component\Mailer\Transport;
+use Twig\Environment as TwigEnvironment;
+
+$twig = new TwigEnvironment(...);
+$messageListener = new MessageListener(null, new BodyRenderer($twig));
+
+$eventDispatcher = new EventDispatcher();
+$eventDispatcher->addSubscriber($messageListener);
+
+$transport = Transport::fromDsn('smtp://localhost', $eventDispatcher);
+$mailer = new Mailer($transport, null, $eventDispatcher);
+
+$email = (new TemplatedEmail())
+ // ...
+ ->htmlTemplate('emails/signup.html.twig')
+ ->context([
+ 'expiration_date' => new \DateTimeImmutable('+7 days'),
+ 'username' => 'foo',
+ ])
+;
+$mailer->send($email);
+```
+
+Resources
+---------
+
+ * [Documentation](https://symfony.com/doc/current/mailer.html)
+ * [Contributing](https://symfony.com/doc/current/contributing/index.html)
+ * [Report issues](https://github.com/symfony/symfony/issues) and
+ [send Pull Requests](https://github.com/symfony/symfony/pulls)
+ in the [main Symfony repository](https://github.com/symfony/symfony)
diff --git a/tools/mailer/symfony/mailer/SentMessage.php b/tools/mailer/symfony/mailer/SentMessage.php
new file mode 100644
index 000000000..be8471180
--- /dev/null
+++ b/tools/mailer/symfony/mailer/SentMessage.php
@@ -0,0 +1,95 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer;
+
+use Symfony\Component\Mime\Message;
+use Symfony\Component\Mime\RawMessage;
+
+/**
+ * @author Fabien Potencier
+ */
+class SentMessage
+{
+ private RawMessage $original;
+ private RawMessage $raw;
+ private Envelope $envelope;
+ private string $messageId;
+ private string $debug = '';
+
+ /**
+ * @internal
+ */
+ public function __construct(RawMessage $message, Envelope $envelope)
+ {
+ $message->ensureValidity();
+
+ $this->original = $message;
+ $this->envelope = $envelope;
+
+ if ($message instanceof Message) {
+ $message = clone $message;
+ $headers = $message->getHeaders();
+ if (!$headers->has('Message-ID')) {
+ $headers->addIdHeader('Message-ID', $message->generateMessageId());
+ }
+ $this->messageId = $headers->get('Message-ID')->getId();
+ $this->raw = new RawMessage($message->toIterable());
+ } else {
+ $this->raw = $message;
+ }
+ }
+
+ public function getMessage(): RawMessage
+ {
+ return $this->raw;
+ }
+
+ public function getOriginalMessage(): RawMessage
+ {
+ return $this->original;
+ }
+
+ public function getEnvelope(): Envelope
+ {
+ return $this->envelope;
+ }
+
+ public function setMessageId(string $id): void
+ {
+ $this->messageId = $id;
+ }
+
+ public function getMessageId(): string
+ {
+ return $this->messageId;
+ }
+
+ public function getDebug(): string
+ {
+ return $this->debug;
+ }
+
+ public function appendDebug(string $debug): void
+ {
+ $this->debug .= $debug;
+ }
+
+ public function toString(): string
+ {
+ return $this->raw->toString();
+ }
+
+ public function toIterable(): iterable
+ {
+ return $this->raw->toIterable();
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Test/Constraint/EmailCount.php b/tools/mailer/symfony/mailer/Test/Constraint/EmailCount.php
new file mode 100644
index 000000000..2ba80f250
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Test/Constraint/EmailCount.php
@@ -0,0 +1,65 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Test\Constraint;
+
+use PHPUnit\Framework\Constraint\Constraint;
+use Symfony\Component\Mailer\Event\MessageEvents;
+
+final class EmailCount extends Constraint
+{
+ private int $expectedValue;
+ private ?string $transport;
+ private bool $queued;
+
+ public function __construct(int $expectedValue, ?string $transport = null, bool $queued = false)
+ {
+ $this->expectedValue = $expectedValue;
+ $this->transport = $transport;
+ $this->queued = $queued;
+ }
+
+ public function toString(): string
+ {
+ return sprintf('%shas %s "%d" emails', $this->transport ? $this->transport.' ' : '', $this->queued ? 'queued' : 'sent', $this->expectedValue);
+ }
+
+ /**
+ * @param MessageEvents $events
+ */
+ protected function matches($events): bool
+ {
+ return $this->expectedValue === $this->countEmails($events);
+ }
+
+ /**
+ * @param MessageEvents $events
+ */
+ protected function failureDescription($events): string
+ {
+ return sprintf('the Transport %s (%d %s)', $this->toString(), $this->countEmails($events), $this->queued ? 'queued' : 'sent');
+ }
+
+ private function countEmails(MessageEvents $events): int
+ {
+ $count = 0;
+ foreach ($events->getEvents($this->transport) as $event) {
+ if (
+ ($this->queued && $event->isQueued())
+ || (!$this->queued && !$event->isQueued())
+ ) {
+ ++$count;
+ }
+ }
+
+ return $count;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Test/Constraint/EmailIsQueued.php b/tools/mailer/symfony/mailer/Test/Constraint/EmailIsQueued.php
new file mode 100644
index 000000000..46436aa06
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Test/Constraint/EmailIsQueued.php
@@ -0,0 +1,39 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Test\Constraint;
+
+use PHPUnit\Framework\Constraint\Constraint;
+use Symfony\Component\Mailer\Event\MessageEvent;
+
+final class EmailIsQueued extends Constraint
+{
+ public function toString(): string
+ {
+ return 'is queued';
+ }
+
+ /**
+ * @param MessageEvent $event
+ */
+ protected function matches($event): bool
+ {
+ return $event->isQueued();
+ }
+
+ /**
+ * @param MessageEvent $event
+ */
+ protected function failureDescription($event): string
+ {
+ return 'the Email '.$this->toString();
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Test/TransportFactoryTestCase.php b/tools/mailer/symfony/mailer/Test/TransportFactoryTestCase.php
new file mode 100644
index 000000000..5156086ae
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Test/TransportFactoryTestCase.php
@@ -0,0 +1,117 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Test;
+
+use PHPUnit\Framework\TestCase;
+use Psr\Log\LoggerInterface;
+use Symfony\Component\Mailer\Exception\IncompleteDsnException;
+use Symfony\Component\Mailer\Exception\UnsupportedSchemeException;
+use Symfony\Component\Mailer\Transport\Dsn;
+use Symfony\Component\Mailer\Transport\TransportFactoryInterface;
+use Symfony\Component\Mailer\Transport\TransportInterface;
+use Symfony\Contracts\EventDispatcher\EventDispatcherInterface;
+use Symfony\Contracts\HttpClient\HttpClientInterface;
+
+/**
+ * A test case to ease testing Transport Factory.
+ *
+ * @author Konstantin Myakshin
+ */
+abstract class TransportFactoryTestCase extends TestCase
+{
+ protected const USER = 'u$er';
+ protected const PASSWORD = 'pa$s';
+
+ protected $dispatcher;
+ protected $client;
+ protected $logger;
+
+ abstract public function getFactory(): TransportFactoryInterface;
+
+ abstract public static function supportsProvider(): iterable;
+
+ abstract public static function createProvider(): iterable;
+
+ public static function unsupportedSchemeProvider(): iterable
+ {
+ return [];
+ }
+
+ public static function incompleteDsnProvider(): iterable
+ {
+ return [];
+ }
+
+ /**
+ * @dataProvider supportsProvider
+ */
+ public function testSupports(Dsn $dsn, bool $supports)
+ {
+ $factory = $this->getFactory();
+
+ $this->assertSame($supports, $factory->supports($dsn));
+ }
+
+ /**
+ * @dataProvider createProvider
+ */
+ public function testCreate(Dsn $dsn, TransportInterface $transport)
+ {
+ $factory = $this->getFactory();
+
+ $this->assertEquals($transport, $factory->create($dsn));
+ if (str_contains('smtp', $dsn->getScheme())) {
+ $this->assertStringMatchesFormat($dsn->getScheme().'://%S'.$dsn->getHost().'%S', (string) $transport);
+ }
+ }
+
+ /**
+ * @dataProvider unsupportedSchemeProvider
+ */
+ public function testUnsupportedSchemeException(Dsn $dsn, ?string $message = null)
+ {
+ $factory = $this->getFactory();
+
+ $this->expectException(UnsupportedSchemeException::class);
+ if (null !== $message) {
+ $this->expectExceptionMessage($message);
+ }
+
+ $factory->create($dsn);
+ }
+
+ /**
+ * @dataProvider incompleteDsnProvider
+ */
+ public function testIncompleteDsnException(Dsn $dsn)
+ {
+ $factory = $this->getFactory();
+
+ $this->expectException(IncompleteDsnException::class);
+ $factory->create($dsn);
+ }
+
+ protected function getDispatcher(): EventDispatcherInterface
+ {
+ return $this->dispatcher ??= $this->createMock(EventDispatcherInterface::class);
+ }
+
+ protected function getClient(): HttpClientInterface
+ {
+ return $this->client ??= $this->createMock(HttpClientInterface::class);
+ }
+
+ protected function getLogger(): LoggerInterface
+ {
+ return $this->logger ??= $this->createMock(LoggerInterface::class);
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport.php b/tools/mailer/symfony/mailer/Transport.php
new file mode 100644
index 000000000..599f4fbce
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport.php
@@ -0,0 +1,188 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer;
+
+use Psr\EventDispatcher\EventDispatcherInterface;
+use Psr\Log\LoggerInterface;
+use Symfony\Component\Mailer\Bridge\Amazon\Transport\SesTransportFactory;
+use Symfony\Component\Mailer\Bridge\Brevo\Transport\BrevoTransportFactory;
+use Symfony\Component\Mailer\Bridge\Google\Transport\GmailTransportFactory;
+use Symfony\Component\Mailer\Bridge\Infobip\Transport\InfobipTransportFactory;
+use Symfony\Component\Mailer\Bridge\Mailchimp\Transport\MandrillTransportFactory;
+use Symfony\Component\Mailer\Bridge\MailerSend\Transport\MailerSendTransportFactory;
+use Symfony\Component\Mailer\Bridge\Mailgun\Transport\MailgunTransportFactory;
+use Symfony\Component\Mailer\Bridge\Mailjet\Transport\MailjetTransportFactory;
+use Symfony\Component\Mailer\Bridge\MailPace\Transport\MailPaceTransportFactory;
+use Symfony\Component\Mailer\Bridge\OhMySmtp\Transport\OhMySmtpTransportFactory;
+use Symfony\Component\Mailer\Bridge\Postmark\Transport\PostmarkTransportFactory;
+use Symfony\Component\Mailer\Bridge\Scaleway\Transport\ScalewayTransportFactory;
+use Symfony\Component\Mailer\Bridge\Sendgrid\Transport\SendgridTransportFactory;
+use Symfony\Component\Mailer\Bridge\Sendinblue\Transport\SendinblueTransportFactory;
+use Symfony\Component\Mailer\Exception\InvalidArgumentException;
+use Symfony\Component\Mailer\Exception\UnsupportedSchemeException;
+use Symfony\Component\Mailer\Transport\Dsn;
+use Symfony\Component\Mailer\Transport\FailoverTransport;
+use Symfony\Component\Mailer\Transport\NativeTransportFactory;
+use Symfony\Component\Mailer\Transport\NullTransportFactory;
+use Symfony\Component\Mailer\Transport\RoundRobinTransport;
+use Symfony\Component\Mailer\Transport\SendmailTransportFactory;
+use Symfony\Component\Mailer\Transport\Smtp\EsmtpTransportFactory;
+use Symfony\Component\Mailer\Transport\TransportFactoryInterface;
+use Symfony\Component\Mailer\Transport\TransportInterface;
+use Symfony\Component\Mailer\Transport\Transports;
+use Symfony\Contracts\HttpClient\HttpClientInterface;
+
+/**
+ * @author Fabien Potencier
+ * @author Konstantin Myakshin
+ */
+final class Transport
+{
+ private const FACTORY_CLASSES = [
+ BrevoTransportFactory::class,
+ GmailTransportFactory::class,
+ InfobipTransportFactory::class,
+ MailerSendTransportFactory::class,
+ MailgunTransportFactory::class,
+ MailjetTransportFactory::class,
+ MailPaceTransportFactory::class,
+ MandrillTransportFactory::class,
+ OhMySmtpTransportFactory::class,
+ PostmarkTransportFactory::class,
+ ScalewayTransportFactory::class,
+ SendgridTransportFactory::class,
+ SendinblueTransportFactory::class,
+ SesTransportFactory::class,
+ ];
+
+ private iterable $factories;
+
+ public static function fromDsn(#[\SensitiveParameter] string $dsn, ?EventDispatcherInterface $dispatcher = null, ?HttpClientInterface $client = null, ?LoggerInterface $logger = null): TransportInterface
+ {
+ $factory = new self(iterator_to_array(self::getDefaultFactories($dispatcher, $client, $logger)));
+
+ return $factory->fromString($dsn);
+ }
+
+ public static function fromDsns(#[\SensitiveParameter] array $dsns, ?EventDispatcherInterface $dispatcher = null, ?HttpClientInterface $client = null, ?LoggerInterface $logger = null): TransportInterface
+ {
+ $factory = new self(iterator_to_array(self::getDefaultFactories($dispatcher, $client, $logger)));
+
+ return $factory->fromStrings($dsns);
+ }
+
+ /**
+ * @param TransportFactoryInterface[] $factories
+ */
+ public function __construct(iterable $factories)
+ {
+ $this->factories = $factories;
+ }
+
+ public function fromStrings(#[\SensitiveParameter] array $dsns): Transports
+ {
+ $transports = [];
+ foreach ($dsns as $name => $dsn) {
+ $transports[$name] = $this->fromString($dsn);
+ }
+
+ return new Transports($transports);
+ }
+
+ public function fromString(#[\SensitiveParameter] string $dsn): TransportInterface
+ {
+ [$transport, $offset] = $this->parseDsn($dsn);
+ if ($offset !== \strlen($dsn)) {
+ throw new InvalidArgumentException('The mailer DSN has some garbage at the end.');
+ }
+
+ return $transport;
+ }
+
+ private function parseDsn(#[\SensitiveParameter] string $dsn, int $offset = 0): array
+ {
+ static $keywords = [
+ 'failover' => FailoverTransport::class,
+ 'roundrobin' => RoundRobinTransport::class,
+ ];
+
+ while (true) {
+ foreach ($keywords as $name => $class) {
+ $name .= '(';
+ if ($name === substr($dsn, $offset, \strlen($name))) {
+ $offset += \strlen($name) - 1;
+ preg_match('{\(([^()]|(?R))*\)}A', $dsn, $matches, 0, $offset);
+ if (!isset($matches[0])) {
+ continue;
+ }
+
+ ++$offset;
+ $args = [];
+ while (true) {
+ [$arg, $offset] = $this->parseDsn($dsn, $offset);
+ $args[] = $arg;
+ if (\strlen($dsn) === $offset) {
+ break;
+ }
+ ++$offset;
+ if (')' === $dsn[$offset - 1]) {
+ break;
+ }
+ }
+
+ return [new $class($args), $offset];
+ }
+ }
+
+ if (preg_match('{(\w+)\(}A', $dsn, $matches, 0, $offset)) {
+ throw new InvalidArgumentException(sprintf('The "%s" keyword is not valid (valid ones are "%s"), ', $matches[1], implode('", "', array_keys($keywords))));
+ }
+
+ if ($pos = strcspn($dsn, ' )', $offset)) {
+ return [$this->fromDsnObject(Dsn::fromString(substr($dsn, $offset, $pos))), $offset + $pos];
+ }
+
+ return [$this->fromDsnObject(Dsn::fromString(substr($dsn, $offset))), \strlen($dsn)];
+ }
+ }
+
+ public function fromDsnObject(Dsn $dsn): TransportInterface
+ {
+ foreach ($this->factories as $factory) {
+ if ($factory->supports($dsn)) {
+ return $factory->create($dsn);
+ }
+ }
+
+ throw new UnsupportedSchemeException($dsn);
+ }
+
+ /**
+ * @return \Traversable
+ */
+ public static function getDefaultFactories(?EventDispatcherInterface $dispatcher = null, ?HttpClientInterface $client = null, ?LoggerInterface $logger = null): \Traversable
+ {
+ foreach (self::FACTORY_CLASSES as $factoryClass) {
+ if (class_exists($factoryClass)) {
+ yield new $factoryClass($dispatcher, $client, $logger);
+ }
+ }
+
+ yield new NullTransportFactory($dispatcher, $client, $logger);
+
+ yield new SendmailTransportFactory($dispatcher, $client, $logger);
+
+ yield new EsmtpTransportFactory($dispatcher, $client, $logger);
+
+ yield new NativeTransportFactory($dispatcher, $client, $logger);
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/AbstractApiTransport.php b/tools/mailer/symfony/mailer/Transport/AbstractApiTransport.php
new file mode 100644
index 000000000..040745eed
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/AbstractApiTransport.php
@@ -0,0 +1,47 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+use Symfony\Component\Mailer\Envelope;
+use Symfony\Component\Mailer\Exception\RuntimeException;
+use Symfony\Component\Mailer\SentMessage;
+use Symfony\Component\Mime\Address;
+use Symfony\Component\Mime\Email;
+use Symfony\Component\Mime\MessageConverter;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * @author Fabien Potencier
+ */
+abstract class AbstractApiTransport extends AbstractHttpTransport
+{
+ abstract protected function doSendApi(SentMessage $sentMessage, Email $email, Envelope $envelope): ResponseInterface;
+
+ protected function doSendHttp(SentMessage $message): ResponseInterface
+ {
+ try {
+ $email = MessageConverter::toEmail($message->getOriginalMessage());
+ } catch (\Exception $e) {
+ throw new RuntimeException(sprintf('Unable to send message with the "%s" transport: ', __CLASS__).$e->getMessage(), 0, $e);
+ }
+
+ return $this->doSendApi($message, $email, $message->getEnvelope());
+ }
+
+ /**
+ * @return Address[]
+ */
+ protected function getRecipients(Email $email, Envelope $envelope): array
+ {
+ return array_filter($envelope->getRecipients(), fn (Address $address) => false === \in_array($address, array_merge($email->getCc(), $email->getBcc()), true));
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/AbstractHttpTransport.php b/tools/mailer/symfony/mailer/Transport/AbstractHttpTransport.php
new file mode 100644
index 000000000..96b7ec009
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/AbstractHttpTransport.php
@@ -0,0 +1,78 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+use Psr\EventDispatcher\EventDispatcherInterface;
+use Psr\Log\LoggerInterface;
+use Symfony\Component\HttpClient\HttpClient;
+use Symfony\Component\Mailer\Exception\HttpTransportException;
+use Symfony\Component\Mailer\SentMessage;
+use Symfony\Contracts\HttpClient\HttpClientInterface;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * @author Victor Bocharsky
+ */
+abstract class AbstractHttpTransport extends AbstractTransport
+{
+ protected $host;
+ protected $port;
+ protected $client;
+
+ public function __construct(?HttpClientInterface $client = null, ?EventDispatcherInterface $dispatcher = null, ?LoggerInterface $logger = null)
+ {
+ $this->client = $client;
+ if (null === $client) {
+ if (!class_exists(HttpClient::class)) {
+ throw new \LogicException(sprintf('You cannot use "%s" as the HttpClient component is not installed. Try running "composer require symfony/http-client".', __CLASS__));
+ }
+
+ $this->client = HttpClient::create();
+ }
+
+ parent::__construct($dispatcher, $logger);
+ }
+
+ /**
+ * @return $this
+ */
+ public function setHost(?string $host): static
+ {
+ $this->host = $host;
+
+ return $this;
+ }
+
+ /**
+ * @return $this
+ */
+ public function setPort(?int $port): static
+ {
+ $this->port = $port;
+
+ return $this;
+ }
+
+ abstract protected function doSendHttp(SentMessage $message): ResponseInterface;
+
+ protected function doSend(SentMessage $message): void
+ {
+ try {
+ $response = $this->doSendHttp($message);
+ $message->appendDebug($response->getInfo('debug') ?? '');
+ } catch (HttpTransportException $e) {
+ $e->appendDebug($e->getResponse()->getInfo('debug') ?? '');
+
+ throw $e;
+ }
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/AbstractTransport.php b/tools/mailer/symfony/mailer/Transport/AbstractTransport.php
new file mode 100644
index 000000000..9a1cd6859
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/AbstractTransport.php
@@ -0,0 +1,136 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+use Psr\EventDispatcher\EventDispatcherInterface;
+use Psr\Log\LoggerInterface;
+use Psr\Log\NullLogger;
+use Symfony\Bridge\Twig\Mime\TemplatedEmail;
+use Symfony\Component\Mailer\Envelope;
+use Symfony\Component\Mailer\Event\FailedMessageEvent;
+use Symfony\Component\Mailer\Event\MessageEvent;
+use Symfony\Component\Mailer\Event\SentMessageEvent;
+use Symfony\Component\Mailer\Exception\LogicException;
+use Symfony\Component\Mailer\SentMessage;
+use Symfony\Component\Mime\Address;
+use Symfony\Component\Mime\BodyRendererInterface;
+use Symfony\Component\Mime\RawMessage;
+
+/**
+ * @author Fabien Potencier
+ */
+abstract class AbstractTransport implements TransportInterface
+{
+ private ?EventDispatcherInterface $dispatcher;
+ private LoggerInterface $logger;
+ private float $rate = 0;
+ private float $lastSent = 0;
+
+ public function __construct(?EventDispatcherInterface $dispatcher = null, ?LoggerInterface $logger = null)
+ {
+ $this->dispatcher = $dispatcher;
+ $this->logger = $logger ?? new NullLogger();
+ }
+
+ /**
+ * Sets the maximum number of messages to send per second (0 to disable).
+ *
+ * @return $this
+ */
+ public function setMaxPerSecond(float $rate): static
+ {
+ if (0 >= $rate) {
+ $rate = 0;
+ }
+
+ $this->rate = $rate;
+ $this->lastSent = 0;
+
+ return $this;
+ }
+
+ public function send(RawMessage $message, ?Envelope $envelope = null): ?SentMessage
+ {
+ $message = clone $message;
+ $envelope = null !== $envelope ? clone $envelope : Envelope::create($message);
+
+ try {
+ if (!$this->dispatcher) {
+ $sentMessage = new SentMessage($message, $envelope);
+ $this->doSend($sentMessage);
+
+ return $sentMessage;
+ }
+
+ $event = new MessageEvent($message, $envelope, (string) $this);
+ $this->dispatcher->dispatch($event);
+ if ($event->isRejected()) {
+ return null;
+ }
+
+ $envelope = $event->getEnvelope();
+ $message = $event->getMessage();
+
+ if ($message instanceof TemplatedEmail && !$message->isRendered()) {
+ throw new LogicException(sprintf('You must configure a "%s" when a "%s" instance has a text or HTML template set.', BodyRendererInterface::class, get_debug_type($message)));
+ }
+
+ $sentMessage = new SentMessage($message, $envelope);
+
+ try {
+ $this->doSend($sentMessage);
+ } catch (\Throwable $error) {
+ $this->dispatcher->dispatch(new FailedMessageEvent($message, $error));
+ $this->checkThrottling();
+
+ throw $error;
+ }
+
+ $this->dispatcher->dispatch(new SentMessageEvent($sentMessage));
+
+ return $sentMessage;
+ } finally {
+ $this->checkThrottling();
+ }
+ }
+
+ abstract protected function doSend(SentMessage $message): void;
+
+ /**
+ * @param Address[] $addresses
+ *
+ * @return string[]
+ */
+ protected function stringifyAddresses(array $addresses): array
+ {
+ return array_map(fn (Address $a) => $a->toString(), $addresses);
+ }
+
+ protected function getLogger(): LoggerInterface
+ {
+ return $this->logger;
+ }
+
+ private function checkThrottling(): void
+ {
+ if (0 == $this->rate) {
+ return;
+ }
+
+ $sleep = (1 / $this->rate) - (microtime(true) - $this->lastSent);
+ if (0 < $sleep) {
+ $this->logger->debug(sprintf('Email transport "%s" sleeps for %.2f seconds', __CLASS__, $sleep));
+ usleep((int) ($sleep * 1000000));
+ }
+ $this->lastSent = microtime(true);
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/AbstractTransportFactory.php b/tools/mailer/symfony/mailer/Transport/AbstractTransportFactory.php
new file mode 100644
index 000000000..96e90f346
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/AbstractTransportFactory.php
@@ -0,0 +1,51 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+use Psr\EventDispatcher\EventDispatcherInterface;
+use Psr\Log\LoggerInterface;
+use Symfony\Component\Mailer\Exception\IncompleteDsnException;
+use Symfony\Contracts\HttpClient\HttpClientInterface;
+
+/**
+ * @author Konstantin Myakshin
+ */
+abstract class AbstractTransportFactory implements TransportFactoryInterface
+{
+ protected $dispatcher;
+ protected $client;
+ protected $logger;
+
+ public function __construct(?EventDispatcherInterface $dispatcher = null, ?HttpClientInterface $client = null, ?LoggerInterface $logger = null)
+ {
+ $this->dispatcher = $dispatcher;
+ $this->client = $client;
+ $this->logger = $logger;
+ }
+
+ public function supports(Dsn $dsn): bool
+ {
+ return \in_array($dsn->getScheme(), $this->getSupportedSchemes());
+ }
+
+ abstract protected function getSupportedSchemes(): array;
+
+ protected function getUser(Dsn $dsn): string
+ {
+ return $dsn->getUser() ?? throw new IncompleteDsnException('User is not set.');
+ }
+
+ protected function getPassword(Dsn $dsn): string
+ {
+ return $dsn->getPassword() ?? throw new IncompleteDsnException('Password is not set.');
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/Dsn.php b/tools/mailer/symfony/mailer/Transport/Dsn.php
new file mode 100644
index 000000000..0cff6aad1
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/Dsn.php
@@ -0,0 +1,89 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+use Symfony\Component\Mailer\Exception\InvalidArgumentException;
+
+/**
+ * @author Konstantin Myakshin
+ */
+final class Dsn
+{
+ private string $scheme;
+ private string $host;
+ private ?string $user;
+ private ?string $password;
+ private ?int $port;
+ private array $options;
+
+ public function __construct(string $scheme, string $host, ?string $user = null, #[\SensitiveParameter] ?string $password = null, ?int $port = null, array $options = [])
+ {
+ $this->scheme = $scheme;
+ $this->host = $host;
+ $this->user = $user;
+ $this->password = $password;
+ $this->port = $port;
+ $this->options = $options;
+ }
+
+ public static function fromString(#[\SensitiveParameter] string $dsn): self
+ {
+ if (false === $params = parse_url($dsn)) {
+ throw new InvalidArgumentException('The mailer DSN is invalid.');
+ }
+
+ if (!isset($params['scheme'])) {
+ throw new InvalidArgumentException('The mailer DSN must contain a scheme.');
+ }
+
+ if (!isset($params['host'])) {
+ throw new InvalidArgumentException('The mailer DSN must contain a host (use "default" by default).');
+ }
+
+ $user = '' !== ($params['user'] ?? '') ? rawurldecode($params['user']) : null;
+ $password = '' !== ($params['pass'] ?? '') ? rawurldecode($params['pass']) : null;
+ $port = $params['port'] ?? null;
+ parse_str($params['query'] ?? '', $query);
+
+ return new self($params['scheme'], $params['host'], $user, $password, $port, $query);
+ }
+
+ public function getScheme(): string
+ {
+ return $this->scheme;
+ }
+
+ public function getHost(): string
+ {
+ return $this->host;
+ }
+
+ public function getUser(): ?string
+ {
+ return $this->user;
+ }
+
+ public function getPassword(): ?string
+ {
+ return $this->password;
+ }
+
+ public function getPort(?int $default = null): ?int
+ {
+ return $this->port ?? $default;
+ }
+
+ public function getOption(string $key, mixed $default = null): mixed
+ {
+ return $this->options[$key] ?? $default;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/FailoverTransport.php b/tools/mailer/symfony/mailer/Transport/FailoverTransport.php
new file mode 100644
index 000000000..d6a747730
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/FailoverTransport.php
@@ -0,0 +1,41 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+/**
+ * Uses several Transports using a failover algorithm.
+ *
+ * @author Fabien Potencier
+ */
+class FailoverTransport extends RoundRobinTransport
+{
+ private ?TransportInterface $currentTransport = null;
+
+ protected function getNextTransport(): ?TransportInterface
+ {
+ if (null === $this->currentTransport || $this->isTransportDead($this->currentTransport)) {
+ $this->currentTransport = parent::getNextTransport();
+ }
+
+ return $this->currentTransport;
+ }
+
+ protected function getInitialCursor(): int
+ {
+ return 0;
+ }
+
+ protected function getNameSymbol(): string
+ {
+ return 'failover';
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/NativeTransportFactory.php b/tools/mailer/symfony/mailer/Transport/NativeTransportFactory.php
new file mode 100644
index 000000000..8afa53cc4
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/NativeTransportFactory.php
@@ -0,0 +1,63 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+use Symfony\Component\Mailer\Exception\TransportException;
+use Symfony\Component\Mailer\Exception\UnsupportedSchemeException;
+use Symfony\Component\Mailer\Transport\Smtp\SmtpTransport;
+use Symfony\Component\Mailer\Transport\Smtp\Stream\SocketStream;
+
+/**
+ * Factory that configures a transport (sendmail or SMTP) based on php.ini settings.
+ *
+ * @author Laurent VOULLEMIER
+ */
+final class NativeTransportFactory extends AbstractTransportFactory
+{
+ public function create(Dsn $dsn): TransportInterface
+ {
+ if (!\in_array($dsn->getScheme(), $this->getSupportedSchemes(), true)) {
+ throw new UnsupportedSchemeException($dsn, 'native', $this->getSupportedSchemes());
+ }
+
+ if ($sendMailPath = ini_get('sendmail_path')) {
+ return new SendmailTransport($sendMailPath, $this->dispatcher, $this->logger);
+ }
+
+ if ('\\' !== \DIRECTORY_SEPARATOR) {
+ throw new TransportException('sendmail_path is not configured in php.ini.');
+ }
+
+ // Only for windows hosts; at this point non-windows
+ // host have already thrown an exception or returned a transport
+ $host = ini_get('SMTP');
+ $port = (int) ini_get('smtp_port');
+
+ if (!$host || !$port) {
+ throw new TransportException('smtp or smtp_port is not configured in php.ini.');
+ }
+
+ $socketStream = new SocketStream();
+ $socketStream->setHost($host);
+ $socketStream->setPort($port);
+ if (465 !== $port) {
+ $socketStream->disableTls();
+ }
+
+ return new SmtpTransport($socketStream, $this->dispatcher, $this->logger);
+ }
+
+ protected function getSupportedSchemes(): array
+ {
+ return ['native'];
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/NullTransport.php b/tools/mailer/symfony/mailer/Transport/NullTransport.php
new file mode 100644
index 000000000..92fb82a47
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/NullTransport.php
@@ -0,0 +1,31 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+use Symfony\Component\Mailer\SentMessage;
+
+/**
+ * Pretends messages have been sent, but just ignores them.
+ *
+ * @author Fabien Potencier
+ */
+final class NullTransport extends AbstractTransport
+{
+ protected function doSend(SentMessage $message): void
+ {
+ }
+
+ public function __toString(): string
+ {
+ return 'null://';
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/NullTransportFactory.php b/tools/mailer/symfony/mailer/Transport/NullTransportFactory.php
new file mode 100644
index 000000000..4c45f39e1
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/NullTransportFactory.php
@@ -0,0 +1,34 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+use Symfony\Component\Mailer\Exception\UnsupportedSchemeException;
+
+/**
+ * @author Konstantin Myakshin
+ */
+final class NullTransportFactory extends AbstractTransportFactory
+{
+ public function create(Dsn $dsn): TransportInterface
+ {
+ if ('null' === $dsn->getScheme()) {
+ return new NullTransport($this->dispatcher, $this->logger);
+ }
+
+ throw new UnsupportedSchemeException($dsn, 'null', $this->getSupportedSchemes());
+ }
+
+ protected function getSupportedSchemes(): array
+ {
+ return ['null'];
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/RoundRobinTransport.php b/tools/mailer/symfony/mailer/Transport/RoundRobinTransport.php
new file mode 100644
index 000000000..ac9709bf7
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/RoundRobinTransport.php
@@ -0,0 +1,125 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+use Symfony\Component\Mailer\Envelope;
+use Symfony\Component\Mailer\Exception\TransportException;
+use Symfony\Component\Mailer\Exception\TransportExceptionInterface;
+use Symfony\Component\Mailer\SentMessage;
+use Symfony\Component\Mime\RawMessage;
+
+/**
+ * Uses several Transports using a round robin algorithm.
+ *
+ * @author Fabien Potencier
+ */
+class RoundRobinTransport implements TransportInterface
+{
+ /**
+ * @var \SplObjectStorage
+ */
+ private \SplObjectStorage $deadTransports;
+ private array $transports = [];
+ private int $retryPeriod;
+ private int $cursor = -1;
+
+ /**
+ * @param TransportInterface[] $transports
+ */
+ public function __construct(array $transports, int $retryPeriod = 60)
+ {
+ if (!$transports) {
+ throw new TransportException(sprintf('"%s" must have at least one transport configured.', static::class));
+ }
+
+ $this->transports = $transports;
+ $this->deadTransports = new \SplObjectStorage();
+ $this->retryPeriod = $retryPeriod;
+ }
+
+ public function send(RawMessage $message, ?Envelope $envelope = null): ?SentMessage
+ {
+ $exception = null;
+
+ while ($transport = $this->getNextTransport()) {
+ try {
+ return $transport->send($message, $envelope);
+ } catch (TransportExceptionInterface $e) {
+ $exception ??= new TransportException('All transports failed.');
+ $exception->appendDebug(sprintf("Transport \"%s\": %s\n", $transport, $e->getDebug()));
+ $this->deadTransports[$transport] = microtime(true);
+ }
+ }
+
+ throw $exception ?? new TransportException('No transports found.');
+ }
+
+ public function __toString(): string
+ {
+ return $this->getNameSymbol().'('.implode(' ', array_map('strval', $this->transports)).')';
+ }
+
+ /**
+ * Rotates the transport list around and returns the first instance.
+ */
+ protected function getNextTransport(): ?TransportInterface
+ {
+ if (-1 === $this->cursor) {
+ $this->cursor = $this->getInitialCursor();
+ }
+
+ $cursor = $this->cursor;
+ while (true) {
+ $transport = $this->transports[$cursor];
+
+ if (!$this->isTransportDead($transport)) {
+ break;
+ }
+
+ if ((microtime(true) - $this->deadTransports[$transport]) > $this->retryPeriod) {
+ $this->deadTransports->detach($transport);
+
+ break;
+ }
+
+ if ($this->cursor === $cursor = $this->moveCursor($cursor)) {
+ return null;
+ }
+ }
+
+ $this->cursor = $this->moveCursor($cursor);
+
+ return $transport;
+ }
+
+ protected function isTransportDead(TransportInterface $transport): bool
+ {
+ return $this->deadTransports->contains($transport);
+ }
+
+ protected function getInitialCursor(): int
+ {
+ // the cursor initial value is randomized so that
+ // when are not in a daemon, we are still rotating the transports
+ return mt_rand(0, \count($this->transports) - 1);
+ }
+
+ protected function getNameSymbol(): string
+ {
+ return 'roundrobin';
+ }
+
+ private function moveCursor(int $cursor): int
+ {
+ return ++$cursor >= \count($this->transports) ? 0 : $cursor;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/SendmailTransport.php b/tools/mailer/symfony/mailer/Transport/SendmailTransport.php
new file mode 100644
index 000000000..3add460eb
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/SendmailTransport.php
@@ -0,0 +1,124 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+use Psr\EventDispatcher\EventDispatcherInterface;
+use Psr\Log\LoggerInterface;
+use Symfony\Component\Mailer\Envelope;
+use Symfony\Component\Mailer\SentMessage;
+use Symfony\Component\Mailer\Transport\Smtp\SmtpTransport;
+use Symfony\Component\Mailer\Transport\Smtp\Stream\AbstractStream;
+use Symfony\Component\Mailer\Transport\Smtp\Stream\ProcessStream;
+use Symfony\Component\Mime\RawMessage;
+
+/**
+ * SendmailTransport for sending mail through a Sendmail/Postfix (etc..) binary.
+ *
+ * Transport can be instantiated through SendmailTransportFactory or NativeTransportFactory:
+ *
+ * - SendmailTransportFactory to use most common sendmail path and recommended options
+ * - NativeTransportFactory when configuration is set via php.ini
+ *
+ * @author Fabien Potencier
+ * @author Chris Corbyn
+ */
+class SendmailTransport extends AbstractTransport
+{
+ private string $command = '/usr/sbin/sendmail -bs';
+ private ProcessStream $stream;
+ private ?SmtpTransport $transport = null;
+
+ /**
+ * Constructor.
+ *
+ * Supported modes are -bs and -t, with any additional flags desired.
+ *
+ * The recommended mode is "-bs" since it is interactive and failure notifications are hence possible.
+ * Note that the -t mode does not support error reporting and does not support Bcc properly (the Bcc headers are not removed).
+ *
+ * If using -t mode, you are strongly advised to include -oi or -i in the flags (like /usr/sbin/sendmail -oi -t)
+ *
+ * -f flag will be appended automatically if one is not present.
+ */
+ public function __construct(?string $command = null, ?EventDispatcherInterface $dispatcher = null, ?LoggerInterface $logger = null)
+ {
+ parent::__construct($dispatcher, $logger);
+
+ if (null !== $command) {
+ if (!str_contains($command, ' -bs') && !str_contains($command, ' -t')) {
+ throw new \InvalidArgumentException(sprintf('Unsupported sendmail command flags "%s"; must be one of "-bs" or "-t" but can include additional flags.', $command));
+ }
+
+ $this->command = $command;
+ }
+
+ $this->stream = new ProcessStream();
+ if (str_contains($this->command, ' -bs')) {
+ $this->stream->setCommand($this->command);
+ $this->stream->setInteractive(true);
+ $this->transport = new SmtpTransport($this->stream, $dispatcher, $logger);
+ }
+ }
+
+ public function send(RawMessage $message, ?Envelope $envelope = null): ?SentMessage
+ {
+ if ($this->transport) {
+ return $this->transport->send($message, $envelope);
+ }
+
+ return parent::send($message, $envelope);
+ }
+
+ public function __toString(): string
+ {
+ if ($this->transport) {
+ return (string) $this->transport;
+ }
+
+ return 'smtp://sendmail';
+ }
+
+ protected function doSend(SentMessage $message): void
+ {
+ $this->getLogger()->debug(sprintf('Email transport "%s" starting', __CLASS__));
+
+ $command = $this->command;
+
+ if ($recipients = $message->getEnvelope()->getRecipients()) {
+ $command = str_replace(' -t', '', $command);
+ }
+
+ if (!str_contains($command, ' -f')) {
+ $command .= ' -f'.escapeshellarg($message->getEnvelope()->getSender()->getEncodedAddress());
+ }
+
+ $chunks = AbstractStream::replace("\r\n", "\n", $message->toIterable());
+
+ if (!str_contains($command, ' -i') && !str_contains($command, ' -oi')) {
+ $chunks = AbstractStream::replace("\n.", "\n..", $chunks);
+ }
+
+ foreach ($recipients as $recipient) {
+ $command .= ' '.escapeshellarg($recipient->getEncodedAddress());
+ }
+
+ $this->stream->setCommand($command);
+ $this->stream->initialize();
+ foreach ($chunks as $chunk) {
+ $this->stream->write($chunk);
+ }
+ $this->stream->flush();
+ $this->stream->terminate();
+
+ $this->getLogger()->debug(sprintf('Email transport "%s" stopped', __CLASS__));
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/SendmailTransportFactory.php b/tools/mailer/symfony/mailer/Transport/SendmailTransportFactory.php
new file mode 100644
index 000000000..6d977e74b
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/SendmailTransportFactory.php
@@ -0,0 +1,34 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+use Symfony\Component\Mailer\Exception\UnsupportedSchemeException;
+
+/**
+ * @author Konstantin Myakshin
+ */
+final class SendmailTransportFactory extends AbstractTransportFactory
+{
+ public function create(Dsn $dsn): TransportInterface
+ {
+ if ('sendmail+smtp' === $dsn->getScheme() || 'sendmail' === $dsn->getScheme()) {
+ return new SendmailTransport($dsn->getOption('command'), $this->dispatcher, $this->logger);
+ }
+
+ throw new UnsupportedSchemeException($dsn, 'sendmail', $this->getSupportedSchemes());
+ }
+
+ protected function getSupportedSchemes(): array
+ {
+ return ['sendmail', 'sendmail+smtp'];
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/Smtp/Auth/AuthenticatorInterface.php b/tools/mailer/symfony/mailer/Transport/Smtp/Auth/AuthenticatorInterface.php
new file mode 100644
index 000000000..98ea2d44a
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/Smtp/Auth/AuthenticatorInterface.php
@@ -0,0 +1,35 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport\Smtp\Auth;
+
+use Symfony\Component\Mailer\Exception\TransportExceptionInterface;
+use Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport;
+
+/**
+ * An Authentication mechanism.
+ *
+ * @author Chris Corbyn
+ */
+interface AuthenticatorInterface
+{
+ /**
+ * Tries to authenticate the user.
+ *
+ * @throws TransportExceptionInterface
+ */
+ public function authenticate(EsmtpTransport $client): void;
+
+ /**
+ * Gets the name of the AUTH mechanism this Authenticator handles.
+ */
+ public function getAuthKeyword(): string;
+}
diff --git a/tools/mailer/symfony/mailer/Transport/Smtp/Auth/CramMd5Authenticator.php b/tools/mailer/symfony/mailer/Transport/Smtp/Auth/CramMd5Authenticator.php
new file mode 100644
index 000000000..79cddc469
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/Smtp/Auth/CramMd5Authenticator.php
@@ -0,0 +1,65 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport\Smtp\Auth;
+
+use Symfony\Component\Mailer\Exception\InvalidArgumentException;
+use Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport;
+
+/**
+ * Handles CRAM-MD5 authentication.
+ *
+ * @author Chris Corbyn
+ */
+class CramMd5Authenticator implements AuthenticatorInterface
+{
+ public function getAuthKeyword(): string
+ {
+ return 'CRAM-MD5';
+ }
+
+ /**
+ * @see https://www.ietf.org/rfc/rfc4954.txt
+ */
+ public function authenticate(EsmtpTransport $client): void
+ {
+ $challenge = $client->executeCommand("AUTH CRAM-MD5\r\n", [334]);
+ $challenge = base64_decode(substr($challenge, 4));
+ $message = base64_encode($client->getUsername().' '.$this->getResponse($client->getPassword(), $challenge));
+ $client->executeCommand(sprintf("%s\r\n", $message), [235]);
+ }
+
+ /**
+ * Generates a CRAM-MD5 response from a server challenge.
+ */
+ private function getResponse(#[\SensitiveParameter] string $secret, string $challenge): string
+ {
+ if (!$secret) {
+ throw new InvalidArgumentException('A non-empty secret is required.');
+ }
+
+ if (\strlen($secret) > 64) {
+ $secret = pack('H32', md5($secret));
+ }
+
+ if (\strlen($secret) < 64) {
+ $secret = str_pad($secret, 64, \chr(0));
+ }
+
+ $kipad = substr($secret, 0, 64) ^ str_repeat(\chr(0x36), 64);
+ $kopad = substr($secret, 0, 64) ^ str_repeat(\chr(0x5C), 64);
+
+ $inner = pack('H32', md5($kipad.$challenge));
+ $digest = md5($kopad.$inner);
+
+ return $digest;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/Smtp/Auth/LoginAuthenticator.php b/tools/mailer/symfony/mailer/Transport/Smtp/Auth/LoginAuthenticator.php
new file mode 100644
index 000000000..e0b7d577e
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/Smtp/Auth/LoginAuthenticator.php
@@ -0,0 +1,37 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport\Smtp\Auth;
+
+use Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport;
+
+/**
+ * Handles LOGIN authentication.
+ *
+ * @author Chris Corbyn
+ */
+class LoginAuthenticator implements AuthenticatorInterface
+{
+ public function getAuthKeyword(): string
+ {
+ return 'LOGIN';
+ }
+
+ /**
+ * @see https://www.ietf.org/rfc/rfc4954.txt
+ */
+ public function authenticate(EsmtpTransport $client): void
+ {
+ $client->executeCommand("AUTH LOGIN\r\n", [334]);
+ $client->executeCommand(sprintf("%s\r\n", base64_encode($client->getUsername())), [334]);
+ $client->executeCommand(sprintf("%s\r\n", base64_encode($client->getPassword())), [235]);
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/Smtp/Auth/PlainAuthenticator.php b/tools/mailer/symfony/mailer/Transport/Smtp/Auth/PlainAuthenticator.php
new file mode 100644
index 000000000..6b680b511
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/Smtp/Auth/PlainAuthenticator.php
@@ -0,0 +1,35 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport\Smtp\Auth;
+
+use Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport;
+
+/**
+ * Handles PLAIN authentication.
+ *
+ * @author Chris Corbyn
+ */
+class PlainAuthenticator implements AuthenticatorInterface
+{
+ public function getAuthKeyword(): string
+ {
+ return 'PLAIN';
+ }
+
+ /**
+ * @see https://www.ietf.org/rfc/rfc4954.txt
+ */
+ public function authenticate(EsmtpTransport $client): void
+ {
+ $client->executeCommand(sprintf("AUTH PLAIN %s\r\n", base64_encode($client->getUsername().\chr(0).$client->getUsername().\chr(0).$client->getPassword())), [235]);
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/Smtp/Auth/XOAuth2Authenticator.php b/tools/mailer/symfony/mailer/Transport/Smtp/Auth/XOAuth2Authenticator.php
new file mode 100644
index 000000000..c3aaa4909
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/Smtp/Auth/XOAuth2Authenticator.php
@@ -0,0 +1,37 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport\Smtp\Auth;
+
+use Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport;
+
+/**
+ * Handles XOAUTH2 authentication.
+ *
+ * @author xu.li
+ *
+ * @see https://developers.google.com/google-apps/gmail/xoauth2_protocol
+ */
+class XOAuth2Authenticator implements AuthenticatorInterface
+{
+ public function getAuthKeyword(): string
+ {
+ return 'XOAUTH2';
+ }
+
+ /**
+ * @see https://developers.google.com/google-apps/gmail/xoauth2_protocol#the_sasl_xoauth2_mechanism
+ */
+ public function authenticate(EsmtpTransport $client): void
+ {
+ $client->executeCommand('AUTH XOAUTH2 '.base64_encode('user='.$client->getUsername()."\1auth=Bearer ".$client->getPassword()."\1\1")."\r\n", [235]);
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/Smtp/EsmtpTransport.php b/tools/mailer/symfony/mailer/Transport/Smtp/EsmtpTransport.php
new file mode 100644
index 000000000..f5edfe112
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/Smtp/EsmtpTransport.php
@@ -0,0 +1,228 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport\Smtp;
+
+use Psr\EventDispatcher\EventDispatcherInterface;
+use Psr\Log\LoggerInterface;
+use Symfony\Component\Mailer\Exception\TransportException;
+use Symfony\Component\Mailer\Exception\TransportExceptionInterface;
+use Symfony\Component\Mailer\Exception\UnexpectedResponseException;
+use Symfony\Component\Mailer\Transport\Smtp\Auth\AuthenticatorInterface;
+use Symfony\Component\Mailer\Transport\Smtp\Stream\AbstractStream;
+use Symfony\Component\Mailer\Transport\Smtp\Stream\SocketStream;
+
+/**
+ * Sends Emails over SMTP with ESMTP support.
+ *
+ * @author Fabien Potencier
+ * @author Chris Corbyn
+ */
+class EsmtpTransport extends SmtpTransport
+{
+ private array $authenticators = [];
+ private string $username = '';
+ private string $password = '';
+ private array $capabilities;
+
+ public function __construct(string $host = 'localhost', int $port = 0, ?bool $tls = null, ?EventDispatcherInterface $dispatcher = null, ?LoggerInterface $logger = null, ?AbstractStream $stream = null, ?array $authenticators = null)
+ {
+ parent::__construct($stream, $dispatcher, $logger);
+
+ if (null === $authenticators) {
+ // fallback to default authenticators
+ // order is important here (roughly most secure and popular first)
+ $authenticators = [
+ new Auth\CramMd5Authenticator(),
+ new Auth\LoginAuthenticator(),
+ new Auth\PlainAuthenticator(),
+ new Auth\XOAuth2Authenticator(),
+ ];
+ }
+ $this->setAuthenticators($authenticators);
+
+ /** @var SocketStream $stream */
+ $stream = $this->getStream();
+
+ if (null === $tls) {
+ if (465 === $port) {
+ $tls = true;
+ } else {
+ $tls = \defined('OPENSSL_VERSION_NUMBER') && 0 === $port && 'localhost' !== $host;
+ }
+ }
+ if (!$tls) {
+ $stream->disableTls();
+ }
+ if (0 === $port) {
+ $port = $tls ? 465 : 25;
+ }
+
+ $stream->setHost($host);
+ $stream->setPort($port);
+ }
+
+ /**
+ * @return $this
+ */
+ public function setUsername(string $username): static
+ {
+ $this->username = $username;
+
+ return $this;
+ }
+
+ public function getUsername(): string
+ {
+ return $this->username;
+ }
+
+ /**
+ * @return $this
+ */
+ public function setPassword(#[\SensitiveParameter] string $password): static
+ {
+ $this->password = $password;
+
+ return $this;
+ }
+
+ public function getPassword(): string
+ {
+ return $this->password;
+ }
+
+ public function setAuthenticators(array $authenticators): void
+ {
+ $this->authenticators = [];
+ foreach ($authenticators as $authenticator) {
+ $this->addAuthenticator($authenticator);
+ }
+ }
+
+ public function addAuthenticator(AuthenticatorInterface $authenticator): void
+ {
+ $this->authenticators[] = $authenticator;
+ }
+
+ public function executeCommand(string $command, array $codes): string
+ {
+ return [250] === $codes && str_starts_with($command, 'HELO ') ? $this->doEhloCommand() : parent::executeCommand($command, $codes);
+ }
+
+ final protected function getCapabilities(): array
+ {
+ return $this->capabilities;
+ }
+
+ private function doEhloCommand(): string
+ {
+ try {
+ $response = $this->executeCommand(sprintf("EHLO %s\r\n", $this->getLocalDomain()), [250]);
+ } catch (TransportExceptionInterface $e) {
+ try {
+ return parent::executeCommand(sprintf("HELO %s\r\n", $this->getLocalDomain()), [250]);
+ } catch (TransportExceptionInterface $ex) {
+ if (!$ex->getCode()) {
+ throw $e;
+ }
+
+ throw $ex;
+ }
+ }
+
+ $this->capabilities = $this->parseCapabilities($response);
+
+ /** @var SocketStream $stream */
+ $stream = $this->getStream();
+ // WARNING: !$stream->isTLS() is right, 100% sure :)
+ // if you think that the ! should be removed, read the code again
+ // if doing so "fixes" your issue then it probably means your SMTP server behaves incorrectly or is wrongly configured
+ if (!$stream->isTLS() && \defined('OPENSSL_VERSION_NUMBER') && \array_key_exists('STARTTLS', $this->capabilities)) {
+ $this->executeCommand("STARTTLS\r\n", [220]);
+
+ if (!$stream->startTLS()) {
+ throw new TransportException('Unable to connect with STARTTLS.');
+ }
+
+ $response = $this->executeCommand(sprintf("EHLO %s\r\n", $this->getLocalDomain()), [250]);
+ $this->capabilities = $this->parseCapabilities($response);
+ }
+
+ if (\array_key_exists('AUTH', $this->capabilities)) {
+ $this->handleAuth($this->capabilities['AUTH']);
+ }
+
+ return $response;
+ }
+
+ private function parseCapabilities(string $ehloResponse): array
+ {
+ $capabilities = [];
+ $lines = explode("\r\n", trim($ehloResponse));
+ array_shift($lines);
+ foreach ($lines as $line) {
+ if (preg_match('/^[0-9]{3}[ -]([A-Z0-9-]+)((?:[ =].*)?)$/Di', $line, $matches)) {
+ $value = strtoupper(ltrim($matches[2], ' ='));
+ $capabilities[strtoupper($matches[1])] = $value ? explode(' ', $value) : [];
+ }
+ }
+
+ return $capabilities;
+ }
+
+ private function handleAuth(array $modes): void
+ {
+ if (!$this->username) {
+ return;
+ }
+
+ $code = null;
+ $authNames = [];
+ $errors = [];
+ $modes = array_map('strtolower', $modes);
+ foreach ($this->authenticators as $authenticator) {
+ if (!\in_array(strtolower($authenticator->getAuthKeyword()), $modes, true)) {
+ continue;
+ }
+
+ $code = null;
+ $authNames[] = $authenticator->getAuthKeyword();
+ try {
+ $authenticator->authenticate($this);
+
+ return;
+ } catch (UnexpectedResponseException $e) {
+ $code = $e->getCode();
+
+ try {
+ $this->executeCommand("RSET\r\n", [250]);
+ } catch (TransportExceptionInterface) {
+ // ignore this exception as it probably means that the server error was final
+ }
+
+ // keep the error message, but tries the other authenticators
+ $errors[$authenticator->getAuthKeyword()] = $e->getMessage();
+ }
+ }
+
+ if (!$authNames) {
+ throw new TransportException(sprintf('Failed to find an authenticator supported by the SMTP server, which currently supports: "%s".', implode('", "', $modes)), $code ?: 504);
+ }
+
+ $message = sprintf('Failed to authenticate on SMTP server with username "%s" using the following authenticators: "%s".', $this->username, implode('", "', $authNames));
+ foreach ($errors as $name => $error) {
+ $message .= sprintf(' Authenticator "%s" returned "%s".', $name, $error);
+ }
+
+ throw new TransportException($message, $code ?: 535);
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/Smtp/EsmtpTransportFactory.php b/tools/mailer/symfony/mailer/Transport/Smtp/EsmtpTransportFactory.php
new file mode 100644
index 000000000..a15d12245
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/Smtp/EsmtpTransportFactory.php
@@ -0,0 +1,78 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport\Smtp;
+
+use Symfony\Component\Mailer\Transport\AbstractTransportFactory;
+use Symfony\Component\Mailer\Transport\Dsn;
+use Symfony\Component\Mailer\Transport\Smtp\Stream\SocketStream;
+use Symfony\Component\Mailer\Transport\TransportInterface;
+
+/**
+ * @author Konstantin Myakshin
+ */
+final class EsmtpTransportFactory extends AbstractTransportFactory
+{
+ public function create(Dsn $dsn): TransportInterface
+ {
+ $tls = 'smtps' === $dsn->getScheme() ? true : null;
+ $port = $dsn->getPort(0);
+ $host = $dsn->getHost();
+
+ $transport = new EsmtpTransport($host, $port, $tls, $this->dispatcher, $this->logger);
+
+ /** @var SocketStream $stream */
+ $stream = $transport->getStream();
+ $streamOptions = $stream->getStreamOptions();
+
+ if ('' !== $dsn->getOption('verify_peer') && !filter_var($dsn->getOption('verify_peer', true), \FILTER_VALIDATE_BOOL)) {
+ $streamOptions['ssl']['verify_peer'] = false;
+ $streamOptions['ssl']['verify_peer_name'] = false;
+ }
+
+ if (null !== $peerFingerprint = $dsn->getOption('peer_fingerprint')) {
+ $streamOptions['ssl']['peer_fingerprint'] = $peerFingerprint;
+ }
+
+ $stream->setStreamOptions($streamOptions);
+
+ if ($user = $dsn->getUser()) {
+ $transport->setUsername($user);
+ }
+
+ if ($password = $dsn->getPassword()) {
+ $transport->setPassword($password);
+ }
+
+ if (null !== ($localDomain = $dsn->getOption('local_domain'))) {
+ $transport->setLocalDomain($localDomain);
+ }
+
+ if (null !== ($maxPerSecond = $dsn->getOption('max_per_second'))) {
+ $transport->setMaxPerSecond((float) $maxPerSecond);
+ }
+
+ if (null !== ($restartThreshold = $dsn->getOption('restart_threshold'))) {
+ $transport->setRestartThreshold((int) $restartThreshold, (int) $dsn->getOption('restart_threshold_sleep', 0));
+ }
+
+ if (null !== ($pingThreshold = $dsn->getOption('ping_threshold'))) {
+ $transport->setPingThreshold((int) $pingThreshold);
+ }
+
+ return $transport;
+ }
+
+ protected function getSupportedSchemes(): array
+ {
+ return ['smtp', 'smtps'];
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/Smtp/SmtpTransport.php b/tools/mailer/symfony/mailer/Transport/Smtp/SmtpTransport.php
new file mode 100644
index 000000000..0de38fb2e
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/Smtp/SmtpTransport.php
@@ -0,0 +1,392 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport\Smtp;
+
+use Psr\EventDispatcher\EventDispatcherInterface;
+use Psr\Log\LoggerInterface;
+use Symfony\Component\Mailer\Envelope;
+use Symfony\Component\Mailer\Exception\LogicException;
+use Symfony\Component\Mailer\Exception\TransportException;
+use Symfony\Component\Mailer\Exception\TransportExceptionInterface;
+use Symfony\Component\Mailer\Exception\UnexpectedResponseException;
+use Symfony\Component\Mailer\SentMessage;
+use Symfony\Component\Mailer\Transport\AbstractTransport;
+use Symfony\Component\Mailer\Transport\Smtp\Stream\AbstractStream;
+use Symfony\Component\Mailer\Transport\Smtp\Stream\SocketStream;
+use Symfony\Component\Mime\RawMessage;
+
+/**
+ * Sends emails over SMTP.
+ *
+ * @author Fabien Potencier
+ * @author Chris Corbyn
+ */
+class SmtpTransport extends AbstractTransport
+{
+ private bool $started = false;
+ private int $restartThreshold = 100;
+ private int $restartThresholdSleep = 0;
+ private int $restartCounter = 0;
+ private int $pingThreshold = 100;
+ private float $lastMessageTime = 0;
+ private AbstractStream $stream;
+ private string $domain = '[127.0.0.1]';
+
+ public function __construct(?AbstractStream $stream = null, ?EventDispatcherInterface $dispatcher = null, ?LoggerInterface $logger = null)
+ {
+ parent::__construct($dispatcher, $logger);
+
+ $this->stream = $stream ?? new SocketStream();
+ }
+
+ public function getStream(): AbstractStream
+ {
+ return $this->stream;
+ }
+
+ /**
+ * Sets the maximum number of messages to send before re-starting the transport.
+ *
+ * By default, the threshold is set to 100 (and no sleep at restart).
+ *
+ * @param int $threshold The maximum number of messages (0 to disable)
+ * @param int $sleep The number of seconds to sleep between stopping and re-starting the transport
+ *
+ * @return $this
+ */
+ public function setRestartThreshold(int $threshold, int $sleep = 0): static
+ {
+ $this->restartThreshold = $threshold;
+ $this->restartThresholdSleep = $sleep;
+
+ return $this;
+ }
+
+ /**
+ * Sets the minimum number of seconds required between two messages, before the server is pinged.
+ * If the transport wants to send a message and the time since the last message exceeds the specified threshold,
+ * the transport will ping the server first (NOOP command) to check if the connection is still alive.
+ * Otherwise the message will be sent without pinging the server first.
+ *
+ * Do not set the threshold too low, as the SMTP server may drop the connection if there are too many
+ * non-mail commands (like pinging the server with NOOP).
+ *
+ * By default, the threshold is set to 100 seconds.
+ *
+ * @param int $seconds The minimum number of seconds between two messages required to ping the server
+ *
+ * @return $this
+ */
+ public function setPingThreshold(int $seconds): static
+ {
+ $this->pingThreshold = $seconds;
+
+ return $this;
+ }
+
+ /**
+ * Sets the name of the local domain that will be used in HELO.
+ *
+ * This should be a fully-qualified domain name and should be truly the domain
+ * you're using.
+ *
+ * If your server does not have a domain name, use the IP address. This will
+ * automatically be wrapped in square brackets as described in RFC 5321,
+ * section 4.1.3.
+ *
+ * @return $this
+ */
+ public function setLocalDomain(string $domain): static
+ {
+ if ('' !== $domain && '[' !== $domain[0]) {
+ if (filter_var($domain, \FILTER_VALIDATE_IP, \FILTER_FLAG_IPV4)) {
+ $domain = '['.$domain.']';
+ } elseif (filter_var($domain, \FILTER_VALIDATE_IP, \FILTER_FLAG_IPV6)) {
+ $domain = '[IPv6:'.$domain.']';
+ }
+ }
+
+ $this->domain = $domain;
+
+ return $this;
+ }
+
+ /**
+ * Gets the name of the domain that will be used in HELO.
+ *
+ * If an IP address was specified, this will be returned wrapped in square
+ * brackets as described in RFC 5321, section 4.1.3.
+ */
+ public function getLocalDomain(): string
+ {
+ return $this->domain;
+ }
+
+ public function send(RawMessage $message, ?Envelope $envelope = null): ?SentMessage
+ {
+ try {
+ $message = parent::send($message, $envelope);
+ } catch (TransportExceptionInterface $e) {
+ if ($this->started) {
+ try {
+ $this->executeCommand("RSET\r\n", [250]);
+ } catch (TransportExceptionInterface) {
+ // ignore this exception as it probably means that the server error was final
+ }
+ }
+
+ throw $e;
+ }
+
+ $this->checkRestartThreshold();
+
+ return $message;
+ }
+
+ protected function parseMessageId(string $mtaResult): string
+ {
+ $regexps = [
+ '/250 Ok (?P[0-9a-f-]+)\r?$/mis',
+ '/250 Ok:? queued as (?P[A-Z0-9]+)\r?$/mis',
+ ];
+ $matches = [];
+ foreach ($regexps as $regexp) {
+ if (preg_match($regexp, $mtaResult, $matches)) {
+ return $matches['id'];
+ }
+ }
+
+ return '';
+ }
+
+ public function __toString(): string
+ {
+ if ($this->stream instanceof SocketStream) {
+ $name = sprintf('smtp%s://%s', ($tls = $this->stream->isTLS()) ? 's' : '', $this->stream->getHost());
+ $port = $this->stream->getPort();
+ if (!(25 === $port || ($tls && 465 === $port))) {
+ $name .= ':'.$port;
+ }
+
+ return $name;
+ }
+
+ return 'smtp://sendmail';
+ }
+
+ /**
+ * Runs a command against the stream, expecting the given response codes.
+ *
+ * @param int[] $codes
+ *
+ * @throws TransportException when an invalid response if received
+ */
+ public function executeCommand(string $command, array $codes): string
+ {
+ $this->stream->write($command);
+ $response = $this->getFullResponse();
+ $this->assertResponseCode($response, $codes);
+
+ return $response;
+ }
+
+ protected function doSend(SentMessage $message): void
+ {
+ if (microtime(true) - $this->lastMessageTime > $this->pingThreshold) {
+ $this->ping();
+ }
+
+ if (!$this->started) {
+ $this->start();
+ }
+
+ try {
+ $envelope = $message->getEnvelope();
+ $this->doMailFromCommand($envelope->getSender()->getEncodedAddress());
+ foreach ($envelope->getRecipients() as $recipient) {
+ $this->doRcptToCommand($recipient->getEncodedAddress());
+ }
+
+ $this->executeCommand("DATA\r\n", [354]);
+ try {
+ foreach (AbstractStream::replace("\r\n.", "\r\n..", $message->toIterable()) as $chunk) {
+ $this->stream->write($chunk, false);
+ }
+ $this->stream->flush();
+ } catch (TransportExceptionInterface $e) {
+ throw $e;
+ } catch (\Exception $e) {
+ $this->stream->terminate();
+ $this->started = false;
+ $this->getLogger()->debug(sprintf('Email transport "%s" stopped', __CLASS__));
+ throw $e;
+ }
+ $mtaResult = $this->executeCommand("\r\n.\r\n", [250]);
+ $message->appendDebug($this->stream->getDebug());
+ $this->lastMessageTime = microtime(true);
+
+ if ($mtaResult && $messageId = $this->parseMessageId($mtaResult)) {
+ $message->setMessageId($messageId);
+ }
+ } catch (TransportExceptionInterface $e) {
+ $e->appendDebug($this->stream->getDebug());
+ $this->lastMessageTime = 0;
+ throw $e;
+ }
+ }
+
+ /**
+ * @internal since version 6.1, to be made private in 7.0
+ *
+ * @final since version 6.1, to be made private in 7.0
+ */
+ protected function doHeloCommand(): void
+ {
+ $this->executeCommand(sprintf("HELO %s\r\n", $this->domain), [250]);
+ }
+
+ private function doMailFromCommand(string $address): void
+ {
+ $this->executeCommand(sprintf("MAIL FROM:<%s>\r\n", $address), [250]);
+ }
+
+ private function doRcptToCommand(string $address): void
+ {
+ $this->executeCommand(sprintf("RCPT TO:<%s>\r\n", $address), [250, 251, 252]);
+ }
+
+ public function start(): void
+ {
+ if ($this->started) {
+ return;
+ }
+
+ $this->getLogger()->debug(sprintf('Email transport "%s" starting', __CLASS__));
+
+ $this->stream->initialize();
+ $this->assertResponseCode($this->getFullResponse(), [220]);
+ $this->doHeloCommand();
+ $this->started = true;
+ $this->lastMessageTime = 0;
+
+ $this->getLogger()->debug(sprintf('Email transport "%s" started', __CLASS__));
+ }
+
+ /**
+ * Manually disconnect from the SMTP server.
+ *
+ * In most cases this is not necessary since the disconnect happens automatically on termination.
+ * In cases of long-running scripts, this might however make sense to avoid keeping an open
+ * connection to the SMTP server in between sending emails.
+ */
+ public function stop(): void
+ {
+ if (!$this->started) {
+ return;
+ }
+
+ $this->getLogger()->debug(sprintf('Email transport "%s" stopping', __CLASS__));
+
+ try {
+ $this->executeCommand("QUIT\r\n", [221]);
+ } catch (TransportExceptionInterface) {
+ } finally {
+ $this->stream->terminate();
+ $this->started = false;
+ $this->getLogger()->debug(sprintf('Email transport "%s" stopped', __CLASS__));
+ }
+ }
+
+ private function ping(): void
+ {
+ if (!$this->started) {
+ return;
+ }
+
+ try {
+ $this->executeCommand("NOOP\r\n", [250]);
+ } catch (TransportExceptionInterface) {
+ $this->stop();
+ }
+ }
+
+ /**
+ * @throws TransportException if a response code is incorrect
+ */
+ private function assertResponseCode(string $response, array $codes): void
+ {
+ if (!$codes) {
+ throw new LogicException('You must set the expected response code.');
+ }
+
+ [$code] = sscanf($response, '%3d');
+ $valid = \in_array($code, $codes);
+
+ if (!$valid || !$response) {
+ $codeStr = $code ? sprintf('code "%s"', $code) : 'empty code';
+ $responseStr = $response ? sprintf(', with message "%s"', trim($response)) : '';
+
+ throw new UnexpectedResponseException(sprintf('Expected response code "%s" but got ', implode('/', $codes)).$codeStr.$responseStr.'.', $code ?: 0);
+ }
+ }
+
+ private function getFullResponse(): string
+ {
+ $response = '';
+ do {
+ $line = $this->stream->readLine();
+ $response .= $line;
+ } while ($line && isset($line[3]) && ' ' !== $line[3]);
+
+ return $response;
+ }
+
+ private function checkRestartThreshold(): void
+ {
+ // when using sendmail via non-interactive mode, the transport is never "started"
+ if (!$this->started) {
+ return;
+ }
+
+ ++$this->restartCounter;
+ if ($this->restartCounter < $this->restartThreshold) {
+ return;
+ }
+
+ $this->stop();
+ if (0 < $sleep = $this->restartThresholdSleep) {
+ $this->getLogger()->debug(sprintf('Email transport "%s" sleeps for %d seconds after stopping', __CLASS__, $sleep));
+
+ sleep($sleep);
+ }
+ $this->start();
+ $this->restartCounter = 0;
+ }
+
+ public function __sleep(): array
+ {
+ throw new \BadMethodCallException('Cannot serialize '.__CLASS__);
+ }
+
+ /**
+ * @return void
+ */
+ public function __wakeup()
+ {
+ throw new \BadMethodCallException('Cannot unserialize '.__CLASS__);
+ }
+
+ public function __destruct()
+ {
+ $this->stop();
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/Smtp/Stream/AbstractStream.php b/tools/mailer/symfony/mailer/Transport/Smtp/Stream/AbstractStream.php
new file mode 100644
index 000000000..498dc560c
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/Smtp/Stream/AbstractStream.php
@@ -0,0 +1,145 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport\Smtp\Stream;
+
+use Symfony\Component\Mailer\Exception\TransportException;
+
+/**
+ * A stream supporting remote sockets and local processes.
+ *
+ * @author Fabien Potencier
+ * @author Nicolas Grekas
+ * @author Chris Corbyn
+ *
+ * @internal
+ */
+abstract class AbstractStream
+{
+ /** @var resource|null */
+ protected $stream;
+ /** @var resource|null */
+ protected $in;
+ /** @var resource|null */
+ protected $out;
+ protected $err;
+
+ private string $debug = '';
+
+ public function write(string $bytes, bool $debug = true): void
+ {
+ if ($debug) {
+ foreach (explode("\n", trim($bytes)) as $line) {
+ $this->debug .= sprintf("> %s\n", $line);
+ }
+ }
+
+ $bytesToWrite = \strlen($bytes);
+ $totalBytesWritten = 0;
+ while ($totalBytesWritten < $bytesToWrite) {
+ $bytesWritten = @fwrite($this->in, substr($bytes, $totalBytesWritten));
+ if (false === $bytesWritten || 0 === $bytesWritten) {
+ throw new TransportException('Unable to write bytes on the wire.');
+ }
+
+ $totalBytesWritten += $bytesWritten;
+ }
+ }
+
+ /**
+ * Flushes the contents of the stream (empty it) and set the internal pointer to the beginning.
+ */
+ public function flush(): void
+ {
+ fflush($this->in);
+ }
+
+ /**
+ * Performs any initialization needed.
+ */
+ abstract public function initialize(): void;
+
+ public function terminate(): void
+ {
+ $this->stream = $this->err = $this->out = $this->in = null;
+ }
+
+ public function readLine(): string
+ {
+ if (feof($this->out)) {
+ return '';
+ }
+
+ $line = @fgets($this->out);
+ if ('' === $line || false === $line) {
+ $metas = stream_get_meta_data($this->out);
+ if ($metas['timed_out']) {
+ throw new TransportException(sprintf('Connection to "%s" timed out.', $this->getReadConnectionDescription()));
+ }
+ if ($metas['eof']) {
+ throw new TransportException(sprintf('Connection to "%s" has been closed unexpectedly.', $this->getReadConnectionDescription()));
+ }
+ if (false === $line) {
+ throw new TransportException(sprintf('Unable to read from connection to "%s": ', $this->getReadConnectionDescription()).error_get_last()['message']);
+ }
+ }
+
+ $this->debug .= sprintf('< %s', $line);
+
+ return $line;
+ }
+
+ public function getDebug(): string
+ {
+ $debug = $this->debug;
+ $this->debug = '';
+
+ return $debug;
+ }
+
+ public static function replace(string $from, string $to, iterable $chunks): \Generator
+ {
+ if ('' === $from) {
+ yield from $chunks;
+
+ return;
+ }
+
+ $carry = '';
+ $fromLen = \strlen($from);
+
+ foreach ($chunks as $chunk) {
+ if ('' === $chunk = $carry.$chunk) {
+ continue;
+ }
+
+ if (str_contains($chunk, $from)) {
+ $chunk = explode($from, $chunk);
+ $carry = array_pop($chunk);
+
+ yield implode($to, $chunk).$to;
+ } else {
+ $carry = $chunk;
+ }
+
+ if (\strlen($carry) > $fromLen) {
+ yield substr($carry, 0, -$fromLen);
+ $carry = substr($carry, -$fromLen);
+ }
+ }
+
+ if ('' !== $carry) {
+ yield $carry;
+ }
+ }
+
+ abstract protected function getReadConnectionDescription(): string;
+}
diff --git a/tools/mailer/symfony/mailer/Transport/Smtp/Stream/ProcessStream.php b/tools/mailer/symfony/mailer/Transport/Smtp/Stream/ProcessStream.php
new file mode 100644
index 000000000..e63514709
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/Smtp/Stream/ProcessStream.php
@@ -0,0 +1,81 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport\Smtp\Stream;
+
+use Symfony\Component\Mailer\Exception\TransportException;
+
+/**
+ * A stream supporting local processes.
+ *
+ * @author Fabien Potencier
+ * @author Chris Corbyn
+ *
+ * @internal
+ */
+final class ProcessStream extends AbstractStream
+{
+ private string $command;
+ private bool $interactive = false;
+
+ public function setCommand(string $command): void
+ {
+ $this->command = $command;
+ }
+
+ public function setInteractive(bool $interactive): void
+ {
+ $this->interactive = $interactive;
+ }
+
+ public function initialize(): void
+ {
+ $descriptorSpec = [
+ 0 => ['pipe', 'r'],
+ 1 => ['pipe', 'w'],
+ 2 => ['pipe', '\\' === \DIRECTORY_SEPARATOR ? 'a' : 'w'],
+ ];
+ $pipes = [];
+ $this->stream = proc_open($this->command, $descriptorSpec, $pipes);
+ stream_set_blocking($pipes[2], false);
+ if ($err = stream_get_contents($pipes[2])) {
+ throw new TransportException('Process could not be started: '.$err);
+ }
+ $this->in = &$pipes[0];
+ $this->out = &$pipes[1];
+ $this->err = &$pipes[2];
+ }
+
+ public function terminate(): void
+ {
+ if (null !== $this->stream) {
+ fclose($this->in);
+ $out = stream_get_contents($this->out);
+ fclose($this->out);
+ $err = stream_get_contents($this->err);
+ fclose($this->err);
+ if (0 !== $exitCode = proc_close($this->stream)) {
+ $errorMessage = 'Process failed with exit code '.$exitCode.': '.$out.$err;
+ }
+ }
+
+ parent::terminate();
+
+ if (!$this->interactive && isset($errorMessage)) {
+ throw new TransportException($errorMessage);
+ }
+ }
+
+ protected function getReadConnectionDescription(): string
+ {
+ return 'process '.$this->command;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/Smtp/Stream/SocketStream.php b/tools/mailer/symfony/mailer/Transport/Smtp/Stream/SocketStream.php
new file mode 100644
index 000000000..49e6ea499
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/Smtp/Stream/SocketStream.php
@@ -0,0 +1,193 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport\Smtp\Stream;
+
+use Symfony\Component\Mailer\Exception\TransportException;
+
+/**
+ * A stream supporting remote sockets.
+ *
+ * @author Fabien Potencier
+ * @author Chris Corbyn
+ *
+ * @internal
+ */
+final class SocketStream extends AbstractStream
+{
+ private string $url;
+ private string $host = 'localhost';
+ private int $port = 465;
+ private float $timeout;
+ private bool $tls = true;
+ private ?string $sourceIp = null;
+ private array $streamContextOptions = [];
+
+ /**
+ * @return $this
+ */
+ public function setTimeout(float $timeout): static
+ {
+ $this->timeout = $timeout;
+
+ return $this;
+ }
+
+ public function getTimeout(): float
+ {
+ return $this->timeout ?? (float) \ini_get('default_socket_timeout');
+ }
+
+ /**
+ * Literal IPv6 addresses should be wrapped in square brackets.
+ *
+ * @return $this
+ */
+ public function setHost(string $host): static
+ {
+ $this->host = $host;
+
+ return $this;
+ }
+
+ public function getHost(): string
+ {
+ return $this->host;
+ }
+
+ /**
+ * @return $this
+ */
+ public function setPort(int $port): static
+ {
+ $this->port = $port;
+
+ return $this;
+ }
+
+ public function getPort(): int
+ {
+ return $this->port;
+ }
+
+ /**
+ * Sets the TLS/SSL on the socket (disables STARTTLS).
+ *
+ * @return $this
+ */
+ public function disableTls(): static
+ {
+ $this->tls = false;
+
+ return $this;
+ }
+
+ public function isTLS(): bool
+ {
+ return $this->tls;
+ }
+
+ /**
+ * @return $this
+ */
+ public function setStreamOptions(array $options): static
+ {
+ $this->streamContextOptions = $options;
+
+ return $this;
+ }
+
+ public function getStreamOptions(): array
+ {
+ return $this->streamContextOptions;
+ }
+
+ /**
+ * Sets the source IP.
+ *
+ * IPv6 addresses should be wrapped in square brackets.
+ *
+ * @return $this
+ */
+ public function setSourceIp(string $ip): static
+ {
+ $this->sourceIp = $ip;
+
+ return $this;
+ }
+
+ /**
+ * Returns the IP used to connect to the destination.
+ */
+ public function getSourceIp(): ?string
+ {
+ return $this->sourceIp;
+ }
+
+ public function initialize(): void
+ {
+ $this->url = $this->host.':'.$this->port;
+ if ($this->tls) {
+ $this->url = 'ssl://'.$this->url;
+ }
+ $options = [];
+ if ($this->sourceIp) {
+ $options['socket']['bindto'] = $this->sourceIp.':0';
+ }
+ if ($this->streamContextOptions) {
+ $options = array_merge($options, $this->streamContextOptions);
+ }
+ // do it unconditionally as it will be used by STARTTLS as well if supported
+ $options['ssl']['crypto_method'] ??= \STREAM_CRYPTO_METHOD_TLS_CLIENT | \STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT | \STREAM_CRYPTO_METHOD_TLSv1_1_CLIENT;
+ $streamContext = stream_context_create($options);
+
+ $timeout = $this->getTimeout();
+ set_error_handler(function ($type, $msg) {
+ throw new TransportException(sprintf('Connection could not be established with host "%s": ', $this->url).$msg);
+ });
+ try {
+ $this->stream = stream_socket_client($this->url, $errno, $errstr, $timeout, \STREAM_CLIENT_CONNECT, $streamContext);
+ } finally {
+ restore_error_handler();
+ }
+
+ stream_set_blocking($this->stream, true);
+ stream_set_timeout($this->stream, (int) $timeout, (int) (($timeout - (int) $timeout) * 1000000));
+ $this->in = &$this->stream;
+ $this->out = &$this->stream;
+ }
+
+ public function startTLS(): bool
+ {
+ set_error_handler(function ($type, $msg) {
+ throw new TransportException('Unable to connect with STARTTLS: '.$msg);
+ });
+ try {
+ return stream_socket_enable_crypto($this->stream, true);
+ } finally {
+ restore_error_handler();
+ }
+ }
+
+ public function terminate(): void
+ {
+ if (null !== $this->stream) {
+ fclose($this->stream);
+ }
+
+ parent::terminate();
+ }
+
+ protected function getReadConnectionDescription(): string
+ {
+ return $this->url;
+ }
+}
diff --git a/tools/mailer/symfony/mailer/Transport/TransportFactoryInterface.php b/tools/mailer/symfony/mailer/Transport/TransportFactoryInterface.php
new file mode 100644
index 000000000..9785ae81a
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/TransportFactoryInterface.php
@@ -0,0 +1,29 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+use Symfony\Component\Mailer\Exception\IncompleteDsnException;
+use Symfony\Component\Mailer\Exception\UnsupportedSchemeException;
+
+/**
+ * @author Konstantin Myakshin
+ */
+interface TransportFactoryInterface
+{
+ /**
+ * @throws UnsupportedSchemeException
+ * @throws IncompleteDsnException
+ */
+ public function create(Dsn $dsn): TransportInterface;
+
+ public function supports(Dsn $dsn): bool;
+}
diff --git a/tools/mailer/symfony/mailer/Transport/TransportInterface.php b/tools/mailer/symfony/mailer/Transport/TransportInterface.php
new file mode 100644
index 000000000..01570cab4
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/TransportInterface.php
@@ -0,0 +1,33 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+use Symfony\Component\Mailer\Envelope;
+use Symfony\Component\Mailer\Exception\TransportExceptionInterface;
+use Symfony\Component\Mailer\SentMessage;
+use Symfony\Component\Mime\RawMessage;
+
+/**
+ * Interface for all mailer transports.
+ *
+ * When sending emails, you should prefer MailerInterface implementations
+ * as they allow asynchronous sending.
+ *
+ * @author Fabien Potencier
+ */
+interface TransportInterface extends \Stringable
+{
+ /**
+ * @throws TransportExceptionInterface
+ */
+ public function send(RawMessage $message, ?Envelope $envelope = null): ?SentMessage;
+}
diff --git a/tools/mailer/symfony/mailer/Transport/Transports.php b/tools/mailer/symfony/mailer/Transport/Transports.php
new file mode 100644
index 000000000..f02b9bc9b
--- /dev/null
+++ b/tools/mailer/symfony/mailer/Transport/Transports.php
@@ -0,0 +1,75 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Transport;
+
+use Symfony\Component\Mailer\Envelope;
+use Symfony\Component\Mailer\Exception\InvalidArgumentException;
+use Symfony\Component\Mailer\Exception\LogicException;
+use Symfony\Component\Mailer\SentMessage;
+use Symfony\Component\Mime\Message;
+use Symfony\Component\Mime\RawMessage;
+
+/**
+ * @author Fabien Potencier
+ */
+final class Transports implements TransportInterface
+{
+ /**
+ * @var array
+ */
+ private array $transports = [];
+ private TransportInterface $default;
+
+ /**
+ * @param iterable $transports
+ */
+ public function __construct(iterable $transports)
+ {
+ foreach ($transports as $name => $transport) {
+ $this->default ??= $transport;
+ $this->transports[$name] = $transport;
+ }
+
+ if (!$this->transports) {
+ throw new LogicException(sprintf('"%s" must have at least one transport configured.', __CLASS__));
+ }
+ }
+
+ public function send(RawMessage $message, ?Envelope $envelope = null): ?SentMessage
+ {
+ /** @var Message $message */
+ if (RawMessage::class === $message::class || !$message->getHeaders()->has('X-Transport')) {
+ return $this->default->send($message, $envelope);
+ }
+
+ $headers = $message->getHeaders();
+ $transport = $headers->get('X-Transport')->getBody();
+ $headers->remove('X-Transport');
+
+ if (!isset($this->transports[$transport])) {
+ throw new InvalidArgumentException(sprintf('The "%s" transport does not exist (available transports: "%s").', $transport, implode('", "', array_keys($this->transports))));
+ }
+
+ try {
+ return $this->transports[$transport]->send($message, $envelope);
+ } catch (\Throwable $e) {
+ $headers->addTextHeader('X-Transport', $transport);
+
+ throw $e;
+ }
+ }
+
+ public function __toString(): string
+ {
+ return '['.implode(',', array_keys($this->transports)).']';
+ }
+}
diff --git a/tools/mailer/symfony/mailer/composer.json b/tools/mailer/symfony/mailer/composer.json
new file mode 100644
index 000000000..28dcb9196
--- /dev/null
+++ b/tools/mailer/symfony/mailer/composer.json
@@ -0,0 +1,47 @@
+{
+ "name": "symfony/mailer",
+ "type": "library",
+ "description": "Helps sending emails",
+ "keywords": [],
+ "homepage": "https://symfony.com",
+ "license": "MIT",
+ "authors": [
+ {
+ "name": "Fabien Potencier",
+ "email": "fabien@symfony.com"
+ },
+ {
+ "name": "Symfony Community",
+ "homepage": "https://symfony.com/contributors"
+ }
+ ],
+ "require": {
+ "php": ">=8.1",
+ "egulias/email-validator": "^2.1.10|^3|^4",
+ "psr/event-dispatcher": "^1",
+ "psr/log": "^1|^2|^3",
+ "symfony/event-dispatcher": "^5.4|^6.0|^7.0",
+ "symfony/mime": "^6.2|^7.0",
+ "symfony/service-contracts": "^2.5|^3"
+ },
+ "require-dev": {
+ "symfony/console": "^5.4|^6.0|^7.0",
+ "symfony/http-client": "^5.4|^6.0|^7.0",
+ "symfony/messenger": "^6.2|^7.0",
+ "symfony/twig-bridge": "^6.2|^7.0"
+ },
+ "conflict": {
+ "symfony/http-client-contracts": "<2.5",
+ "symfony/http-kernel": "<5.4",
+ "symfony/messenger": "<6.2",
+ "symfony/mime": "<6.2",
+ "symfony/twig-bridge": "<6.2.1"
+ },
+ "autoload": {
+ "psr-4": { "Symfony\\Component\\Mailer\\": "" },
+ "exclude-from-classmap": [
+ "/Tests/"
+ ]
+ },
+ "minimum-stability": "dev"
+}
diff --git a/tools/mailer/symfony/mime/Address.php b/tools/mailer/symfony/mime/Address.php
new file mode 100644
index 000000000..ce57f77ee
--- /dev/null
+++ b/tools/mailer/symfony/mime/Address.php
@@ -0,0 +1,120 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime;
+
+use Egulias\EmailValidator\EmailValidator;
+use Egulias\EmailValidator\Validation\MessageIDValidation;
+use Egulias\EmailValidator\Validation\RFCValidation;
+use Symfony\Component\Mime\Encoder\IdnAddressEncoder;
+use Symfony\Component\Mime\Exception\InvalidArgumentException;
+use Symfony\Component\Mime\Exception\LogicException;
+use Symfony\Component\Mime\Exception\RfcComplianceException;
+
+/**
+ * @author Fabien Potencier
+ */
+final class Address
+{
+ /**
+ * A regex that matches a structure like 'Name '.
+ * It matches anything between the first < and last > as email address.
+ * This allows to use a single string to construct an Address, which can be convenient to use in
+ * config, and allows to have more readable config.
+ * This does not try to cover all edge cases for address.
+ */
+ private const FROM_STRING_PATTERN = '~(?[^<]*)<(?.*)>[^>]*~';
+
+ private static EmailValidator $validator;
+ private static IdnAddressEncoder $encoder;
+
+ private string $address;
+ private string $name;
+
+ public function __construct(string $address, string $name = '')
+ {
+ if (!class_exists(EmailValidator::class)) {
+ throw new LogicException(sprintf('The "%s" class cannot be used as it needs "%s". Try running "composer require egulias/email-validator".', __CLASS__, EmailValidator::class));
+ }
+
+ self::$validator ??= new EmailValidator();
+
+ $this->address = trim($address);
+ $this->name = trim(str_replace(["\n", "\r"], '', $name));
+
+ if (!self::$validator->isValid($this->address, class_exists(MessageIDValidation::class) ? new MessageIDValidation() : new RFCValidation())) {
+ throw new RfcComplianceException(sprintf('Email "%s" does not comply with addr-spec of RFC 2822.', $address));
+ }
+ }
+
+ public function getAddress(): string
+ {
+ return $this->address;
+ }
+
+ public function getName(): string
+ {
+ return $this->name;
+ }
+
+ public function getEncodedAddress(): string
+ {
+ self::$encoder ??= new IdnAddressEncoder();
+
+ return self::$encoder->encodeString($this->address);
+ }
+
+ public function toString(): string
+ {
+ return ($n = $this->getEncodedName()) ? $n.' <'.$this->getEncodedAddress().'>' : $this->getEncodedAddress();
+ }
+
+ public function getEncodedName(): string
+ {
+ if ('' === $this->getName()) {
+ return '';
+ }
+
+ return sprintf('"%s"', preg_replace('/"/u', '\"', $this->getName()));
+ }
+
+ public static function create(self|string $address): self
+ {
+ if ($address instanceof self) {
+ return $address;
+ }
+
+ if (!str_contains($address, '<')) {
+ return new self($address);
+ }
+
+ if (!preg_match(self::FROM_STRING_PATTERN, $address, $matches)) {
+ throw new InvalidArgumentException(sprintf('Could not parse "%s" to a "%s" instance.', $address, self::class));
+ }
+
+ return new self($matches['addrSpec'], trim($matches['displayName'], ' \'"'));
+ }
+
+ /**
+ * @param array $addresses
+ *
+ * @return Address[]
+ */
+ public static function createArray(array $addresses): array
+ {
+ $addrs = [];
+ foreach ($addresses as $address) {
+ $addrs[] = self::create($address);
+ }
+
+ return $addrs;
+ }
+}
diff --git a/tools/mailer/symfony/mime/BodyRendererInterface.php b/tools/mailer/symfony/mime/BodyRendererInterface.php
new file mode 100644
index 000000000..d69217265
--- /dev/null
+++ b/tools/mailer/symfony/mime/BodyRendererInterface.php
@@ -0,0 +1,20 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime;
+
+/**
+ * @author Fabien Potencier
+ */
+interface BodyRendererInterface
+{
+ public function render(Message $message): void;
+}
diff --git a/tools/mailer/symfony/mime/CHANGELOG.md b/tools/mailer/symfony/mime/CHANGELOG.md
new file mode 100644
index 000000000..8d593e6ff
--- /dev/null
+++ b/tools/mailer/symfony/mime/CHANGELOG.md
@@ -0,0 +1,57 @@
+CHANGELOG
+=========
+
+7.0
+---
+
+ * Remove `Email::attachPart()`, use `Email::addPart()` instead
+ * Argument `$body` is now required (at least null) in `Message::setBody()`
+ * Require explicit argument when calling `Message::setBody()`
+
+6.3
+---
+
+ * Support detection of related parts if `Content-Id` is used instead of the name
+ * Add `TextPart::getDisposition()`
+
+6.2
+---
+
+ * Add `File`
+ * Deprecate `Email::attachPart()`, use `addPart()` instead
+ * Deprecate calling `Message::setBody()` without arguments
+
+6.1
+---
+
+ * Add `DataPart::getFilename()` and `DataPart::getContentType()`
+
+6.0
+---
+
+ * Remove `Address::fromString()`, use `Address::create()` instead
+ * Remove `Serializable` interface from `RawMessage`
+
+5.2.0
+-----
+
+ * Add support for DKIM
+ * Deprecated `Address::fromString()`, use `Address::create()` instead
+
+4.4.0
+-----
+
+ * [BC BREAK] Removed `NamedAddress` (`Address` now supports a name)
+ * Added PHPUnit constraints
+ * Added `AbstractPart::asDebugString()`
+ * Added `Address::fromString()`
+
+4.3.3
+-----
+
+ * [BC BREAK] Renamed method `Headers::getAll()` to `Headers::all()`.
+
+4.3.0
+-----
+
+ * Introduced the component as experimental
diff --git a/tools/mailer/symfony/mime/CharacterStream.php b/tools/mailer/symfony/mime/CharacterStream.php
new file mode 100644
index 000000000..572cf820b
--- /dev/null
+++ b/tools/mailer/symfony/mime/CharacterStream.php
@@ -0,0 +1,211 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime;
+
+/**
+ * @author Fabien Potencier
+ * @author Xavier De Cock
+ *
+ * @internal
+ */
+final class CharacterStream
+{
+ /** Pre-computed for optimization */
+ private const UTF8_LENGTH_MAP = [
+ "\x00" => 1, "\x01" => 1, "\x02" => 1, "\x03" => 1, "\x04" => 1, "\x05" => 1, "\x06" => 1, "\x07" => 1,
+ "\x08" => 1, "\x09" => 1, "\x0a" => 1, "\x0b" => 1, "\x0c" => 1, "\x0d" => 1, "\x0e" => 1, "\x0f" => 1,
+ "\x10" => 1, "\x11" => 1, "\x12" => 1, "\x13" => 1, "\x14" => 1, "\x15" => 1, "\x16" => 1, "\x17" => 1,
+ "\x18" => 1, "\x19" => 1, "\x1a" => 1, "\x1b" => 1, "\x1c" => 1, "\x1d" => 1, "\x1e" => 1, "\x1f" => 1,
+ "\x20" => 1, "\x21" => 1, "\x22" => 1, "\x23" => 1, "\x24" => 1, "\x25" => 1, "\x26" => 1, "\x27" => 1,
+ "\x28" => 1, "\x29" => 1, "\x2a" => 1, "\x2b" => 1, "\x2c" => 1, "\x2d" => 1, "\x2e" => 1, "\x2f" => 1,
+ "\x30" => 1, "\x31" => 1, "\x32" => 1, "\x33" => 1, "\x34" => 1, "\x35" => 1, "\x36" => 1, "\x37" => 1,
+ "\x38" => 1, "\x39" => 1, "\x3a" => 1, "\x3b" => 1, "\x3c" => 1, "\x3d" => 1, "\x3e" => 1, "\x3f" => 1,
+ "\x40" => 1, "\x41" => 1, "\x42" => 1, "\x43" => 1, "\x44" => 1, "\x45" => 1, "\x46" => 1, "\x47" => 1,
+ "\x48" => 1, "\x49" => 1, "\x4a" => 1, "\x4b" => 1, "\x4c" => 1, "\x4d" => 1, "\x4e" => 1, "\x4f" => 1,
+ "\x50" => 1, "\x51" => 1, "\x52" => 1, "\x53" => 1, "\x54" => 1, "\x55" => 1, "\x56" => 1, "\x57" => 1,
+ "\x58" => 1, "\x59" => 1, "\x5a" => 1, "\x5b" => 1, "\x5c" => 1, "\x5d" => 1, "\x5e" => 1, "\x5f" => 1,
+ "\x60" => 1, "\x61" => 1, "\x62" => 1, "\x63" => 1, "\x64" => 1, "\x65" => 1, "\x66" => 1, "\x67" => 1,
+ "\x68" => 1, "\x69" => 1, "\x6a" => 1, "\x6b" => 1, "\x6c" => 1, "\x6d" => 1, "\x6e" => 1, "\x6f" => 1,
+ "\x70" => 1, "\x71" => 1, "\x72" => 1, "\x73" => 1, "\x74" => 1, "\x75" => 1, "\x76" => 1, "\x77" => 1,
+ "\x78" => 1, "\x79" => 1, "\x7a" => 1, "\x7b" => 1, "\x7c" => 1, "\x7d" => 1, "\x7e" => 1, "\x7f" => 1,
+ "\x80" => 0, "\x81" => 0, "\x82" => 0, "\x83" => 0, "\x84" => 0, "\x85" => 0, "\x86" => 0, "\x87" => 0,
+ "\x88" => 0, "\x89" => 0, "\x8a" => 0, "\x8b" => 0, "\x8c" => 0, "\x8d" => 0, "\x8e" => 0, "\x8f" => 0,
+ "\x90" => 0, "\x91" => 0, "\x92" => 0, "\x93" => 0, "\x94" => 0, "\x95" => 0, "\x96" => 0, "\x97" => 0,
+ "\x98" => 0, "\x99" => 0, "\x9a" => 0, "\x9b" => 0, "\x9c" => 0, "\x9d" => 0, "\x9e" => 0, "\x9f" => 0,
+ "\xa0" => 0, "\xa1" => 0, "\xa2" => 0, "\xa3" => 0, "\xa4" => 0, "\xa5" => 0, "\xa6" => 0, "\xa7" => 0,
+ "\xa8" => 0, "\xa9" => 0, "\xaa" => 0, "\xab" => 0, "\xac" => 0, "\xad" => 0, "\xae" => 0, "\xaf" => 0,
+ "\xb0" => 0, "\xb1" => 0, "\xb2" => 0, "\xb3" => 0, "\xb4" => 0, "\xb5" => 0, "\xb6" => 0, "\xb7" => 0,
+ "\xb8" => 0, "\xb9" => 0, "\xba" => 0, "\xbb" => 0, "\xbc" => 0, "\xbd" => 0, "\xbe" => 0, "\xbf" => 0,
+ "\xc0" => 2, "\xc1" => 2, "\xc2" => 2, "\xc3" => 2, "\xc4" => 2, "\xc5" => 2, "\xc6" => 2, "\xc7" => 2,
+ "\xc8" => 2, "\xc9" => 2, "\xca" => 2, "\xcb" => 2, "\xcc" => 2, "\xcd" => 2, "\xce" => 2, "\xcf" => 2,
+ "\xd0" => 2, "\xd1" => 2, "\xd2" => 2, "\xd3" => 2, "\xd4" => 2, "\xd5" => 2, "\xd6" => 2, "\xd7" => 2,
+ "\xd8" => 2, "\xd9" => 2, "\xda" => 2, "\xdb" => 2, "\xdc" => 2, "\xdd" => 2, "\xde" => 2, "\xdf" => 2,
+ "\xe0" => 3, "\xe1" => 3, "\xe2" => 3, "\xe3" => 3, "\xe4" => 3, "\xe5" => 3, "\xe6" => 3, "\xe7" => 3,
+ "\xe8" => 3, "\xe9" => 3, "\xea" => 3, "\xeb" => 3, "\xec" => 3, "\xed" => 3, "\xee" => 3, "\xef" => 3,
+ "\xf0" => 4, "\xf1" => 4, "\xf2" => 4, "\xf3" => 4, "\xf4" => 4, "\xf5" => 4, "\xf6" => 4, "\xf7" => 4,
+ "\xf8" => 5, "\xf9" => 5, "\xfa" => 5, "\xfb" => 5, "\xfc" => 6, "\xfd" => 6, "\xfe" => 0, "\xff" => 0,
+ ];
+
+ private string $data = '';
+ private int $dataSize = 0;
+ private array $map = [];
+ private int $charCount = 0;
+ private int $currentPos = 0;
+ private int $fixedWidth = 0;
+
+ /**
+ * @param resource|string $input
+ */
+ public function __construct($input, ?string $charset = 'utf-8')
+ {
+ $charset = strtolower(trim($charset)) ?: 'utf-8';
+ if ('utf-8' === $charset || 'utf8' === $charset) {
+ $this->fixedWidth = 0;
+ $this->map = ['p' => [], 'i' => []];
+ } else {
+ $this->fixedWidth = match ($charset) {
+ // 16 bits
+ 'ucs2',
+ 'ucs-2',
+ 'utf16',
+ 'utf-16' => 2,
+ // 32 bits
+ 'ucs4',
+ 'ucs-4',
+ 'utf32',
+ 'utf-32' => 4,
+ // 7-8 bit charsets: (us-)?ascii, (iso|iec)-?8859-?[0-9]+, windows-?125[0-9], cp-?[0-9]+, ansi, macintosh,
+ // koi-?7, koi-?8-?.+, mik, (cork|t1), v?iscii
+ // and fallback
+ default => 1,
+ };
+ }
+ if (\is_resource($input)) {
+ $blocks = 16372;
+ while (false !== $read = fread($input, $blocks)) {
+ $this->write($read);
+ }
+ } else {
+ $this->write($input);
+ }
+ }
+
+ public function read(int $length): ?string
+ {
+ if ($this->currentPos >= $this->charCount) {
+ return null;
+ }
+ $length = ($this->currentPos + $length > $this->charCount) ? $this->charCount - $this->currentPos : $length;
+ if ($this->fixedWidth > 0) {
+ $len = $length * $this->fixedWidth;
+ $ret = substr($this->data, $this->currentPos * $this->fixedWidth, $len);
+ $this->currentPos += $length;
+ } else {
+ $end = $this->currentPos + $length;
+ $end = min($end, $this->charCount);
+ $ret = '';
+ $start = 0;
+ if ($this->currentPos > 0) {
+ $start = $this->map['p'][$this->currentPos - 1];
+ }
+ $to = $start;
+ for (; $this->currentPos < $end; ++$this->currentPos) {
+ if (isset($this->map['i'][$this->currentPos])) {
+ $ret .= substr($this->data, $start, $to - $start).'?';
+ $start = $this->map['p'][$this->currentPos];
+ } else {
+ $to = $this->map['p'][$this->currentPos];
+ }
+ }
+ $ret .= substr($this->data, $start, $to - $start);
+ }
+
+ return $ret;
+ }
+
+ public function readBytes(int $length): ?array
+ {
+ if (null !== $read = $this->read($length)) {
+ return array_map('ord', str_split($read, 1));
+ }
+
+ return null;
+ }
+
+ public function setPointer(int $charOffset): void
+ {
+ if ($this->charCount < $charOffset) {
+ $charOffset = $this->charCount;
+ }
+ $this->currentPos = $charOffset;
+ }
+
+ public function write(string $chars): void
+ {
+ $ignored = '';
+ $this->data .= $chars;
+ if ($this->fixedWidth > 0) {
+ $strlen = \strlen($chars);
+ $ignoredL = $strlen % $this->fixedWidth;
+ $ignored = $ignoredL ? substr($chars, -$ignoredL) : '';
+ $this->charCount += ($strlen - $ignoredL) / $this->fixedWidth;
+ } else {
+ $this->charCount += $this->getUtf8CharPositions($chars, $this->dataSize, $ignored);
+ }
+ $this->dataSize = \strlen($this->data) - \strlen($ignored);
+ }
+
+ private function getUtf8CharPositions(string $string, int $startOffset, string &$ignoredChars): int
+ {
+ $strlen = \strlen($string);
+ $charPos = \count($this->map['p']);
+ $foundChars = 0;
+ $invalid = false;
+ for ($i = 0; $i < $strlen; ++$i) {
+ $char = $string[$i];
+ $size = self::UTF8_LENGTH_MAP[$char];
+ if (0 == $size) {
+ /* char is invalid, we must wait for a resync */
+ $invalid = true;
+ continue;
+ }
+
+ if ($invalid) {
+ /* We mark the chars as invalid and start a new char */
+ $this->map['p'][$charPos + $foundChars] = $startOffset + $i;
+ $this->map['i'][$charPos + $foundChars] = true;
+ ++$foundChars;
+ $invalid = false;
+ }
+ if (($i + $size) > $strlen) {
+ $ignoredChars = substr($string, $i);
+ break;
+ }
+ for ($j = 1; $j < $size; ++$j) {
+ $char = $string[$i + $j];
+ if ($char > "\x7F" && $char < "\xC0") {
+ // Valid - continue parsing
+ } else {
+ /* char is invalid, we must wait for a resync */
+ $invalid = true;
+ continue 2;
+ }
+ }
+ /* Ok we got a complete char here */
+ $this->map['p'][$charPos + $foundChars] = $startOffset + $i + $size;
+ $i += $j - 1;
+ ++$foundChars;
+ }
+
+ return $foundChars;
+ }
+}
diff --git a/tools/mailer/symfony/mime/Crypto/DkimOptions.php b/tools/mailer/symfony/mime/Crypto/DkimOptions.php
new file mode 100644
index 000000000..cee4e7cb8
--- /dev/null
+++ b/tools/mailer/symfony/mime/Crypto/DkimOptions.php
@@ -0,0 +1,97 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Crypto;
+
+/**
+ * A helper providing autocompletion for available DkimSigner options.
+ *
+ * @author Fabien Potencier
+ */
+final class DkimOptions
+{
+ private array $options = [];
+
+ public function toArray(): array
+ {
+ return $this->options;
+ }
+
+ /**
+ * @return $this
+ */
+ public function algorithm(string $algo): static
+ {
+ $this->options['algorithm'] = $algo;
+
+ return $this;
+ }
+
+ /**
+ * @return $this
+ */
+ public function signatureExpirationDelay(int $show): static
+ {
+ $this->options['signature_expiration_delay'] = $show;
+
+ return $this;
+ }
+
+ /**
+ * @return $this
+ */
+ public function bodyMaxLength(int $max): static
+ {
+ $this->options['body_max_length'] = $max;
+
+ return $this;
+ }
+
+ /**
+ * @return $this
+ */
+ public function bodyShowLength(bool $show): static
+ {
+ $this->options['body_show_length'] = $show;
+
+ return $this;
+ }
+
+ /**
+ * @return $this
+ */
+ public function headerCanon(string $canon): static
+ {
+ $this->options['header_canon'] = $canon;
+
+ return $this;
+ }
+
+ /**
+ * @return $this
+ */
+ public function bodyCanon(string $canon): static
+ {
+ $this->options['body_canon'] = $canon;
+
+ return $this;
+ }
+
+ /**
+ * @return $this
+ */
+ public function headersToIgnore(array $headers): static
+ {
+ $this->options['headers_to_ignore'] = $headers;
+
+ return $this;
+ }
+}
diff --git a/tools/mailer/symfony/mime/Crypto/DkimSigner.php b/tools/mailer/symfony/mime/Crypto/DkimSigner.php
new file mode 100644
index 000000000..93a59b4f5
--- /dev/null
+++ b/tools/mailer/symfony/mime/Crypto/DkimSigner.php
@@ -0,0 +1,217 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Crypto;
+
+use Symfony\Component\Mime\Exception\InvalidArgumentException;
+use Symfony\Component\Mime\Exception\RuntimeException;
+use Symfony\Component\Mime\Header\UnstructuredHeader;
+use Symfony\Component\Mime\Message;
+use Symfony\Component\Mime\Part\AbstractPart;
+
+/**
+ * @author Fabien Potencier
+ *
+ * RFC 6376 and 8301
+ */
+final class DkimSigner
+{
+ public const CANON_SIMPLE = 'simple';
+ public const CANON_RELAXED = 'relaxed';
+
+ public const ALGO_SHA256 = 'rsa-sha256';
+ public const ALGO_ED25519 = 'ed25519-sha256'; // RFC 8463
+
+ private \OpenSSLAsymmetricKey $key;
+
+ /**
+ * @param string $pk The private key as a string or the path to the file containing the private key, should be prefixed with file:// (in PEM format)
+ * @param string $passphrase A passphrase of the private key (if any)
+ */
+ public function __construct(
+ string $pk,
+ private string $domainName,
+ private string $selector,
+ private array $defaultOptions = [],
+ string $passphrase = '',
+ ) {
+ if (!\extension_loaded('openssl')) {
+ throw new \LogicException('PHP extension "openssl" is required to use DKIM.');
+ }
+ $this->key = openssl_pkey_get_private($pk, $passphrase) ?: throw new InvalidArgumentException('Unable to load DKIM private key: '.openssl_error_string());
+ $this->defaultOptions += [
+ 'algorithm' => self::ALGO_SHA256,
+ 'signature_expiration_delay' => 0,
+ 'body_max_length' => \PHP_INT_MAX,
+ 'body_show_length' => false,
+ 'header_canon' => self::CANON_RELAXED,
+ 'body_canon' => self::CANON_RELAXED,
+ 'headers_to_ignore' => [],
+ ];
+ }
+
+ public function sign(Message $message, array $options = []): Message
+ {
+ $options += $this->defaultOptions;
+ if (!\in_array($options['algorithm'], [self::ALGO_SHA256, self::ALGO_ED25519], true)) {
+ throw new InvalidArgumentException(sprintf('Invalid DKIM signing algorithm "%s".', $options['algorithm']));
+ }
+ $headersToIgnore['return-path'] = true;
+ $headersToIgnore['x-transport'] = true;
+ foreach ($options['headers_to_ignore'] as $name) {
+ $headersToIgnore[strtolower($name)] = true;
+ }
+ unset($headersToIgnore['from']);
+ $signedHeaderNames = [];
+ $headerCanonData = '';
+ $headers = $message->getPreparedHeaders();
+ foreach ($headers->getNames() as $name) {
+ foreach ($headers->all($name) as $header) {
+ if (isset($headersToIgnore[strtolower($header->getName())])) {
+ continue;
+ }
+
+ if ('' !== $header->getBodyAsString()) {
+ $headerCanonData .= $this->canonicalizeHeader($header->toString(), $options['header_canon']);
+ $signedHeaderNames[] = $header->getName();
+ }
+ }
+ }
+
+ [$bodyHash, $bodyLength] = $this->hashBody($message->getBody(), $options['body_canon'], $options['body_max_length']);
+
+ $params = [
+ 'v' => '1',
+ 'q' => 'dns/txt',
+ 'a' => $options['algorithm'],
+ 'bh' => base64_encode($bodyHash),
+ 'd' => $this->domainName,
+ 'h' => implode(': ', $signedHeaderNames),
+ 'i' => '@'.$this->domainName,
+ 's' => $this->selector,
+ 't' => time(),
+ 'c' => $options['header_canon'].'/'.$options['body_canon'],
+ ];
+
+ if ($options['body_show_length']) {
+ $params['l'] = $bodyLength;
+ }
+ if ($options['signature_expiration_delay']) {
+ $params['x'] = $params['t'] + $options['signature_expiration_delay'];
+ }
+ $value = '';
+ foreach ($params as $k => $v) {
+ $value .= $k.'='.$v.'; ';
+ }
+ $value = trim($value);
+ $header = new UnstructuredHeader('DKIM-Signature', $value);
+ $headerCanonData .= rtrim($this->canonicalizeHeader($header->toString()."\r\n b=", $options['header_canon']));
+ if (self::ALGO_SHA256 === $options['algorithm']) {
+ if (!openssl_sign($headerCanonData, $signature, $this->key, \OPENSSL_ALGO_SHA256)) {
+ throw new RuntimeException('Unable to sign DKIM hash: '.openssl_error_string());
+ }
+ } else {
+ throw new \RuntimeException(sprintf('The "%s" DKIM signing algorithm is not supported yet.', self::ALGO_ED25519));
+ }
+ $header->setValue($value.' b='.trim(chunk_split(base64_encode($signature), 73, ' ')));
+ $headers->add($header);
+
+ return new Message($headers, $message->getBody());
+ }
+
+ private function canonicalizeHeader(string $header, string $headerCanon): string
+ {
+ if (self::CANON_RELAXED !== $headerCanon) {
+ return $header."\r\n";
+ }
+
+ $exploded = explode(':', $header, 2);
+ $name = strtolower(trim($exploded[0]));
+ $value = str_replace("\r\n", '', $exploded[1]);
+ $value = trim(preg_replace("/[ \t][ \t]+/", ' ', $value));
+
+ return $name.':'.$value."\r\n";
+ }
+
+ private function hashBody(AbstractPart $body, string $bodyCanon, int $maxLength): array
+ {
+ $hash = hash_init('sha256');
+ $relaxed = self::CANON_RELAXED === $bodyCanon;
+ $currentLine = '';
+ $emptyCounter = 0;
+ $isSpaceSequence = false;
+ $length = 0;
+ foreach ($body->bodyToIterable() as $chunk) {
+ $canon = '';
+ for ($i = 0, $len = \strlen($chunk); $i < $len; ++$i) {
+ switch ($chunk[$i]) {
+ case "\r":
+ break;
+ case "\n":
+ // previous char is always \r
+ if ($relaxed) {
+ $isSpaceSequence = false;
+ }
+ if ('' === $currentLine) {
+ ++$emptyCounter;
+ } else {
+ $currentLine = '';
+ $canon .= "\r\n";
+ }
+ break;
+ case ' ':
+ case "\t":
+ if ($relaxed) {
+ $isSpaceSequence = true;
+ break;
+ }
+ // no break
+ default:
+ if ($emptyCounter > 0) {
+ $canon .= str_repeat("\r\n", $emptyCounter);
+ $emptyCounter = 0;
+ }
+ if ($isSpaceSequence) {
+ $currentLine .= ' ';
+ $canon .= ' ';
+ $isSpaceSequence = false;
+ }
+ $currentLine .= $chunk[$i];
+ $canon .= $chunk[$i];
+ }
+ }
+
+ if ($length + \strlen($canon) >= $maxLength) {
+ $canon = substr($canon, 0, $maxLength - $length);
+ $length += \strlen($canon);
+ hash_update($hash, $canon);
+
+ break;
+ }
+
+ $length += \strlen($canon);
+ hash_update($hash, $canon);
+ }
+
+ // Add trailing Line return if last line is non empty
+ if ('' !== $currentLine) {
+ hash_update($hash, "\r\n");
+ $length += \strlen("\r\n");
+ }
+
+ if (!$relaxed && 0 === $length) {
+ hash_update($hash, "\r\n");
+ $length = 2;
+ }
+
+ return [hash_final($hash, true), $length];
+ }
+}
diff --git a/tools/mailer/symfony/mime/Crypto/SMime.php b/tools/mailer/symfony/mime/Crypto/SMime.php
new file mode 100644
index 000000000..cba95f210
--- /dev/null
+++ b/tools/mailer/symfony/mime/Crypto/SMime.php
@@ -0,0 +1,111 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Crypto;
+
+use Symfony\Component\Mime\Exception\RuntimeException;
+use Symfony\Component\Mime\Part\SMimePart;
+
+/**
+ * @author Sebastiaan Stok
+ *
+ * @internal
+ */
+abstract class SMime
+{
+ protected function normalizeFilePath(string $path): string
+ {
+ if (!file_exists($path)) {
+ throw new RuntimeException(sprintf('File does not exist: "%s".', $path));
+ }
+
+ return 'file://'.str_replace('\\', '/', realpath($path));
+ }
+
+ protected function iteratorToFile(iterable $iterator, $stream): void
+ {
+ foreach ($iterator as $chunk) {
+ fwrite($stream, $chunk);
+ }
+ }
+
+ protected function convertMessageToSMimePart($stream, string $type, string $subtype): SMimePart
+ {
+ rewind($stream);
+
+ $headers = '';
+
+ while (!feof($stream)) {
+ $buffer = fread($stream, 78);
+ $headers .= $buffer;
+
+ // Detect ending of header list
+ if (preg_match('/(\r\n\r\n|\n\n)/', $headers, $match)) {
+ $headersPosEnd = strpos($headers, $headerBodySeparator = $match[0]);
+
+ break;
+ }
+ }
+
+ $headers = $this->getMessageHeaders(trim(substr($headers, 0, $headersPosEnd)));
+
+ fseek($stream, $headersPosEnd + \strlen($headerBodySeparator));
+
+ return new SMimePart($this->getStreamIterator($stream), $type, $subtype, $this->getParametersFromHeader($headers['content-type']));
+ }
+
+ protected function getStreamIterator($stream): iterable
+ {
+ while (!feof($stream)) {
+ yield str_replace("\n", "\r\n", str_replace("\r\n", "\n", fread($stream, 16372)));
+ }
+ }
+
+ private function getMessageHeaders(string $headerData): array
+ {
+ $headers = [];
+ $headerLines = explode("\r\n", str_replace("\n", "\r\n", str_replace("\r\n", "\n", $headerData)));
+ $currentHeaderName = '';
+
+ // Transform header lines into an associative array
+ foreach ($headerLines as $headerLine) {
+ // Empty lines between headers indicate a new mime-entity
+ if ('' === $headerLine) {
+ break;
+ }
+
+ // Handle headers that span multiple lines
+ if (!str_contains($headerLine, ':')) {
+ $headers[$currentHeaderName] .= ' '.trim($headerLine);
+ continue;
+ }
+
+ $header = explode(':', $headerLine, 2);
+ $currentHeaderName = strtolower($header[0]);
+ $headers[$currentHeaderName] = trim($header[1]);
+ }
+
+ return $headers;
+ }
+
+ private function getParametersFromHeader(string $header): array
+ {
+ $params = [];
+
+ preg_match_all('/(?P[a-z-0-9]+)=(?P"[^"]+"|(?:[^\s;]+|$))(?:\s+;)?/i', $header, $matches);
+
+ foreach ($matches['value'] as $pos => $paramValue) {
+ $params[$matches['name'][$pos]] = trim($paramValue, '"');
+ }
+
+ return $params;
+ }
+}
diff --git a/tools/mailer/symfony/mime/Crypto/SMimeEncrypter.php b/tools/mailer/symfony/mime/Crypto/SMimeEncrypter.php
new file mode 100644
index 000000000..c7c05452c
--- /dev/null
+++ b/tools/mailer/symfony/mime/Crypto/SMimeEncrypter.php
@@ -0,0 +1,63 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Crypto;
+
+use Symfony\Component\Mime\Exception\RuntimeException;
+use Symfony\Component\Mime\Message;
+
+/**
+ * @author Sebastiaan Stok
+ */
+final class SMimeEncrypter extends SMime
+{
+ private string|array $certs;
+ private int $cipher;
+
+ /**
+ * @param string|string[] $certificate The path (or array of paths) of the file(s) containing the X.509 certificate(s)
+ * @param int|null $cipher A set of algorithms used to encrypt the message. Must be one of these PHP constants: https://www.php.net/manual/en/openssl.ciphers.php
+ */
+ public function __construct(string|array $certificate, ?int $cipher = null)
+ {
+ if (!\extension_loaded('openssl')) {
+ throw new \LogicException('PHP extension "openssl" is required to use SMime.');
+ }
+
+ if (\is_array($certificate)) {
+ $this->certs = array_map($this->normalizeFilePath(...), $certificate);
+ } else {
+ $this->certs = $this->normalizeFilePath($certificate);
+ }
+
+ $this->cipher = $cipher ?? \OPENSSL_CIPHER_AES_256_CBC;
+ }
+
+ public function encrypt(Message $message): Message
+ {
+ $bufferFile = tmpfile();
+ $outputFile = tmpfile();
+
+ $this->iteratorToFile($message->toIterable(), $bufferFile);
+
+ if (!@openssl_pkcs7_encrypt(stream_get_meta_data($bufferFile)['uri'], stream_get_meta_data($outputFile)['uri'], $this->certs, [], 0, $this->cipher)) {
+ throw new RuntimeException(sprintf('Failed to encrypt S/Mime message. Error: "%s".', openssl_error_string()));
+ }
+
+ $mimePart = $this->convertMessageToSMimePart($outputFile, 'application', 'pkcs7-mime');
+ $mimePart->getHeaders()
+ ->addTextHeader('Content-Transfer-Encoding', 'base64')
+ ->addParameterizedHeader('Content-Disposition', 'attachment', ['name' => 'smime.p7m'])
+ ;
+
+ return new Message($message->getHeaders(), $mimePart);
+ }
+}
diff --git a/tools/mailer/symfony/mime/Crypto/SMimeSigner.php b/tools/mailer/symfony/mime/Crypto/SMimeSigner.php
new file mode 100644
index 000000000..eaa423d8c
--- /dev/null
+++ b/tools/mailer/symfony/mime/Crypto/SMimeSigner.php
@@ -0,0 +1,65 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Crypto;
+
+use Symfony\Component\Mime\Exception\RuntimeException;
+use Symfony\Component\Mime\Message;
+
+/**
+ * @author Sebastiaan Stok
+ */
+final class SMimeSigner extends SMime
+{
+ private string $signCertificate;
+ private string|array $signPrivateKey;
+ private int $signOptions;
+ private ?string $extraCerts;
+
+ /**
+ * @param string $certificate The path of the file containing the signing certificate (in PEM format)
+ * @param string $privateKey The path of the file containing the private key (in PEM format)
+ * @param string|null $privateKeyPassphrase A passphrase of the private key (if any)
+ * @param string|null $extraCerts The path of the file containing intermediate certificates (in PEM format) needed by the signing certificate
+ * @param int|null $signOptions Bitwise operator options for openssl_pkcs7_sign() (@see https://secure.php.net/manual/en/openssl.pkcs7.flags.php)
+ */
+ public function __construct(string $certificate, string $privateKey, ?string $privateKeyPassphrase = null, ?string $extraCerts = null, ?int $signOptions = null)
+ {
+ if (!\extension_loaded('openssl')) {
+ throw new \LogicException('PHP extension "openssl" is required to use SMime.');
+ }
+
+ $this->signCertificate = $this->normalizeFilePath($certificate);
+
+ if (null !== $privateKeyPassphrase) {
+ $this->signPrivateKey = [$this->normalizeFilePath($privateKey), $privateKeyPassphrase];
+ } else {
+ $this->signPrivateKey = $this->normalizeFilePath($privateKey);
+ }
+
+ $this->signOptions = $signOptions ?? \PKCS7_DETACHED;
+ $this->extraCerts = $extraCerts ? realpath($extraCerts) : null;
+ }
+
+ public function sign(Message $message): Message
+ {
+ $bufferFile = tmpfile();
+ $outputFile = tmpfile();
+
+ $this->iteratorToFile($message->getBody()->toIterable(), $bufferFile);
+
+ if (!@openssl_pkcs7_sign(stream_get_meta_data($bufferFile)['uri'], stream_get_meta_data($outputFile)['uri'], $this->signCertificate, $this->signPrivateKey, [], $this->signOptions, $this->extraCerts)) {
+ throw new RuntimeException(sprintf('Failed to sign S/Mime message. Error: "%s".', openssl_error_string()));
+ }
+
+ return new Message($message->getHeaders(), $this->convertMessageToSMimePart($outputFile, 'multipart', 'signed'));
+ }
+}
diff --git a/tools/mailer/symfony/mime/DependencyInjection/AddMimeTypeGuesserPass.php b/tools/mailer/symfony/mime/DependencyInjection/AddMimeTypeGuesserPass.php
new file mode 100644
index 000000000..897743fbd
--- /dev/null
+++ b/tools/mailer/symfony/mime/DependencyInjection/AddMimeTypeGuesserPass.php
@@ -0,0 +1,34 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\DependencyInjection;
+
+use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+use Symfony\Component\DependencyInjection\Reference;
+
+/**
+ * Registers custom mime types guessers.
+ *
+ * @author Fabien Potencier
+ */
+class AddMimeTypeGuesserPass implements CompilerPassInterface
+{
+ public function process(ContainerBuilder $container): void
+ {
+ if ($container->has('mime_types')) {
+ $definition = $container->findDefinition('mime_types');
+ foreach ($container->findTaggedServiceIds('mime.mime_type_guesser', true) as $id => $attributes) {
+ $definition->addMethodCall('registerGuesser', [new Reference($id)]);
+ }
+ }
+ }
+}
diff --git a/tools/mailer/symfony/mime/DraftEmail.php b/tools/mailer/symfony/mime/DraftEmail.php
new file mode 100644
index 000000000..82ce76369
--- /dev/null
+++ b/tools/mailer/symfony/mime/DraftEmail.php
@@ -0,0 +1,45 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime;
+
+use Symfony\Component\Mime\Header\Headers;
+use Symfony\Component\Mime\Part\AbstractPart;
+
+/**
+ * @author Kevin Bond
+ */
+class DraftEmail extends Email
+{
+ public function __construct(?Headers $headers = null, ?AbstractPart $body = null)
+ {
+ parent::__construct($headers, $body);
+
+ $this->getHeaders()->addTextHeader('X-Unsent', '1');
+ }
+
+ /**
+ * Override default behavior as draft emails do not require From/Sender/Date/Message-ID headers.
+ * These are added by the client that actually sends the email.
+ */
+ public function getPreparedHeaders(): Headers
+ {
+ $headers = clone $this->getHeaders();
+
+ if (!$headers->has('MIME-Version')) {
+ $headers->addTextHeader('MIME-Version', '1.0');
+ }
+
+ $headers->remove('Bcc');
+
+ return $headers;
+ }
+}
diff --git a/tools/mailer/symfony/mime/Email.php b/tools/mailer/symfony/mime/Email.php
new file mode 100644
index 000000000..233afc075
--- /dev/null
+++ b/tools/mailer/symfony/mime/Email.php
@@ -0,0 +1,576 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime;
+
+use Symfony\Component\Mime\Exception\LogicException;
+use Symfony\Component\Mime\Part\AbstractPart;
+use Symfony\Component\Mime\Part\DataPart;
+use Symfony\Component\Mime\Part\File;
+use Symfony\Component\Mime\Part\Multipart\AlternativePart;
+use Symfony\Component\Mime\Part\Multipart\MixedPart;
+use Symfony\Component\Mime\Part\Multipart\RelatedPart;
+use Symfony\Component\Mime\Part\TextPart;
+
+/**
+ * @author Fabien Potencier
+ */
+class Email extends Message
+{
+ public const PRIORITY_HIGHEST = 1;
+ public const PRIORITY_HIGH = 2;
+ public const PRIORITY_NORMAL = 3;
+ public const PRIORITY_LOW = 4;
+ public const PRIORITY_LOWEST = 5;
+
+ private const PRIORITY_MAP = [
+ self::PRIORITY_HIGHEST => 'Highest',
+ self::PRIORITY_HIGH => 'High',
+ self::PRIORITY_NORMAL => 'Normal',
+ self::PRIORITY_LOW => 'Low',
+ self::PRIORITY_LOWEST => 'Lowest',
+ ];
+
+ /**
+ * @var resource|string|null
+ */
+ private $text;
+
+ private ?string $textCharset = null;
+
+ /**
+ * @var resource|string|null
+ */
+ private $html;
+
+ private ?string $htmlCharset = null;
+ private array $attachments = [];
+ private ?AbstractPart $cachedBody = null; // Used to avoid wrong body hash in DKIM signatures with multiple parts (e.g. HTML + TEXT) due to multiple boundaries.
+
+ /**
+ * @return $this
+ */
+ public function subject(string $subject): static
+ {
+ return $this->setHeaderBody('Text', 'Subject', $subject);
+ }
+
+ public function getSubject(): ?string
+ {
+ return $this->getHeaders()->getHeaderBody('Subject');
+ }
+
+ /**
+ * @return $this
+ */
+ public function date(\DateTimeInterface $dateTime): static
+ {
+ return $this->setHeaderBody('Date', 'Date', $dateTime);
+ }
+
+ public function getDate(): ?\DateTimeImmutable
+ {
+ return $this->getHeaders()->getHeaderBody('Date');
+ }
+
+ /**
+ * @return $this
+ */
+ public function returnPath(Address|string $address): static
+ {
+ return $this->setHeaderBody('Path', 'Return-Path', Address::create($address));
+ }
+
+ public function getReturnPath(): ?Address
+ {
+ return $this->getHeaders()->getHeaderBody('Return-Path');
+ }
+
+ /**
+ * @return $this
+ */
+ public function sender(Address|string $address): static
+ {
+ return $this->setHeaderBody('Mailbox', 'Sender', Address::create($address));
+ }
+
+ public function getSender(): ?Address
+ {
+ return $this->getHeaders()->getHeaderBody('Sender');
+ }
+
+ /**
+ * @return $this
+ */
+ public function addFrom(Address|string ...$addresses): static
+ {
+ return $this->addListAddressHeaderBody('From', $addresses);
+ }
+
+ /**
+ * @return $this
+ */
+ public function from(Address|string ...$addresses): static
+ {
+ if (!$addresses) {
+ throw new LogicException('"from()" must be called with at least one address.');
+ }
+
+ return $this->setListAddressHeaderBody('From', $addresses);
+ }
+
+ /**
+ * @return Address[]
+ */
+ public function getFrom(): array
+ {
+ return $this->getHeaders()->getHeaderBody('From') ?: [];
+ }
+
+ /**
+ * @return $this
+ */
+ public function addReplyTo(Address|string ...$addresses): static
+ {
+ return $this->addListAddressHeaderBody('Reply-To', $addresses);
+ }
+
+ /**
+ * @return $this
+ */
+ public function replyTo(Address|string ...$addresses): static
+ {
+ return $this->setListAddressHeaderBody('Reply-To', $addresses);
+ }
+
+ /**
+ * @return Address[]
+ */
+ public function getReplyTo(): array
+ {
+ return $this->getHeaders()->getHeaderBody('Reply-To') ?: [];
+ }
+
+ /**
+ * @return $this
+ */
+ public function addTo(Address|string ...$addresses): static
+ {
+ return $this->addListAddressHeaderBody('To', $addresses);
+ }
+
+ /**
+ * @return $this
+ */
+ public function to(Address|string ...$addresses): static
+ {
+ return $this->setListAddressHeaderBody('To', $addresses);
+ }
+
+ /**
+ * @return Address[]
+ */
+ public function getTo(): array
+ {
+ return $this->getHeaders()->getHeaderBody('To') ?: [];
+ }
+
+ /**
+ * @return $this
+ */
+ public function addCc(Address|string ...$addresses): static
+ {
+ return $this->addListAddressHeaderBody('Cc', $addresses);
+ }
+
+ /**
+ * @return $this
+ */
+ public function cc(Address|string ...$addresses): static
+ {
+ return $this->setListAddressHeaderBody('Cc', $addresses);
+ }
+
+ /**
+ * @return Address[]
+ */
+ public function getCc(): array
+ {
+ return $this->getHeaders()->getHeaderBody('Cc') ?: [];
+ }
+
+ /**
+ * @return $this
+ */
+ public function addBcc(Address|string ...$addresses): static
+ {
+ return $this->addListAddressHeaderBody('Bcc', $addresses);
+ }
+
+ /**
+ * @return $this
+ */
+ public function bcc(Address|string ...$addresses): static
+ {
+ return $this->setListAddressHeaderBody('Bcc', $addresses);
+ }
+
+ /**
+ * @return Address[]
+ */
+ public function getBcc(): array
+ {
+ return $this->getHeaders()->getHeaderBody('Bcc') ?: [];
+ }
+
+ /**
+ * Sets the priority of this message.
+ *
+ * The value is an integer where 1 is the highest priority and 5 is the lowest.
+ *
+ * @return $this
+ */
+ public function priority(int $priority): static
+ {
+ if ($priority > 5) {
+ $priority = 5;
+ } elseif ($priority < 1) {
+ $priority = 1;
+ }
+
+ return $this->setHeaderBody('Text', 'X-Priority', sprintf('%d (%s)', $priority, self::PRIORITY_MAP[$priority]));
+ }
+
+ /**
+ * Get the priority of this message.
+ *
+ * The returned value is an integer where 1 is the highest priority and 5
+ * is the lowest.
+ */
+ public function getPriority(): int
+ {
+ [$priority] = sscanf($this->getHeaders()->getHeaderBody('X-Priority') ?? '', '%[1-5]');
+
+ return $priority ?? 3;
+ }
+
+ /**
+ * @param resource|string|null $body
+ *
+ * @return $this
+ */
+ public function text($body, string $charset = 'utf-8'): static
+ {
+ if (null !== $body && !\is_string($body) && !\is_resource($body)) {
+ throw new \TypeError(sprintf('The body must be a string, a resource or null (got "%s").', get_debug_type($body)));
+ }
+
+ $this->cachedBody = null;
+ $this->text = $body;
+ $this->textCharset = $charset;
+
+ return $this;
+ }
+
+ /**
+ * @return resource|string|null
+ */
+ public function getTextBody()
+ {
+ return $this->text;
+ }
+
+ public function getTextCharset(): ?string
+ {
+ return $this->textCharset;
+ }
+
+ /**
+ * @param resource|string|null $body
+ *
+ * @return $this
+ */
+ public function html($body, string $charset = 'utf-8'): static
+ {
+ if (null !== $body && !\is_string($body) && !\is_resource($body)) {
+ throw new \TypeError(sprintf('The body must be a string, a resource or null (got "%s").', get_debug_type($body)));
+ }
+
+ $this->cachedBody = null;
+ $this->html = $body;
+ $this->htmlCharset = $charset;
+
+ return $this;
+ }
+
+ /**
+ * @return resource|string|null
+ */
+ public function getHtmlBody()
+ {
+ return $this->html;
+ }
+
+ public function getHtmlCharset(): ?string
+ {
+ return $this->htmlCharset;
+ }
+
+ /**
+ * @param resource|string $body
+ *
+ * @return $this
+ */
+ public function attach($body, ?string $name = null, ?string $contentType = null): static
+ {
+ return $this->addPart(new DataPart($body, $name, $contentType));
+ }
+
+ /**
+ * @return $this
+ */
+ public function attachFromPath(string $path, ?string $name = null, ?string $contentType = null): static
+ {
+ return $this->addPart(new DataPart(new File($path), $name, $contentType));
+ }
+
+ /**
+ * @param resource|string $body
+ *
+ * @return $this
+ */
+ public function embed($body, ?string $name = null, ?string $contentType = null): static
+ {
+ return $this->addPart((new DataPart($body, $name, $contentType))->asInline());
+ }
+
+ /**
+ * @return $this
+ */
+ public function embedFromPath(string $path, ?string $name = null, ?string $contentType = null): static
+ {
+ return $this->addPart((new DataPart(new File($path), $name, $contentType))->asInline());
+ }
+
+ /**
+ * @return $this
+ */
+ public function addPart(DataPart $part): static
+ {
+ $this->cachedBody = null;
+ $this->attachments[] = $part;
+
+ return $this;
+ }
+
+ /**
+ * @return DataPart[]
+ */
+ public function getAttachments(): array
+ {
+ return $this->attachments;
+ }
+
+ public function getBody(): AbstractPart
+ {
+ if (null !== $body = parent::getBody()) {
+ return $body;
+ }
+
+ return $this->generateBody();
+ }
+
+ public function ensureValidity(): void
+ {
+ $this->ensureBodyValid();
+
+ if ('1' === $this->getHeaders()->getHeaderBody('X-Unsent')) {
+ throw new LogicException('Cannot send messages marked as "draft".');
+ }
+
+ parent::ensureValidity();
+ }
+
+ private function ensureBodyValid(): void
+ {
+ if (null === $this->text && null === $this->html && !$this->attachments) {
+ throw new LogicException('A message must have a text or an HTML part or attachments.');
+ }
+ }
+
+ /**
+ * Generates an AbstractPart based on the raw body of a message.
+ *
+ * The most "complex" part generated by this method is when there is text and HTML bodies
+ * with related images for the HTML part and some attachments:
+ *
+ * multipart/mixed
+ * |
+ * |------------> multipart/related
+ * | |
+ * | |------------> multipart/alternative
+ * | | |
+ * | | ------------> text/plain (with content)
+ * | | |
+ * | | ------------> text/html (with content)
+ * | |
+ * | ------------> image/png (with content)
+ * |
+ * ------------> application/pdf (with content)
+ */
+ private function generateBody(): AbstractPart
+ {
+ if (null !== $this->cachedBody) {
+ return $this->cachedBody;
+ }
+
+ $this->ensureBodyValid();
+
+ [$htmlPart, $otherParts, $relatedParts] = $this->prepareParts();
+
+ $part = null === $this->text ? null : new TextPart($this->text, $this->textCharset);
+ if (null !== $htmlPart) {
+ if (null !== $part) {
+ $part = new AlternativePart($part, $htmlPart);
+ } else {
+ $part = $htmlPart;
+ }
+ }
+
+ if ($relatedParts) {
+ $part = new RelatedPart($part, ...$relatedParts);
+ }
+
+ if ($otherParts) {
+ if ($part) {
+ $part = new MixedPart($part, ...$otherParts);
+ } else {
+ $part = new MixedPart(...$otherParts);
+ }
+ }
+
+ return $this->cachedBody = $part;
+ }
+
+ private function prepareParts(): ?array
+ {
+ $names = [];
+ $htmlPart = null;
+ $html = $this->html;
+ if (null !== $html) {
+ $htmlPart = new TextPart($html, $this->htmlCharset, 'html');
+ $html = $htmlPart->getBody();
+
+ $regexes = [
+ ']*src\s*=\s*(?:([\'"])cid:(.+?)\\1|cid:([^>\s]+))',
+ '<\w+\s+[^>]*background\s*=\s*(?:([\'"])cid:(.+?)\\1|cid:([^>\s]+))',
+ ];
+ $tmpMatches = [];
+ foreach ($regexes as $regex) {
+ preg_match_all('/'.$regex.'/i', $html, $tmpMatches);
+ $names = array_merge($names, $tmpMatches[2], $tmpMatches[3]);
+ }
+ $names = array_filter(array_unique($names));
+ }
+
+ $otherParts = $relatedParts = [];
+ foreach ($this->attachments as $part) {
+ foreach ($names as $name) {
+ if ($name !== $part->getName() && (!$part->hasContentId() || $name !== $part->getContentId())) {
+ continue;
+ }
+ if (isset($relatedParts[$name])) {
+ continue 2;
+ }
+
+ if ($name !== $part->getContentId()) {
+ $html = str_replace('cid:'.$name, 'cid:'.$part->getContentId(), $html, $count);
+ }
+ $relatedParts[$name] = $part;
+ $part->setName($part->getContentId())->asInline();
+
+ continue 2;
+ }
+
+ $otherParts[] = $part;
+ }
+ if (null !== $htmlPart) {
+ $htmlPart = new TextPart($html, $this->htmlCharset, 'html');
+ }
+
+ return [$htmlPart, $otherParts, array_values($relatedParts)];
+ }
+
+ /**
+ * @return $this
+ */
+ private function setHeaderBody(string $type, string $name, $body): static
+ {
+ $this->getHeaders()->setHeaderBody($type, $name, $body);
+
+ return $this;
+ }
+
+ /**
+ * @return $this
+ */
+ private function addListAddressHeaderBody(string $name, array $addresses): static
+ {
+ if (!$header = $this->getHeaders()->get($name)) {
+ return $this->setListAddressHeaderBody($name, $addresses);
+ }
+ $header->addAddresses(Address::createArray($addresses));
+
+ return $this;
+ }
+
+ /**
+ * @return $this
+ */
+ private function setListAddressHeaderBody(string $name, array $addresses): static
+ {
+ $addresses = Address::createArray($addresses);
+ $headers = $this->getHeaders();
+ if ($header = $headers->get($name)) {
+ $header->setAddresses($addresses);
+ } else {
+ $headers->addMailboxListHeader($name, $addresses);
+ }
+
+ return $this;
+ }
+
+ /**
+ * @internal
+ */
+ public function __serialize(): array
+ {
+ if (\is_resource($this->text)) {
+ $this->text = (new TextPart($this->text))->getBody();
+ }
+
+ if (\is_resource($this->html)) {
+ $this->html = (new TextPart($this->html))->getBody();
+ }
+
+ return [$this->text, $this->textCharset, $this->html, $this->htmlCharset, $this->attachments, parent::__serialize()];
+ }
+
+ /**
+ * @internal
+ */
+ public function __unserialize(array $data): void
+ {
+ [$this->text, $this->textCharset, $this->html, $this->htmlCharset, $this->attachments, $parentData] = $data;
+
+ parent::__unserialize($parentData);
+ }
+}
diff --git a/tools/mailer/symfony/mime/Encoder/AddressEncoderInterface.php b/tools/mailer/symfony/mime/Encoder/AddressEncoderInterface.php
new file mode 100644
index 000000000..de477d884
--- /dev/null
+++ b/tools/mailer/symfony/mime/Encoder/AddressEncoderInterface.php
@@ -0,0 +1,28 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Encoder;
+
+use Symfony\Component\Mime\Exception\AddressEncoderException;
+
+/**
+ * @author Christian Schmidt
+ */
+interface AddressEncoderInterface
+{
+ /**
+ * Encodes an email address.
+ *
+ * @throws AddressEncoderException if the email cannot be represented in
+ * the encoding implemented by this class
+ */
+ public function encodeString(string $address): string;
+}
diff --git a/tools/mailer/symfony/mime/Encoder/Base64ContentEncoder.php b/tools/mailer/symfony/mime/Encoder/Base64ContentEncoder.php
new file mode 100644
index 000000000..440868af7
--- /dev/null
+++ b/tools/mailer/symfony/mime/Encoder/Base64ContentEncoder.php
@@ -0,0 +1,45 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Encoder;
+
+use Symfony\Component\Mime\Exception\RuntimeException;
+
+/**
+ * @author Fabien Potencier
+ */
+final class Base64ContentEncoder extends Base64Encoder implements ContentEncoderInterface
+{
+ public function encodeByteStream($stream, int $maxLineLength = 0): iterable
+ {
+ if (!\is_resource($stream)) {
+ throw new \TypeError(sprintf('Method "%s" takes a stream as a first argument.', __METHOD__));
+ }
+
+ $filter = stream_filter_append($stream, 'convert.base64-encode', \STREAM_FILTER_READ, [
+ 'line-length' => 0 >= $maxLineLength || 76 < $maxLineLength ? 76 : $maxLineLength,
+ 'line-break-chars' => "\r\n",
+ ]);
+ if (!\is_resource($filter)) {
+ throw new RuntimeException('Unable to set the base64 content encoder to the filter.');
+ }
+
+ while (!feof($stream)) {
+ yield fread($stream, 16372);
+ }
+ stream_filter_remove($filter);
+ }
+
+ public function getName(): string
+ {
+ return 'base64';
+ }
+}
diff --git a/tools/mailer/symfony/mime/Encoder/Base64Encoder.php b/tools/mailer/symfony/mime/Encoder/Base64Encoder.php
new file mode 100644
index 000000000..710647857
--- /dev/null
+++ b/tools/mailer/symfony/mime/Encoder/Base64Encoder.php
@@ -0,0 +1,41 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Encoder;
+
+/**
+ * @author Chris Corbyn
+ */
+class Base64Encoder implements EncoderInterface
+{
+ /**
+ * Takes an unencoded string and produces a Base64 encoded string from it.
+ *
+ * Base64 encoded strings have a maximum line length of 76 characters.
+ * If the first line needs to be shorter, indicate the difference with
+ * $firstLineOffset.
+ */
+ public function encodeString(string $string, ?string $charset = 'utf-8', int $firstLineOffset = 0, int $maxLineLength = 0): string
+ {
+ if (0 >= $maxLineLength || 76 < $maxLineLength) {
+ $maxLineLength = 76;
+ }
+
+ $encodedString = base64_encode($string);
+ $firstLine = '';
+ if (0 !== $firstLineOffset) {
+ $firstLine = substr($encodedString, 0, $maxLineLength - $firstLineOffset)."\r\n";
+ $encodedString = substr($encodedString, $maxLineLength - $firstLineOffset);
+ }
+
+ return $firstLine.trim(chunk_split($encodedString, $maxLineLength, "\r\n"));
+ }
+}
diff --git a/tools/mailer/symfony/mime/Encoder/Base64MimeHeaderEncoder.php b/tools/mailer/symfony/mime/Encoder/Base64MimeHeaderEncoder.php
new file mode 100644
index 000000000..5c06f6d9a
--- /dev/null
+++ b/tools/mailer/symfony/mime/Encoder/Base64MimeHeaderEncoder.php
@@ -0,0 +1,43 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Encoder;
+
+/**
+ * @author Chris Corbyn
+ */
+final class Base64MimeHeaderEncoder extends Base64Encoder implements MimeHeaderEncoderInterface
+{
+ public function getName(): string
+ {
+ return 'B';
+ }
+
+ /**
+ * Takes an unencoded string and produces a Base64 encoded string from it.
+ *
+ * If the charset is iso-2022-jp, it uses mb_encode_mimeheader instead of
+ * default encodeString, otherwise pass to the parent method.
+ */
+ public function encodeString(string $string, ?string $charset = 'utf-8', int $firstLineOffset = 0, int $maxLineLength = 0): string
+ {
+ if ('iso-2022-jp' === strtolower($charset)) {
+ $old = mb_internal_encoding();
+ mb_internal_encoding('utf-8');
+ $newstring = mb_encode_mimeheader($string, 'iso-2022-jp', $this->getName(), "\r\n");
+ mb_internal_encoding($old);
+
+ return $newstring;
+ }
+
+ return parent::encodeString($string, $charset, $firstLineOffset, $maxLineLength);
+ }
+}
diff --git a/tools/mailer/symfony/mime/Encoder/ContentEncoderInterface.php b/tools/mailer/symfony/mime/Encoder/ContentEncoderInterface.php
new file mode 100644
index 000000000..a45ad04c2
--- /dev/null
+++ b/tools/mailer/symfony/mime/Encoder/ContentEncoderInterface.php
@@ -0,0 +1,30 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Encoder;
+
+/**
+ * @author Chris Corbyn
+ */
+interface ContentEncoderInterface extends EncoderInterface
+{
+ /**
+ * Encodes the stream to a Generator.
+ *
+ * @param resource $stream
+ */
+ public function encodeByteStream($stream, int $maxLineLength = 0): iterable;
+
+ /**
+ * Gets the MIME name of this content encoding scheme.
+ */
+ public function getName(): string;
+}
diff --git a/tools/mailer/symfony/mime/Encoder/EightBitContentEncoder.php b/tools/mailer/symfony/mime/Encoder/EightBitContentEncoder.php
new file mode 100644
index 000000000..82831209e
--- /dev/null
+++ b/tools/mailer/symfony/mime/Encoder/EightBitContentEncoder.php
@@ -0,0 +1,35 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Encoder;
+
+/**
+ * @author Fabien Potencier
+ */
+final class EightBitContentEncoder implements ContentEncoderInterface
+{
+ public function encodeByteStream($stream, int $maxLineLength = 0): iterable
+ {
+ while (!feof($stream)) {
+ yield fread($stream, 16372);
+ }
+ }
+
+ public function getName(): string
+ {
+ return '8bit';
+ }
+
+ public function encodeString(string $string, ?string $charset = 'utf-8', int $firstLineOffset = 0, int $maxLineLength = 0): string
+ {
+ return $string;
+ }
+}
diff --git a/tools/mailer/symfony/mime/Encoder/EncoderInterface.php b/tools/mailer/symfony/mime/Encoder/EncoderInterface.php
new file mode 100644
index 000000000..bbf6d4886
--- /dev/null
+++ b/tools/mailer/symfony/mime/Encoder/EncoderInterface.php
@@ -0,0 +1,26 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Encoder;
+
+/**
+ * @author Chris Corbyn
+ */
+interface EncoderInterface
+{
+ /**
+ * Encode a given string to produce an encoded string.
+ *
+ * @param int $firstLineOffset if first line needs to be shorter
+ * @param int $maxLineLength - 0 indicates the default length for this encoding
+ */
+ public function encodeString(string $string, ?string $charset = 'utf-8', int $firstLineOffset = 0, int $maxLineLength = 0): string;
+}
diff --git a/tools/mailer/symfony/mime/Encoder/IdnAddressEncoder.php b/tools/mailer/symfony/mime/Encoder/IdnAddressEncoder.php
new file mode 100644
index 000000000..b56e7e396
--- /dev/null
+++ b/tools/mailer/symfony/mime/Encoder/IdnAddressEncoder.php
@@ -0,0 +1,44 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Encoder;
+
+/**
+ * An IDN email address encoder.
+ *
+ * Encodes the domain part of an address using IDN. This is compatible will all
+ * SMTP servers.
+ *
+ * Note: It leaves the local part as is. In case there are non-ASCII characters
+ * in the local part then it depends on the SMTP Server if this is supported.
+ *
+ * @author Christian Schmidt
+ */
+final class IdnAddressEncoder implements AddressEncoderInterface
+{
+ /**
+ * Encodes the domain part of an address using IDN.
+ */
+ public function encodeString(string $address): string
+ {
+ $i = strrpos($address, '@');
+ if (false !== $i) {
+ $local = substr($address, 0, $i);
+ $domain = substr($address, $i + 1);
+
+ if (preg_match('/[^\x00-\x7F]/', $domain)) {
+ $address = sprintf('%s@%s', $local, idn_to_ascii($domain, \IDNA_DEFAULT | \IDNA_USE_STD3_RULES | \IDNA_CHECK_BIDI | \IDNA_CHECK_CONTEXTJ | \IDNA_NONTRANSITIONAL_TO_ASCII, \INTL_IDNA_VARIANT_UTS46));
+ }
+ }
+
+ return $address;
+ }
+}
diff --git a/tools/swift/classes/Swift/Mime/HeaderEncoder.php b/tools/mailer/symfony/mime/Encoder/MimeHeaderEncoderInterface.php
similarity index 52%
rename from tools/swift/classes/Swift/Mime/HeaderEncoder.php
rename to tools/mailer/symfony/mime/Encoder/MimeHeaderEncoderInterface.php
index 08fd453d6..fff2c782b 100644
--- a/tools/swift/classes/Swift/Mime/HeaderEncoder.php
+++ b/tools/mailer/symfony/mime/Encoder/MimeHeaderEncoderInterface.php
@@ -1,24 +1,23 @@
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
+namespace Symfony\Component\Mime\Encoder;
+
/**
- * Interface for all Header Encoding schemes.
- *
* @author Chris Corbyn
*/
-interface Swift_Mime_HeaderEncoder extends Swift_Encoder
+interface MimeHeaderEncoderInterface
{
/**
* Get the MIME name of this content encoding scheme.
- *
- * @return string
*/
- public function getName();
+ public function getName(): string;
}
diff --git a/tools/mailer/symfony/mime/Encoder/QpContentEncoder.php b/tools/mailer/symfony/mime/Encoder/QpContentEncoder.php
new file mode 100644
index 000000000..6f420fff3
--- /dev/null
+++ b/tools/mailer/symfony/mime/Encoder/QpContentEncoder.php
@@ -0,0 +1,55 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Encoder;
+
+/**
+ * @author Lars Strojny
+ */
+final class QpContentEncoder implements ContentEncoderInterface
+{
+ public function encodeByteStream($stream, int $maxLineLength = 0): iterable
+ {
+ if (!\is_resource($stream)) {
+ throw new \TypeError(sprintf('Method "%s" takes a stream as a first argument.', __METHOD__));
+ }
+
+ // we don't use PHP stream filters here as the content should be small enough
+ yield $this->encodeString(stream_get_contents($stream), 'utf-8', 0, $maxLineLength);
+ }
+
+ public function getName(): string
+ {
+ return 'quoted-printable';
+ }
+
+ public function encodeString(string $string, ?string $charset = 'utf-8', int $firstLineOffset = 0, int $maxLineLength = 0): string
+ {
+ return $this->standardize(quoted_printable_encode($string));
+ }
+
+ /**
+ * Make sure CRLF is correct and HT/SPACE are in valid places.
+ */
+ private function standardize(string $string): string
+ {
+ // transform CR or LF to CRLF
+ $string = preg_replace('~=0D(?!=0A)|(? substr_replace($string, '=09', -1),
+ 0x20 => substr_replace($string, '=20', -1),
+ default => $string,
+ };
+ }
+}
diff --git a/tools/swift/classes/Swift/Encoder/QpEncoder.php b/tools/mailer/symfony/mime/Encoder/QpEncoder.php
similarity index 55%
rename from tools/swift/classes/Swift/Encoder/QpEncoder.php
rename to tools/mailer/symfony/mime/Encoder/QpEncoder.php
index edec10c51..160dde329 100644
--- a/tools/swift/classes/Swift/Encoder/QpEncoder.php
+++ b/tools/mailer/symfony/mime/Encoder/QpEncoder.php
@@ -1,42 +1,27 @@
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
+namespace Symfony\Component\Mime\Encoder;
+
+use Symfony\Component\Mime\CharacterStream;
+
/**
- * Handles Quoted Printable (QP) Encoding in Swift Mailer.
- *
- * Possibly the most accurate RFC 2045 QP implementation found in PHP.
- *
* @author Chris Corbyn
*/
-class Swift_Encoder_QpEncoder implements Swift_Encoder
+class QpEncoder implements EncoderInterface
{
- /**
- * The CharacterStream used for reading characters (as opposed to bytes).
- *
- * @var Swift_CharacterStream
- */
- protected $_charStream;
-
- /**
- * A filter used if input should be canonicalized.
- *
- * @var Swift_StreamFilter
- */
- protected $_filter;
-
/**
* Pre-computed QP for HUGE optimization.
- *
- * @var string[]
*/
- protected static $_qpMap = array(
+ private const QP_MAP = [
0 => '=00', 1 => '=01', 2 => '=02', 3 => '=03', 4 => '=04',
5 => '=05', 6 => '=06', 7 => '=07', 8 => '=08', 9 => '=09',
10 => '=0A', 11 => '=0B', 12 => '=0C', 13 => '=0D', 14 => '=0E',
@@ -89,60 +74,34 @@ class Swift_Encoder_QpEncoder implements Swift_Encoder
245 => '=F5', 246 => '=F6', 247 => '=F7', 248 => '=F8', 249 => '=F9',
250 => '=FA', 251 => '=FB', 252 => '=FC', 253 => '=FD', 254 => '=FE',
255 => '=FF',
- );
+ ];
- protected static $_safeMapShare = array();
+ private static array $safeMapShare = [];
/**
* A map of non-encoded ascii characters.
*
* @var string[]
- */
- protected $_safeMap = array();
-
- /**
- * Creates a new QpEncoder for the given CharacterStream.
*
- * @param Swift_CharacterStream $charStream to use for reading characters
- * @param Swift_StreamFilter $filter if input should be canonicalized
+ * @internal
*/
- public function __construct(Swift_CharacterStream $charStream, Swift_StreamFilter $filter = null)
- {
- $this->_charStream = $charStream;
- if (!isset(self::$_safeMapShare[$this->getSafeMapShareId()])) {
- $this->initSafeMap();
- self::$_safeMapShare[$this->getSafeMapShareId()] = $this->_safeMap;
- } else {
- $this->_safeMap = self::$_safeMapShare[$this->getSafeMapShareId()];
- }
- $this->_filter = $filter;
- }
+ protected array $safeMap = [];
- public function __sleep()
+ public function __construct()
{
- return array('_charStream', '_filter');
- }
-
- public function __wakeup()
- {
- if (!isset(self::$_safeMapShare[$this->getSafeMapShareId()])) {
+ $id = static::class;
+ if (!isset(self::$safeMapShare[$id])) {
$this->initSafeMap();
- self::$_safeMapShare[$this->getSafeMapShareId()] = $this->_safeMap;
+ self::$safeMapShare[$id] = $this->safeMap;
} else {
- $this->_safeMap = self::$_safeMapShare[$this->getSafeMapShareId()];
+ $this->safeMap = self::$safeMapShare[$id];
}
}
- protected function getSafeMapShareId()
+ protected function initSafeMap(): void
{
- return get_class($this);
- }
-
- protected function initSafeMap()
- {
- foreach (array_merge(
- array(0x09, 0x20), range(0x21, 0x3C), range(0x3E, 0x7E)) as $byte) {
- $this->_safeMap[$byte] = chr($byte);
+ foreach (array_merge([0x09, 0x20], range(0x21, 0x3C), range(0x3E, 0x7E)) as $byte) {
+ $this->safeMap[$byte] = \chr($byte);
}
}
@@ -152,14 +111,8 @@ class Swift_Encoder_QpEncoder implements Swift_Encoder
* QP encoded strings have a maximum line length of 76 characters.
* If the first line needs to be shorter, indicate the difference with
* $firstLineOffset.
- *
- * @param string $string to encode
- * @param int $firstLineOffset, optional
- * @param int $maxLineLength, optional 0 indicates the default of 76 chars
- *
- * @return string
*/
- public function encodeString($string, $firstLineOffset = 0, $maxLineLength = 0)
+ public function encodeString(string $string, ?string $charset = 'utf-8', int $firstLineOffset = 0, int $maxLineLength = 0): string
{
if ($maxLineLength > 76 || $maxLineLength <= 0) {
$maxLineLength = 76;
@@ -167,40 +120,21 @@ class Swift_Encoder_QpEncoder implements Swift_Encoder
$thisLineLength = $maxLineLength - $firstLineOffset;
- $lines = array();
+ $lines = [];
$lNo = 0;
$lines[$lNo] = '';
$currentLine = &$lines[$lNo++];
$size = $lineLen = 0;
-
- $this->_charStream->flushContents();
- $this->_charStream->importString($string);
+ $charStream = new CharacterStream($string, $charset);
// Fetching more than 4 chars at one is slower, as is fetching fewer bytes
// Conveniently 4 chars is the UTF-8 safe number since UTF-8 has up to 6
// bytes per char and (6 * 4 * 3 = 72 chars per line) * =NN is 3 bytes
- while (false !== $bytes = $this->_nextSequence()) {
- // If we're filtering the input
- if (isset($this->_filter)) {
- // If we can't filter because we need more bytes
- while ($this->_filter->shouldBuffer($bytes)) {
- // Then collect bytes into the buffer
- if (false === $moreBytes = $this->_nextSequence(1)) {
- break;
- }
-
- foreach ($moreBytes as $b) {
- $bytes[] = $b;
- }
- }
- // And filter them
- $bytes = $this->_filter->filter($bytes);
- }
-
- $enc = $this->_encodeByteSequence($bytes, $size);
+ while (null !== $bytes = $charStream->readBytes(4)) {
+ $enc = $this->encodeByteSequence($bytes, $size);
$i = strpos($enc, '=0D=0A');
- $newLineLength = $lineLen + ($i === false ? $size : $i);
+ $newLineLength = $lineLen + (false === $i ? $size : $i);
if ($currentLine && $newLineLength >= $thisLineLength) {
$lines[$lNo] = '';
@@ -211,7 +145,7 @@ class Swift_Encoder_QpEncoder implements Swift_Encoder
$currentLine .= $enc;
- if ($i === false) {
+ if (false === $i) {
$lineLen += $size;
} else {
// 6 is the length of '=0D=0A'.
@@ -219,37 +153,22 @@ class Swift_Encoder_QpEncoder implements Swift_Encoder
}
}
- return $this->_standardize(implode("=\r\n", $lines));
- }
-
- /**
- * Updates the charset used.
- *
- * @param string $charset
- */
- public function charsetChanged($charset)
- {
- $this->_charStream->setCharacterSet($charset);
+ return $this->standardize(implode("=\r\n", $lines));
}
/**
* Encode the given byte array into a verbatim QP form.
- *
- * @param int[] $bytes
- * @param int $size
- *
- * @return string
*/
- protected function _encodeByteSequence(array $bytes, &$size)
+ private function encodeByteSequence(array $bytes, int &$size): string
{
$ret = '';
$size = 0;
foreach ($bytes as $b) {
- if (isset($this->_safeMap[$b])) {
- $ret .= $this->_safeMap[$b];
+ if (isset($this->safeMap[$b])) {
+ $ret .= $this->safeMap[$b];
++$size;
} else {
- $ret .= self::$_qpMap[$b];
+ $ret .= self::QP_MAP[$b];
$size += 3;
}
}
@@ -257,44 +176,17 @@ class Swift_Encoder_QpEncoder implements Swift_Encoder
return $ret;
}
- /**
- * Get the next sequence of bytes to read from the char stream.
- *
- * @param int $size number of bytes to read
- *
- * @return int[]
- */
- protected function _nextSequence($size = 4)
- {
- return $this->_charStream->readBytes($size);
- }
-
/**
* Make sure CRLF is correct and HT/SPACE are in valid places.
- *
- * @param string $string
- *
- * @return string
*/
- protected function _standardize($string)
+ private function standardize(string $string): string
{
- $string = str_replace(array("\t=0D=0A", ' =0D=0A', '=0D=0A'),
- array("=09\r\n", "=20\r\n", "\r\n"), $string
- );
- switch ($end = ord(substr($string, -1))) {
- case 0x09:
- case 0x20:
- $string = substr_replace($string, self::$_qpMap[$end], -1);
- }
+ $string = str_replace(["\t=0D=0A", ' =0D=0A', '=0D=0A'], ["=09\r\n", "=20\r\n", "\r\n"], $string);
- return $string;
- }
-
- /**
- * Make a deep copy of object.
- */
- public function __clone()
- {
- $this->_charStream = clone $this->_charStream;
+ return match ($end = \ord(substr($string, -1))) {
+ 0x09,
+ 0x20 => substr_replace($string, self::QP_MAP[$end], -1),
+ default => $string,
+ };
}
}
diff --git a/tools/mailer/symfony/mime/Encoder/QpMimeHeaderEncoder.php b/tools/mailer/symfony/mime/Encoder/QpMimeHeaderEncoder.php
new file mode 100644
index 000000000..d1d38375f
--- /dev/null
+++ b/tools/mailer/symfony/mime/Encoder/QpMimeHeaderEncoder.php
@@ -0,0 +1,40 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Encoder;
+
+/**
+ * @author Chris Corbyn
+ */
+final class QpMimeHeaderEncoder extends QpEncoder implements MimeHeaderEncoderInterface
+{
+ protected function initSafeMap(): void
+ {
+ foreach (array_merge(
+ range(0x61, 0x7A), range(0x41, 0x5A),
+ range(0x30, 0x39), [0x20, 0x21, 0x2A, 0x2B, 0x2D, 0x2F]
+ ) as $byte) {
+ $this->safeMap[$byte] = \chr($byte);
+ }
+ }
+
+ public function getName(): string
+ {
+ return 'Q';
+ }
+
+ public function encodeString(string $string, ?string $charset = 'utf-8', int $firstLineOffset = 0, int $maxLineLength = 0): string
+ {
+ return str_replace([' ', '=20', "=\r\n"], ['_', '_', "\r\n"],
+ parent::encodeString($string, $charset, $firstLineOffset, $maxLineLength)
+ );
+ }
+}
diff --git a/tools/mailer/symfony/mime/Encoder/Rfc2231Encoder.php b/tools/mailer/symfony/mime/Encoder/Rfc2231Encoder.php
new file mode 100644
index 000000000..4d93dc641
--- /dev/null
+++ b/tools/mailer/symfony/mime/Encoder/Rfc2231Encoder.php
@@ -0,0 +1,50 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Encoder;
+
+use Symfony\Component\Mime\CharacterStream;
+
+/**
+ * @author Chris Corbyn
+ */
+final class Rfc2231Encoder implements EncoderInterface
+{
+ /**
+ * Takes an unencoded string and produces a string encoded according to RFC 2231 from it.
+ */
+ public function encodeString(string $string, ?string $charset = 'utf-8', int $firstLineOffset = 0, int $maxLineLength = 0): string
+ {
+ $lines = [];
+ $lineCount = 0;
+ $lines[] = '';
+ $currentLine = &$lines[$lineCount++];
+
+ if (0 >= $maxLineLength) {
+ $maxLineLength = 75;
+ }
+
+ $charStream = new CharacterStream($string, $charset);
+ $thisLineLength = $maxLineLength - $firstLineOffset;
+
+ while (null !== $char = $charStream->read(4)) {
+ $encodedChar = rawurlencode($char);
+ if ('' !== $currentLine && \strlen($currentLine.$encodedChar) > $thisLineLength) {
+ $lines[] = '';
+ $currentLine = &$lines[$lineCount++];
+ $thisLineLength = $maxLineLength;
+ }
+ $currentLine .= $encodedChar;
+ }
+
+ return implode("\r\n", $lines);
+ }
+}
diff --git a/tools/mailer/symfony/mime/Exception/AddressEncoderException.php b/tools/mailer/symfony/mime/Exception/AddressEncoderException.php
new file mode 100644
index 000000000..51ee2e06f
--- /dev/null
+++ b/tools/mailer/symfony/mime/Exception/AddressEncoderException.php
@@ -0,0 +1,19 @@
+
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mime\Exception;
+
+/**
+ * @author Fabien Potencier