BasicObject methods

treatParameters( &$parameters, $setup )

Provides a system to pass complex parameters to a method, where parameters are passed in a hash array instead of the usual parameters passing method. A method using this system should accept a hash array of parameters and pass them as the first parameter to this method via a parent::treatParameters call, specifying as a second parameter a setup hash array of options for each parameter to be treated in a special way.

• parameters The hash array of received parameters.

• setup A hash array of setup options on how to treat each passed parameter, where each key is the parameter name, and each corresponding value a hash array to setup how that parameter will be treated, with the following possible keys:

  • isRequired When set to true, the parameter will be required and an error will be thrown if it has not been passed.

  • default The default value this parameter will take if no value was passed in $parameters

  • addArrayKeysIfNotExist When specified, the passed key-value pairs will be added to $parameters without overwriting any existing keys.

  • addArrayValuesIfNotExist When specified, the passed values will be added to the specific $parameters key as additional array items.