Framework Documentation - Filter Package

Updating from v3 to v4

Release 4.0.0 raises the PHP requirement and removes one deprecated protected method.

At a glance

Minimum supported PHP version raised

All Framework packages now require PHP 8.3 or newer.

InputFilter::decode() was removed

The protected helper was a one-line wrapper deprecated since the PHP 5.3 era:

// Removed in 4.0.0
protected function decode($source)
{
    return html_entity_decode($source, \ENT_QUOTES, 'UTF-8');
}

Because it was protected, this only affects subclasses of InputFilter that called or overrode
it. Call the function directly:

// Before
$plain = $this->decode($source);

// After
$plain = html_entity_decode($source, \ENT_QUOTES, 'UTF-8');

To find the call sites:

grep -rn -- '->decode(' src/

No public method changed, so code that only uses clean() needs no work.

Dependency changes

joomla/language remains optional and moved to ^4.0.