183 lines
3.8 KiB
PHP
183 lines
3.8 KiB
PHP
|
|
<?php
|
||
|
|
# -- BEGIN LICENSE BLOCK ----------------------------------
|
||
|
|
#
|
||
|
|
# This file is part of Clearbricks.
|
||
|
|
#
|
||
|
|
# Copyright (c) 2003-2008 Olivier Meunier and contributors
|
||
|
|
# Licensed under the GPL version 2.0 license.
|
||
|
|
# See LICENSE file or
|
||
|
|
# http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
|
||
|
|
#
|
||
|
|
# -- END LICENSE BLOCK ------------------------------------
|
||
|
|
|
||
|
|
/**
|
||
|
|
* HTML utilities
|
||
|
|
*
|
||
|
|
* @package Clearbricks
|
||
|
|
* @subpackage Common
|
||
|
|
*/
|
||
|
|
class html
|
||
|
|
{
|
||
|
|
/** @ignore */
|
||
|
|
public static $url_root;
|
||
|
|
|
||
|
|
/** @var array Array of regular expression for {@link absoluteURLs()} */
|
||
|
|
public static $absolute_regs = array();
|
||
|
|
|
||
|
|
/**
|
||
|
|
* HTML escape
|
||
|
|
*
|
||
|
|
* Replaces HTML special characters by entities.
|
||
|
|
*
|
||
|
|
* @param string $str String to escape
|
||
|
|
* @return string
|
||
|
|
*/
|
||
|
|
public static function escapeHTML($str)
|
||
|
|
{
|
||
|
|
return htmlspecialchars($str,ENT_COMPAT,'UTF-8');
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Decode HTML entities
|
||
|
|
*
|
||
|
|
* Returns a string with all entities decoded.
|
||
|
|
*
|
||
|
|
* @param string $str String to protect
|
||
|
|
* @param string $keep_special Keep special characters: > < &
|
||
|
|
* @return string
|
||
|
|
*/
|
||
|
|
public static function decodeEntities($str,$keep_special=false)
|
||
|
|
{
|
||
|
|
if ($keep_special) {
|
||
|
|
$str = str_replace(
|
||
|
|
array('&','>','<'),
|
||
|
|
array('&amp;','&gt;','&lt;'),
|
||
|
|
$str);
|
||
|
|
}
|
||
|
|
|
||
|
|
# Some extra replacements
|
||
|
|
$extra = array(
|
||
|
|
''' => "'"
|
||
|
|
);
|
||
|
|
|
||
|
|
$str = str_replace(array_keys($extra),array_values($extra),$str);
|
||
|
|
|
||
|
|
return html_entity_decode($str,ENT_QUOTES,'UTF-8');
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Remove markup
|
||
|
|
*
|
||
|
|
* Removes every tags, comments, cdata from string
|
||
|
|
*
|
||
|
|
* @param string $str String to clean
|
||
|
|
* @return string
|
||
|
|
*/
|
||
|
|
public static function clean($str)
|
||
|
|
{
|
||
|
|
$str = strip_tags($str);
|
||
|
|
return $str;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Javascript escape
|
||
|
|
*
|
||
|
|
* Returns a protected JavaScript string
|
||
|
|
*
|
||
|
|
* @param string $str String to protect
|
||
|
|
* @return string
|
||
|
|
*/
|
||
|
|
public static function escapeJS($str)
|
||
|
|
{
|
||
|
|
$str = htmlspecialchars($str,ENT_NOQUOTES,'UTF-8');
|
||
|
|
$str = str_replace("'","\'",$str);
|
||
|
|
$str = str_replace('"','\"',$str);
|
||
|
|
return $str;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* URL escape
|
||
|
|
*
|
||
|
|
* Returns an escaped URL string for HTML content
|
||
|
|
*
|
||
|
|
* @param string $str String to escape
|
||
|
|
* @return string
|
||
|
|
*/
|
||
|
|
public static function escapeURL($str)
|
||
|
|
{
|
||
|
|
return str_replace('&','&',$str);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* URL sanitize
|
||
|
|
*
|
||
|
|
* Encode every parts between / in url
|
||
|
|
*
|
||
|
|
* @param string $str String to satinyze
|
||
|
|
* @return string
|
||
|
|
*/
|
||
|
|
public static function sanitizeURL($str)
|
||
|
|
{
|
||
|
|
return str_replace('%2F','/',rawurlencode($str));
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Remove host in URL
|
||
|
|
*
|
||
|
|
* Removes host part in URL
|
||
|
|
*
|
||
|
|
* @param string $str URL to transform
|
||
|
|
* @return string
|
||
|
|
*/
|
||
|
|
public static function stripHostURL($url)
|
||
|
|
{
|
||
|
|
return preg_replace('|^[a-z]{3,}://.*?(/.*$)|','$1',$url);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Set links to absolute ones
|
||
|
|
*
|
||
|
|
* Appends $root URL to URIs attributes in $str.
|
||
|
|
*
|
||
|
|
* @param string $str HTML to transform
|
||
|
|
* @param string $root Base URL
|
||
|
|
* @return string
|
||
|
|
*/
|
||
|
|
public static function absoluteURLs($str,$root)
|
||
|
|
{
|
||
|
|
self::$url_root = $root;
|
||
|
|
$attr = 'action|background|cite|classid|codebase|data|href|longdesc|profile|src|usemap';
|
||
|
|
|
||
|
|
$str = preg_replace_callback('/((?:'.$attr.')=")(.*?)(")/msu',array('self','absoluteURLHandler'),$str);
|
||
|
|
|
||
|
|
foreach (self::$absolute_regs as $r) {
|
||
|
|
$str = preg_replace_callback($r,array('self','absoluteURLHandler'),$str);
|
||
|
|
}
|
||
|
|
|
||
|
|
self::$url_root = null;
|
||
|
|
return $str;
|
||
|
|
}
|
||
|
|
|
||
|
|
private static function absoluteURLHandler($m)
|
||
|
|
{
|
||
|
|
$url = $m[2];
|
||
|
|
|
||
|
|
$link = $m[1].'%s'.$m[3];
|
||
|
|
$host = preg_replace('|^([a-z]{3,}://)(.*?)/(.*)$|','$1$2',self::$url_root);
|
||
|
|
|
||
|
|
$parse = parse_url($m[2]);
|
||
|
|
if (empty($parse['scheme']))
|
||
|
|
{
|
||
|
|
if (strpos($url,'/') === 0) {
|
||
|
|
$url = $host.$url;
|
||
|
|
} elseif (preg_match('|/$|',self::$url_root)) {
|
||
|
|
$url = self::$url_root.$url;
|
||
|
|
} else {
|
||
|
|
$url = dirname(self::$url_root).'/'.$url;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
return sprintf($link,$url);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
?>
|