ESAPIEncode()
Encodes the given string for safe output to stop Cross Site Scripting attacks.
Status:
Requires Extension: ESAPI extension
ESAPIEncode( encodeFor=string, string=string, canonicalize=boolean, dialect=string );
Returns: String
| Argument | Description | Default |
|---|---|---|
|
encodeFor
string,
required
|
edit
encode for what, valid values are:
|
|
|
string
string,
required
|
edit
string to encode |
|
|
canonicalize
boolean,
optional
|
edit
If set to true, canonicalization happens before encoding. If set to false, the given input string will just be encoded. The default value for canonicalize is false. When this parameter is not specified, canonicalization will not happen. By default, when canonicalization is performed, both mixed and multiple encodings will be allowed. To use any other combinations you should canonicalize using canonicalize method and then do encoding. Introduced: 5.0.0.0 |
false |
|
dialect
string,
optional
|
edit
Only used when "encodeFor" is set to "sql". This defines the SQL dialect used. Possible values are: * db2 * mysql_ansi * mysql * oracle |
Examples
edit enc=ESAPIEncode("html","<table>");//html
writeDump(enc);
enc=ESAPIEncode('url','https://download.lucee.org/?type=releases');//URL
writeDump(enc);
See also
- Encode/Decode
- LDAP
- XML
- HTML
- JavaScript
- EncodeForCSS()
- EncodeForHTML()
- ESAPIDecode()
- HTMLCodeFormat()
- HTMLEditFormat()
- Search Issue Tracker open_in_new
- Search Lucee Test Cases open_in_new (good for further, detailed examples)