🎸 ⚜️ 👊 HTML शोधक अवसरों का विस्तार 🕺🏽 👨🏼‍🔬 ⚓️

केवल कुछ पैराग्राफों में, मैं इस पुस्तकालय के Yii ढांचे के साथ बातचीत की विशेषताओं पर ध्यान दूंगा, बाकी पूरी तरह से सार्वभौमिक है और उन सभी के लिए दिलचस्प होगा जो इस पुस्तकालय का उपयोग करने की योजना या उपयोग करते हैं।

यदि आप पहले से ही शोधक से परिचित हैं, तो आप सुरक्षित रूप से यहां से पढ़ना शुरू कर सकते हैं।

HTML शोधक के बारे में थोड़ा सा

यदि आपने HTML प्यूरिफायर के रूप में इस तरह के एक सुंदर पुस्तकालय (और हैबेरी पर एक खोज इतनी लोकप्रियता की बात नहीं) के बारे में नहीं सुना है, तो मैं आपको सलाह देता हूं कि आप इस पर करीब से नज़र डालें, खासकर यदि आपके उपयोगकर्ता HTML प्रारूप में सामग्री उत्पन्न करते हैं। यह एक साधारण उपयोगकर्ता, एक मध्यस्थ या एक प्रशासक भी हो सकता है।
यह पुस्तकालय क्या करता है?
कॉन्फ़िगरेशन के अनुसार, यह व्यक्तिगत विशेषताओं सहित कोड के सभी दुर्भावनापूर्ण, अमान्य, निषिद्ध (आपके कॉन्फ़िगरेशन द्वारा) भागों के किसी भी HTML कोड को साफ़ करता है।

कम शब्द, अधिक कोड।

मुझे लगता है कि कुछ उदाहरण खुद के लिए बोलेंगे।

$config = HTMLPurifier_Config::createDefault(); $config->set('Attr.AllowedClasses',array('header')); //  Attr.ForbiddenClasses   CSS  $config->set('AutoFormat.AutoParagraph',true); //   <p>     $config->set('AutoFormat.RemoveEmpty',true); //   ,  * $config->set('HTML.Doctype','HTML 4.01 Strict'); //      <strike> $purifier = new HTMLPurifier($config); $clean_html = $purifier->purify($html);

* - RemoveEmpty अपवाद

स्रोत HTML:

  <p invalidAttribute="value">,    <strike></strike>:</p> <p>  - <invalidTag></invalidTag>,</p> <p class="header error"> - ,</p>  - ! <script type="text/javascript">alert("hacked by Alexander Blok");</script>

शुद्धिकरण फ़ंक्शन परिणाम

  <p>,    <span style="text-decoration:line-through;"></span>:</p> <p>  - ,</p> <p class="header"> - ,</p> <p> - !</p>

सेटिंग्स की संख्या प्रभावशाली है और उन बन्स को प्राप्त करना संभव बनाती है जो आपको बॉक्स से चाहिए।

"पर्ल बटन्स की माँ"

लेकिन यह पद मौजूद नहीं होगा, यदि हमेशा की तरह, हम दो चीजों के लिए कुछ विशेष नहीं चाहते थे:

बाहरी साइटों के सभी लिंक को हमारी साइट के लिंक के साथ बदलें site.ru/redirect?url=link
सभी उपयोगकर्ता लिंक पर लक्ष्य = _blank विशेषता जोड़ें

कार्य बहुत जटिल नहीं लगते हैं, पहले के अनुसार डॉक पर एक अच्छा लेख है , और दूसरा आम तौर पर ट्रिफ़्लिंग है - एचटीएमएल कॉन्फ़िगरेशन। लक्ष्यबैंक हमारे लिए काम करता है।

कार्य 1 - बाहरी लिंक की जगह

शोधक के पास एक अद्भुत श्रेणी का HTMLPurifier_URIFilter है और इस फ़िल्टर की क्षमताओं को लागू करने के लिए कोई कम अद्भुत उदाहरण नहीं है
मैंने DisableExternalResources फ़ाइल को एक आधार के रूप में लिया और अपनी आवश्यकताओं को फिट करने के लिए इसे तुरंत फिर से लिखा, अर्थात् बाहरी लिंक को आंतरिक के साथ बदल दिया।

