|
207 | 207 | is <code>none</code>, where no decoding will be done. If set to |
208 | 208 | <code>url</code>, then URL decoding (also known as %-encoding; |
209 | 209 | this is appropriate for use within URLs in links, etc.) will be |
210 | | - performed. If set to <code>base64</code>, base64 will be decoded, |
211 | | - and if set to <code>entity</code>, HTML entity encoding will be |
212 | | - stripped. Decoding is done prior to any further encoding on the |
213 | | - variable. Multiple encodings can be stripped by specifying more |
214 | | - than one comma separated encoding. The decoding setting will |
215 | | - remain in effect until the next decoding attribute is encountered, |
216 | | - or the element ends.</p> |
| 210 | + performed. If set to <code>urlencoded</code>, |
| 211 | + application/x-www-form-urlencoded compatible encoding (found in |
| 212 | + query strings) will be stripped. If set to <code>base64</code>, |
| 213 | + base64 will be decoded, and if set to <code>entity</code>, HTML |
| 214 | + entity encoding will be stripped. Decoding is done prior to any |
| 215 | + further encoding on the variable. Multiple encodings can be |
| 216 | + stripped by specifying more than one comma separated encoding. |
| 217 | + The decoding setting will remain in effect until the next decoding |
| 218 | + attribute is encountered, or the element ends.</p> |
217 | 219 |
|
218 | 220 | <p>The <code>decoding</code> attribute must <em>precede</em> the |
219 | 221 | corresponding <code>var</code> attribute to be effective.</p> |
|
225 | 227 | to <code>none</code>, no encoding will be done. If set to |
226 | 228 | <code>url</code>, then URL encoding (also known as %-encoding; |
227 | 229 | this is appropriate for use within URLs in links, etc.) will be |
228 | | - performed. If set to <code>base64</code>, base64 encoding will |
229 | | - be performed. At the start of an <code>echo</code> element, |
230 | | - the default is set to <code>entity</code>, resulting in entity |
231 | | - encoding (which is appropriate in the context of a block-level |
232 | | - HTML element, <em>e.g.</em> a paragraph of text). This can be |
233 | | - changed by adding an <code>encoding</code> attribute, which will |
234 | | - remain in effect until the next <code>encoding</code> attribute |
235 | | - is encountered or the element ends, whichever comes first.</p> |
| 230 | + performed. If set to <code>urlencoded</code>, |
| 231 | + application/x-www-form-urlencoded compatible encoding will be |
| 232 | + performed instead, and should be used with query strings. If set |
| 233 | + to <code>base64</code>, base64 encoding will be performed. At |
| 234 | + the start of an <code>echo</code> element, the default is set to |
| 235 | + <code>entity</code>, resulting in entity encoding (which is |
| 236 | + appropriate in the context of a block-level HTML element, |
| 237 | + <em>e.g.</em> a paragraph of text). This can be changed by adding |
| 238 | + an <code>encoding</code> attribute, which will remain in effect |
| 239 | + until the next <code>encoding</code> attribute is encountered or |
| 240 | + the element ends, whichever comes first.</p> |
236 | 241 |
|
237 | 242 | <p>The <code>encoding</code> attribute must <em>precede</em> the |
238 | 243 | corresponding <code>var</code> attribute to be effective.</p> |
|
442 | 447 | <dd><p>Specifies whether Apache should strip an encoding from |
443 | 448 | the variable before processing the variable further. The default |
444 | 449 | is <code>none</code>, where no decoding will be done. If set to |
445 | | - <code>url</code>, <code>base64</code> or <code>entity</code>, |
446 | | - URL decoding, base64 decoding or HTML entity decoding will be |
447 | | - performed respectively. More than one decoding can be specified |
448 | | - by separating with commas. The decoding setting will remain in |
449 | | - effect until the next decoding attribute is encountered, or the |
450 | | - element ends. The <code>decoding</code> attribute must |
451 | | - <em>precede</em> the corresponding <code>var</code> attribute to |
452 | | - be effective.</p> |
| 450 | + <code>url</code>, <code>urlencoded</code>, <code>base64</code> |
| 451 | + or <code>entity</code>, URL decoding, |
| 452 | + application/x-www-form-urlencoded decoding, base64 decoding or HTML |
| 453 | + entity decoding will be performed respectively. More than one |
| 454 | + decoding can be specified by separating with commas. The decoding |
| 455 | + setting will remain in effect until the next decoding attribute |
| 456 | + is encountered, or the element ends. The <code>decoding</code> |
| 457 | + attribute must <em>precede</em> the corresponding |
| 458 | + <code>var</code> attribute to be effective.</p> |
453 | 459 | </dd> |
454 | 460 |
|
455 | 461 | <dt><code>encoding</code></dt> |
456 | 462 | <dd><p>Specifies how Apache should encode special characters |
457 | 463 | contained in the variable before setting them. The default is |
458 | 464 | <code>none</code>, where no encoding will be done. If set to |
459 | | - <code>url</code>, <code>base64</code> or <code>entity</code>, |
460 | | - URL encoding, base64 encoding or HTML entity encoding will be |
461 | | - performed respectively. More than one encoding can be specified |
462 | | - by separating with commas. The encoding setting will remain in |
463 | | - effect until the next encoding attribute is encountered, or the |
464 | | - element ends. The <code>encoding</code> attribute must |
465 | | - <em>precede</em> the corresponding <code>var</code> attribute |
466 | | - to be effective. Encodings are applied after all decodings have |
467 | | - been stripped.</p> |
| 465 | + <code>url</code>, <code>urlencoding</code>, <code>base64</code> |
| 466 | + or <code>entity</code>, URL encoding, |
| 467 | + application/x-www-form-urlencoded encoding, base64 encoding or |
| 468 | + HTML entity encoding will be performed respectively. More than |
| 469 | + one encoding can be specified by separating with commas. The |
| 470 | + encoding setting will remain in effect until the next encoding |
| 471 | + attribute is encountered, or the element ends. The |
| 472 | + <code>encoding</code> attribute must <em>precede</em> the |
| 473 | + corresponding <code>var</code> attribute to be effective. |
| 474 | + Encodings are applied after all decodings have been |
| 475 | + stripped.</p> |
468 | 476 | </dd> |
469 | 477 | </dl> |
470 | 478 |
|
|
0 commit comments