Base class for all actions.
You must derive your action's classes from this class.
In the constructor you must define one or more function to validate the input.
Use the method setCheckFunction() to do that.
Example to validate input:
Every field (with the name of the form!!) must have an associative array with
the check type and his parameters.
$definitions is an associative array with the description of the checks.
$names is an associative array with the name of the fields, used for the error message.
$errorMsgs is an associative array with the possible errors. For every check of the field, it should contain a description of the error. {field} is a placeholder for the name of the field (see $names). {checkValue} is a placeholder for the given value for the check (for example: 'min' => 2).
If $errorMsg does not contain a message for the current error, it will just return '{field} is not valid' (parsed with GetText)
$definition has to be created as follow:
In myMVC_BaseAction there are many $VALIDATE_xxx defines to validate the different input fields.
Every validate-check can have more parameters.
In the following example-code you can find the validate-checks with their parameters explained.
You can give more than one parameter for every check.
Valid parameters for all checks (but $VALIDATE_EXTERN) are:
empty true or false. It decides wheter an empty field should be accepted.
range array of valid values for the checked field.
rangei same as range, but case insensitive (just for $VALIDATE_STRING, $VALIDATE_EMAIL and $VALIDATE_WEB).
rangesql SQL-query to get the valid values for the checked field.
rangesqli same as rangesql, but case insensitive (just for $VALIDATE_STRING, $VALIDATE_EMAIL and $VALIDATE_WEB).
comparedb Execute an SQL-query and compare the result with the given value.
In the query you can use {checkValue} as placeholder for the user's given input value. See example to use it.
WARNING: the query must return just one record with one column, otherwise it throws an exception.
$VALIDATE_NUMBER has 'min' and 'max', too, to restrict the valid numbers into a range.
$VALIDATE_DATETIME has 'format' to give the format of the date (see strftime). This parameter is mandatory!
$VALIDATE_STRING has the parameters 'minlen' and 'maxlen' to restrict the length of the input string, and the parameter 'regexp' to check the string against a given regular expression.
$VALIDATE_EXTERN has just the parameter 'checkFunction'. See the example.
If a required parameter wasn't given, the Framework generates an Exception.
this function must return true if data are valid, and false otherwise. In this case, $errMsg can contain an error message, that will be parsed with $errorMsgs (placeholder: {externError}).
Located in /myMVC/BaseAction.php (line 176)
myMVC_BasePage | --myMVC_BaseAction
Class | Description |
---|---|
![]() |
Action-class to manage a login system. |
![]() |
Action-class to manage a login system. |
Error not matched in compare database
Error empty
Error invalid (generic)
Error greater than given maximum
Error longer than given maximum
Error lesser than given minimum
Error smaller than given minimum
Error not boolean
Error not date/time
Error not E-Mail
Error not numeric
Error not string
Error not URL
Error not in given range
Error not matched in regular expression
Check for a boolean value
Check for a date/time value
Check for an E-Mail
Check using external function
Check for a numeric value
Check for a generic string
Check for an URL
Returns the string to be displayed in the menu to identify the current action.
Only necessary if isMenuAction() returns true
Returns the token used to identify the current Action
Returns the CSS class of this action
Returns whether the current user is allowed to call the current Action
Returns whether this action should appear in the menu (created by controller)
Constructor
Returns if the current action was called from menu or from a view
Returns whether this action was called from the given view
Called if user data are not valid (check with validate)
Perform the Action
Set the functions to be used to validate the user's input.
Validate the data from user.
It call the proper validate function, depending on the request method (GET or POST), to allow different checks. WARNING: this function should not be overrided! Please create proper validatePost() or validateGet() functions!
Check if the given data (from Request) are valid.
The function save in the session (namespace: validate) an associative array with the invalid fields.
Inherited From myMVC_BasePage
myMVC_BasePage::__construct()
myMVC_BasePage::getFromPreviousSubmit()
myMVC_BasePage::getInvalidFromPreviousSubmit()
myMVC_BasePage::getLoggedUser()
myMVC_BasePage::getParameterErrors()
myMVC_BasePage::getParameterFromPreviousPage()
myMVC_BasePage::isParameterFromPreviousSubmitValid()
myMVC_BasePage::saveParameterForNextPage()
Documentation generated on Wed, 27 Jun 2012 09:45:09 +0200 by phpDocumentor 1.4.4