PHP 매뉴얼
이전 |  | 다음

# XL. iconv 함수

# 소개

이 모듈은 iconv 문자셋 변환 기능을 사용하는 인터페이스를 가지고 있습니다. 이 모듈로, 로컬 문자셋을 유니코드 문자셋 등의 다른 문자셋으로 변환할 수 있습니다. 지원하는 문자셋은 시스템의 iconv 실행에 의존합니다. 몇몇 시스템에서는 iconv가 기대한대로 작동하지 않을 수 있는 점에 주의하십시오. GNU libiconv 라이브러리를 설치하면 대부분의 경우에 좋은 결과를 얻을 수 있습니다.

PHP 5.0.0부터, 이 확장 모듈은 다중 언어 스크립트를 작성할 때 도움을 주는 다양한 실용적인 함수를 제공합니다. 새로운 기능에 대해서 아래의 섹션을 살펴보십시오.

# 요구 사항

최근의 POSIX 호환 시스템을 사용한다면 iconv 기능을 표준 C 라이브러리에서 지원하기 때문에, 추가로 필요한 것이 없습니다. 그렇지 않다면 libiconv 라이브러리를 얻어서 시스템에 설치해야 합니다.

# 설치

이 모듈이 제공하는 함수를 사용하려면, 설정 옵션 `--with-iconv[=DIR]`을 사용하여 PHP 바이너리를 빌드해야 합니다.

> Windows® 사용자 주의: Windows® 환경에서 이 모듈을 사용하려면, PHP/Win32 바이너리 패키지에 들어 있는 iconv.dll, 또는 iconv-1.3.dll(4.2.1 이전) DLL 파일을 `PATH` 환경 변수로 지정한 디렉토리나 Windows®의 시스템 디렉토리에 놓아야 합니다.

# 런타임 설정

이 함수의 작동은 `php.ini` 설정에 영향을 받습니다.

표 1. Iconv 설정 옵션

이름 | 기본값 | 변경가능성
--- | --- | ---
iconv.input_encoding | ICONV_INPUT_ENCODING | PHP_INI_ALL
iconv.output_encoding | ICONV_OUTPUT_ENCODING | PHP_INI_ALL
iconv.internal_encoding | ICONV_INTERNAL_ENCODING | PHP_INI_ALL

PHP_INI_* 상수에 대한 자세한 내용 및 정의는 ini_set()을 참고하십시오

# 리소스 종류

이 확장 모듈은 리소스형을 정의하지 않습니다.

# 상수 정의

PHP 4.3.0부터 실행시에 이 확장 모듈에서 어느 `iconv` implementation을 사용할지 결정할 수 있습니다.

표 2. `iconv` 상수

이름 | 형 | 설명
--- | --- | ---
ICONV_IMPL | string | implementation 이름
ICONV_VERSION | string | implementation 버전

> 참고: 이 상수들을 사용하여 implementation 의존적인 스크립트를 작성하는 것은 절대 권장하지 않습니다.

PHP 5.0.0부터, 다음의 상수를 사용할 수 있습니다:

표 3. PHP 5.0.0부터 사용할 수 있는 `iconv` 상수

이름 | 형 | 설명
--- | --- | ---
ICONV_MIME_DECODE_STRICT | integer | iconv_mime_decode()에서 사용하는 비트마스크
ICONV_MIME_DECODE_CONTINUE_ON_ERROR | integer | iconv_mime_decode()에서 사용하는 비트마스크

# 참고

참고: GNU Recode 함수.

이전 | 처음으로 | 다음
hw_api->userlist | 위로 | iconv_get_encoding