Security Class
Calling the Security Class
class Security
This class is initialized automatically.
Cross-Site Scripting Protection
For general XSS protection handling, please refer to the Cross-Site Scripting section of the security guidelines.
xss_clean($str[, $is_image = FALSE])
| Parameter | Type | Description |
|---|---|---|
| $str | Mixed |
Either a string or an array to sanitize |
| $is_image | Boolean |
Set to TRUE if you want to test images for XSS attacks. |
| Returns | Mixed |
Either a string or an array of sanitized strings. If $is_image is set to TRUE, will return FALSE if the image fails the check. |
xss_clean() is the built-in ExpressionEngine XSS sanitization method, which is constantly tweaked for improved security and performance:
$str = ee()->security->xss_clean($str);
Cross-Site Request Forgery Protection
For general CSRF protection handling, please refer to the Cross-Site Request Forgery section of the security guidelines.
Other Class Methods
sanitize_filename($str[, $relative_path = FALSE])
| Parameter | Type | Description |
|---|---|---|
| $str | String |
Filename to sanitize |
| $relative_path | Boolean |
Set to TRUE if you want to validate a filename with a relative path |
| Returns | String |
Sanitized filename |
Removes naughty characters from filenames. Returns a sanitized string:
$filename = ee()->security->sanitize_filename($name);
xss_hash()
| Parameter | Type | Description |
|---|---|---|
| Returns | String |
Random hash |
Returns a random hash:
echo ee()->security->xss_hash();