-
Notifications
You must be signed in to change notification settings - Fork 127
/
UPGRADING
335 lines (193 loc) · 7.32 KB
/
UPGRADING
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
======================
Upgrading Horde_Mime
======================
:Contact: dev@lists.horde.org
.. contents:: Contents
.. section-numbering::
This lists the API changes between releases of the package.
Upgrading to 2.8
================
- Horde_Mime_Part
- $encodingTypes
- $mimeTypes
These static properties are deprecated.
- clearContentTypeParameter()
This method is deprecated. Use Horde_Mime_Part#setContentTypeParameter()
instead with null as the second argument to delete a Content-Type
parameter.
- setContentTypeParameter()
Passing null as the second argument will cause the Content-Type
parameter identified by the first argument to be deleted.
- setDispositionParameter()
Passing null as the second argument will cause the Content-Disposition
parameter identified by the first argument to be deleted.
- setDescription()
Passing null as the argument will cause the description to be deleted.
- Horde_Mime_Headers_ContentId
- Horde_Mime_Headers_ContentLanguage
- Horde_Mime_Headers_ContentParam_ContentDisposition
- Horde_Mime_Headers_ContentParam_ContentType
- Horde_Mime_Headers_ContentTransferEncoding
- Horde_Mime_Headers_Mime
These classes have been added.
- Horde_Mime_Headers_Element
- isDefault()
This method has been added.
- Horde_Mime_Headers_Extension_Mime
This interface has been added.
- Horde_Mime_Headers_ContentParam
- setContentParamValue()
This method has been added.
Upgrading to 2.7
================
- Horde_Mime_Headers_ContentDescription
This class has been added.
Upgrading to 2.6
================
- Horde_Mime_Filter_Encoding
This class has been added.
- Horde_Mime
- $decodeWindows1252
This property now defaults to true. (HTML 5 demands that ISO-8859-1 be
treated as Windows-1252, so this is matching conventional usage.)
Upgrading to 2.5
================
- Horde_Mime
- $brokenRFC2231
This static property is deprecated. Use the 'broken_rfc2231' parameter
to Horde_Mime_Headers_ContentParam#encode() instead.
- decodeParam()
This method is deprecated. Use Horde_Mime_Headers_ContentParam#decode()
instead.
- encodeParam()
This method is deprecated. Use Horde_Mime_Headers_ContentParam#encode()
instead.
- generateMessageId()
This method is deprecated. Use Horde_Mime_Headers_MessageId::create()
instead.
- is8bit()
The 2nd parameter ($charset) is no longer needed/used.
- isChild()
This method is deprecated. Use Horde_Mime_Id#isChild() instead.
- mimeIdArithmetic()
This method is deprecated. Use Horde_Mime_Id#idArithmetic() instead.
- quotedPrintableEncode()
This method is deprecated. Use PHP's quoted_printable_encode() method
instead (or, if you need to control EOL and/or wrapping length, use
Horde_Mime_QuotedPrintable::encode()).
- uudecode()
This method is deprecated. Use the Horde_Mime_Uudecode() class instead.
- Horde_Mime_Headers
Headers are now internally stored in a list of Horde_Mime_Headers_Element
objects.
- addHeader()
Deprecate the 'decode' and 'params' optional parameters.
To indicate distinct value and parameter data, use the
Horde_Mime_Headers_ContentParam object to add the data.
MIME decoding is now done automatically, based on the header name.
- addHeaderOb()
This method has been added.
- addMessageIdHeader()
This method is deprecated. Add a Horde_Mime_Headers_MessageId object via
Horde_Mime_Headers#addHeaderOb() instead.
- addReceivedHeader()
This method is deprecated. Create an object using
Horde_Mime_Headers_Received::createHordeHop() and add to the headers
object via Horde_Mime_Headers#addHeaderOb().
- addUserAgentHeader()
This method is deprecated. Add a Horde_Mime_Headers_UserAgent object via
Horde_Mime_Headers#addHeaderOb() instead.
- getEOL()
This method is deprecated.
- getUserAgent()
This method is deprecated. Get the default user agent via
strval(Horde_Mime_Headers_UserAgent::create()) instead.
- listHeadersExist()
This method is deprecated. Use Horde_ListHeaders#listHeadersExist()
instead.
- getOb()
This method is deprecated. Directly obtain the header element that
implements Horde_Mime_Headers_Element_Address and call
getAddressList() on it.
- getString()
This method is deprecated. Directly obtain the header element and query
its 'name' property instead.
- replaceHeader()
This method is deprecated. Use Horde_Mime_Headers#removeHeader()
followed by Horde_Mime_Headers#addHeader[Ob]() instead.
- setEOL()
This method is deprecated. EOLs are only needed for
Horde_Mime_Headers#toString(), where the 'canonical' parameter already
exists for the same purpose.
- setUserAgent()
This method is deprecated. Set the user agent via
Horde_Mime_Headers#addHeaderOb() instead.
- Horde_Mime_ContentParam_Decode
- Horde_Mime_Id
- Horde_Mime_QuotedPrintable
- Horde_Mime_Uudecode
These classes were added.
- Horde_Mime_Part
- send()
Added the 'broken_rfc2231' option.
Upgrading to 2.4
================
- Horde_Mime_Mail
- getRaw()
This method was added.
Upgrading to 2.3
================
- Horde_Mime_Headers
- parseHeaders()
The $text parameter now accepts both resources and Horde_Stream objects.
Upgrading to 2.2
================
- Horde_Mime
- parseMessage()
Added the 'no_body' parameter.
Upgrading to 2.1
================
- Horde_Mime
- encodeParam()
The 'escape' option has been removed.
The MIME_PARAM_QUOTED constant has been added.
- Horde_Mime_Related
- cidReplace()
The $text parameter can now be a Horde_Domhtml object.
Upgrading to 2.0
================
- Horde_Mime
- decode()
Removed the second parameter ($to_charset). Output is now in UTF-8.
- decodeAddrString()
This method has been removed.
Equivalent functionality can now be found in the Horde_Mail package
(version 2.0.0+).
- decodeParam()
Removed the third parameter ($charset). Output is now in UTF-8.
- encode()
The first parameter ($text) now requires a UTF-8 string.
The second parameter ($charset) is now optional and indicates the
charset to MIME encode to.
- encodeAddress()
This method has been removed.
Equivalent functionality can now be found in the Horde_Mail package
(version 2.0.0+).
- encodeParam()
The third parameter ($charset) has been removed and moved to the options.
By default, the string is encoded in UTF-8.
- Horde_Mime_Address
This class has been removed. Equivalent functionality can now be found
in the Horde_Mail package (version 2.0.0+).
- Horde_Mime_Headers
- addHeader()
Removed the 'charset' and 'decode' parameters.
Added the 'sanity_check' parameter.
- getOb()
Now returns null if the header does not exist.
- replaceHeader()
Removed the 'charset' and 'decode' parameters.
Added the 'sanity_check' parameter.
- setValue()
- sanityCheck()
These methods have been removed.