Skip to content

EspoCRM – Open Source CRM Application

free email domain checker inerface and implementation

Yuri Kuznetsovabd9fb9985d0
diff --git a/application/Espo/Modules/Crm/Binding.php b/application/Espo/Modules/Crm/Binding.php
index 622cc163cb..6090d266f0 100644
--- a/application/Espo/Modules/Crm/Binding.php
+++ b/application/Espo/Modules/Crm/Binding.php
@@ -40,5 +40,10 @@ class Binding implements BindingProcessor
'Espo\\Modules\\Crm\\Tools\\MassEmail\\MessageHeadersPreparator',
'Espo\\Modules\\Crm\\Tools\\MassEmail\\DefaultMessageHeadersPreparator'
);
+
+ $binder->bindImplementation(
+ 'Espo\\Modules\\Crm\\Tools\\EmailAddress\\FreeDomainChecker',
+ 'Espo\\Modules\\Crm\\Tools\\EmailAddress\\DefaultFreeDomainChecker'
+ );
}
}
diff --git a/application/Espo/Modules/Crm/Tools/EmailAddress/DefaultFreeDomainChecker.php b/application/Espo/Modules/Crm/Tools/EmailAddress/DefaultFreeDomainChecker.php
new file mode 100644
index 0000000000..0e9e185c4f
--- /dev/null
+++ b/application/Espo/Modules/Crm/Tools/EmailAddress/DefaultFreeDomainChecker.php
@@ -0,0 +1,57 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2025 Yurii Kuznietsov, Taras Machyshyn, Oleksii Avramenko
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Modules\Crm\Tools\EmailAddress;
+
+use Espo\Core\Utils\File\Manager as FileManager;
+use Espo\Core\Utils\Json;
+use RuntimeException;
+
+/**
+ * @since 9.0.3
+ */
+class DefaultFreeDomainChecker implements FreeDomainChecker
+{
+ private string $file = 'application/Espo/Modules/Crm/Resources/data/freeEmailProviderDomains.json';
+
+ public function __construct(
+ private FileManager $fileManager
+ ) {}
+
+ public function check(string $domain): bool
+ {
+ $list = Json::decode($this->fileManager->getContents($this->file));
+
+ if (!is_array($list)) {
+ throw new RuntimeException("Bad data in freeEmailProviderDomains file.");
+ }
+
+ return in_array($domain, $list);
+ }
+}
diff --git a/application/Espo/Modules/Crm/Tools/EmailAddress/FreeDomainChecker.php b/application/Espo/Modules/Crm/Tools/EmailAddress/FreeDomainChecker.php
new file mode 100644
index 0000000000..3e3ae2b185
--- /dev/null
+++ b/application/Espo/Modules/Crm/Tools/EmailAddress/FreeDomainChecker.php
@@ -0,0 +1,41 @@
+<?php
+/************************************************************************
+ * This file is part of EspoCRM.
+ *
+ * EspoCRM – Open Source CRM application.
+ * Copyright (C) 2014-2025 Yurii Kuznietsov, Taras Machyshyn, Oleksii Avramenko
+ * Website: https://www.espocrm.com
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * The interactive user interfaces in modified source and object code versions
+ * of this program must display Appropriate Legal Notices, as required under
+ * Section 5 of the GNU Affero General Public License version 3.
+ *
+ * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
+ * these Appropriate Legal Notices must retain the display of the "EspoCRM" word.
+ ************************************************************************/
+
+namespace Espo\Modules\Crm\Tools\EmailAddress;
+
+/**
+ * @since 9.0.3
+ */
+interface FreeDomainChecker
+{
+ /**
+ * Check whether the domain belongs to a free email provider.
+ */
+ public function check(string $domain): bool;
+}