Lithe Crypt ist ein einfaches Verschlüsselungs- und Entschlüsselungsdienstprogramm in PHP, das für die Arbeit mit dem Lithe-Framework entwickelt wurde. Es nutzt den AES-256-CBC-Algorithmus zur sicheren Datenverarbeitung.

Installation

Um das Lithe Crypt-Paket zu installieren, können Sie Composer verwenden. Wenn Sie es noch nicht installiert haben, stellen Sie sicher, dass Composer auf Ihrem System verfügbar ist. Führen Sie dann den folgenden Befehl in Ihrem Projektverzeichnis aus:

composer require lithemod/crypt

Anforderungen

• PHP 8 oder höher
• OpenSSL-Erweiterung in Ihrer PHP-Installation aktiviert

Verwenden

Umgebungsvariablen laden

Bevor Sie die Crypt-Klasse verwenden, müssen Sie Ihre Umgebungsvariablen laden. Verwenden Sie den folgenden Code, um Ihre .env-Datei zu laden:

use Lithe\Support\Env;

// Carregar variáveis de ambiente
Env::load(__DIR__); // Ajuste o caminho conforme necessário

Festlegen des APP_KEY

Stellen Sie sicher, dass die Umgebungsvariable APP_KEY festgelegt ist. Dieser Schlüssel muss eine 32-Byte-Base64-codierte Zeichenfolge sein. Sie können es in Ihrer .env-Datei oder direkt in der Serverumgebung konfigurieren.

Beispiel für einen gültigen Base64-Schlüssel:

YXNkZmFnc2Rhc2RmYWdlcyBhc2RmYWdlcyBhYXNkZmFnc2Q=

Daten verschlüsseln

Um Daten zu verschlüsseln, verwenden Sie die Verschlüsselungsmethode der Crypt-Klasse. Sie können auch angeben, ob ein fester IV (Initialisierungsvektor) für die Verschlüsselung verwendet werden soll:

use Lithe\Support\Security\Crypt;

$data = "dados sensíveis";

// Criptografar sem IV fixo
$encrypted = Crypt::encrypt($data);
echo "Dados Criptografados: " . $encrypted;

// Criptografar com IV fixo (útil para valores únicos como e-mails)
$encryptedWithSameIV = Crypt::encrypt($data, true);
echo "Dados Criptografados com IV Fixo: " . $encryptedWithSameIV;

Daten entschlüsseln

Um zuvor verschlüsselte Daten zu entschlüsseln, verwenden Sie die Entschlüsselungsmethode. Sie müssen dieselben Parameter angeben, die während der Verschlüsselung verwendet wurden, um eine korrekte Entschlüsselung sicherzustellen:

use Lithe\Support\Security\Crypt;

// Descriptografar sem IV fixo
$decrypted = Crypt::decrypt($encrypted);
echo "Dados Descriptografados: " . $decrypted;

// Descriptografar com IV fixo
$decryptedWithSameIV = Crypt::decrypt($encryptedWithSameIV, true, $data);
echo "Dados Descriptografados com IV Fixo: " . $decryptedWithSameIV;

Ausnahmebehandlung

Wenn der APP_KEY nicht definiert oder ungültig ist, löst die Crypt-Klasse eine CryptException aus. Es ist wichtig, diese Ausnahme in Ihrem Code zu behandeln, um unerwartete Fehler zu vermeiden:

use Lithe\Exceptions\Encryption\CryptException;

try {
    $encrypted = Crypt::encrypt($data);
    // Descriptografar sem IV fixo
    $decrypted = Crypt::decrypt($encrypted);
} catch (CryptException $e) {
    echo "Erro de Criptografia: " . $e->getMessage();
}

Abschließende Überlegungen

Lithe Crypt bietet eine praktische und sichere Möglichkeit, die Datenverschlüsselung und -entschlüsselung in Ihren PHP-Anwendungen durchzuführen. Mit der Implementierung des AES-256-CBC-Algorithmus und der einfachen Integration in das Lithe-Framework können Sie Ihre Daten effektiv schützen. Probieren Sie es aus und sehen Sie, wie es die Sicherheit Ihrer Anwendung verbessern kann!

Wenn Sie Fragen oder Vorschläge haben, können Sie unten gerne einen Kommentar abgeben!