Framework Documentation - Crypt Package

Updating from v2 to v3

Release 3.0.0 raises the PHP requirement and reformats the codebase. No public or protected
method signature changed, so code written against 2.x keeps working on PHP 8.1.

At a glance

	v2 (2.0.1)	v3 (3.0.0)
PHP	^7.2.5 | ^8.0	^8.1.0
Public API	—	unchanged
Coding style	Joomla Coding Standard	PSR-12

Minimum supported PHP version raised

All Framework packages now require PHP 8.1 or newer.

No API changes

Crypt, CipherInterface, Key, the three ciphers and all five exception classes have the same
signatures in 3.0.0 as in 2.0.0.

Codebase converted to PSR-12

The package was reformatted from the Joomla Coding Standard to PSR-12. This touches nearly every
line and changes no behaviour, so a git diff between 2.x and 3.x is almost entirely noise. Use
git diff -w when looking for real changes.

Dependency changes

Package	v2 (2.0.1)	v3 (3.0.0)
php	^7.2.5 | ^8.0	^8.1.0

The optional packages are unchanged: ext-openssl, ext-sodium, defuse/php-encryption and
paragonie/sodium_compat all remain in suggest. Install defuse/php-encryption if you use
Cipher\Crypto, which is the recommended cipher.