(PHP 4, PHP 5, PHP 7, PHP 8)
imap_utf7_encode — Convierte una cadena ISO-8859-1 a un texto UTF-7 modifiicado
$data): string
Convierte data a texto UTF-7 modificado.
Esto es necesario para codificar nombres de buzones que contienen ciertos caracteres que no están en el conjunto de caracters imprimibles de ASCII.
dataUna cadena ISO-8859-1.
Devuelve data codificado con la codificación UTF-7
modificada como está definido en » RFC 2060,
sección 5.1.3 (el UTF-7 original fue definido en » RFC1642).
Maccoy function's isn't reliable 'cause it doesn't follow the RFC 2060. It will work fine for most latin chars (which, in base64, will turn into "+A..."), but for other language it can make a big mess. If you're using an internationalizated system, try using the other presented options.
For those who search for a good implementation of modified UTF-7 encoding for IMAP, you can find a code that works on :
http://tananyag.ntszki.hu/mail/functions/imap_utf7_local.php
The result is different from imap-utf7-encode() function and is identical to mailbox name generated by Thunderbird.
This encoding will not work for cyrus imapservers and you might have problems with other mail clients.
Use mb_convert_encoding($str, "UTF7-IMAP","ISO-8859-15") instead.
ps: mb_convert_encoding() requires building php with --enable-mbstring option
Note that php4 (4.4.0) will encode IMAP folders in a way that no other program will be able to decode them back.
$ php4 <<EOF
> <?php
> echo "ENCODED: " . imap_utf7_encode("?") . "\\n";
> ?>
> EOF
ENCODED: &w5w-
Now try to decode the result string ("&w5w-") using e.g. javamail or python's imaplib, or if you don't like these languages - create an IMAP folder using PHP and try to display it in an IMAP client (mutt, thunderbird, outlook, whatever...)
<?php
/**
* @return encoded string
* @param string $str
* @desc Convert str to UTF-7 imap default mailbox names
(the imap_utf7_encode don t built the same result)
*/
function getEncodedUtf7($str){
if(!$str){
echo "error: you need to give a string parameter.";
return false;
}
# change spaces by entropy because mb_convert fail with spaces
$str=ereg_replace(" ","xyxy",$str);
# if mb_convert work
if($str=mb_convert_encoding($str,"UTF-7")){
# change characters
$str=preg_replace("/\+A/","&A",$str);
# change to spaces again
$str=preg_replace("/xyxy/"," ",$str);
# return encoded string
return $str;
# else
}else{
# print error and return false
echo "error: is not possible to encode this string '$str'.[".
imap_last_error().
"]";
return false;
}
}
?>
