iconv_mime_encode 함수

함수

(PHP 5, PHP 7, PHP 8)

iconv_mime_encode — MIME 헤더 필드를 구성합니다.


설명

iconv_mime_encode(string $field_name, string $field_value, array $options = []): string|false

다음과 같은 유효한 MIME 헤더 필드를 나타내는 문자열을 작성하고 반환합니다.

Subject: =?ISO-8859-1?Q?Pr=FCfung_f=FCr?= Entwerfen von einer MIME kopfzeile

위의 예에서 "제목"은 필드 이름이고 "=?ISO-8859-1?..."로 시작하는 부분은 필드 값입니다.


매개변수
field_name
필드 이름입니다.
field_value
필드 값입니다.
options
구성 항목을 포함하는 연관 배열을 선택적 세 번째 매개변수 options에 지정하여 iconv_mime_encode()의 동작을 제어할 수 있습니다. iconv_mime_encode()에서 지원하는 항목은 다음과 같습니다. 항목 이름은 대소문자를 구분합니다.

iconv_mime_encode()에서 지원하는 구성 항목

Item Type 설명 Default value Example
scheme string 드 값을 인코딩하는 방법을 지정합니다. 이 항목의 값은 "B" 또는 "Q"일 수 있습니다. 여기서 "B"는 base64 인코딩 체계를 나타내고 "Q"는 quoted-printable 인코딩 체계를 나타냅니다. B B
input-charset string 첫 번째 매개변수 field_name과 두 번째 매개변수 field_value가 표시되는 문자 집합을 지정합니다. 지정하지 않으면 iconv_mime_encode()는 해당 매개변수가 iconv.internal_encoding ini 설정에 제공된 것으로 가정합니다. iconv.internal_encoding ISO-8859-1
output-charset string MIME 헤더를 구성하는 데 사용할 문자 집합을 지정합니다. iconv.internal_encoding UTF-8
line-length int 헤더 라인의 최대 길이를 지정합니다. » RFC2822 - Internet Message Format에 따라 결과 헤더 필드가 이 매개변수의 값보다 긴 경우 결과 헤더가 여러 줄 세트로 "접혀" 있습니다. 지정하지 않으면 길이가 76자로 제한됩니다. 76 996
line-break-chars string 긴 헤더 필드에서 "접기"가 수행될 때 줄 끝 기호로 각 줄에 추가할 문자 시퀀스를 지정합니다. 지정하지 않으면 기본값은 "\r\n"(CR LF)입니다. 이 매개변수는 input-charset 값에 관계없이 항상 ASCII 문자열로 취급된다는 점에 유의하십시오. \r\n \n

반환 값

성공하면 인코딩된 MIME 필드를 반환하고, 인코딩 중에 오류가 발생하면 false를 반환합니다.


Examples

예제 #1 iconv_mime_encode() 예제

                  
<?php
$preferences = array(
    "input-charset" => "ISO-8859-1",
    "output-charset" => "UTF-8",
    "line-length" => 76,
    "line-break-chars" => "\n"
);
$preferences["scheme"] = "Q";
// This yields "Subject: =?UTF-8?Q?Pr=C3=BCfung=20Pr=C3=BCfung?="
echo iconv_mime_encode("Subject", "Prüfung Prüfung", $preferences);

$preferences["scheme"] = "B";
// This yields "Subject: =?UTF-8?B?UHLDvGZ1bmcgUHLDvGZ1bmc=?="
echo iconv_mime_encode("Subject", "Prüfung Prüfung", $preferences);
?>

기타

PHP

웹학교

참조