Riverwatcher Active Content Environment

RACE Documentation:


EXIT - Exiting a script and returning a result or status to Apache



  • RESULT - Apache Module Result Code to be returned to the server. Legal values are: OK, SERVER_ERROR, DECLINED, FORBIDDEN, AUTH_REQUIRED, or NOT_FOUND.
  • STATUS - HTTP return status to send to the browser. Any valid HTTP code can be used, including: HTTP_OK, HTTP_MOVED_PERMANENTLY, HTTP_MOVED_TEMPORARILY, HTTP_SEE_OTHER, HTTP_TEMPORARY_REDIRECT, HTTP_NOT_FOUND, HTTP_GONE, HTTP_NOT_IMPLEMENTED, HTTP_INTERNAL_SERVER_ERROR, and HTTP_SERVICE_UNAVAILABLE.
The exit tag is used to abort the execution of a RACE script. When invoked, the RACE engine will return everything currently in the output stream to the browser, including the optional status and result attributes, and stop execution of the current page.

Example - Aborting a script
Source:
Error: Improperly formatted array or hash.

Output:
This snippet checks to see if $valid_user equals 'true'. If not, the page immediately aborts.


Example - Script-based hotlink page protection
Source:

<if test="<$system.referer> != 'www.mydomain.com'">
  <exit status="204">
<else>
  Welcome.
</if>

Output:
This performs simple hotlink protection to keep external websites from linking to a specific script on www.mydomain.com by returning a 204 No Content error.




RACE Documentation



 
Copyright 2009 Riverwatcher, Inc. Hosting by Riverwatcher Studios