Blame view

vendor/yiisoft/yii2/helpers/BaseHtmlPurifier.php 2.25 KB
abf1649b   andryeyev   Чистая установка ...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
  <?php
  /**
   * @link http://www.yiiframework.com/
   * @copyright Copyright (c) 2008 Yii Software LLC
   * @license http://www.yiiframework.com/license/
   */
  
  namespace yii\helpers;
  
  /**
   * BaseHtmlPurifier provides concrete implementation for [[HtmlPurifier]].
   *
   * Do not use BaseHtmlPurifier. Use [[HtmlPurifier]] instead.
   *
   * @author Alexander Makarov <sam@rmcreative.ru>
   * @since 2.0
   */
  class BaseHtmlPurifier
  {
      /**
       * Passes markup through HTMLPurifier making it safe to output to end user
       *
       * @param string $content The HTML content to purify
       * @param array|\Closure|null $config The config to use for HtmlPurifier.
       * If not specified or `null` the default config will be used.
       * You can use an array or an anonymous function to provide configuration options:
       *
       * - An array will be passed to the `HTMLPurifier_Config::create()` method.
       * - An anonymous function will be called after the config was created.
       *   The signature should be: `function($config)` where `$config` will be an
       *   instance of `HTMLPurifier_Config`.
       *
       *   Here is a usage example of such a function:
       *
       *   ~~~
       *   // Allow the HTML5 data attribute `data-type` on `img` elements.
       *   $content = HtmlPurifier::process($content, function ($config) {
       *     $config->getHTMLDefinition(true)
       *            ->addAttribute('img', 'data-type', 'Text');
       *   });
       * ~~~
       *
       * @return string the purified HTML content.
       */
      public static function process($content, $config = null)
      {
          $configInstance = \HTMLPurifier_Config::create($config instanceof \Closure ? null : $config);
          $configInstance->autoFinalize = false;
          $purifier = \HTMLPurifier::instance($configInstance);
          $purifier->config->set('Cache.SerializerPath', \Yii::$app->getRuntimePath());
          
          if ($config instanceof \Closure) {
              call_user_func($config, $configInstance);
          }
          static::configure($configInstance);
  
          return $purifier->purify($content);
      }
  
      /**
       * Allow the extended HtmlPurifier class to set some default config options.
       * @param \HTMLPurifier_Config $config
       * @since 2.0.3
       */
      protected static function configure($config)
      {
      }
  }