PUT_DATA_IN_URL Setting

This page documents the PUT_DATA_IN_URL configuration setting in FormMail.

Type Of Setting

PUT_DATA_IN_URL is an OPTIONAL setting, which means...

Précis

Controls data transmission to bad_url.

Description

Set PUT_DATA_IN_URL to false if you want to prevent FormMail from placing data in the URL when redirecting to bad_url.

The default value is "true" and will work fine for forms with a small amount of data (less than 2000 bytes, approximately.)

However, URLs have a finite length which is dependent on the user's browser. If you've got forms with large amounts of data, then a redirect to bad_url will probably cause an error display to the user, for example: Cannot find server or DNS Error

By setting PUT_DATA_IN_URL to false, you avoid this problem.

In any case, error information and the data submitted in the form will be placed in PHP session variables.

So, if your bad_url target is written in PHP and your PHP version is sufficient to handle sessions correctly, you'll be fine with PUT_DATA_IN_URL set to false. (As always, test thoroughly!)

Otherwise, you'll need to keep PUT_DATA_IN_URL set to true and your forms will need to be small.

Default Value

From version 9 onwards:

$PUT_DATA_IN_URL = true;

Before version 9:

define("PUT_DATA_IN_URL",true);

$PUT_DATA_IN_URL = false;

define("PUT_DATA_IN_URL",false);