DEV Community

Lithe
Lithe

Posted on

2 2

Lithe Crypt: Simplifying Encryption in PHP Applications

Lithe Crypt is a simple encryption and decryption utility for PHP, designed to work with the Lithe framework. It utilizes the AES-256-CBC algorithm for secure data handling.

Installation

To install the Lithe Crypt package, you can use Composer. If you haven't installed it yet, make sure Composer is available on your system. Then run the following command in your project directory:

composer require lithemod/crypt
Enter fullscreen mode Exit fullscreen mode

Requirements

  • PHP 8 or higher
  • OpenSSL extension enabled in your PHP installation

Usage

Loading Environment Variables

Before using the Crypt class, you need to load your environment variables. Use the following code to load your .env file:

use Lithe\Support\Env;

// Load environment variables
Env::load(__DIR__); // Adjust the path as necessary
Enter fullscreen mode Exit fullscreen mode

Setting the APP_KEY

Ensure that the APP_KEY environment variable is set. This key should be a base64 encoded string of 32 bytes. You can configure it in your .env file or directly in your server environment.

Example of a valid base64 key:

YXNkZmFnc2Rhc2RmYWdlcyBhc2RmYWdlcyBhYXNkZmFnc2Q=
Enter fullscreen mode Exit fullscreen mode

Encrypting Data

To encrypt data, use the encrypt method of the Crypt class. You can also specify whether you want to use a fixed IV (initialization vector) for encryption:

use Lithe\Support\Security\Crypt;

$data = "sensitive data";

// Encrypt without fixed IV
$encrypted = Crypt::encrypt($data);
echo "Encrypted Data: " . $encrypted;

// Encrypt with fixed IV (useful for unique values like emails)
$encryptedWithSameIV = Crypt::encrypt($data, true);
echo "Encrypted Data with Fixed IV: " . $encryptedWithSameIV;
Enter fullscreen mode Exit fullscreen mode

Decrypting Data

To decrypt the previously encrypted data, use the decrypt method. You must specify the same parameters used during encryption to ensure proper decryption:

use Lithe\Support\Security\Crypt;

// Decrypt without fixed IV
$decrypted = Crypt::decrypt($encrypted);
echo "Decrypted Data: " . $decrypted;

// Decrypt with fixed IV
$decryptedWithSameIV = Crypt::decrypt($encryptedWithSameIV, true, $data);
echo "Decrypted Data with Fixed IV: " . $decryptedWithSameIV;
Enter fullscreen mode Exit fullscreen mode

Exception Handling

If the APP_KEY is not set or is invalid, the Crypt class will throw a CryptException. It's essential to handle this exception in your code to avoid unexpected errors:

use Lithe\Exceptions\Encryption\CryptException;

try {
    $encrypted = Crypt::encrypt($data);
    // Decrypt without fixed IV
    $decrypted = Crypt::decrypt($encrypted);
} catch (CryptException $e) {
    echo "Encryption Error: " . $e->getMessage();
}
Enter fullscreen mode Exit fullscreen mode

Final Considerations

Lithe Crypt provides a practical and secure way to handle encryption and decryption of data in your PHP applications. With the implementation of the AES-256-CBC algorithm and easy integration with the Lithe framework, you can effectively protect your data. Try it out and see how it can enhance your application's security!

If you have any questions or suggestions, feel free to comment below!

Sentry blog image

Identify what makes your TTFB high so you can fix it

In the past few years in the web dev world, we’ve seen a significant push towards rendering our websites on the server. Doing so is better for SEO and performs better on low-powered devices, but one thing we had to sacrifice is TTFB.

Read more

Top comments (0)

A Workflow Copilot. Tailored to You.

Pieces.app image

Our desktop app, with its intelligent copilot, streamlines coding by generating snippets, extracting code from screenshots, and accelerating problem-solving.

Read the docs

👋 Kindness is contagious

Immerse yourself in a wealth of knowledge with this piece, supported by the inclusive DEV Community—every developer, no matter where they are in their journey, is invited to contribute to our collective wisdom.

A simple “thank you” goes a long way—express your gratitude below in the comments!

Gathering insights enriches our journey on DEV and fortifies our community ties. Did you find this article valuable? Taking a moment to thank the author can have a significant impact.

Okay