> YII 类库手册 > CHtmlPurifier
system.web.widgets
继承 class CHTMLPurifier » COutputProcessor » CFilterWidget » CWidget » CBaseController » CComponent
实现 IFilter
源自 1.0
版本 $Id: CHtmlPurifier.PHP 3541 2012-01-17 07:27:46Z mDOMba $
源码
CHtmlPurifier 是HTML Purifier的一个包装。

CHtmlPurifier通过一个彻底的审核移除所有的恶意代码 (即众所周知的XSS),保护被许可的白名单。它也将确 保生成的代码是符合标准的。

CHtmlPurifier可以被作为一个小物件或一个控制器过滤器使用。

注意:好的HTML Purifier(净化器)是一个大的包,它的性能 并不是非常好。你可以考虑缓冲净化结果,或在将用户输入存入 数据库前执行净化。

作为一个类的用法:
$p = new CHtmlPurifier();
$p->options = array('URI.AllowedSchemes'=>array(
  'Http' => true,
  'https' => true,
));
$text = $p->purify($text);


作为验证规则的用法:
array('text','filter','filter'=>array($obj=new CHtmlPurifier(),'purify')),

公共属性

属性 类型 描述 定义在
actionPrefix string actions的ID的前缀。 当微件在CController::actions中声明了 动作提供者,可以为其动作的ID指定前缀以区别 于别的微件或控制器。当微件用于控制器 的视图中时,必须配置同样的前缀。 CWidget
controller CController 返回此微件所属的控制器。 CWidget
id string 返回此微件的ID。如果需要的话,将生产一个新的ID并将其返回。 CWidget
isFilter boolean 这个widget是否作为一个过滤器使用。 CFilterWidget
options mixed 需要传送给HTML Purifier实例的参数。 这个值可以是一个HTMLPurifier_Config对象,也可以是一个由指令组成 的数组 (Namespace. CHtmlPurifier
owner CBaseController 返回此微件的所有者或创建者。 CWidget
skin mixed 微件使用的皮肤的名称。默认为“default”。 如果此属性设置为false,微件将不会有皮肤被使用。 CWidget
stopAction boolean 当这个widget用作一个过滤器时是否停止动作的执行。 此属性应当仅在CWidget::init方法中进行改变。 默认值是false,表示动作将会被执行。 CFilterWidget
viewPath string 返回包含此微件所需的视图文件的路径。 CWidget

公共方法

方法 描述 定义在
__call() 如果类中没有调的方法名,则调用这个方法。 CComponent
__construct() 构造器。 CFilterWidget
__get() 返回一个属性值、一个事件处理程序列表或一个
上一篇:
下一篇: