*/ /** * [CLASS/FUNCTION INDEX of SCRIPT] * * * * 66: class t3lib_diff * 86: function makeDiffDisplay($str1,$str2,$wrapTag='span') * 163: function getDiff($str1,$str2) * 189: function addClearBuffer($clearBuffer,$last=0) * 205: function explodeStringIntoWords($str) * 226: function tagSpace($str,$rev=0) * * TOTAL FUNCTIONS: 5 * (This index is automatically created/updated by the extension "extdeveval") * */ /** * This class has functions which generates a difference output of a content string * * @author Kasper Skaarhoj * @package TYPO3 * @subpackage t3lib */ class t3lib_diff { // External, static: var $stripTags = 0; // If set, the HTML tags are stripped from the input strings first. var $diffOptions = ''; // Diff options. eg "--unified=3" // Internal, dynamic: var $clearBufferIdx=0; // This indicates the number of times the function addClearBuffer has been called - and used to detect the very first call... var $differenceLgd=0; /** * This will produce a color-marked-up diff output in HTML from the input strings. * * @param string String 1 * @param string String 2 * @param string Setting the wrapping tag name * @return string Formatted output. */ function makeDiffDisplay($str1,$str2,$wrapTag='span') { if ($this->stripTags) { $str1 = strip_tags($str1); $str2 = strip_tags($str2); } else { $str1 = $this->tagSpace($str1); $str2 = $this->tagSpace($str2); } $str1Lines = $this->explodeStringIntoWords($str1); $str2Lines = $this->explodeStringIntoWords($str2); $diffRes = $this->getDiff(implode(chr(10),$str1Lines).chr(10),implode(chr(10),$str2Lines).chr(10)); if (is_array($diffRes)) { reset($diffRes); $c=0; $diffResArray=array(); $differenceStr = ''; while(list(,$lValue)=each($diffRes)) { if (intval($lValue)) { $c=intval($lValue); $diffResArray[$c]['changeInfo']=$lValue; } if (substr($lValue,0,1)=='<') { $differenceStr.= $diffResArray[$c]['old'][] = substr($lValue,2); } if (substr($lValue,0,1)=='>') { $differenceStr.= $diffResArray[$c]['new'][] = substr($lValue,2); } } $this->differenceLgd = strlen($differenceStr); $outString=''; $clearBuffer=''; for ($a=-1;$aaddClearBuffer($clearBuffer); $clearBuffer=''; if (is_array($diffResArray[$a+1]['old'])) { $outString.='<'.$wrapTag.' class="diff-r">'.htmlspecialchars(implode(' ',$diffResArray[$a+1]['old'])).' '; } if (is_array($diffResArray[$a+1]['new'])) { $outString.='<'.$wrapTag.' class="diff-g">'.htmlspecialchars(implode(' ',$diffResArray[$a+1]['new'])).' '; } $chInfParts = explode(',',$diffResArray[$a+1]['changeInfo']); if (!strcmp($chInfParts[0],$a+1)) { $newLine = intval($chInfParts[1])-1; if ($newLine>$a) $a=$newLine; // Security that $a is not set lower than current for some reason... } } else { $clearBuffer.=htmlspecialchars($str1Lines[$a]).' '; } } $outString.=$this->addClearBuffer($clearBuffer,1); $outString = str_replace(' ',chr(10),$outString); if (!$this->stripTags) { $outString = $this->tagSpace($outString,1); } return $outString; } } /** * Produce a diff (using the "diff" application) between two strings * The function will write the two input strings to temporary files, then execute the diff program, delete the temp files and return the result. * * @param string String 1 * @param string String 2 * @return array The result from the exec() function call. * @access private */ function getDiff($str1,$str2) { // Create file 1 and write string $file1 = t3lib_div::tempnam('diff1_'); t3lib_div::writeFile($file1,$str1); // Create file 2 and write string $file2 = t3lib_div::tempnam('diff2_'); t3lib_div::writeFile($file2,$str2); // Perform diff. $cmd = $GLOBALS['TYPO3_CONF_VARS']['BE']['diff_path'].' '.$this->diffOptions.' '.$file1.' '.$file2; $res = array(); exec($cmd,$res); unlink($file1); unlink($file2); return $res; } /** * Will bring down the length of strings to < 150 chars if they were longer than 200 chars. This done by preserving the 70 first and last chars and concatenate those strings with "..." and a number indicating the string length * * @param string The input string. * @param boolean If set, it indicates that the string should just end with ... (thus no "complete" ending) * @return string Processed string. * @access private */ function addClearBuffer($clearBuffer,$last=0) { if (strlen($clearBuffer)>200) { $clearBuffer=($this->clearBufferIdx?t3lib_div::fixed_lgd_cs($clearBuffer,70):'').'['.strlen($clearBuffer).']'.(!$last?t3lib_div::fixed_lgd_cs($clearBuffer,-70):''); } $this->clearBufferIdx++; return $clearBuffer; } /** * Explodes the input string into words. * This is done by splitting first by lines, then by space char. Each word will be in stored as a value in an array. Lines will be indicated by two subsequent empty values. * * @param string The string input * @return array Array with words. * @access private */ function explodeStringIntoWords($str) { $strArr = t3lib_div::trimExplode(chr(10),$str); $outArray=array(); reset($strArr); while(list(,$lineOfWords)=each($strArr)) { $allWords = t3lib_div::trimExplode(' ',$lineOfWords,1); $outArray = array_merge($outArray,$allWords); $outArray[]=''; $outArray[]=''; } return $outArray; } /** * Adds a space character before and after HTML tags (more precisely any found < or >) * * @param string String to process * @param boolean If set, the < > searched for will be < and > * @return string Processed string * @access private */ function tagSpace($str,$rev=0) { if ($rev) { return str_replace(' <','<',str_replace('> ','>',$str)); } else { return str_replace('<',' <',str_replace('>','> ',$str)); } } } if (defined('TYPO3_MODE') && $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['t3lib/class.t3lib_diff.php']) { include_once($TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['t3lib/class.t3lib_diff.php']); } ?>