Download the PHP package saeven/zf3-purifier without Composer
On this page you can find all versions of the php package saeven/zf3-purifier. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package zf3-purifier
Soflomo\Purifier
Soflomo\Purifier is the HTMLPurifier integration for Zend Framework 2.
It provides a Laminas\Filter\FilterInterface implementation so you can use HTMLPurifier within your Laminas\InputFilter classes.
Furthermore, a view helper is provided to help purifying html on the fly in view scripts.
Installation
You can install Soflomo\Purifier through Composer
To enable the module in your ZF2 application, add an entry Soflomo\Purifier to the list of enabled modules in config/application.config.php.
Usage
In your input filter configuration, use the htmlpurifier as name in your filter spec.
An example Form:
or an InputFilter:
Alternatively, you can use the FQCN Soflomo\Purifier\PurifierFilter in place of the htmlpurifier alias.
If you're pulling the consumers from their respective plugin managers, this should work out-of-the-box. If not, please read how to inject the filter plugin manager.
If for some reason you want to use the filter in your view templates, you also have a view helper available.
Please be aware that HTMLPurifier is not a very fast library and as such, filtering on every request can be a significant performance bottleneck. Be advised to use a caching mechanism to cache the output of the filtered html. The view helper is available under the key htmlPurifier:
And there is a shorthand available too:
Configuring HTMLPurifier
HTMLPurifier use the class HTMLPurifier_Config to configure its rules. Most configuration rules are based on a key/value pair: $config->set('HTML.Doctype', 'HTML 4.01 Transitional').
Global configuration
The HTMLPurifier_Config key/value storege is exposed by Soflomo\Purifier as an associative array into the ZF2 configuration, so you can customize the default HTMLPurifier_Config instance like this:
The configuration factory also handles a definitions sub array to add custom definitions to the purifier, as documented here.
For example:
This will add a HTMLPurifier_AttrDef_Enum definition for the target attribute of the a element.
Note that an arbitrary value for the HTML.DefinitionID config key is required to correctly load the definition.
Definitions can also be set under the definitions key in the config array. These will override the key in the soflomo_purifier array.
Per-instance configuration
You can also set a different configuration each time you add the filter with a spec using the usual options key:
Injecting the FilterManager
If you instantiate your forms or your input filters manually with the new keyword, rather than pulling them from their respective plugin managers (i.e. FormElementManager and InputFilterManager), the FilterManager is not injected automatically into their factories, and these will resort to use a default one.
As such, you get a ServiceNotFoundException: Laminas\Filter\FilterPluginManager::get was unable to fetch or create an instance for htmlpurifier. This means the filter plugin manager was lazily instantiated, and does not know about the htmlpurifier plugin.
You can hack your way through this by executing the initializers manually:
It is however strongly advised to pull forms and input filters from their respective plugin managers, and use the init() method (which will be invoked after all the factories are injected) when applicable.
Performance optimization
HTMLPurifier is not the fastest library. It uses a large number of classes and files so autoloading can be cumbersome.
Luckily, you can create a standalone version of the HTMLPurifier class, where a single file contains most of the classes.
The script in vendor/bin/purifier-generate-standalone generates this file for you. The standalone file is created inside vendor/ezyang/htmlpurifier/library so make sure you can write in that directory.
Soflomo\Purifier helps you using this standalone version with the configuration option soflomo_purifier.standalone.
For example, you could add this in your config/autoload/local.php:
If you want to place the standalone file somewhere else, you can set its path too:
Note: The standalone generator script requires HTMLPurifier to be installed either with version <4.7.0 or with Composer --prefer-source flag, because since that version the maintenance tools were removed from the archive (see htmlpurifier #65).
