athoshun/html-filter

This package is abandoned and no longer maintained. No replacement package was suggested.

Remove tags or attributes based on a whitelist from a snippet of well-formatted HTML text using PHP's DOM library

v2.0.4 2015-02-13 22:13 UTC

This package is not auto-updated.

Last update: 2021-02-05 20:54:08 UTC


README

Build Status Latest build report

Remove tags or attributes based on a whitelist from a snippet of somewhat well-formatted HTML text using PHP's DOM library.

Example:

<?php

$config = new AthosHun\HTMLFilter\Configuration();
$config->allowTag("p")
       ->allowAttribute("a", "title")
       ->allowAttribute("a", "href", "|^https?://.*\$|");

$filter = new AthosHun\HTMLFilter\HTMLFilter();

$html = <<<HTML
Lorem ipsum <em>dolor</em> sit amet
<p>
    Consectetur <a href="http://example.com" title="hey!">adipisicing</a>
    <a href="javascript:alert(42)" onclick="alert(42)">elit</a>.
</p>
HTML;

print $filter->filter($config, $html);

Output:

Lorem ipsum dolor sit amet
<p>
    Consectetur <a href="http://example.com" title="hey!">adipisicing</a>
    <a>elit</a>.
</p>

Installation

Installation is possible via Composer. Create a file named composer.json in your project directory with the following contents:

{
    "require": {
        "athoshun/html-filter": "2.0.*"
    }
}

Then as a normal user, issue the following commands:

$ curl http://getcomposer.org/installer | php
$ php composer.phar install