Back

verifies()

Instructs CFWheels to verify that some specific criterias are met before running an action. Note that all undeclared arguments will be passed to redirectTo() call if a handler is not specified.

Name	Type	Required	Description
only	string	No	List of action names to limit this verification to.
except	string	No	List of action names to exclude this verification from.
post	any	No	Set to true to verify that this is a `POST` request.
get	any	No	Set to true to verify that this is a `GET` request.
ajax	any	No	Set to true to verify that this is an `AJAX` request.
cookie	string	No	Verify that the passed in variable name exists in the cookie scope.
session	string	No	Verify that the passed in variable name exists in the session scope.
params	string	No	Verify that the passed in variable name exists in the params struct.
handler	string	No	Pass in the name of a function that should handle failed verifications. The default is to just abort the request when a verification fails.
cookieTypes	string	No	List of types to check each listed cookie value against (will be passed through to your CFML engine's `IsValid` function).
sessionTypes	string	No	List of types to check each list session value against (will be passed through to your CFML engine's `IsValid` function).
paramsTypes	string	No	List of types to check each params value against (will be passed through to your CFML engine's `IsValid` function).

// Tell CFWheels to verify that the `handleForm` action is always a `POST` request when executed.
verifies(only="handleForm", post=true);

// Make sure that the edit action is a `GET` request, that `userId` exists in the `params` struct, and that it's an integer.
verifies(only="edit", get=true, params="userId", paramsTypes="integer");

// Just like above, only this time we want to invoke a custom function in our controller to handle the request when it is invalid.
verifies(only="edit", get=true, params="userId", paramsTypes="integer", handler="myCustomFunction");

// Just like above, only this time instead of specifying a handler, we want to `redirect` the visitor to the index action of the controller and show an error in The Flash when the request is invalid.
verifies(only="edit", get=true, params="userId", paramsTypes="integer", action="index", error="Invalid userId");