Lithe Crypt：简化 PHP 应用程序中的加密技术

php中文网 2024-11-05 12:08:36

lithe crypt 是 php 中的一个简单的加密和解密实用程序，旨在与 lithe 框架配合使用。它使用 aes-256-cbc 算法进行安全数据处理。

安装

要安装 lithe crypt 软件包，您可以使用 composer。如果您尚未安装，请确保 composer 在您的系统上可用。然后在项目目录中运行以下命令：

composer require lithemod/crypt

要求

php 8 或更高版本
在 php 安装中启用 openssl 扩展

使用

加载环境变量

在使用 crypt 类之前，您需要加载环境变量。使用以下代码加载您的 .env 文件：

use lithesupportenv;

// 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 lithesupportsecuritycrypt;

$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 lithesupportsecuritycrypt;

// 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 LitheExceptionsEncryptionCryptException;

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