FyreEncryption is a free, encryption library for PHP.

• Installation
• Methods
• Encrypters
  • OpenSSL
  • Sodium

Using Composer

composer require fyre/encryption

In PHP:

use Fyre\Encryption\Encryption;

Clear

Clear all instances and configs.

Encryption::clear();

Get Config

Set an encrypter config.

• $key is a string representing the encrypter key.

$config = Encryption::getConfig($key);

Alternatively, if the $key argument is omitted an array containing all configurations will be returned.

$config = Encryption::getConfig();

Get Key

Get the key for an encrypter instance.

• $encrypter is a Encrypter.

$key = Encryption::getKey($encrypter);

Load

Load an encrypter.

• $options is an array containing configuration options.

$encrypter = Encryption::load($options);

Set Config

Set the encrypter config.

• $key is a string representing the encrypter key.
• $options is an array containing configuration options.

Encryption::setConfig($key, $options);

Alternatively, a single array can be provided containing key/value of configuration options.

Encryption::setConfig($config);

Unload

Unload an encrypter.

• $key is a string representing the encrypter key, and will default to "default".

Encryption::unload($key);

Use

Load a shared encrypter instance.

• $key is a string representing the encrypter key, and will default to "default".

$encrypter = Encryption::use($key);

You can load a specific encrypter by specifying the className option of the $options variable above.

Custom encrypters can be created by extending \Fyre\Encryption\Encrypter, ensuring all below methods are implemented.

Decrypt

Decrypt data.

• $data is the encrypted data.
• $key is a string representing the encryption key.

$decrypted = $encrypter->decrypt($data, $key);

Encrypt

Encrypt data.

• $data is the data to encrypt.
• $key is a string representing the encryption key.

$encrypted = $encrypter->encrypt($data, $key);

Generate Key

Generate an encryption key.

$key = $encrypter->generateKey();

The OpenSSL encrypter can be loaded using default configuration using the "openssl" key.

$encrypter = Encryption::use('openssl');

You can also load the encrypter using custom configuration.

• $key is a string representing the encrypter key.
• $options is an array containing configuration options.
  • className must be set to \Fyre\Encryption\Handlers\OpenSSLEncrypter.
  • cipher is a string indicating the cipher, and will default to "AES-256-CTR".

Encryption::setConfig($key, $options);

$encrypter = Encryption::use($key);

The Sodium encrypter is the default handler.

$encrypter = Encryption::use();

You can also load the encrypter using custom configuration.

• $key is a string representing the encrypter key.
• $options is an array containing configuration options.
  • className must be set to \Fyre\Encryption\Handlers\SodiumEncrypter.
  • blockSize is a number indicating the block size, and will default to 16.

Encryption::setConfig($key, $options);

$encrypter = Encryption::use($key);