PHP의 mb_list_encodings() 함수는 멀티바이트 확장(mbstring)에서 현재 지원하는 모든 문자 인코딩의 목록을 배열 형태로 반환합니다. 이 함수는 PHP 5 이상 버전에서 사용할 수 있으며, 별도의 매개변수 없이 호출만 하면 됩니다.
구문 (Syntax)
array mb_list_encodings()
매개변수 (Parameters)
mb_list_encodings() 함수는 어떠한 매개변수도 받지 않습니다.
반환 값 (Return Values)
이 함수는 지원되는 모든 인코딩 이름이 담긴 숫자 인덱스 배열(numerically indexed array)을 반환합니다. 배열의 각 요소는 인코딩 이름을 나타내는 문자열입니다.
오류 및 예외 (Errors/Exceptions)
mb_list_encodings() 함수는 호출 시 별도의 오류나 예외를 발생시키지 않습니다.
예제 (Example)
아래 예제에서는 mb_list_encodings() 함수를 호출하여 반환된 배열 전체를 var_dump()로 확인해 봅니다.
<?php $arr = mb_list_encodings(); var_dump($arr); ?>
출력 결과 (Output)
위 코드를 실행하면 다음과 같이 지원되는 인코딩 목록이 출력됩니다. 환경에 따라 PHP 버전이나 설치된 mbstring 설정에 따라 항목 수와 내용은 다소 달라질 수 있습니다.
array(87) {
[0]=> string(4) "pass"
[1]=> string(4) "auto"
[2]=> string(5) "wchar"
[3]=> string(7) "byte2be"
[4]=> string(7) "byte2le"
[5]=> string(7) "byte4be"
[6]=> string(7) "byte4le"
[7]=> string(6) "BASE64"
[8]=> string(8) "UUENCODE"
[9]=> string(13) "HTML-ENTITIES"
[10]=> string(16) "Quoted-Printable"
[11]=> string(4) "7bit"
[12]=> string(4) "8bit"
[13]=> string(5) "UCS-4"
[14]=> string(7) "UCS-4BE"
[15]=> string(7) "UCS-4LE"
[16]=> string(5) "UCS-2"
[17]=> string(7) "UCS-2BE"
[18]=> string(7) "UCS-2LE"
[19]=> string(6) "UTF-32"
[20]=> string(8) "UTF-32BE"
[21]=> string(8) "UTF-32LE"
[22]=> string(6) "UTF-16"
[23]=> string(8) "UTF-16BE"
[24]=> string(8) "UTF-16LE"
[25]=> string(5) "UTF-8"
[26]=> string(5) "UTF-7"
[27]=> string(9) "UTF7-IMAP"
[28]=> string(5) "ASCII"
[29]=> string(6) "EUC-JP"
[30]=> string(4) "SJIS"
[31]=> string(9) "eucJP-win"
[32]=> string(11) "EUC-JP-2004"
[33]=> string(8) "SJIS-win"
[34]=> string(18) "SJIS-Mobile#DOCOMO"
[35]=> string(16) "SJIS-Mobile#KDDI"
[36]=> string(20) "SJIS-Mobile#SOFTBANK"
[37]=> string(8) "SJIS-mac"
[38]=> string(9) "SJIS-2004"
[39]=> string(19) "UTF-8-Mobile#DOCOMO"
[40]=> string(19) "UTF-8-Mobile#KDDI-A"
[41]=> string(19) "UTF-8-Mobile#KDDI-B"
[42]=> string(21) "UTF-8-Mobile#SOFTBANK"
[43]=> string(5) "CP932"
[44]=> string(7) "CP51932"
[45]=> string(3) "JIS"
[46]=> string(11) "ISO-2022-JP"
[47]=> string(14) "ISO-2022-JP-MS"
[48]=> string(7) "GB18030"
[49]=> string(12) "Windows-1252"
[50]=> string(12) "Windows-1254"
[51]=> string(10) "ISO-8859-1"
[52]=> string(10) "ISO-8859-2"
[53]=> string(10) "ISO-8859-3"
[54]=> string(10) "ISO-8859-4"
[55]=> string(10) "ISO-8859-5"
[56]=> string(10) "ISO-8859-6"
[57]=> string(10) "ISO-8859-7"
[58]=> string(10) "ISO-8859-8"
[59]=> string(10) "ISO-8859-9"
[60]=> string(11) "ISO-8859-10"
[61]=> string(11) "ISO-8859-13"
[62]=> string(11) "ISO-8859-14"
[63]=> string(11) "ISO-8859-15"
[64]=> string(11) "ISO-8859-16"
[65]=> string(6) "EUC-CN"
[66]=> string(5) "CP936"
[67]=> string(2) "HZ"
[68]=> string(6) "EUC-TW"
[69]=> string(5) "BIG-5"
[70]=> string(5) "CP950"
[71]=> string(6) "EUC-KR"
[72]=> string(3) "UHC"
[73]=> string(11) "ISO-2022-KR"
[74]=> string(12) "Windows-1251"
[75]=> string(5) "CP866"
[76]=> string(6) "KOI8-R"
[77]=> string(6) "KOI8-U"
[78]=> string(9) "ArmSCII-8"
[79]=> string(5) "CP850"
[80]=> string(6) "JIS-ms"
[81]=> string(16) "ISO-2022-JP-2004"
[82]=> string(23) "ISO-2022-JP-MOBILE#KDDI"
[83]=> string(7) "CP50220"
[84]=> string(10) "CP50220raw"
[85]=> string(7) "CP50221"
[86]=> string(7) "CP50222"
}활용 팁
반환된 배열에는 in_array() 함수를 함께 사용하여 특정 인코딩이 서버에서 지원되는지 손쉽게 검사할 수 있습니다. 예를 들어 UTF-8 지원 여부를 확인하려면 in_array('UTF-8', mb_list_encodings())처럼 작성하면 되며, 이는 다국어 처리나 데이터 변환 로직을 구현할 때 유용하게 활용됩니다.