Lithe Crypt 是 PHP 中的一個簡單的加密和解密實用程序，旨在與 Lithe 框架配合使用。它使用 AES-256-CBC 演算法進行安全資料處理。

安裝

要安裝 Lithe Crypt 軟體包，您可以使用 Composer。如果您尚未安裝，請確保 Composer 在您的系統上可用。然後在專案目錄中執行以下命令：

composer require lithemod/crypt

要求

• PHP 8 或更高版本
• 您的 PHP 安裝中啟用了 OpenSSL 擴充

使用

載入環境變數

在使用Crypt類別之前，您需要載入環境變數。使用以下程式碼載入您的 .env 檔案：

use Lithe\Support\Env;

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

設定APP_KEY

確保已設定 APP_KEY 環境變數。此密鑰必須是 32 位元組的 base64 編碼字串。您可以在 .env 檔案中設定它，也可以直接在伺服器環境中設定它。

有效的 Base64 金鑰範例：

YXNkZmFnc2Rhc2RmYWdlcyBhc2RmYWdlcyBhYXNkZmFnc2Q=

加密數據

要加密數據，請使用 Crypt 類別的 encrypt 方法。也可以指定是否使用固定IV（初始化向量）進行加密：

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;

解密資料

要解密先前加密的數據，請使用decrypt方法。您必須指定與加密期間使用的相同參數以確保正確解密：

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;

例外處理

如果 APP_KEY 未定義或無效，Crypt 類別將拋出 CryptException。必須在程式碼中處理此異常以避免意外錯誤：

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();
}

最後的考慮因素

Lithe Crypt 提供了一種實用且安全的方法來處理 PHP 應用程式中的資料加密和解密。透過實施 AES-256-CBC 演算法以及與 Lithe 框架的輕鬆集成，您可以有效地保護您的資料。試試一下，看看它如何提高應用程式的安全性！

如果您有任何問題或建議，請隨時在下面評論！