(PHP 5, PHP 7, PHP 8)
iconv_mime_encode — Compõe um campo de cabeçalho MIME
Compõe e retorna uma string que representa um campo de cabeçalho MIME
válido, semelhante ao seguinte:
Subject: =?ISO-8859-1?Q?Pr=FCfung_f=FCr?= Entwerfen von einer MIME kopfzeile
field_name
O nome do campo.
field_value
O valor do campo.
options
Você pode controlar o comportamento de iconv_mime_encode() especificando uma matriz associativa que contém itens de configuração para as options
opcionais do terceiro parâmetro. Os itens suportados por iconv_mime_encode() estão listados abaixo. Observe que os nomes dos itens são tratados com distinção entre maiúsculas e minúsculas.
Item | Tipo | Descrição | Valor padrão | Exemplo |
---|---|---|---|---|
scheme | string | Especifica o método para codificar um valor de campo. O valor deste item pode ser "B" ou "Q", onde "B" significa esquema de codificação base64 e "Q" significa esquema de codificação quoted-printable . | B | B |
input-charset | string | Especifica o conjunto de caracteres no qual o primeiro parâmetro field_name e o segundo parâmetro field_value são apresentados. Se não for fornecido, iconv_mime_encode() assume que esses parâmetros são apresentados a ele na configuração ini iconv.internal_encoding . | iconv.internal_encoding | ISO-8859-1 |
output-charset | string | Especifica o conjunto de caracteres a ser usado para compor o cabeçalho MIME . | iconv.internal_encoding | UTF-8 |
line-length | int | Especifica o comprimento máximo das linhas de cabeçalho. O cabeçalho resultante é "dobrado" em um conjunto de múltiplas linhas caso o campo do cabeçalho resultante seja maior que o valor deste parâmetro, de acordo com » RFC2822 - Internet Message Format. Se não for fornecido, o comprimento será limitado a 76 caracteres. | 76 | 996 |
line-break-chars | string | Especifica a sequência de caracteres a ser anexada a cada linha como um sinal de fim de linha quando a "dobragem" é executada em um campo de cabeçalho longo. Se não fornecido, o padrão é "\r\n" (CR LF ). Observe que esse parâmetro é sempre tratado como uma string ASCII, independentemente do valor de input-charset . | \r\n | \n |
Retorna um campo MIME
codificado em caso de sucesso ou false
se ocorrer um erro durante a codificação.
Exemplo #1 Exemplo 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);
?>