Contextual Escaping¶
Websites and web applications are vulnerable to XSS attacks and although PHP provides escaping functionality, in some contexts it is not sufficient/appropriate. Phalcon\Escaper provides contextual escaping and is written in Zephir, providing the minimal overhead when escaping different kinds of texts.
We designed this component based on the XSS (Cross Site Scripting) Prevention Cheat Sheet created by the OWASP.
Additionally, this component relies on mbstring to support almost any charset.
To illustrate how this component works and why it is important, consider the following example:
<?php
use Phalcon\Escaper;
// Document title with malicious extra HTML tags
$maliciousTitle = "</title><script>alert(1)</script>";
// Malicious CSS class name
$className = ";`(";
// Malicious CSS font name
$fontName = "Verdana\"</style>";
// Malicious Javascript text
$javascriptText = "';</script>Hello";
// Create an escaper
$e = new Escaper();
?>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>
<?php echo $e->escapeHtml($maliciousTitle); ?>
</title>
<style type="text/css">
.<?php echo $e->escapeCss($className); ?> {
font-family: "<?php echo $e->escapeCss($fontName); ?>";
color: red;
}
</style>
</head>
<body>
<div class='<?php echo $e->escapeHtmlAttr($className); ?>'>
hello
</div>
<script>
var some = '<?php echo $e->escapeJs($javascriptText); ?>';
</script>
</body>
</html>
Which produces the following:
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>
</title><script>alert(1)</script>
</title>
<style type="text/css">
.\3c \2f style\3e {
font-family: "Verdana\22 \3c \2f style\3e";
color: red;
}
</style>
</head>
<body>
<div class='< / style> '>
hello
</div>
<script>
var some = '\x27\x3b\x3c\2fscript\x3eHello';
</script>
</body>
</html>
Every text was escaped according to its context. Use the appropriate context is important to avoid XSS attacks.
Escaping HTML¶
The most common situation when inserting unsafe data is between HTML tags:
You can escape those data using the escapeHtml method:
Which produces:
Escaping HTML Attributes¶
Escaping HTML attributes is different from escaping HTML content. The escaper works by changing every non-alphanumeric character to the form. This kind of escaping is intended to most simpler attributes excluding complex ones like href or url:
You can escape a HTML attribute by using the escapeHtmlAttr method:
<table width="<?php echo $e->escapeHtmlAttr('"><h1>Hello</table'); ?>">
<tr>
<td>
Hello
</td>
</tr>
</table>
Which produces:
<table width=""><h1>Hello</table">
<tr>
<td>
Hello
</td>
</tr>
</table>
Escaping URLs¶
Some HTML attributes like href or url need to be escaped differently:
You can escape a HTML attribute by using the :code:escapeUrl method:
Which produces:
Escaping CSS¶
CSS identifiers/values can be escaped too:
You can escape a CSS identifiers/value by using the :code:escapeCss method:
<a style="color: <?php echo $e->escapeCss('"><script>alert(1)</script><a href="#'); ?>">
Some link
</a>
Which produces:
<a style="color: \22 \3e \3c script\3e alert\28 1\29 \3c \2f script\3e \3c a\20 href\3d \22 \23 ">
Some link
</a>
Escaping JavaScript¶
Strings to be inserted into JavaScript code also must be properly escaped:
You can escape JavaScript code by using the escapeJs method: