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

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

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

安装

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

composer require lithemod/crypt

要求

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

用法

加载环境变量

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

use lithesupportenv;

// load environment variables
env::load(__dir__); // adjust the path as necessary

设置app_key

确保已设置 app_key 环境变量。该密钥应该是 32 字节的 base64 编码字符串。您可以在 .env 文件中配置它，也可以直接在服务器环境中配置它。

有效的 base64 密钥示例：

yxnkzmfnc2rhc2rmywdlcybhc2rmywdlcybhyxnkzmfnc2q=

加密数据

要加密数据，请使用 crypt 类的 encrypt 方法。您还可以指定是否要使用固定iv（初始化向量）进行加密：

use lithesupportsecuritycrypt;

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

解密数据

要解密之前加密的数据，请使用decrypt方法。您必须指定加密期间使用的相同参数以确保正确解密：

use lithesupportsecuritycrypt;

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

异常处理

如果 app_key 未设置或无效，crypt 类将抛出 cryptexception。必须在代码中处理此异常以避免意外错误：

use LitheExceptionsEncryptionCryptException;

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