joomla/crypt

Joomla Crypt Package

3.0.1 2024-08-15 19:53 UTC

README

Latest Stable Version Total Downloads Latest Unstable Version License

The Crypt password provides a set of classes that can be used for encrypting and hashing data.

Interfaces

PasswordInterface

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

Classes

Password\Simple

Usage

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.

Installation via Composer

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"