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 | Default | 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");