adbario/php-encrypter

Encryption with AES-256 and HMAC-SHA256

PHP Encrypter

This project encrypts and decrypts the given value. It uses OpenSSL extension with AES-256 cipher for encryption and HMAC-SHA-256 for hash. The encryption and hash can use different keys., _(*1)

PHP Encrypter requires PHP 5.3 or higher, OpenSSL and Multibyte String extensions., _(*2)

Security Notice

As a reversible operation, encryption is not a secure solution for storing passwords. Always use hashing with salt per user for passwords., _(*3)

Installation

With Composer:

composer require adbario/php-encrypter

Manual installation:

1. Download the latest release
2. Extract the files into your project
3. require_once '/path/to/php-encrypter/src/Encrypter.php';
4. If your PHP version is lower than 7, also polyfill for random_bytes() is required

Usage

Setup the encryption key:, _(*4)

$key = '+NeXrQhAEhW}g8gf^y)Up8hAUKpue7wb';

Change the key to your own custom random 32 character string., _(*5)

Create a new encrypter instance:, _(*6)

$encrypter = new \Adbar\Encrypter($key);

If you wish to use a different key for hashing, you can pass it to constructor as a second parameter:, _(*7)

$encrypter = new \Adbar\Encrypter($key, $authKey);

Encryption

Encrypt a string:, _(*8)

$string = 'This is my string to encrypt.';
$encrypted = $encrypter->encryptString($string);

Encrypt other variable types with serialization:, _(*9)

$array = array('key' => 'value');
$encrypted = $encrypter->encrypt($array);

Decryption

Decrypt a string:, _(*10)

$string = $encrypter->decryptString($encrypted);

Decrypt other variable types with serialization:, _(*11)

$array = $encrypter->decrypt($encrypted);

License

MIT license, _(*12)