Handling Errors

Phorm™ v3.5.2

Handling Errors:

If an error occurs during Phorm's operation, such as an inaccessible file, processing will proceed if possible, or terminate, depending on what the problem is. In any case, a message is generated. Problems that prevent Phorm from operating at all, such as being unable to open the configuration file, are called errors; problems that only affect the back end, such as unable to open the log file, or unable to open the database, are called alerts. Error messages are always displayed to the visitor, and cause Phorm to abort. Alert messages are displayed to the visitor unless you specify an email address to have them sent to. To have alert messages sent to you, define $PHORM_ALERTTO with the email address. If you wish, you can also specify a From: address for the alerts message, with the variable $PHORM_ALERTFM.

Error messages (and alerts, if you don't define $PHORM_ALERTTO) are displayed to the visitor on a simple, blank page. If you wish to provide a customized page for error and alert messages to be displayed on, create an HTML file named *****_err.html, where ***** is the name you assigned to the form with $PHORM_NAME. For example, if your form is named widgets, the error page for it would be named widgets_err.html. This file must be located in the files directory under the Phorm directory (or whatever directory you've defined in $PHORM_ROOT). Include the message indicator  to indicate where the messages should be displayed on the page. There is a special case for this file: If $PHORM_NAME has no value (for example, when a visitor attempts to access Phorm directly), Phorm will look for a file named phorm_err.html and use that if it exists.

Customizing Error Messages

Phorm's error messages are contained in the file messages.txt in the lib subdirectory, to allow for easy customization or translation. Read that file for instructions on how to format your messages. If you wish to provide a translated message file, I will be happy to include it in the distribution.

0101000001101000011011110111001001101101010010010111001101000011011011110110111101101100