Merge pull request #2 from jakubboucek/jb-noescape

Add unescape()

.github/workflows/code_analysis.yaml

@@ -9,7 +9,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        php: ['7.3', '7.4', '8.0']
+        php: ['7.3', '7.4', '8.0', '8.1']
         actions:
           - name: PHPStan
             run: composer phpstan

README.md

@@ -52,6 +52,15 @@ echo '<style>color: ' . \JakubBoucek\Escape\EscapeCss::color($cssColor) . ';</st
 
 It's prevent attact by escaping color value context.
 
+## Output without any escaping
+
+In some cases you intentionally want to output variable without any escaping, but somebody other or your future self may
+mistakenly believe you forgot to escape it. Here you can use `noescape()` method to mark code as intentionally unescaped. 
+
+```php
+echo \JakubBoucek\Escape\Escape::noescape($htmlContent);
+```
+
 ## FAQ
 
 ### Is it support for escaping SQL query?

src/Escape.php

@@ -100,4 +100,15 @@ public static function url($url): string
     {
         return urlencode((string)$url);
     }
+
+    /**
+     * Just returns argument as is without any escaping
+     * Method is useful to mark code as intentionally unescaped as opposed to simple neglected
+     * @param string|mixed $url
+     * @return string
+     */
+    public static function noescape($url): string
+    {
+        return (string)$url;
+    }
 }