<?php
# -- BEGIN LICENSE BLOCK ---------------------------------------
#
# This file is part of Clearbricks.
#
# Copyright (c) 2003-2011 Olivier Meunier & Association Dotclear
# 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 -----------------------------------------
/**
* Text utilities
*
* @package Clearbricks
* @subpackage Common
*/
class text
{
/**
* Check email address
*
* Returns true if $email is a valid email address.
*
* @copyright Cal Henderson
* @license http://creativecommons.org/licenses/by-sa/2.5/ CC-BY-SA
* @link http://www.iamcal.com/publish/articles/php/parsing_email/
*
* @param string $email Email string
* @return boolean
*/
public static function isEmail($email)
{
$qtext = '[^\\x0d\\x22\\x5c\\x80-\\xff]';
$dtext = '[^\\x0d\\x5b-\\x5d\\x80-\\xff]';
$atom = '[^\\x00-\\x20\\x22\\x28\\x29\\x2c\\x2e\\x3a-\\x3c\\x3e\\x40\\x5b-\\x5d\\x7f-\\xff]+';
$quoted_pair = '\\x5c[\\x00-\\x7f]';
$domain_literal = "\\x5b($dtext|$quoted_pair)*\\x5d";
$quoted_string = "\\x22($qtext|$quoted_pair)*\\x22";
$domain_ref = $atom;
$sub_domain = "($domain_ref|$domain_literal)";
$word = "($atom|$quoted_string)";
$domain = "$sub_domain(\\x2e$sub_domain)*";
$local_part = "$word(\\x2e$word)*";
$addr_spec = "$local_part\\x40$domain";
return (boolean) preg_match("!^$addr_spec$!", $email);
}
/**
* Accents replacement
*
* Replaces some occidental accentuated characters by their ASCII
* representation.
*
* @param string $str String to deaccent
* @return string
*/
public static function deaccent($str)
{
$pattern['A'] = '\x{00C0}-\x{00C5}';
$pattern['AE'] = '\x{00C6}';
$pattern['C'] = '\x{00C7}';
$pattern['D'] = '\x{00D0}';
$pattern['E'] = '\x{00C8}-\x{00CB}';
$pattern['I'] = '\x{00CC}-\x{00CF}';
$pattern['N'] = '\x{00D1}';
$pattern['O'] = '\x{00D2}-\x{00D6}\x{00D8}';
$pattern['OE'] = '\x{0152}';
$pattern['S'] = '\x{0160}';
$pattern['U'] = '\x{00D9}-\x{00DC}';
$pattern['Y'] = '\x{00DD}';
$pattern['Z'] = '\x{017D}';
$pattern['a'] = '\x{00E0}-\x{00E5}';
$pattern['ae'] = '\x{00E6}';
$pattern['c'] = '\x{00E7}';
$pattern['d'] = '\x{00F0}';
$pattern['e'] = '\x{00E8}-\x{00EB}';
$pattern['i'] = '\x{00EC}-\x{00EF}';
$pattern['n'] = '\x{00F1}';
$pattern['o'] = '\x{00F2}-\x{00F6}\x{00F8}';
$pattern['oe'] = '\x{0153}';
$pattern['s'] = '\x{0161}';
$pattern['u'] = '\x{00F9}-\x{00FC}';
$pattern['y'] = '\x{00FD}\x{00FF}';
$pattern['z'] = '\x{017E}';
$pattern['ss'] = '\x{00DF}';
foreach ($pattern as $r => $p) {
$str = preg_replace('/['.$p.']/u',$r,$str);
}
return $str;
}
/**
* String to URL
*
* Transforms a string to a proper URL.
*
* @param string $str String to transform
* @param boolean $with_slashes Keep slashes in URL
* @return string
*/
public static function str2URL($str,$with_slashes=true)
{
$str = self::deaccent($str);
$str = preg_replace('/[^A-Za-z0-9_\s\'\:\/[\]-]/','',$str);
return self::tidyURL($str,$with_slashes);
}
/**
* URL cleanup
*
* @param string $str URL to tidy
* @param boolean $keep_slashes Keep slashes in URL
* @param boolean $keep_spaces Keep spaces in URL
* @return string
*/
public static function tidyURL($str,$keep_slashes=true,$keep_spaces=false)
{
$str = strip_tags($str);
$str = str_replace(array('?','&','#','=','+','<','>','"','%'),'',$str);
$str = str_replace("'",' ',$str);
$str = preg_replace('/[\s]+/u',' ',trim($str));
if (!$keep_slashes) {
$str = str_replace('/','-',$str);
}
if (!$keep_spaces) {
$str = str_replace(' ','-',$str);
}
$str = preg_replace('/[-]+/','-',$str);
# Remove path changes in URL
$str = preg_replace('%^/%','',$str);
$str = preg_replace('%\.+/%','',$str);
return $str;
}
/**
* Cut string
*
* Returns a cuted string on spaced at given length $l.
*
* @param string $str String to cut
* @param integer $l Length to keep
* @return string
*/
public static function cutString($str,$l)
{
$s = preg_split('/([\s]+)/u',$str,-1,PREG_SPLIT_DELIM_CAPTURE);
$res = '';
$L = 0;
if (mb_strlen($s[0]) >= $l) {
return mb_substr($s[0],0,$l);
}
foreach ($s as $v)
{
$L = $L+mb_strlen($v);
if ($L > $l) {
break;
} else {
$res .= $v;
}
}
return trim($res);
}
/**
* Split words
*
* Returns an array of words from a given string.
*
* @param string $str Words to split
* @return array
*/
public static function splitWords($str)
{
$non_word = '\x{0000}-\x{002F}\x{003A}-\x{0040}\x{005b}-\x{0060}\x{007B}-\x{007E}\x{00A0}-\x{00BF}\s';
if (preg_match_all('/([^'.$non_word.']{3,})/msu',html::clean($str),$match)) {
foreach ($match[1] as $i => $v) {
$match[1][$i] = mb_strtolower($v);
}
return $match[1];
}
return array();
}
/**
* Encoding detection
*
* Returns the encoding (in lowercase) of given $str.
*
* @param string $str String
* @return string
*/
public static function detectEncoding($str)
{
return strtolower(mb_detect_encoding($str.' ',
'UTF-8,ISO-8859-1,ISO-8859-2,ISO-8859-3,'.
'ISO-8859-4,ISO-8859-5,ISO-8859-6,ISO-8859-7,ISO-8859-8,'.
'ISO-8859-9,ISO-8859-10,ISO-8859-13,ISO-8859-14,ISO-8859-15'));
}
/**
* UTF8 conversions
*
* Returns an UTF-8 converted string. If $encoding is not specified, the
* function will try to detect encoding.
*
* @param string $str String to convert
* @param string $encoding Optionnal "from" encoding
* @return string
*/
public static function toUTF8($str,$encoding=null)
{
if (!$encoding) {
$encoding = self::detectEncoding($str);
}
if ($encoding != 'utf-8') {
$str = iconv($encoding,'UTF-8',$str);
}
return $str;
}
/**
* Find bad UTF8 tokens
*
* Locates the first bad byte in a UTF-8 string returning it's
* byte index in the string
* PCRE Pattern to locate bad bytes in a UTF-8 string
* Comes from W3 FAQ: Multilingual Forms
* Note: modified to include full ASCII range including control chars
*
* @copyright Harry Fuecks
* @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU LGPL 2.1
* @link http://phputf8.sourceforge.net
*
* @param string $str String to search
* @return integer|false
*/
public static function utf8badFind($str)
{
$UTF8_BAD =
'([\x00-\x7F]'. # ASCII (including control chars)
'|[\xC2-\xDF][\x80-\xBF]'. # non-overlong 2-byte
'|\xE0[\xA0-\xBF][\x80-\xBF]'. # excluding overlongs
'|[\xE1-\xEC\xEE\xEF][\x80-\xBF]{2}'. # straight 3-byte
'|\xED[\x80-\x9F][\x80-\xBF]'. # excluding surrogates
'|\xF0[\x90-\xBF][\x80-\xBF]{2}'. # planes 1-3
'|[\xF1-\xF3][\x80-\xBF]{3}'. # planes 4-15
'|\xF4[\x80-\x8F][\x80-\xBF]{2}'. # plane 16
'|(.{1}))'; # invalid byte
$pos = 0;
$badList = array();
while (preg_match('/'.$UTF8_BAD.'/S', $str, $matches)) {
$bytes = strlen($matches[0]);
if ( isset($matches[2])) {
return $pos;
}
$pos += $bytes;
$str = substr($str,$bytes);
}
return false;
}
/**
* UTF8 cleanup
*
* Replaces non utf8 bytes in $str by $repl.
*
* @copyright Harry Fuecks
* @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU LGPL 2.1
* @link http://phputf8.sourceforge.net
*
* @param string $str String to clean
* @param string $repl Replacement string
* @return string
*/
public static function cleanUTF8($str,$repl='?')
{
while (($bad_index = self::utf8badFind($str)) !== false) {
$str = substr_replace($str,$repl,$bad_index,1);
}
return $str;
}
/**
* BOM removal
*
* Removes BOM from the begining of a string if present.
*
* @param string $str String to clean
* @return string
*/
public static function removeBOM($str)
{
if (substr_count($str,'')) {
return str_replace('','',$str);
}
return $str;
}
/**
* Quoted printable conversion
*
* Encodes given str to quoted printable
*
* @param string $str String to encode
* @return string
*/
public static function QPEncode($str)
{
$res = '';
foreach (preg_split("/\r?\n/msu", $str) as $line)
{
$l = '';
preg_match_all('/./',$line,$m);
foreach ($m[0] as $c)
{
$a = ord($c);
if ($a < 32 || $a == 61 || $a > 126) {
$c = sprintf('=%02X',$a);
}
$l .= $c;
}
$res .= $l."\r\n";
}
return $res;
}
}
?>