This page documents the EMAIL_VALIDATION_MAX_MONITORING_TIME_SECS configuration setting in FormMail.
Type Of Setting
EMAIL_VALIDATION_MAX_MONITORING_TIME_SECS is an OPTIONAL setting, which means...
OPTIONAL : you can change this setting if you need to, but the default value is fine for most circumstances.
Précis
Control email domain validation monitoring.
Description
You can use EMAIL_VALIDATION_MAX_MONITORING_TIME_SECS with VALIDATE_EMAIL_DOMAIN to control what FormMail does if the email validation takes too long.
Email validation uses the Internet's Domain Name System (DNS) to find the MX records for the user's email address and this validation can fail for many reasons, including timeouts.
When EMAIL_VALIDATION_MAX_MONITORING_TIME_SECS is set to 0, any timeout will be treated as an error and the user will not be able to submit their form. This is the default behaviour.
EMAIL_VALIDATION_MAX_MONITORING_TIME_SECS allows you to set an upper bound for the time it takes to perform the MX record lookup and if the time exceeds the value you set, the email address is deemed to be correct.
This means you can make form submissions more reliable in the case of a DNS timeout problem.
As the name suggests, EMAIL_VALIDATION_MAX_MONITORING_TIME_SECS is a value in seconds, and fractional values are allowed. For example, 0.2 means 200 milliseconds.
If the MX record lookup takes longer than the value you set, FormMail creates a special field called "email_validation_time_secs" and fills it with the time (in seconds) that elapsed to perform the validation. You can use this field in your email templates and CSV files. The value is rounded to 2 decimal places.
This setting is available from version 10.00 of FormMail.
Default Value
$EMAIL_VALIDATION_MAX_MONITORING_TIME_SECS = 0;Examples
$EMAIL_VALIDATION_MAX_MONITORING_TIME_SECS = 5;$EMAIL_VALIDATION_MAX_MONITORING_TIME_SECS = 7.5;
