Upgraded to dotkernel/dot-mail 5.0

.github/workflows/codecov.yml

@@ -47,7 +47,7 @@ jobs:
       - name: Setup project
         run: |
           mv config/autoload/local.php.dist config/autoload/local.php
-          mv config/autoload/mail.local.php.dist config/autoload/mail.local.php
+          mv config/autoload/mail.global.php.dist config/autoload/mail.global.php
           mv config/autoload/local.test.php.dist config/autoload/local.test.php
 
       - name: Collect code coverage with PHPUnit

.github/workflows/static-analysis.yml

@@ -47,7 +47,7 @@ jobs:
       - name: Setup project
         run: |
           mv config/autoload/local.php.dist config/autoload/local.php
-          mv config/autoload/mail.local.php.dist config/autoload/mail.local.php
+          mv config/autoload/mail.global.php.dist config/autoload/mail.global.php
           mv config/autoload/local.test.php.dist config/autoload/local.test.php
 
       - name: Run static analysis with PHPStan

.laminas-ci/pre-run.sh

@@ -9,7 +9,7 @@ if [[ ${COMMAND} =~ phpunit ]];then
   apt-get install php"${PHP_VERSION}"-sqlite3
 
   cp config/autoload/local.php.dist config/autoload/local.php
-  cp config/autoload/mail.local.php.dist config/autoload/mail.local.php
+  cp config/autoload/mail.global.php.dist config/autoload/mail.global.php
   cp config/autoload/local.test.php.dist config/autoload/local.test.php
 
 fi

composer.json

@@ -56,7 +56,7 @@
         "dotkernel/dot-data-fixtures": "^1.2.2",
         "dotkernel/dot-dependency-injection": "^1.0",
         "dotkernel/dot-errorhandler": "^4.0.0",
-        "dotkernel/dot-mail": "^4.1.1",
+        "dotkernel/dot-mail": "^5.1.0",
         "dotkernel/dot-response-header": "^3.2.3",
         "laminas/laminas-component-installer": "^3.4.0",
         "laminas/laminas-config-aggregator": "^1.14.0",

config/autoload/mail.global.php.dist

@@ -0,0 +1,80 @@
+<?php
+
+declare(strict_types=1);
+
+return [
+    /**
+     * Dotkernel mail module configuration
+     * Note that many of these options can be set programmatically too, when sending mail messages actually that is
+     * what you'll usually do, these configs provide just defaults and options that remain the same for all mails
+     */
+    'dot_mail' => [
+        //the key is the mail service name, this is the default one, which does not extend any configuration
+        'default' => [
+            //message configuration
+            'message_options' => [
+                //from email address of the email
+                'from' => '',
+                //from name to be displayed instead of from address
+                'from_name' => '',
+                //reply-to email address of the email
+                'reply_to' => '',
+                //replyTo name to be displayed instead of the address
+                'reply_to_name' => '',
+                //destination email address as string or a list of email addresses
+                'to' => [],
+                //copy destination addresses
+                'cc' => [],
+                //hidden copy destination addresses
+                'bcc' => [],
+                //email subject
+                'subject' => '',
+                //body options - content can be plain text, HTML
+                'body' => [
+                    'content' => '',
+                    'charset' => 'utf-8',
+                ],
+                //attachments config
+                'attachments' => [
+                    'files' => [],
+                    'dir'   => [
+                        'iterate'   => false,
+                        'path'      => 'data/mail/attachments',
+                        'recursive' => false,
+                    ],
+                ],
+            ],
+            /**
+             * the mail transport to use can be any class implementing
+             * Symfony\Component\Mailer\Transport\TransportInterface
+             *
+             * for standard mail transports, you can use these aliases:
+             * - sendmail  => Symfony\Component\Mailer\Transport\SendmailTransport
+             * - esmtp     => Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport
+             *
+             * defaults to sendmail
+             **/
+            'transport' => 'sendmail',
+            //options that will be used only if esmtp adapter is used
+            'smtp_options' => [
+                //hostname or IP address of the mail server
+                'host' => '',
+                //port of the mail server - 587 or 465 for secure connections
+                'port'              => 587,
+                'connection_config' => [
+                    //the smtp authentication identity
+                    'username' => '',
+                    //the smtp authentication credential
+                    'password' => '',
+                    //to disable auto_tls set tls key to false
+                    //it's not recommended to disable TLS while connecting to an SMTP server
+                    'tls' => null,
+                ],
+            ],
+        ],
+        // option to log the SENT emails
+        'log' => [
+            'sent' => getcwd() . '/log/mail/sent.log',
+        ],
+    ],
+];

config/config.php

@@ -25,7 +25,6 @@
     Laminas\Filter\ConfigProvider::class,
     Laminas\HttpHandlerRunner\ConfigProvider::class,
     Laminas\Hydrator\ConfigProvider::class,
-    Laminas\Mail\ConfigProvider::class,
     Laminas\Validator\ConfigProvider::class,
     // Include cache configuration
     new Laminas\ConfigAggregator\ArrayProvider($cacheConfig),