Lithe Crypt는 Lithe 프레임워크와 함께 작동하도록 설계된 PHP의 간단한 암호화 및 암호 해독 유틸리티입니다. 안전한 데이터 처리를 위해 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 클래스의 암호화 메소드를 사용하십시오. 암호화에 고정 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 프레임워크와의 간편한 통합을 통해 데이터를 효과적으로 보호할 수 있습니다. 직접 사용해보시고 애플리케이션의 보안을 어떻게 향상시킬 수 있는지 알아보세요!

질문이나 제안사항이 있으시면 아래에 댓글을 남겨주세요!