The usage of filters is quite simple. There are several methods for adding and manipulating filters.

• addFilter($filter, $options = null, $files = null): Adds the given filter to the filter stack (optionally only to the file(s) specified). $filter may be either an actual filter instance, or a short name specifying the filter type (e.g., 'Rename').

• addFilters(array $filters, $files = null): Adds the given filters to the stack of filters. Each entry may be either a filter type/options pair, or an array with the key 'filter' specifying the filter (all other options will be considered filter options for instantiation).

• setFilters(array $filters, $files = null): Overwrites any existing filters with the filters specified. The filters should follow the syntax for addFilters().

• hasFilter($name): Indicates if a filter has been registered.

• getFilter($name): Returns a previously registered filter.

• getFilters($files = null): Returns registered filters; if $files is passed, returns filters for that particular file or set of files.

• removeFilter($name): Removes a previously registered filter.

• clearFilters(): Clears all registered filters.

Generally you should simply use the addFilters() method, which can be called multiple times.

Note: Note that even though setting the same filter multiple times is allowed, doing so can lead to issues when using different options for the same filter.

The Decrypt filter allows to decrypt a encrypted file.

This filter makes use of Zend_Filter_Decrypt. It supports the Mcrypt and OpenSSL extensions from PHP. Please read the related section for details about how to set the options for decryption and which options are supported.

This filter supports one additional option which can be used to save the decrypted file with another filename. Set the filename option to change the filename where the decrypted file will be stored. If you suppress this option, the decrypted file will overwrite the original encrypted file.

The Encrypt filter allows to encrypt a file.

This filter makes use of Zend_Filter_Encrypt. It supports the Mcrypt and OpenSSL extensions from PHP. Please read the related section for details about how to set the options for encryption and which options are supported.

This filter supports one additional option which can be used to save the encrypted file with another filename. Set the filename option to change the filename where the encrypted file will be stored. If you suppress this option, the encrypted file will overwrite the original file.

The LowerCase filter allows to change the content of a file to lowercase. You should use this filter only on textfiles.

At initiation you can give a string which will then be used as encoding. Or you can use the setEncoding() method to set it afterwards.

Note: Note that due to the fact that the options for the LowerCase filter are optional, you must give a NULL as second parameter (the options) when you want to limit it to a single file element.

The Rename filter allows to change the destination of the upload, the filename and also to overwrite existing files. It supports the following options:

• source: The name and destination of the old file which shall be renamed.

• target: The new directory, or filename of the file.

• overwrite: Sets if the old file overwrites the new one if it already exists. The default value is FALSE.

Additionally you can also use the method setFile() to set files, which erases all previous set, addFile() to add a new file to existing ones, and getFile() to get all actually set files. To simplify things, this filter understands several notations and that methods and constructor understand the same notations.

You can use different notations. Below is a table where you will find a description and the intention for the supported notations. Note that when you use the Adapter or the Form Element you will not be able to use all described notations.

Different notations of the rename filter and their meaning

notation	description
addFile('C:\uploads')	Specifies a new location for all files when the given string is a directory. Note that you will get an exception when the file already exists, see the overwriting parameter.
addFile('C:\uploads\file.ext')	Specifies a new location and filename for all files when the given string is not detected as directory. Note that you will get an exception when the file already exists, see the overwriting parameter.
addFile(array('C:\uploads\file.ext', 'overwrite' => true))	Specifies a new location and filename for all files when the given string is not detected as directory and overwrites an existing file with the same target name. Note, that you will get no notification that a file was overwritten.
addFile(array('source' => 'C:\temp\uploads', 'target' => 'C:\uploads'))	Specifies a new location for all files in the old location when the given strings are detected as directory. Note that you will get an exception when the file already exists, see the overwriting parameter.
addFile(array('source' => 'C:\temp\uploads', 'target' => 'C:\uploads', 'overwrite' => true))	Specifies a new location for all files in the old location when the given strings are detected as directory and overwrites and existing file with the same target name. Note, that you will get no notification that a file was overwritten.

The UpperCase filter allows to change the content of a file to uppercase. You should use this filter only on textfiles.

At initiation you can give a string which will then be used as encoding. Or you can use the setEncoding() method to set it afterwards.

Note: Note that due to the fact that the options for the UpperCase filter are optional, you must give a NULL as second parameter (the options) when you want to limit it to a single file element.