kijin/example.md

## example.md

      
    Raw
  

              example.md
            
          
    Rhymix\Framework\Security

Security 클래스는 보안과 관련된 유틸리티를 모아 놓은 클래스로, 인스턴스 생성이 필요하지 않습니다.
Security 클래스에서 제공하는 것과 유사한 암호화, 난수 생성 등의 작업을 할 때는 가능하면 직접 구현하여 쓰지 말고 라이믹스 프레임워크에서 제공하는 것을 사용할 것을 권장합니다.
getRandom()

public static function getRandom(int $length = 32, string $format = 'alnum'): string

※ 실제 소스나 주석에 타입 선언이 없더라도 유추하여 작성합니다. 입력값이나 반환값의 타입이 여러 가지인 경우 ?object, array|false, void 등 최신 PHP 문법이나 PHP 매뉴얼과 유사한 형식으로 표현합니다.
요약


임시 비밀번호, 암호화 키 등 난수가 필요할 때 사용합니다.
문자열 형태의 난수를 생성하는 데 최적화되어 있으며, 정수가 필요할 경우 getRandomNumber() 메소드 사용을 권장합니다.
사용자의 시스템에서 사용할 수 있는 가장 안전한 난수 생성기를 자동으로 감지하도록 되어 있습니다. PHP 7 이후 대부분의 서버에서는 random_bytes() 내장함수를 사용합니다.

파라미터


$length : 반환할 문자열의 길이
$format : 반환할 문자열의 형태

binary : 바이너리를 그대로 반환합니다. 화면에 표시할 수 없는 문자나 널바이트 등이 포함될 수 있으므로, 직접 출력하거나 저장하기보다는 암호화 초기화 벡터 등 다른 연산의 입력값으로 활용하는 데 적합합니다.
hex : 0-9, a-f 문자만을 사용하여 인코딩합니다. 일정량의 엔트로피를 담는 데 가장 많은 문자가 필요합니다.
alnum : 영문 대소문자와 숫자를 사용합니다. (기본값)
printable : 특수문자를 포함하여 화면에 표시할 수 있는 모든 아스키 문자를 사용합니다.


반환값


지정한 길이의 문자열을 반환합니다.
반환값은 매번 다르며, 예측 가능한 주기로 반복되지 않습니다.

예외


이 메소드는 예외를 발생시키지 않습니다.

예제

$secret_key = \Rhymix\Framework\Security::getRandom(24, 'printable');

참고


Password
Security::getRandomNumber()
Security::getRandomUUID()
관련 외부 링크, PHP 매뉴얼 등