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

У прикладі вище "Subject" є ім'ям поля, а частина рядка, починаючи з "=? ISO-8859-1? ..." – Його значення.

Список параметрів

field_name

Ім'я поля.

field_value

Значення поля.

options

Є можливість контролювати поведінку функції iconv_mime_encode() за допомогою передачі масиву з налаштуваннями як третій аргумент options. Можливі значення цього масиву, що підтримуються функцією iconv_mime_encode(), наведені нижче. Зверніть увагу, що імена елементів чутливі до регістру символів.

Установки, що підтримуються в iconv_mime_encode()

Элемент	Тип	Опис	Значение по умолчанию	Приклад
scheme	string	Задає, як закодувати значення поля. Значенням цього елемента може бути "B", або "Q". "B" означає схему кодування `base64`, а "Q" - `quoted-printable`	B	B
input-charset	string	Задає, в якому кодуванні представлені аргументи `field_name`и`field_value`. . Якщо не задано, iconv_mime_encode() передбачає, що набір символів вказано в ini-налаштуванні iconv.internal_encoding	iconv.internal_encoding	ISO-8859-1
output-charset	string	Задає набір символів, у якому буде представлений результат. `MIME`-Заголовок.	iconv.internal_encoding	UTF-8
line-length	int	Встановлює максимальну довжину рядків заголовка. Якщо результуючий заголовок виявиться довшим за цю величину, функція його розріже на кілька рядків відповідно до » Форматом інтернет повідомлень - RFC2822. . Якщо не встановлено, ця довжина буде встановлена 76 символами.	76	996
line-break-chars	string	Задає послідовність символів, які будуть використовуватися для завершення "розрізаних" рядків заголовка, якщо заголовок виявиться довшим за один рядок. Якщо не встановлено, будуть використовуватися символи "\r\n" (`CRLF`). Зверніть увагу, що цей аргумент завжди обробляється як рядок ASCII незалежно від значення `input-charset`	\r\n	\n

Значення, що повертаються

Повертає закодоване MIME-поле у разі успішного виконання або **false**в случае возникновения ошибки.

Приклади

Приклад #1 Приклад використання iconv_mime_encode()****

Loading...

Дивіться також

imap_binary() - Конвертує 8-бітовий рядок у рядок base64
mb_encode_mimeheader() - Кодує рядок для MIME-заголовка
imap_8bit() - Конвертує 8-бітний рядок у рядок у форматі quoted-printable
quoted_printable_encode() - Перетворює 8-бітний рядок методом quoted-printable