The Crypt password provides a set of classes that can be used for encrypting and hashing data.
PasswordInterface
is an interface that requires a class to be implemented with a create and a verify method.
The create method should take a plain text password and a type and return a hashed password.
The verify method should accept a plain text password and a hashed password and return a boolean indicating whether or not the password matched the password in the hash.
The PasswordInterface
interface defines the following constants for use with implementations:
PasswordInterface::BLOWFISH
PasswordInterface::JOOMLA
PasswordInterface::MD5
PasswordInterface::PBKDF
In addition to the interface PasswordInterface
there is also a basic implementation provided which provides for use with the most common password schemes. This if found in the Password\Simple
class.
Aside from the two methods create and verify methods, this implementation also adds an additional method called setCost. This method is used to set a cost parameter for methods that support workload factors. It takes an integer cost factor as a parameter.
Password\Simple
provides support for bcrypt, MD5 and the traditional Joomla! CMS hashing scheme. The hash format can be specified during hash creation by using the constants PasswordInterface::BLOWFISH
, PasswordInterface::MD5
, PasswordInterface::JOOMLA
, and PasswordInterface::PBKDF
. An appropriate salt will be automatically generated when required.
Add "joomla/crypt": "~3.0" to the require block in your composer.json and then run
composer install`.
{
"require": {
"joomla/crypt": "~3.0"
}
}
Alternatively, you can simply run the following from the command line:
composer require joomla/crypt "~3.0"
If you want to include the test sources, use
composer require --prefer-source joomla/crypt "~3.0"