HTML Purifier 使用教程
1. 项目的目录结构及介绍
HTML Purifier 是一个用于过滤和净化 HTML 的开源项目,其目录结构如下:
htmlpurifier/
├── configdoc/
├── docs/
├── library/
│ ├── HTMLPurifier/
│ └── HTMLPurifier.php
├── maintenance/
├── tests/
├── tools/
├── INSTALL
├── LICENSE
├── README
└── TODO
configdoc/
: 包含配置文档的目录。docs/
: 开发者文档和示例代码。library/
: 核心库文件,包括HTMLPurifier
类和相关子类。maintenance/
: 维护工具和脚本。tests/
: 测试文件。tools/
: 开发工具。INSTALL
: 安装指南。LICENSE
: 许可证文件。README
: 项目介绍和基本使用说明。TODO
: 待办事项。
2. 项目的启动文件介绍
HTML Purifier 的启动文件是 library/HTMLPurifier.php
。这个文件是整个库的入口点,包含了主要的类定义和初始化代码。
require_once 'HTMLPurifier.php';
$config = HTMLPurifier_Config::createDefault();
$purifier = new HTMLPurifier($config);
$clean_html = $purifier->purify($dirty_html);
在这个示例中,我们首先引入 HTMLPurifier.php
文件,然后创建一个默认配置对象,并使用该配置实例化 HTMLPurifier
类。最后,调用 purify
方法来净化输入的 HTML 代码。
3. 项目的配置文件介绍
HTML Purifier 的配置文件是一个 HTMLPurifier_Config
对象,它允许用户自定义过滤规则和行为。配置文件的详细文档可以在 configdoc/
目录中找到。
以下是一个基本的配置示例:
$config = HTMLPurifier_Config::createDefault();
$config->set('HTML.Doctype', 'HTML 4.01 Transitional');
$config->set('Attr.EnableID', true);
$config->set('HTML.Allowed', 'p,br,b,i,a[href]');
$purifier = new HTMLPurifier($config);
$clean_html = $purifier->purify($dirty_html);
在这个示例中,我们设置了文档类型、启用了 ID 属性,并指定了允许的 HTML 标签和属性。通过这些配置,可以精确控制 HTML Purifier 的过滤行为。
以上是 HTML Purifier 的基本使用教程,涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些内容能帮助你更好地理解和使用 HTML Purifier。