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 $ |
婧愮爜 | framework/web/widgets/CHtmlPurifier.php |
CHtmlPurifier 鏄HTML Purifier鐨勪竴涓寘瑁呫
CHtmlPurifier閫氳繃涓涓交搴曠殑瀹℃牳绉婚櫎鎵鏈夌殑鎭舵剰浠g爜 锛堝嵆浼楁墍鍛ㄧ煡鐨刋SS锛夛紝淇濇姢琚鍙殑鐧藉悕鍗曘傚畠涔熷皢纭 淇濈敓鎴愮殑浠g爜鏄鍚堟爣鍑嗙殑銆
CHtmlPurifier鍙互琚綔涓轰竴涓皬鐗╀欢鎴栦竴涓帶鍒跺櫒杩囨护鍣ㄤ娇鐢ㄣ
娉ㄦ剰锛氬ソ鐨凥TML Purifier锛堝噣鍖栧櫒锛夋槸涓涓ぇ鐨勫寘锛屽畠鐨勬ц兘 骞朵笉鏄潪甯稿ソ銆備綘鍙互鑰冭檻缂撳啿鍑鍖栫粨鏋滐紝鎴栧湪灏嗙敤鎴疯緭鍏ュ瓨鍏 鏁版嵁搴撳墠鎵ц鍑鍖栥
浣滀负涓涓被鐨勭敤娉曪細
浣滀负楠岃瘉瑙勫垯鐨勭敤娉曪細
CHtmlPurifier閫氳繃涓涓交搴曠殑瀹℃牳绉婚櫎鎵鏈夌殑鎭舵剰浠g爜 锛堝嵆浼楁墍鍛ㄧ煡鐨刋SS锛夛紝淇濇姢琚鍙殑鐧藉悕鍗曘傚畠涔熷皢纭 淇濈敓鎴愮殑浠g爜鏄鍚堟爣鍑嗙殑銆
CHtmlPurifier鍙互琚綔涓轰竴涓皬鐗╀欢鎴栦竴涓帶鍒跺櫒杩囨护鍣ㄤ娇鐢ㄣ
娉ㄦ剰锛氬ソ鐨凥TML 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鐨処D鐨勫墠缂銆 褰撳井浠跺湪CController::actions涓0鏄庝簡 鍔ㄤ綔鎻愪緵鑰咃紝鍙互涓哄叾鍔ㄤ綔鐨処D鎸囧畾鍓嶇紑浠ュ尯鍒 浜庡埆鐨勫井浠舵垨鎺у埗鍣ㄣ傚綋寰欢鐢ㄤ簬鎺у埗鍣 鐨勮鍥句腑鏃讹紝蹇呴』閰嶇疆鍚屾牱鐨勫墠缂銆 | CWidget |
controller | CController | 杩斿洖姝ゅ井浠舵墍灞炵殑鎺у埗鍣ㄣ | CWidget |
id | string | 杩斿洖姝ゅ井浠剁殑ID銆傚鏋滈渶瑕佺殑璇濓紝灏嗙敓浜т竴涓柊鐨処D骞跺皢鍏惰繑鍥炪 | CWidget |
isFilter | boolean | 杩欎釜widget鏄惁浣滀负涓涓繃婊ゅ櫒浣跨敤銆 | CFilterWidget |
options | mixed | 闇瑕佷紶閫佺粰HTML Purifier瀹炰緥鐨勫弬鏁般 杩欎釜鍊煎彲浠ユ槸涓涓狧TMLPurifier_Config瀵硅薄锛屼篃鍙互鏄竴涓敱鎸囦护缁勬垚 鐨勬暟缁 (Namespace. | CHtmlPurifier |
owner | CBaseController | 杩斿洖姝ゅ井浠剁殑鎵鏈夎呮垨鍒涘缓鑰呫 | CWidget |
skin | mixed | 寰欢浣跨敤鐨勭毊鑲ょ殑鍚嶇О銆傞粯璁や负鈥渄efault鈥濄 濡傛灉姝ゅ睘鎬ц缃负false锛屽井浠跺皢涓嶄細鏈夌毊鑲よ浣跨敤銆 | CWidget |
stopAction | boolean | 褰撹繖涓獁idget鐢ㄤ綔涓涓繃婊ゅ櫒鏃舵槸鍚﹀仠姝㈠姩浣滅殑鎵ц銆 姝ゅ睘鎬у簲褰撲粎鍦CWidget::init鏂规硶涓繘琛屾敼鍙樸 榛樿鍊兼槸false锛岃〃绀哄姩浣滃皢浼氳鎵ц銆 | CFilterWidget |
viewPath | string | 杩斿洖鍖呭惈姝ゅ井浠舵墍闇鐨勮鍥炬枃浠剁殑璺緞銆 | CWidget |
鍏叡鏂规硶
鏂规硶 | 鎻忚堪 | 瀹氫箟鍦 |
---|---|---|
__call() | 濡傛灉绫讳腑娌℃湁璋冪殑鏂规硶鍚嶏紝鍒欒皟鐢ㄨ繖涓柟娉曘 | CComponent |
__construct() | 鏋勯犲櫒銆 | CFilterWidget |
__get() | 杩斿洖涓涓睘鎬у笺佷竴涓簨浠跺鐞嗙▼搴忓垪琛ㄦ垨涓涓涓哄悕绉般 | CComponent |
__isset() | 妫鏌ヤ竴涓睘鎬ф槸鍚︿负null銆 | CComponent |
__set() | 璁剧疆涓涓粍浠剁殑灞炴у笺 | CComponent |
__unset() | 璁剧疆涓涓粍浠剁殑灞炴т负null銆 | CComponent |
actions() | 杩斿洖姝idget浣跨敤鐨勫姩浣滅殑鍒楄〃銆 | CWidget |
asa() | 杩斿洖杩欎釜鍚嶅瓧鐨勮涓哄璞° | CComponent |
attachBehavior() | 闄勫姞涓涓涓哄埌缁勪欢銆 | CComponent |
attachBehaviors() | 闄勫姞涓涓涓哄垪琛ㄥ埌缁勪欢銆 | CComponent |
attachEventHandler() | 涓轰簨浠堕檮鍔犱竴涓簨浠跺鐞嗙▼搴忋 | CComponent |
beginCache() | Begins fragment caching. | CBaseController |
beginClip() | Begins recording a clip. | CBaseController |
beginContent() | Begins the rendering of content that is to be decorated by the specified view. | CBaseController |
beginWidget() | Creates a widget and executes it. | CBaseController |
canGetProperty() | 纭畾灞炴ф槸鍚﹀彲璇汇 | CComponent |
canSetProperty() | 纭畾灞炴ф槸鍚﹀彲鍐欍 | CComponent |
createWidget() | Creates a widget and initializes it. | CBaseController |
detachBehavior() | 浠庣粍浠朵腑鍒嗙涓涓涓恒 | CComponent |
detachBehaviors() | 浠庣粍浠朵腑鍒嗙鎵鏈夎涓恒 | CComponent |
detachEventHandler() | 鍒嗙涓涓瓨鍦ㄧ殑浜嬩欢澶勭悊绋嬪簭銆 | CComponent |
disableBehavior() | 绂佺敤涓涓檮鍔犺涓恒 | CComponent |
disableBehaviors() | 绂佺敤缁勪欢闄勫姞鐨勬墍鏈夎涓恒 | CComponent |
enableBehavior() | 鍚敤涓涓檮鍔犺涓恒 | CComponent |
enableBehaviors() | 鍚敤缁勪欢闄勫姞鐨勬墍鏈夎涓恒 | CComponent |
endCache() | Ends fragment caching. | CBaseController |
endClip() | Ends recording a clip. | CBaseController |
endContent() | Ends the rendering of content. | CBaseController |
endWidget() | Ends the execution of the named widget. | CBaseController |
evaluateExpression() | 璁$畻涓涓狿HP琛ㄨ揪寮忥紝鎴栨牴鎹粍浠朵笂涓嬫枃鎵ц鍥炶皟銆 | CComponent |
filter() | 鎵ц杩囨护銆 | CFilterWidget |
getController() | 杩斿洖姝ゅ井浠舵墍灞炵殑鎺у埗鍣ㄣ | CWidget |
getEventHandlers() | 杩斿洖涓涓簨浠剁殑闄勫姞澶勭悊绋嬪簭鍒楄〃銆 | CComponent |
getId() | 杩斿洖姝ゅ井浠剁殑ID銆傚鏋滈渶瑕佺殑璇濓紝灏嗙敓浜т竴涓柊鐨処D骞跺皢鍏惰繑鍥炪 | CWidget |
getIsFilter() | 妫鏌ヨ繖涓獁idget鏄惁浣滀负涓涓繃婊ゅ櫒浣跨敤銆 | CFilterWidget |
getOwner() | 杩斿洖姝ゅ井浠剁殑鎵鏈夎呮垨鍒涘缓鑰呫 | CWidget |
getViewFile() | 鏍规嵁瑙嗗浘鍚嶆煡鎵捐鍥炬枃浠躲 | CWidget |
getViewPath() | 杩斿洖鍖呭惈姝ゅ井浠舵墍闇鐨勮鍥炬枃浠剁殑璺緞銆 | CWidget |
hasEvent() | 纭畾涓涓簨浠舵槸鍚﹀畾涔夈 | CComponent |
hasEventHandler() | 妫鏌ヤ簨浠舵槸鍚︽湁闄勫姞鐨勫鐞嗙▼搴忋 | CComponent |
hasProperty() | 纭畾灞炴ф槸鍚﹁瀹氫箟銆 | CComponent |
init() | 鍒濆鍖栨灏忕墿浠躲 | COutputProcessor |
onProcessOutput() | 褰撹幏鍙栧埌杈撳嚭鏃舵縺鍙戙 | COutputProcessor |
processOutput() | 澶勭悊鑾峰彇鐨勮緭鍑恒 | CHtmlPurifier |
purify() | 閫氳繃绉婚櫎鎭舵剰浠g爜瀵笻TML鍐呭杩涜鍑鍖栥 | CHtmlPurifier |
raiseEvent() | 鍙戣捣涓涓簨浠躲 | CComponent |
render() | 娓叉煋涓涓鍥俱 | CWidget |
renderFile() | Renders a view file. | CBaseController |
renderInternal() | Renders a view file. | CBaseController |
run() | 杩愯姝ゅ皬鐗╀欢銆 | COutputProcessor |
setId() | 璁剧疆姝ゅ井浠剁殑ID銆 | CWidget |
widget() | Creates a widget and executes it. | CBaseController |
灞炴ц缁
options
灞炴
public mixed $options;
闇瑕佷紶閫佺粰HTML Purifier瀹炰緥鐨勫弬鏁般 杩欎釜鍊煎彲浠ユ槸涓涓狧TMLPurifier_Config瀵硅薄锛屼篃鍙互鏄竴涓敱鎸囦护缁勬垚 鐨勬暟缁 (Namespace.Directive => Value)鎴栦竴涓 ini 鏂囦欢鐨勬枃浠跺悕銆
鏂规硶璇︾粏
processOutput()
鏂规硶
public void processOutput(string $output)
| ||
$output | string | 灏嗚澶勭悊鐨勮幏鍙栫殑杈撳嚭銆 |
婧愮爜锛 framework/web/widgets/CHtmlPurifier.php#65 (鏄剧ず)
public function processOutput($output)
{
$output=$this->purify($output);
parent::processOutput($output);
}
澶勭悊鑾峰彇鐨勮緭鍑恒 姝ゆ柟娉曚娇鐢HTML Purifier瀵硅緭鍑鸿繘琛屽噣鍖栥
purify()
鏂规硶
public string purify(string $content)
| ||
$content | string | 闇瑕佽鍑鍖栫殑鍐呭銆 |
{return} | string | 宸插噣鍖栫殑鍐呭 |
婧愮爜锛 framework/web/widgets/CHtmlPurifier.php#76 (鏄剧ず)
public function purify($content)
{
$purifier=new HTMLPurifier($this->options);
$purifier->config->set('Cache.SerializerPath',Yii::app()->getRuntimePath());
return $purifier->purify($content);
}
閫氳繃绉婚櫎鎭舵剰浠g爜瀵笻TML鍐呭杩涜鍑鍖栥