*/ /** * This class has functions which generates a difference output of a content string * * @author Kasper Skårhøj * @package TYPO3 * @subpackage t3lib */ class t3lib_diff { // External, static // If set, the HTML tags are stripped from the input strings first. var $stripTags = 0; // Diff options. eg "--unified=3" var $diffOptions = ''; // Internal, dynamic // This indicates the number of times the function addClearBuffer has been called - and used to detect the very first call... var $clearBufferIdx = 0; var $differenceLgd = 0; /** * This will produce a color-marked-up diff output in HTML from the input strings. * * @param string $str1 String 1 * @param string $str2 String 2 * @param string $wrapTag 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(LF, $str1Lines) . LF, implode(LF, $str2Lines) . LF); if (is_array($diffRes)) { $c = 0; $diffResArray = array(); $differenceStr = ''; foreach ($diffRes as $lValue) { 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; $a < count($str1Lines); $a++) { if (is_array($diffResArray[$a + 1])) { // a=Add, c=change, d=delete: If a, then the content is Added after the entry and we must insert the line content as well. if (strstr($diffResArray[$a + 1]['changeInfo'], 'a')) { $clearBuffer .= htmlspecialchars($str1Lines[$a]) . ' '; } $outString .= $this->addClearBuffer($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(' ', LF, $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 $str1 String 1 * @param string $str2 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(); t3lib_utility_Command::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 $clearBuffer The input string. * @param boolean $last 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 $str The string input * @return array Array with words. * @access private */ function explodeStringIntoWords($str) { $strArr = t3lib_div::trimExplode(LF, $str); $outArray = array(); foreach ($strArr as $lineOfWords) { $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 $str String to process * @param boolean $rev 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)); } } } ?>