joomla/filter

Joomla Filter Package

3.0.3 2025-04-01 09:46 UTC

Requires

• php: ^8.1.0
• joomla/string: ^3.0

Requires (Dev)

• joomla/language: ^3.0
• phan/phan: ^5.4.2
• phpstan/phpstan: ^2.0
• phpstan/phpstan-deprecation-rules: ^2.0
• phpunit/phpunit: ^9.5.28
• squizlabs/php_codesniffer: ^3.7.2

Suggests

• joomla/language: Required only if you want to use `OutputFilter::stringURLSafe`.

GPL-2.0-or-later

• framework
• filter
• joomla

README

Installation via Composer

Add "joomla/filter": "~3.0.*@dev" to the require block in your composer.json and then run composer install.

{
	"require": {
		"joomla/filter": "~3.0"
	}
}

Alternatively, you can simply run the following from the command line:

composer require joomla/filter "~3.0"

If you want to include the test sources, use

composer require --prefer-source joomla/filter "~3.0"

Note that the Joomla\Language package is an optional dependency and is only required if the application requires the use of OutputFilter::stringURLSafe.

Upgrades from 1 to 2

Note the InputFilter static class constants have been renamed:

Before	After
InputFilter::TAGS_WHITELIST	InputFilter::ONLY_ALLOW_DEFINED_TAGS
InputFilter::TAGS_BLACKLIST	InputFilter::ONLY_BLOCK_DEFINED_TAGS
InputFilter::ATTR_WHITELIST	InputFilter::ONLY_ALLOW_DEFINED_ATTRIBUTES
InputFilter::ATTR_BLACKLIST	InputFilter::ONLY_BLOCK_DEFINED_ATTRIBUTES

The public property InputFilter::tagBlacklist has been renamed to InputFilter::blockedTags. Similarly InputFilter::attrBlacklist has been renamed to InputFilter::blockedAttributes

All code usage of these properties remains unchanged.