Contact Form Processing Products - for all your needs

FormMail • Form Encryption • Hosted Forms

LOGDIR Setting

This page documents the LOGDIR configuration setting in FormMail.

Type Of Setting

LOGDIR 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 directory/folder for log files.

Description

Set LOGDIR to the directory on your server where log files are stored. When an HTML form provides a 'logfile' value, formmail.php expects the file to be in this directory.

Generally you want this to be outside your server's document root directory. For example, if your server's document root directory is:

/home/yourname/www

use a directory like

/home/yourname/logs

If you don't want to support log files, make this an empty string:

$LOGDIR = "";

The log file simply contains a log of FormMail activity. It contains the date/time, the form user's real name, their email address, and the value of the "subject" field on the form.

One use for the log file is for auditing: you can check the number of successful form submissions and when they occurred. You might use this, for example, to verify that a day's work has been processed by your employees.

FormMail user AlecRaenos told us how he uses the log file:

We keep "lead" counts and this log file will be a HUGE help to us to determine:

  1. if our server is sending out all the processed forms - we have had trouble with this - and
  2. auditing how many leads we get for our business.

You might find other uses, if so, please let us know.

NOTE: you'll need to create the log file on your server and make it writable by the web server software. For security reasons, FormMail cannot do this for you. In general, the correct permissions for your log file are: rw-rw-rw-

NOTE: on Windows servers, use '/' instead of '\' or double the '\', like this:

"d:\\path\\to\\logs"

or

"d:/path/to/logs"

Default Value

$LOGDIR = "";

Examples

$LOGDIR = "/home/mysite/logs";

See Also