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 框架的轻松集成，您可以有效地保护您的数据。尝试一下，看看它如何提高应用程序的安全性！

如果您有任何问题或建议，请随时在下面评论！