README

扩展Security::xss_clean，使用HTML Purifier提供安全的XSS过滤。

安装 Purifier

如果你的应用程序在一个 Git 仓库中，你可以简单地将此仓库作为子模块添加

git submodule add git://github.com/shadowhand/purifier.git modules/purifier
git submodule update --init --recursive

如果你想使用特定版本，你可以检出该版本的标签

cd modules/purifier
git checkout v0.1.0
cd -
git add modules/purifier

始终记得提交你对子模块所做的更改！

git commit -m 'Added Purifier module'

要安装 HTML Purifier，你需要进入 purifier 模块目录并下载它

cd modules/purifier
git submodule update --init --recursive

HTML Purifier 作为 Purifier 模块的子模块启用。只有当你使用 --recursive 标志时，子模块的子模块才会自动初始化

对于未跟踪的仓库，你可以下载仓库并将其安装到 MODPATH/purifier。要下载特定版本，在点击下载链接之前，请在 Github 上选择该标签。

你还需要下载 HTML Purifier并将整个 "htmlpurifier" 目录安装到 MODPATH/purifier/vendor/htmlpurifier。

HTML Purifier 安装后，你需要将 MODPATH/purifier/vendor/htmlpurifier 中的 library/HTMLPurifier/DefinitionCache/Serializer 设置为 Web 服务器可写。

要使用 Purifier，只需像平常一样调用 Security::xss_clean。将使用 HTML Purifier 而不是默认的 "Bitflux" 过滤器。

如果你想直接访问 HTMLPurifier

$html = Security::htmlpurifier();

你可以通过创建 APPPATH/config/purifier.php 来配置 HTMLPurifier 设置。

return array(
    'settings' => array(
        ... => ...
    ),
);