This filter converts any input to be lowercased.
The following options are supported for
encoding: This option can be used to set an encoding which has to be used.
This is a basic example:
$filter = new Zend_Filter_StringToLower();
// returns "sample"
Per default it will only handle characters from the actual locale of your
server. Characters from other charsets would be ignored. Still, it's
possible to also lowercase them when the mbstring extension is available
in your environment. Simply set the wished encoding when initiating the
StringToLower filter. Or use the
setEncoding() method to change the encoding afterwards.
// using UTF-8
$filter = new Zend_Filter_StringToLower('UTF-8');
// or give an array which can be useful when using a configuration
$filter = new Zend_Filter_StringToLower(array('encoding' => 'UTF-8'));
// or do this afterwards
Setting wrong encodings
Be aware that you will get an exception when you want to set an encoding and the mbstring extension is not available in your environment.
Also when you are trying to set an encoding which is not supported by your mbstring extension you will get an exception.