iconv 함수
소개
이 모듈은 iconv 문자셋 변환 기능을 사용하는 인터페이스를 가지고 있습니다. 이 모듈로, 로컬 문자셋을 유니코드 문자셋 등의 다른 문자셋으로 변환할 수 있습니다. 지원하는 문자셋은 시스템의 iconv 실행에 의존합니다. 몇몇 시스템에서는 iconv가 기대한대로 작동하지 않을 수 있는 점에 주의하십시오. » GNU libiconv 라이브러리를 설치하면 대부분의 경우에 좋은 결과를 얻을 수 있습니다.
PHP 5.0.0부터, 이 확장 모듈은 다중 언어 스크립트를 작성할 때 도움을 주는 다양한 실용적인 함수를 제공합니다. 새로운 기능에 대해서 아래의 섹션을 살펴보십시오.
요구 조건
최근의 POSIX 호환 시스템을 사용한다면 iconv 기능을 표준 C 라이브러리에서 지원하기 때문에, 추가로 필요한 것이 없습니다. 그렇지 않다면 » libiconv 라이브러리를 얻어서 시스템에 설치해야 합니다.
설치
이 모듈이 제공하는 함수를 사용하려면, 설정 옵션 --with-iconv[=DIR]을 사용하여 PHP 바이너리를 빌드해야 합니다.
Note: Windows® 사용자 주의 Windows® 환경에서 이 모듈을 사용하려면, PHP/Win32 바이너리 패키지에 들어 있는 iconv.dll, 또는 iconv-1.3.dll(4.2.1 이전) DLL 파일을 PATH 환경 변수로 지정한 디렉토리나 Windows®의 시스템 디렉토리에 놓아야 합니다.
실행시 설정
이 함수의 작동은 php.ini 설정에 영향을 받습니다.
| 이름 | 기본값 | 설정권한 | 변경점 |
|---|---|---|---|
| iconv.input_encoding | "ISO-8859-1" | PHP_INI_ALL | PHP 4.0.5부터 사용할 수 있습니다. |
| iconv.output_encoding | "ISO-8859-1" | PHP_INI_ALL | PHP 4.0.5부터 사용할 수 있습니다. |
| iconv.internal_encoding | "ISO-8859-1" | PHP_INI_ALL | PHP 4.0.5부터 사용할 수 있습니다. |
몇몇 시스템(IBM AIX 등)은 "ISO-8859-1" 대신에 "ISO8859-1"을 사용하기에, 이 값을 설정 옵션과 함수 매개변수로 사용합니다.
Note: 설정 옵션 iconv.input_encoding 는 현재 사용되지 않습니다.
자원형
이 확장은 리소스형을 정의하지 않습니다.
예약 상수
PHP 4.3.0부터 실행시에 이 확장 모듈에서 어느 iconv implementation을 사용할지 결정할 수 있습니다.
| 이름 | 형 | 설명 |
|---|---|---|
| ICONV_IMPL | string | implementation 이름 |
| ICONV_VERSION | string | implementation 버전 |
Note: 이 상수들을 사용하여 implementation 의존적인 스크립트를 작성하는 것은 절대 권장하지 않습니다.
PHP 5.0.0부터, 다음의 상수를 사용할 수 있습니다:
| 이름 | 형 | 설명 |
|---|---|---|
| ICONV_MIME_DECODE_STRICT | integer | iconv_mime_decode()에서 사용하는 비트마스크 |
| ICONV_MIME_DECODE_CONTINUE_ON_ERROR | integer | iconv_mime_decode()에서 사용하는 비트마스크 |
참고
참고: GNU Recode 함수.
Table of Contents
- 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 a haystack
- iconv_substr — Cut out part of a string
- iconv — 원하는 문자 인코딩으로 변환한다
- ob_iconv_handler — 출력 버퍼 핸들러로 문자 엔코딩을 변환한다