mb_encode_mimeheader

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_encode_mimeheader — Codificar string para cabeçalho MIME

Descrição

mb_encode_mimeheader(
    string $string,
    ?string $charset = null,
    ?string $transfer_encoding = null,
    string $newline = "\r\n",
    int $indent = 0
): string

Codifica uma string string pelo esquema de codificação de cabeçalho MIME.

Parâmetros

string

A string a ser codificada. Sua codificação deve ser a mesma que mb_internal_encoding().

charset

charset especifica o nome do conjunto de caracteres no qual string está representada. O valor padrão é determinado pela configuração NLS atual (mbstring.language).

transfer_encoding

transfer_encoding especifica o esquema de codificação MIME. Deve ser ou "B" (Base64) ou "Q" (Quoted-Printable). Retrocede para "B" se não fornecido.

newline

newline especifica o marcador de EOL (end-of-line) com o qual mb_encode_mimeheader() realiza a quebra de linha (um termo » RFC, o ato de quebrar uma linha mais longa que um certo comprimento em várias linhas. O comprimento é atualmente codificado como 74 caracteres). Retrocede para "\r\n" (CRLF) se não fornecido.

indent

Recuo da primeira linha (número de caracteres no cabeçalho antes de string).

Valor Retornado

Uma versão convertida da string representada em ASCII.

Registro de Alterações

Versão Descrição
8.3.0 Bytes NUL (0) não são mais excluídos quando codificados através da codificação Quoted-Printable, mas são codificados como =00.
8.0.0 charset e transfer_encoding agora são anuláveis.

Exemplos

Example #1 Exemplo de mb_encode_mimeheader()

<?php
$name = "太郎"; // kanji
$mbox = "kru";
$doma = "gtinn.mon";
$addr = '"' . addcslashes(mb_encode_mimeheader($name, "UTF-7", "Q"), '"') . '" <' . $mbox . "@" . $doma . ">";
echo $addr;
?>

O exemplo acima produzirá:

"=?UTF-7?Q?+WSqQzg-?=" <[email protected]>

Notas

Note:

Esta função não é projetada para quebrar linhas em pontos de quebra de contexto de nível superior (limites de palavra, etc.). Esse comportamento pode poluir a string original com espaços inesperados.

Veja Também