Overview
This article can be followed to implement basic ColdFusion “onMissingTemplate” and “onError” handling within your web application. Error handling is vital for any web application and should be implemented on every production website. ColdFusion gives you the ability to easily implement error handling within your application and allows you to determine how a web application responds to certain error types. Error handling allows you to control what exactly a visitor sees when an error is generated on your website. You should never allow a visitor to see robust exception information on your public facing web application. Robust error information could expose portions of your code base that is meant to be private any may lead to unintentional information disclosure. By default, we have Robust Exception Information disabled at the server level on our servers.
ColdFusion Error Handling
The below example can be utilized to implement a “onError” and “onMissingTemplate” function within your website’s Application.cfc file:
Please note: If your web application is relying on an Application.cfm file you will need to convert it to an Application.cfc file in order to utilize the onError & onMissingTemplate handling function within ColdFusion. By default, if both an Application.cfc file and Application.cfm file exist within a ColdFusion application the Application.cfc will run first and the Application.cfm file will be completely ignored.
Please refer to our community article on how to convert an Application.cfm to an Application.cfc file if the above note applies to you.
statusCode = "404" statusText = "Page Not Found" > statusCode = "500" statusText = "Internal Server Error" > action = "append" file = "#logPath#" output = "#ErrorMessage#" >
Beginning in ColdFusion 8 and above, there are now methods of handling 404 errors and 500 errors through two separate functions in the Application.cfc. The ‘onMissingTemplate’ function is used to handle 404 errors and the ‘onError’ function is used to handle 500 errors.
In the above example, there are two application variables that determine in what file 500 errors are logged and which page to display to the user when an error occurs:
Also, it should be noted that any errors caught by the above error handling will be written to the error log file you define rather than the server’s ColdFusion logs. You can set the above file name attributes to whatever file names you prefer.
Congratulations! You have implemented your first “onError” and “onMissingTemplate” functions within your ColdFusion application. If you have any questions for our support team concerning error handling please feel free to contact us.