X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=class%2Fmime%2FAddressStructure.class.php;h=ca1436510ed2993e103639a522fabf5a5bebc8a0;hb=77e3ccf6cec41d76af875009610614e4216f63d3;hp=bb55cf83ec6693881bac9654bce9ce619d7d8f56;hpb=1977ab5587905d225c6288141b82f7a6e3d29d02;p=squirrelmail.git diff --git a/class/mime/AddressStructure.class.php b/class/mime/AddressStructure.class.php index bb55cf83..ca143651 100644 --- a/class/mime/AddressStructure.class.php +++ b/class/mime/AddressStructure.class.php @@ -6,7 +6,7 @@ * This file contains functions needed to extract email address headers from * mime messages. * - * @copyright 2003-2010 The SquirrelMail Project Team + * @copyright 2003-2016 The SquirrelMail Project Team * @license http://opensource.org/licenses/gpl-license.php GNU Public License * @version $Id$ * @package squirrelmail @@ -51,9 +51,11 @@ class AddressStructure { * Return address information from mime headers. * @param boolean $full return full address (true) or only personal if it exists, otherwise email (false) * @param boolean $encoded (since 1.4.0) return rfc2047 encoded address (true) or plain text (false). + * @param boolean $unconditionally_quote (since 1.4.21/1.5.2) when TRUE, always quote the personal part, whether or not it is encoded, otherwise quoting is only added if the personal part is not encoded + * * @return string */ - function getAddress($full = true, $encoded = false) { + function getAddress($full = true, $encoded = false, $unconditionally_quote = FALSE) { $result = ''; if (is_object($this)) { $email = ($this->host ? $this->mailbox.'@'.$this->host @@ -65,14 +67,15 @@ class AddressStructure { } if ($personal) { if ($encoded && !$is_encoded) { - $personal_encoded = encodeHeader($personal); + $personal_encoded = encodeHeader('"' . $personal . '"'); if ($personal !== $personal_encoded) { - $personal = '"' . $personal_encoded . '"'; + $personal = $personal_encoded; } else { + //FIXME: this probably adds quotes around an encoded string which itself is already quoted $personal = '"' . $this->personal . '"'; } } else { - if (!$is_encoded) { + if (!$is_encoded || $unconditionally_quote) { $personal = '"' . $this->personal . '"'; } } @@ -91,11 +94,13 @@ class AddressStructure { /** * Shorter version of getAddress() function * Returns full encoded address. + * @param boolean $unconditionally_quote (since 1.4.21/1.5.2) when TRUE, always quote the personal part, whether or not it is encoded, otherwise quoting is only added if the personal part is not encoded + * * @return string * @since 1.4.0 */ - function getEncodedAddress() { - return $this->getAddress(true, true); + function getEncodedAddress($unconditionally_quote=FALSE) { + return $this->getAddress(true, true, $unconditionally_quote); } /**