QpEncoder.php 9.5KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297
  1. <?php
  2. /*
  3. * This file is part of SwiftMailer.
  4. * (c) 2004-2009 Chris Corbyn
  5. *
  6. * For the full copyright and license information, please view the LICENSE
  7. * file that was distributed with this source code.
  8. */
  9. /**
  10. * Handles Quoted Printable (QP) Encoding in Swift Mailer.
  11. * Possibly the most accurate RFC 2045 QP implementation found in PHP.
  12. * @package Swift
  13. * @subpackage Encoder
  14. * @author Chris Corbyn
  15. */
  16. class Swift_Encoder_QpEncoder implements Swift_Encoder
  17. {
  18. /**
  19. * The CharacterStream used for reading characters (as opposed to bytes).
  20. * @var Swift_CharacterStream
  21. * @access protected
  22. */
  23. protected $_charStream;
  24. /**
  25. * A filter used if input should be canonicalized.
  26. * @var Swift_StreamFilter
  27. * @access protected
  28. */
  29. protected $_filter;
  30. /**
  31. * Pre-computed QP for HUGE optmization.
  32. * @var string[]
  33. * @access protected
  34. */
  35. protected static $_qpMap = array(
  36. 0 => '=00', 1 => '=01', 2 => '=02', 3 => '=03', 4 => '=04',
  37. 5 => '=05', 6 => '=06', 7 => '=07', 8 => '=08', 9 => '=09',
  38. 10 => '=0A', 11 => '=0B', 12 => '=0C', 13 => '=0D', 14 => '=0E',
  39. 15 => '=0F', 16 => '=10', 17 => '=11', 18 => '=12', 19 => '=13',
  40. 20 => '=14', 21 => '=15', 22 => '=16', 23 => '=17', 24 => '=18',
  41. 25 => '=19', 26 => '=1A', 27 => '=1B', 28 => '=1C', 29 => '=1D',
  42. 30 => '=1E', 31 => '=1F', 32 => '=20', 33 => '=21', 34 => '=22',
  43. 35 => '=23', 36 => '=24', 37 => '=25', 38 => '=26', 39 => '=27',
  44. 40 => '=28', 41 => '=29', 42 => '=2A', 43 => '=2B', 44 => '=2C',
  45. 45 => '=2D', 46 => '=2E', 47 => '=2F', 48 => '=30', 49 => '=31',
  46. 50 => '=32', 51 => '=33', 52 => '=34', 53 => '=35', 54 => '=36',
  47. 55 => '=37', 56 => '=38', 57 => '=39', 58 => '=3A', 59 => '=3B',
  48. 60 => '=3C', 61 => '=3D', 62 => '=3E', 63 => '=3F', 64 => '=40',
  49. 65 => '=41', 66 => '=42', 67 => '=43', 68 => '=44', 69 => '=45',
  50. 70 => '=46', 71 => '=47', 72 => '=48', 73 => '=49', 74 => '=4A',
  51. 75 => '=4B', 76 => '=4C', 77 => '=4D', 78 => '=4E', 79 => '=4F',
  52. 80 => '=50', 81 => '=51', 82 => '=52', 83 => '=53', 84 => '=54',
  53. 85 => '=55', 86 => '=56', 87 => '=57', 88 => '=58', 89 => '=59',
  54. 90 => '=5A', 91 => '=5B', 92 => '=5C', 93 => '=5D', 94 => '=5E',
  55. 95 => '=5F', 96 => '=60', 97 => '=61', 98 => '=62', 99 => '=63',
  56. 100 => '=64', 101 => '=65', 102 => '=66', 103 => '=67', 104 => '=68',
  57. 105 => '=69', 106 => '=6A', 107 => '=6B', 108 => '=6C', 109 => '=6D',
  58. 110 => '=6E', 111 => '=6F', 112 => '=70', 113 => '=71', 114 => '=72',
  59. 115 => '=73', 116 => '=74', 117 => '=75', 118 => '=76', 119 => '=77',
  60. 120 => '=78', 121 => '=79', 122 => '=7A', 123 => '=7B', 124 => '=7C',
  61. 125 => '=7D', 126 => '=7E', 127 => '=7F', 128 => '=80', 129 => '=81',
  62. 130 => '=82', 131 => '=83', 132 => '=84', 133 => '=85', 134 => '=86',
  63. 135 => '=87', 136 => '=88', 137 => '=89', 138 => '=8A', 139 => '=8B',
  64. 140 => '=8C', 141 => '=8D', 142 => '=8E', 143 => '=8F', 144 => '=90',
  65. 145 => '=91', 146 => '=92', 147 => '=93', 148 => '=94', 149 => '=95',
  66. 150 => '=96', 151 => '=97', 152 => '=98', 153 => '=99', 154 => '=9A',
  67. 155 => '=9B', 156 => '=9C', 157 => '=9D', 158 => '=9E', 159 => '=9F',
  68. 160 => '=A0', 161 => '=A1', 162 => '=A2', 163 => '=A3', 164 => '=A4',
  69. 165 => '=A5', 166 => '=A6', 167 => '=A7', 168 => '=A8', 169 => '=A9',
  70. 170 => '=AA', 171 => '=AB', 172 => '=AC', 173 => '=AD', 174 => '=AE',
  71. 175 => '=AF', 176 => '=B0', 177 => '=B1', 178 => '=B2', 179 => '=B3',
  72. 180 => '=B4', 181 => '=B5', 182 => '=B6', 183 => '=B7', 184 => '=B8',
  73. 185 => '=B9', 186 => '=BA', 187 => '=BB', 188 => '=BC', 189 => '=BD',
  74. 190 => '=BE', 191 => '=BF', 192 => '=C0', 193 => '=C1', 194 => '=C2',
  75. 195 => '=C3', 196 => '=C4', 197 => '=C5', 198 => '=C6', 199 => '=C7',
  76. 200 => '=C8', 201 => '=C9', 202 => '=CA', 203 => '=CB', 204 => '=CC',
  77. 205 => '=CD', 206 => '=CE', 207 => '=CF', 208 => '=D0', 209 => '=D1',
  78. 210 => '=D2', 211 => '=D3', 212 => '=D4', 213 => '=D5', 214 => '=D6',
  79. 215 => '=D7', 216 => '=D8', 217 => '=D9', 218 => '=DA', 219 => '=DB',
  80. 220 => '=DC', 221 => '=DD', 222 => '=DE', 223 => '=DF', 224 => '=E0',
  81. 225 => '=E1', 226 => '=E2', 227 => '=E3', 228 => '=E4', 229 => '=E5',
  82. 230 => '=E6', 231 => '=E7', 232 => '=E8', 233 => '=E9', 234 => '=EA',
  83. 235 => '=EB', 236 => '=EC', 237 => '=ED', 238 => '=EE', 239 => '=EF',
  84. 240 => '=F0', 241 => '=F1', 242 => '=F2', 243 => '=F3', 244 => '=F4',
  85. 245 => '=F5', 246 => '=F6', 247 => '=F7', 248 => '=F8', 249 => '=F9',
  86. 250 => '=FA', 251 => '=FB', 252 => '=FC', 253 => '=FD', 254 => '=FE',
  87. 255 => '=FF'
  88. );
  89. protected static $_safeMapShare = array();
  90. /**
  91. * A map of non-encoded ascii characters.
  92. * @var string[]
  93. * @access protected
  94. */
  95. protected $_safeMap = array();
  96. /**
  97. * Creates a new QpEncoder for the given CharacterStream.
  98. * @param Swift_CharacterStream $charStream to use for reading characters
  99. * @param Swift_StreamFilter $filter if input should be canonicalized
  100. */
  101. public function __construct(Swift_CharacterStream $charStream,
  102. Swift_StreamFilter $filter = null)
  103. {
  104. $this->_charStream = $charStream;
  105. if(!isset(self::$_safeMapShare[$this->getSafeMapShareId()]))
  106. {
  107. $this->initSafeMap();
  108. self::$_safeMapShare[$this->getSafeMapShareId()] = $this->_safeMap;
  109. }
  110. else
  111. {
  112. $this->_safeMap = self::$_safeMapShare[$this->getSafeMapShareId()];
  113. }
  114. $this->_filter = $filter;
  115. }
  116. public function __sleep()
  117. {
  118. return array('_charStream', '_filter');
  119. }
  120. public function __wakeup()
  121. {
  122. if(!isset(self::$_safeMapShare[$this->getSafeMapShareId()]))
  123. {
  124. $this->initSafeMap();
  125. self::$_safeMapShare[$this->getSafeMapShareId()] = $this->_safeMap;
  126. }
  127. else
  128. {
  129. $this->_safeMap = self::$_safeMapShare[$this->getSafeMapShareId()];
  130. }
  131. }
  132. protected function getSafeMapShareId()
  133. {
  134. return get_class($this);
  135. }
  136. protected function initSafeMap()
  137. {
  138. foreach (array_merge(
  139. array(0x09, 0x20), range(0x21, 0x3C), range(0x3E, 0x7E)) as $byte)
  140. {
  141. $this->_safeMap[$byte] = chr($byte);
  142. }
  143. }
  144. /**
  145. * Takes an unencoded string and produces a QP encoded string from it.
  146. * QP encoded strings have a maximum line length of 76 characters.
  147. * If the first line needs to be shorter, indicate the difference with
  148. * $firstLineOffset.
  149. * @param string $string to encode
  150. * @param int $firstLineOffset, optional
  151. * @param int $maxLineLength, optional, 0 indicates the default of 76 chars
  152. * @return string
  153. */
  154. public function encodeString($string, $firstLineOffset = 0,
  155. $maxLineLength = 0)
  156. {
  157. if ($maxLineLength > 76 || $maxLineLength <= 0)
  158. {
  159. $maxLineLength = 76;
  160. }
  161. $thisLineLength = $maxLineLength - $firstLineOffset;
  162. $lines = array();
  163. $lNo = 0;
  164. $lines[$lNo] = '';
  165. $currentLine =& $lines[$lNo++];
  166. $size=$lineLen=0;
  167. $this->_charStream->flushContents();
  168. $this->_charStream->importString($string);
  169. //Fetching more than 4 chars at one is slower, as is fetching fewer bytes
  170. // Conveniently 4 chars is the UTF-8 safe number since UTF-8 has up to 6
  171. // bytes per char and (6 * 4 * 3 = 72 chars per line) * =NN is 3 bytes
  172. while (false !== $bytes = $this->_nextSequence())
  173. {
  174. //If we're filtering the input
  175. if (isset($this->_filter))
  176. {
  177. //If we can't filter because we need more bytes
  178. while ($this->_filter->shouldBuffer($bytes))
  179. {
  180. //Then collect bytes into the buffer
  181. if (false === $moreBytes = $this->_nextSequence(1))
  182. {
  183. break;
  184. }
  185. foreach ($moreBytes as $b)
  186. {
  187. $bytes[] = $b;
  188. }
  189. }
  190. //And filter them
  191. $bytes = $this->_filter->filter($bytes);
  192. }
  193. $enc = $this->_encodeByteSequence($bytes, $size);
  194. if ($currentLine && $lineLen+$size >= $thisLineLength)
  195. {
  196. $lines[$lNo] = '';
  197. $currentLine =& $lines[$lNo++];
  198. $thisLineLength = $maxLineLength;
  199. $lineLen=0;
  200. }
  201. $lineLen+=$size;
  202. $currentLine .= $enc;
  203. }
  204. return $this->_standardize(implode("=\r\n", $lines));
  205. }
  206. /**
  207. * Updates the charset used.
  208. * @param string $charset
  209. */
  210. public function charsetChanged($charset)
  211. {
  212. $this->_charStream->setCharacterSet($charset);
  213. }
  214. // -- Protected methods
  215. /**
  216. * Encode the given byte array into a verbatim QP form.
  217. * @param int[] $bytes
  218. * @return string
  219. * @access protected
  220. */
  221. protected function _encodeByteSequence(array $bytes, &$size)
  222. {
  223. $ret = '';
  224. $size=0;
  225. foreach ($bytes as $b)
  226. {
  227. if (isset($this->_safeMap[$b]))
  228. {
  229. $ret .= $this->_safeMap[$b];
  230. ++$size;
  231. }
  232. else
  233. {
  234. $ret .= self::$_qpMap[$b];
  235. $size+=3;
  236. }
  237. }
  238. return $ret;
  239. }
  240. /**
  241. * Get the next sequence of bytes to read from the char stream.
  242. * @param int $size number of bytes to read
  243. * @return int[]
  244. * @access protected
  245. */
  246. protected function _nextSequence($size = 4)
  247. {
  248. return $this->_charStream->readBytes($size);
  249. }
  250. /**
  251. * Make sure CRLF is correct and HT/SPACE are in valid places.
  252. * @param string $string
  253. * @return string
  254. * @access protected
  255. */
  256. protected function _standardize($string)
  257. {
  258. $string = str_replace(array("\t=0D=0A", " =0D=0A", "=0D=0A"),
  259. array("=09\r\n", "=20\r\n", "\r\n"), $string
  260. );
  261. switch ($end = ord(substr($string, -1)))
  262. {
  263. case 0x09:
  264. case 0x20:
  265. $string = substr_replace($string, self::$_qpMap[$end], -1);
  266. }
  267. return $string;
  268. }
  269. }