array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.iconv-mime-encode.php', 1 => 'iconv_mime_encode', ), 'up' => array ( 0 => 'ref.iconv.php', 1 => 'iconv Funções', ), 'prev' => array ( 0 => 'function.iconv-mime-decode.php', 1 => 'iconv_mime_decode', ), 'next' => array ( 0 => 'function.iconv-set-encoding.php', 1 => 'iconv_set_encoding', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/iconv/functions/iconv-mime-encode.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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);
?>