$v) $val[$k] = self::raw2att($v); return $val; } else { return str_replace(array('&','"',"'",'<','>'), array('&','"',''','<','>'), $val); } } /** * Convert a value to be suitable for an HTML attribute. * * This is useful for converting human readable values into * a value suitable for an ID or NAME attribute. * * @see http://www.w3.org/TR/REC-html40/types.html#type-cdata * @uses Convert::raw2att() * @param array|string $val String to escape, or array of strings * @return array|string */ static function raw2htmlatt($val) { if(is_array($val)) { foreach($val as $k => $v) $val[$k] = self::raw2htmlatt($v); return $val; } else { $val = self::raw2att($val); $val = preg_replace('/[^a-zA-Z0-9\-_]*/', '', $val); return $val; } } /** * Ensure that text is properly escaped for XML. * * @see http://www.w3.org/TR/REC-xml/#dt-escape * @param array|string $val String to escape, or array of strings * @return array|string */ static function raw2xml($val) { if(is_array($val)) { foreach($val as $k => $v) $val[$k] = self::raw2xml($v); return $val; } else { return str_replace(array('&','<','>',"\n",'"',"'"), array('&','<','>','
','"','''), $val); } } /** * Ensure that text is properly escaped for Javascript. * * @param array|string $val String to escape, or array of strings * @return array|string */ static function raw2js($val) { if(is_array($val)) { foreach($val as $k => $v) $val[$k] = self::raw2js($v); return $val; } else { return str_replace(array("\\", '"', "\n", "\r", "'"), array("\\\\", '\"', '\n', '\r', "\\'"), $val); } } /** * Uses the PHP 5.2 native json_encode function if available, * otherwise falls back to the Services_JSON class. * * @see http://pear.php.net/pepr/pepr-proposal-show.php?id=198 * @uses Director::baseFolder() * @uses Services_JSON * * @param mixed $val * @return string JSON safe string */ static function raw2json($val) { if(function_exists('json_encode')) { return json_encode($val); } else { require_once(Director::baseFolder() . '/sapphire/thirdparty/json/JSON.php'); $json = new Services_JSON(); return $json->encode($val); } } static function raw2sql($val) { if(is_array($val)) { foreach($val as $k => $v) $val[$k] = self::raw2sql($v); return $val; } else { return DB::getConn()->addslashes($val); } } /** * Convert XML to raw text. * @uses html2raw() * @todo Currently &#xxx; entries are stripped; they should be converted */ static function xml2raw($val) { if(is_array($val)) { foreach($val as $k => $v) $val[$k] = self::xml2raw($v); return $val; } else { // More complex text needs to use html2raw instead if(strpos($val,'<') !== false) return self::html2raw($val); $converted = str_replace(array('&','<','>','"',''', '''), array('&','<','>','"',"'", "'"), $val); $converted = ereg_replace('&#[0-9]+;', '', $converted); return $converted; } } /** * Convert an array into a JSON encoded string. * * @see http://pear.php.net/pepr/pepr-proposal-show.php?id=198 * @uses Director::baseFolder() * @uses Services_JSON * * @param array $val Array to convert * @return string JSON encoded string */ static function array2json($val) { if(function_exists('json_encode')) { return json_encode($val); } else { require_once(Director::baseFolder() . '/sapphire/thirdparty/json/JSON.php'); $json = new Services_JSON(); return $json->encode($val); } } /** * Convert a JSON encoded string into an object. * * @see http://pear.php.net/pepr/pepr-proposal-show.php?id=198 * @uses Director::baseFolder() * @uses Services_JSON * * @param string $val * @return mixed JSON safe string */ static function json2obj($val) { require_once(Director::baseFolder() . '/sapphire/thirdparty/json/JSON.php'); $json = new Services_JSON(); return $json->decode($val); } /** * Convert a JSON string into an array. * * @uses json2obj * @param string $val JSON string to convert * @return array|boolean */ static function json2array($val) { $json = self::json2obj($val); if(!$json) return false; $arr = array(); foreach($json as $k => $v) { $arr[$k] = $v; } return $arr; } /** * @uses recursiveXMLToArray() */ static function xml2array($val) { $xml = new SimpleXMLElement($val); return self::recursiveXMLToArray($xml); } /** * Function recursively run from {@link Convert::xml2array()} * @uses SimpleXMLElement */ protected static function recursiveXMLToArray($xml) { if(is_object($xml) && get_class($xml) == 'SimpleXMLElement') { $attributes = $xml->attributes(); foreach($attributes as $k => $v) { if($v) $a[$k] = (string) $v; } $x = $xml; $xml = get_object_vars($xml); } if(is_array($xml)) { if(count($xml) == 0) return (string) $x; // for CDATA foreach($xml as $key => $value) { $r[$key] = self::recursiveXMLToArray($value); } if(isset($a)) $r['@'] = $a; // Attributes return $r; } return (string) $xml; } /** * Create a link if the string is a valid URL * @param string The string to linkify * @return A link to the URL if string is a URL */ static function linkIfMatch($string) { if( preg_match( '/^[a-z+]+\:\/\/[a-zA-Z0-9$-_.+?&=!*\'()%]+$/', $string ) ) return "$string"; else return $string; } /** * Simple conversion of HTML to plaintext. * * @param $data string * @param $preserveLinks boolean * @param $wordwrap array */ static function html2raw($data, $preserveLinks = false, $wordWrap = 60, $config = null) { $defaultConfig = array( 'PreserveLinks' => false, 'ReplaceBoldAsterisk' => true, 'CompressWhitespace' => true, 'ReplaceImagesWithAlt' => true, ); if(isset($config)) { $config = array_merge($defaultConfig,$config); } else { $config = $defaultConfig; } // sTRIp style and script /* $data = eregi_replace("][^>]*)?>.*]*>","", $data);*/ /* $data = eregi_replace("][^>]*)?>.*]*>","", $data);*/ $data = preg_replace("/][^>]*)?>.*?<\/style[^>]*>/i","", $data); $data = preg_replace("/][^>]*)?>.*?<\/script[^>]*>/i","", $data); // TODO Deal with attributes inside tags if($config['ReplaceBoldAsterisk']) { $data = str_ireplace( array('','','',''), '*', $data ); } // Expand hyperlinks if(!$preserveLinks && !$config['PreserveLinks']) { $data = preg_replace('/]*href\s*=\s*"([^"]*)">(.*?)<\/a>/ie', "Convert::html2raw('\\2').'[\\1]'", $data); $data = preg_replace('/]*href\s*=\s*([^ ]*)>(.*?)<\/a>/ie', "Convert::html2raw('\\2').'[\\1]'", $data); /* $data = eregi_replace(']*href *= *"([^"]*)">([^<>]*)', '\\2 [\\1]', $data); */ /* $data = eregi_replace(']*href *= *([^ ]*)>([^<>]*)', '\\2 [\\1]', $data); */ } // Replace images with their alt tags if($config['ReplaceImagesWithAlt']) { $data = eregi_replace(']*alt *= *"([^"]*)"[^>]*>', ' \\1 ', $data); $data = eregi_replace(']*alt *= *([^ ]*)[^>]*>', ' \\1 ', $data); } // Compress whitespace if($config['CompressWhitespace']) { $data = ereg_replace("[\n\r\t ]+", " ", $data); } // Parse newline tags $data = ereg_replace("[ \n\r\t]*<[Hh][1-6]([^A-Za-z0-9>][^>]*)?> *", "\n\n", $data); $data = ereg_replace("[ \n\r\t]*<[Pp]([^A-Za-z0-9>][^>]*)?> *", "\n\n", $data); $data = ereg_replace("[ \n\r\t]*<[Dd][Ii][Vv]([^A-Za-z0-9>][^>]*)?> *", "\n\n", $data); $data = ereg_replace("\n\n\n+","\n\n", $data); $data = ereg_replace("<[Bb][Rr]([^A-Za-z0-9>][^>]*)?> *", "\n", $data); $data = ereg_replace("<[Tt][Rr]([^A-Za-z0-9>][^>]*)?> *", "\n", $data); $data = ereg_replace("][^>]*)?> *", " ", $data); $data = preg_replace('/<\/p>/i', "\n\n", $data ); // Replace HTML entities //$data = preg_replace("/&#([0-9]+);/e", 'chr(\1)', $data); //$data = str_replace(array("<",">","&"," "), array("<", ">", "&", " "), $data); $data = html_entity_decode($data, ENT_COMPAT , 'UTF-8'); // Remove all tags (but optionally keep links) // strip_tags seemed to be restricting the length of the output // arbitrarily. This essentially does the same thing. if(!$preserveLinks && !$config['PreserveLinks']) { $data = preg_replace('/<\/?[^>]*>/','', $data); } else { $data = strip_tags($data, ''); } return trim(wordwrap(trim($data), $wordWrap)); } /** * There are no real specifications on correctly encoding mailto-links, * but this seems to be compatible with most of the user-agents. * Does nearly the same as rawurlencode(). * Please only encode the values, not the whole url, e.g. * "mailto:test@test.com?subject=" . Convert::raw2mailto($subject) * * @param $data string * @return string * @see http://www.ietf.org/rfc/rfc1738.txt */ static function raw2mailto($data) { return str_ireplace( array("\n",'?','=',' ','(',')','&','@','"','\'',';'), array('%0A','%3F','%3D','%20','%28','%29','%26','%40','%22','%27','%3B'), $data ); } }