PHP에서 iconv_get_encoding() 함수는 iconv 확장 모듈의 내부 설정 변수들을 조회하는 데 사용됩니다. PHP에 기본으로 내장된 함수로, PHP 4 버전부터 제공되어 왔습니다. 다국어 환경이나 문자셋 변환 작업을 처리할 때 현재 적용된 인코딩 설정을 확인하는 유용한 도구입니다.
문법(Syntax)
mixed iconv_get_encoding($type = "all")
매개변수(Parameter)
iconv_get_encoding() 함수는 하나의 매개변수인 $type만 사용합니다.
$type − 선택적으로 지정할 수 있으며, 사용 가능한 값은 아래와 같습니다.
- all – 모든 설정값을 배열로 반환
- input_encoding – 입력 인코딩 값 반환
- output_encoding – 출력 인코딩 값 반환
- internal_encoding – 내부 인코딩 값 반환
반환 값(Return Value)
함수 호출이 성공하면 해당 내부 설정 변수의 현재 값을 반환하고, 실패할 경우 False를 반환합니다. 만약 $type 매개변수가 전달되지 않거나 'all'로 설정된 경우, 모든 설정 변수를 담은 배열을 반환합니다.
예제 1 – 모든 인코딩 설정 조회하기
<?php
iconv_set_encoding("internal_encoding", "UTF-8");
iconv_set_encoding("output_encoding", "ISO-8859-1");
var_dump(iconv_get_encoding('all'));
?>출력 결과
array(3) {
["input_encoding"]=>
string(5) "UTF-8"
["output_encoding"]=>
string(10) "ISO-8859-1"
["internal_encoding"]=>
string(5) "UTF-8"
}설명 − 위 PHP 코드에서는 iconv_set_encoding()으로 내부 인코딩과 출력 인코딩을 각각 설정한 후, iconv_get_encoding()에 'all'을 전달했습니다. 따라서 input_encoding, output_encoding, internal_encoding 세 가지 설정값이 모두 배열 형태로 출력됩니다.
예제 2 – internal_encoding만 조회하기
<?php
// internal_encoding만 조회
iconv_set_encoding("internal_encoding", "UTF-8");
var_dump(iconv_get_encoding('internal_encoding'));
?>출력 결과
string(5) "UTF-8"
설명 − 이번에는 'all' 대신 'internal_encoding'만 전달했기 때문에, 배열이 아닌 단일 문자열 값인 "UTF-8"이 그대로 반환됩니다. 특정 설정값 하나만 빠르게 확인해야 할 때 유용한 방식입니다.