फ़िल्टर फ़ाइल

संक्षिप्त विवरण:
तैयार फ़ंक्शन में, हम अपनी साइट के मेजबान को प्राप्त करते हैं, अंकों से विभाजित करते हैं, और सरणी का विस्तार करते हैं।
नतीजतन, यह सरणी ('आरयू', 'साइट', 'सबडोमेन') हो जाता है।
फ़िल्टर फ़ंक्शन में, हम उपयोगकर्ता लिंक के साथ भी ऐसा ही करते हैं और होस्ट की तुलना करते हैं, यदि यह समान है, तो कुछ भी न बदलें और सही लौटें, यदि नहीं, तो हमारे पते के साथ एक नया यूआरआई ऑब्जेक्ट बनाएं और उपयोगकर्ता लिंक को जीईटी पैरामीटर में डालें।
महत्वपूर्ण फ़िल्टर विधि को सही या गलत के अलावा कुछ भी वापस नहीं करना चाहिए। लिंक को रिटर्न के माध्यम से बदलकर बदलने की कोशिश न करें।

 <?php class HTMLPurifier_URIFilter_MakeRedirect extends HTMLPurifier_URIFilter { /** * @type string */ public $name = 'MakeRedirect'; /** * @type array */ protected $ourHostParts = false; /** * @param HTMLPurifier_Config $config * @return void */ public function prepare($config) { $our_host = $config->getDefinition('URI')->host; if ($our_host !== null) { $this->ourHostParts = array_reverse(explode('.', $our_host)); } } /** * @param HTMLPurifier_URI $uri Reference * @param HTMLPurifier_Config $config * @param HTMLPurifier_Context $context * @return bool */ public function filter(&$uri, $config, $context) { if (is_null($uri->host)) { return true; } if ($this->ourHostParts === false) { return false; } $host_parts = array_reverse(explode('.', $uri->host)); foreach ($this->ourHostParts as $i => $x) { if (!isset($host_parts[$i]) || $host_parts[$i] != $this->ourHostParts[$i]) { $path = Yii::app()->createUrl('site/redirect'); //  Yii,      url manager       /action,    $query = 'url='.urlencode($uri->toString()); $uri = new HTMLPurifier_URI('http', null, Yii::app()->request->getServerName(), // return $_SERVER['SERVER_NAME'] null, $path, $query, null); break; } } return true; } }

फ़िल्टर लागू करें

इसके लिए, जैसा कि प्रलेखन से पता चलता है, हमें HTMLPurifier_Config ऑब्जेक्ट को चालू करना होगा।

  $config = HTMLPurifier_Config::createDefault(); $uri = $config->getDefinition('URI'); $uri->addFilter(new HTMLPurifier_URIFilter_MakeRedirect(), $config); $purifier = new HTMLPurifier($config); $clean_html = $purifier->purify($html);

खुश Yii उपयोगकर्ताओं के लिए अनुच्छेद

मैं उनमें से एक हूं ( ~~और मुझे कोई पछतावा नहीं है~~ )। बॉक्स से बाहर Yii शोधक का समर्थन करता है, लेकिन सब कुछ इतना चिकना नहीं है।
प्रलेखन से उदाहरण:

 $p = new CHtmlPurifier(); //   Yii $p->options = array('URI.AllowedSchemes'=>array('http' => true, 'https' => true,)); //      $text = $p->purify($text);

वहाँ से हम सीखते हैं:

  /** * @var mixed the options to be passed to HTML Purifier instance. * This can be a HTMLPurifier_Config object, an array of directives (Namespace.Directive => Value) * or the filename of an ini file. * @see http://htmlpurifier.org/live/configdoc/plain.html */ private $_options=null;

सब कुछ ठीक लग रहा है, आप एक सरणी के बजाय एक HTMLPurifier_Config ऑब्जेक्ट पास कर सकते हैं, कोशिश करें:

  $purifier = new CHtmlPurifier(); $config = HTMLPurifier_Config::createDefault(); $config->set('AutoFormat.RemoveEmpty', true); $uri = $config->getDefinition('URI'); $uri->addFilter(new HTMLPurifier_URIFilter_MakeRedirect(), $config); $purifier->options = $config; $clean_html = $purifier->purify($html);

  Warning Base directory /framework/vendors/htmlpurifier/standalone/HTMLPurifier/DefinitionCache/Serializer does not exist, please create or change using %Cache.SerializerPath

यहाँ हम परेशान नहीं होते हैं और गॉगल CHtmlPurifier मन में क्रॉल करते हैं और यह पता लगाते हैं कि Cache.SerializerPath पैरामीटर को Yii :: app () -> getRitimePath () के साथ सेट करना आवश्यक है, इससे कैश को संग्रहीत करने के लिए इस फ़ोल्डर का उपयोग करने की अनुमति मिलेगी।
हम करते हैं:

 $purifier = new CHtmlPurifier(); $config = HTMLPurifier_Config::createDefault(); $config->set('AutoFormat.RemoveEmpty', true); $config->set('Cache.SerializerPath',Yii::app()->getRuntimePath()); // <-- $uri = $config->getDefinition('URI'); $uri->addFilter(new HTMLPurifier_URIFilter_MakeRedirect(), $config); $purifier->options = $config; $clean_html = $purifier->purify($html);

 Cannot set directive after finalization invoked on line 127 in file /framework/web/widgets/CHtmlPurifier.php

अब पर्सर को पसंद नहीं है कि हम दो बार पैरामीटर को परिभाषित करें। और CHtmlPurifier इसे createNewHtmlPurifierInstance () मेथड में करता है

 protected function createNewHtmlPurifierInstance() { $this->_purifier=new HTMLPurifier($this->getOptions()); $this->_purifier->config->set('Cache.SerializerPath',Yii::app()->getRuntimePath()); return $this->_purifier; }

यहां, मैं स्वीकार करता हूं, मैंने एक सुंदर समाधान की तलाश में बहुत समय बिताया, लेकिन अफसोस। मुझे GHtmlPurifier class बनाने और CHNmlPurifier वर्ग की ओर से इसे createNewHtmlPurifierInstance () विधि से अधिलेखित करने से अधिक सुंदर कुछ भी नहीं मिला।
मैंने नई फ़ाइल को संरक्षित / घटकों / फ़ोल्डर में रखा और कोड ने आखिरकार काम किया।

  $htmlpurifier = new GHtmlPurifier(); $config = HTMLPurifier_Config::createDefault(); $config->set('Cache.SerializerPath',Yii::app()->getRuntimePath()); $uri = $config->getDefinition('URI'); $uri->addFilter(new HTMLPurifier_URIFilter_MakeRedirect(), $config); $htmlpurifier->options = $config; return $htmlpurifier->purify($text);

कार्य 2 - लक्ष्य जोड़ना = _blank

मैं आपको गैर-काम करने वाले कोड के उदाहरणों से परेशान नहीं करूंगा और मैं तुरंत कहूंगा कि HTML.TargetBlank केवल बाहरी लिंक के साथ काम करता है और इसके आवेदन की अब आवश्यकता नहीं है। और URI फ़िल्टर टैग और उसकी विशेषताओं तक नहीं पहुँच सकते हैं।
पहले से ही पुस्तकालय पर अच्छे प्रलेखन के आदी, वह मैना में चढ़ गए, लेकिन अफसोस, आवश्यक उन्नत एपीआई अनुभाग खाली था और "विकास के तहत दायर" शिलालेख दिखाई दिया ।
स्रोतों में डुबकी लगाने और HTML.TargetBlank मॉड्यूल को लागू करने का तरीका खोजने के अलावा कुछ नहीं बचा था।
यहाँ यह है:

HTMLPurifier_AttrTransform_TargetBlank

 /** * Adds target="blank" to all outbound links. This transform is * only attached if Attr.TargetBlank is TRUE. This works regardless * of whether or not Attr.AllowedFrameTargets */ class HTMLPurifier_AttrTransform_TargetBlank extends HTMLPurifier_AttrTransform { private $parser; public function __construct() { $this->parser = new HTMLPurifier_URIParser(); } public function transform($attr, $config, $context) { if (!isset($attr['href'])) { return $attr; } // XXX Kind of inefficient $url = $this->parser->parse($attr['href']); $scheme = $url->getSchemeObj($config, $context); if ($scheme->browsable && !$url->isBenign($config, $context)) { $attr['target'] = '_blank'; } return $attr; } }

हमारा अपना मॉड्यूल बनाने का निर्णय लिया गया, जिसमें बाहरी पते के लिए जाँच शामिल नहीं होगी, लेकिन जो भी लिंक आपको मिलेंगे, उनमें लक्ष्य = _blank जोड़ देगा।
मुझे लगता है कि हर कोई ट्रांसफ़ॉर्मिंग पद्धति में एक-दो लाइनों को कॉपी करने और डिलीट करने का सामना करेगा। इसलिए, मैं सूची नहीं दूंगा। यह महत्वपूर्ण है कि अपने मॉड्यूल का नाम बदलना न भूलें, मैंने इसे HTMLPurifier_AttrTransform_TargetBlankAll नाम दिया और इसे उसी फ़ोल्डर / संरक्षित / घटकों / में डाल दिया।
लेकिन यह पर्याप्त नहीं था, मॉड्यूल स्वचालित रूप से नहीं उठाता है, और हमें एक वर्ग बनाने की आवश्यकता है जो मॉड्यूल को हमारे कॉन्फ़िगरेशन में जोड़ देगा। कोड में, मैंने कुछ टिप्पणियों को जोड़ा कि यह स्पष्ट था कि यदि आप अपना खुद का मॉड्यूल लिखना चाहते हैं तो क्या बदलना होगा।

HTMLPurifier_HTMLModule_TargetBlankAll.php

 class HTMLPurifier_HTMLModule_TargetBlankAll extends HTMLPurifier_HTMLModule { public $name = 'TargetBlankAll'; //      .     public function setup($config) { $a = $this->addBlankElement('a'); // ,        A $a->attr_transform_post[] = new HTMLPurifier_AttrTransform_TargetBlankAll(); //       //      $a->attr_transform_pre[] } }

मैंने इस फ़ाइल को / संरक्षित / घटक फ़ोल्डर में भी रखा है।
अब यह इस मॉड्यूल को हमारे विन्यास में जोड़ने और परिणाम का आनंद लेने के लिए बना हुआ है। यह किया जा रहा है, यह पूरी तरह से तर्कसंगत नहीं है। हमें HTML ऑब्जेक्ट का लिंक मिलना चाहिए, और यह आवश्यक है कि पैरामीटर $ रॉ = ट्रू के साथ हो, ताकि यह इनिशियलाइज़ हो जाए और HTMLPurifier_HTMLDefinition क्लास में __construct () विधि काम करती है।
__Construct () विधि $ इस-> मैनेजर वेरिएबल को इनिशियलाइज़ करती है, जिसका उपयोग हम अपने मॉड्यूल को जोड़ने के लिए करेंगे।

  $htmlpurifier = new GHtmlPurifier(); $config = HTMLPurifier_Config::createDefault(); $config->set('Cache.SerializerPath',Yii::app()->getRuntimePath()); $uri = $config->getDefinition('URI'); $uri->addFilter(new HTMLPurifier_URIFilter_MakeRedirect(), $config); $html = $config->getHTMLDefinition(true); //     HTMLPurifier_HTMLDefinition $html->manager->addModule('TargetBlankAll'); //      $htmlpurifier->options = $config; return $htmlpurifier->purify($text);

ता बांध:

 <a href="http://site.ru/">http://site.ru</a> <a href="http://habrahabr.ru/">http://habrahabr.ru</a>

 <a href="http://site.ru/" target="_blank">http://site.ru</a> <a href="http://site.ru/redirect/?url=http%3A%2F%2Fhabrahabr.ru%2F" target="_blank">http://habrahabr.ru</a>

दोनों कार्य पूरे हुए!

मुझे उम्मीद है कि इस लेख ने आपको इस अद्भुत उपकरण से परिचित कराया और आपकी साइट को अधिक रोचक और सुरक्षित बनाने में मदद करेगा, अपने उपयोगकर्ता को HTML की सभी विशेषताओं का उपयोग करके दिलचस्प सामग्री बनाने में सक्षम करेगा।

यह लाइब्रेरी तेज़ नहीं है, इसलिए आपको इसे फ़्लाई पर डेटा आउटपुट करने के लिए उपयोग नहीं करना चाहिए।

HTML शोधक अवसरों का विस्तार