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_encodingICONV_INPUT_ENCODINGPHP_INI_ALL
iconv.output_encodingICONV_OUTPUT_ENCODINGPHP_INI_ALL
iconv.internal_encodingICONV_INTERNAL_ENCODINGPHP_INI_ALL
PHP_INI_* 상수에 대한 자세한 내용 및 정의는 ini_set()을 참고하십시오

리소스 종류

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

상수 정의

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

표 2. iconv 상수

이름설명
ICONV_IMPLstringimplementation 이름
ICONV_VERSIONstringimplementation 버전

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

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

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

이름설명
ICONV_MIME_DECODE_STRICTinteger iconv_mime_decode()에서 사용하는 비트마스크
ICONV_MIME_DECODE_CONTINUE_ON_ERRORinteger iconv_mime_decode()에서 사용하는 비트마스크

참고

참고: GNU Recode 함수.

차례
iconv_get_encoding --  문자 인코딩 변환을 위한 현재 설정 상태를 문의
iconv_mime_decode_headers --  Decodes multiple MIME header fields at once
iconv_mime_decode --  Decodes a MIME header field
iconv_mime_encode --  Composes a MIME header field
iconv_set_encoding --  문자 인코딩 변환을 설정 Set current setting for character encoding conversion
iconv_strlen --  Returns the character count of string
iconv_strpos --  Finds position of first occurrence of a needle within a haystack.
iconv_strrpos --  Finds the last occurrence of a needle within the specified range of haystack.
iconv_substr --  Cut out part of a string
iconv -- 원하는 문자 인코딩으로 변환한다
ob_iconv_handler --  출력 버퍼 핸들러로 문자 엔코딩을 변환한다