The OWASP Top 10 web security risks study lists Cross-Site Scripting (XSS) in second place. PHP's sole functionality against XSS is limited to two functions of which one is commonly misapplied. Thus, the laminas-escaper component was written. It offers developers a way to escape output and defend from XSS and related vulnerabilities by introducing contextual escaping based on peer-reviewed rules.
laminas-escaper was written with ease of use in mind, so it can be used completely stand-alone from the rest of the framework, and as such can be installed with Composer:
$ composer require laminas/laminas-escaper
Several Laminas components provide integrations for consuming laminas-escaper, including laminas-view, which provides a set of helpers that consume it.
laminas-escaper is a security related component. As such, if you believe you have found an issue, we ask that you follow our Security Policy and report security issues accordingly. The Laminas team and the contributors thank you in advance.
laminas-escaper provides one class,
Laminas\Escaper\Escaper, which in turn provides
five methods for escaping output. Which method to use depends on the context in
which the output is used. It is up to the developer to use the right methods in
the right context.
Laminas\Escaper\Escaper has the following escaping methods available for each context:
escapeHtml: escape a string for an HTML body context.
escapeHtmlAttr: escape a string for an HTML attribute context.
escapeCss: escape a string for a CSS context.
escapeUrl: escape a string for a URI or URI parameter context.
Usage of each method will be discussed in detail in later chapters.
What laminas-Escaper is not
laminas-escaper is meant to be used only for escaping data for output, and as such should not be misused for filtering input data. For such tasks, use laminas-filter, HTMLPurifier or PHP's Filter functionality should be used.
Found a mistake or want to contribute to the documentation? Edit this page on GitHub!