This page documents the SESSION_NAME configuration setting in FormMail.
Type Of Setting
SESSION_NAME 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
Sets the PHP session name.
Description
Set SESSION_NAME to a non-empty string to get a unique PHP session for your FormMail processing.
You generally only need to do this if your site is a PHP-based site that uses sessions.
FormMail attaches to or creates a PHP session so it can pass error information to bad_url.
On succcessful completion, and if you're not using good_url, FormMail destroys the session. If you use the default PHP session name on your site and within FormMail, this will cause any session information from your site to be discarded.
In summary, you'll only have a problem with sessions, and need to set SESSION_NAME to prevent these problems if all the following statements are true:
- Your website uses PHP sessions.
- Your website's PHP session name is the default for PHP.
- You do not specify "good_url" in your HTML form.
By specifying a unique name in SESSION_NAME, you avoid problems. You should set the same name in FMBadHandler too, if you're using that script. Also, VerifyImg.php if you're using that.
Choosing a Session Name
The PHP documentation states that a session name should contain only alphanumeric values. This means alphabetic (upper and lower case) and digits (0 through 9). It also states that at least one alphabetic (letter) must be included.
We've found that it's important to follow these rules. Don't use spaces, periods, or other punctuation in your session names. Use a short descriptive name starting with a letter (alphabetic character).
Using Captcha Creator
If you use Captcha Creator and want to change the session name, you'll need to follow additional instructions we've provided in the How-To guide.
Default Value
$SESSION_NAME = "";Examples
$SESSION_NAME = "FormProcessing";
