[Sommaire] [Imprimer]

   1  <?php
   2  # ***** BEGIN LICENSE BLOCK *****
   3  # This file is part of Clearbricks.
   4  # Copyright (c) 2006 Olivier Meunier and contributors. All rights
   5  # reserved.
   6  #
   7  # Clearbricks is free software; you can redistribute it and/or modify
   8  # it under the terms of the GNU General Public License as published by
   9  # the Free Software Foundation; either version 2 of the License, or
  10  # (at your option) any later version.
  11  # 
  12  # Clearbricks is distributed in the hope that it will be useful,
  13  # but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  # GNU General Public License for more details.
  16  # 
  17  # You should have received a copy of the GNU General Public License
  18  # along with Clearbricks; if not, write to the Free Software
  19  # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  20  #
  21  # ***** END LICENSE BLOCK *****
  22  
  23  class html
  24  {
  25      public static $url_root;
  26      
  27      /**
  28      @function escapeHTML
  29      
  30      Replaces HTML special characters by entities.
  31      
  32      @param    str    string    String to escape
  33      @return    string
  34      */
  35  	public static function escapeHTML($str)
  36      {
  37          return htmlspecialchars($str,ENT_COMPAT,'UTF-8');
  38      }
  39      
  40      /**
  41      @function decodeEntities
  42      
  43      Returns a string with all entities decoded.
  44      
  45      @param    str    string    String to protect
  46      @param    keep_special string        Keep special characters: &gt; &lt; &amp;
  47      @return    string
  48      */
  49  	public static function decodeEntities($str,$keep_special=false)
  50      {
  51          if ($keep_special) {
  52              $str = str_replace(
  53                  array('&amp;','&gt;','&lt;'),
  54                  array('&amp;amp;','&amp;gt;','&amp;lt;'),
  55                  $str);
  56          }
  57          
  58          # Some extra replacements
  59          $extra = array(
  60              '&apos;' => "'"
  61          );
  62          
  63          $str = str_replace(array_keys($extra),array_values($extra),$str);
  64          
  65          return html_entity_decode($str,ENT_QUOTES,'UTF-8');
  66      }
  67      
  68      /**
  69      @function clean
  70      
  71      Removes every tags, comments, cdata from string
  72      
  73      @param    str    string    String to clean
  74      @return    string
  75      */
  76  	public static function clean($str)
  77      {
  78          $str = strip_tags($str);
  79          return $str;
  80      }
  81      
  82      /**
  83      @function escapeJS
  84      
  85      Returns a protected JavaScript string
  86      
  87      @param    string    str            String to protect
  88      @return    string
  89      */
  90  	public static function escapeJS($str)
  91      {
  92          $str = htmlspecialchars($str,ENT_NOQUOTES,'UTF-8');
  93          $str = str_replace("'","\'",$str);
  94          $str = str_replace('"','\"',$str);
  95          return $str;
  96      }
  97      
  98      /**
  99      @function escapeURL
 100      
 101      Returns an escaped URL string for HTML content
 102      
 103      @param    str    string    String to escape
 104      @return    string
 105      */
 106  	public static function escapeURL($str)
 107      {
 108          return str_replace('&','&amp;',$str);
 109      }
 110      
 111      /**
 112      @function sanitizeURL
 113      
 114      Encode every parts between / in url
 115      
 116      @param    str    string    String to satinyze
 117      @return    string
 118      */
 119  	public static function sanitizeURL($str)
 120      {
 121          return str_replace('%2F','/',rawurlencode($str));
 122      }
 123      
 124      /**
 125      @function stripHostURL
 126      
 127      Removes host part in URL
 128      
 129      @param    url    string    URL to transform
 130      @return    string
 131      */
 132  	public static function stripHostURL($url)
 133      {
 134          return preg_replace('|^[a-z]{3,}://.*?(/.*$)|','$1',$url);
 135      }
 136      
 137      /**
 138      @function absoluteURLs
 139      
 140      Appends $root URL to URIs attributes in $str.
 141      
 142      @param    str        string    HTML to transform
 143      @param    root        string    Base URL
 144      @return    string
 145      */
 146  	public static function absoluteURLs($str,$root)
 147      {
 148          self::$url_root = $root;
 149          $attr = 'action|background|cite|classid|codebase|data|href|longdesc|profile|src|usemap';
 150          
 151          return preg_replace_callback('/((?:'.$attr.')=")(.*?)(")/msu',array('self','absoluteURLHandler'),$str);
 152      }
 153      
 154  	private static function absoluteURLHandler($m)
 155      {
 156          $url = $m[2];
 157          
 158          $link = $m[1].'%s'.$m[3];
 159          $host = preg_replace('|^([a-z]{3,}://)(.*?)/(.*)$|','$1$2',self::$url_root);
 160          
 161          if (!preg_match('|^[a-z]{3,}://|',$url))
 162          {
 163              if (strpos($url,'/') === 0) {
 164                  $url = $host.$url;
 165              } elseif (preg_match('|/$|',self::$url_root)) {
 166                  $url = self::$url_root.$url;
 167              } else {
 168                  $url = dirname(self::$url_root).'/'.$url;
 169              }
 170          }
 171          
 172          return sprintf($link,$url);
 173      }
 174  }
 175  ?>