Fix manpage in documentation & add tests for DMA

Author: moqmar

README.md

@@ -463,8 +463,11 @@ DMA_CONF_SMARTHOST=smtp.example.org
 DMA_AUTH_USERNAME=noreply
 DMA_AUTH_PASSWORD=helloworld123
 # further DMA settings, according to the DMA man page, prefixed with DMA_CONF_
-# (see https://manpages.debian.org/unstable/dma/sendmail.8.en.html#dma.conf)
-DMA_CONF_STARTTLS=1
+# (see https://dspinellis.github.io/manview/?src=https://raw.githubusercontent.com/corecode/dma/v0.12/dma.8)
+# important for boolean settings: a specified but empty variable corresponds
+#                                 to true, an unspecified one to false!
+DMA_CONF_SECURETRANSFER=
+DMA_CONF_STARTTLS=
 ```
 
 DMA is **installed by default in the fat images**. If you are using the "*slim*" images, you need to install it by passing

build-and-test.sh

@@ -213,6 +213,24 @@ docker build -t test/composer_with_gd --build-arg PHP_VERSION="${PHP_VERSION}" -
 docker run --rm test/composer_with_gd sudo composer update
 docker rmi test/composer_with_gd
 
+# Let's check that we can send mail directly
+TESTMAIL_ID_DIRECT=$RANDOM
+docker run --rm -e DMA_BLOCKING=1 "thecodingmachine/php:${PHP_VERSION}-${BRANCH}-${BRANCH_VARIANT}" php -r "mail('[email protected]', 'Hello World ${TESTMAIL_ID_DIRECT}', 'This is an automatic test email, using a direct connection.');"
+
+# Let's check that we can send mail through a smarthost with credentials
+# Sending to an MCAST-TEST-NET IP address as that must not appear on the public internet according to RFC 5771, and will thus be unreachable for direct sending.
+TESTMAIL_ID_SMARTHOST=$RANDOM
+docker run --rm -e DMA_BLOCKING=1 -e DMA_CONF_SMARTHOST=smtp.ethereal.email -e DMA_CONF_PORT=587 -e DMA_CONF_SECURETRANSFER= -e DMA_CONF_STARTTLS= -e [email protected] -e DMA_AUTH_PASSWORD=pjxG3kc3VR31jQUvHz "thecodingmachine/php:${PHP_VERSION}-${BRANCH}-${BRANCH_VARIANT}" php -r "mail('[email protected]', 'Hello World ${TESTMAIL_ID_SMARTHOST}', 'This is an automatic test email, using a smarthost.');"
+
+# Let's check that the mails came through
+ETHEREAL_COOKIEJAR=$(mktemp --tmpdir ethereal-cookies.XXXXXXXXXX)
+ETHEREAL_CSRF=$(curl https://ethereal.email/login -s --fail -c "${ETHEREAL_COOKIEJAR}" | grep -Pom1 '\bname="_csrf" value="\K[^"]+')
+curl https://ethereal.email/login -s --fail -X POST --data-urlencode "[email protected]" --data-urlencode "password=pjxG3kc3VR31jQUvHz" --data-urlencode "_csrf=${ETHEREAL_CSRF}" -b "${ETHEREAL_COOKIEJAR}" -c "${ETHEREAL_COOKIEJAR}" >/dev/null
+ETHEREAL_INBOX=$(curl https://ethereal.email/messages -s --fail -b "${ETHEREAL_COOKIEJAR}")
+rm "${ETHEREAL_COOKIEJAR}"
+echo "${ETHEREAL_INBOX}" | grep -F ">Hello World ${TESTMAIL_ID_DIRECT}<"
+echo "${ETHEREAL_INBOX}" | grep -F ">Hello World ${TESTMAIL_ID_SMARTHOST}<"
+
 #################################
 # Let's build the "node" images
 #################################

utils/README.blueprint.md

@@ -381,8 +381,11 @@ DMA_CONF_SMARTHOST=smtp.example.org
 DMA_AUTH_USERNAME=noreply
 DMA_AUTH_PASSWORD=helloworld123
 # further DMA settings, according to the DMA man page, prefixed with DMA_CONF_
-# (see https://manpages.debian.org/unstable/dma/sendmail.8.en.html#dma.conf)
-DMA_CONF_STARTTLS=1
+# (see https://dspinellis.github.io/manview/?src=https://raw.githubusercontent.com/corecode/dma/v0.12/dma.8)
+# important for boolean settings: a specified but empty variable corresponds
+#                                 to true, an unspecified one to false!
+DMA_CONF_SECURETRANSFER=
+DMA_CONF_STARTTLS=
 ```
 
 DMA is **installed by default in the fat images**. If you are using the "*slim*" images, you need to install it by passing