* A class to render Diffs in different formats.
* This class renders the diff in classic diff format. It is intended that
* this class be customized via inheritance, to obtain fancier outputs.
* Copyright 2004-2010 The Horde Project (http://www.horde.org/)
* See the enclosed file COPYING for license information (LGPL). If you did
* not receive this file, see http://opensource.org/licenses/lgpl-license.php.
class Text_Diff_Renderer {
* Number of leading context "lines" to preserve.
* This should be left at zero for this class, but subclasses may want to
* set this to other values.
var $_leading_context_lines = 0;
* Number of trailing context "lines" to preserve.
* This should be left at zero for this class, but subclasses may want to
* set this to other values.
var $_trailing_context_lines = 0;
function __construct( $params = array() )
foreach ($params as $param => $value) {
public function Text_Diff_Renderer( $params = array() ) {
self::__construct( $params );
* Get any renderer parameters.
* @return array All parameters of this renderer object.
foreach (get_object_vars($this) as $k => $v) {
$params[substr($k, 1)] = $v;
* @param Text_Diff $diff A Text_Diff object.
* @return string The formatted output.
$nlead = $this->_leading_context_lines;
$ntrail = $this->_trailing_context_lines;
$output = $this->_startDiff();
$diffs = $diff->getDiff();
foreach ($diffs as $i => $edit) {
/* If these are unchanged (copied) lines, and we want to keep
* leading or trailing context lines, extract them from the copy
if (is_a($edit, 'Text_Diff_Op_copy')) {
/* Do we have any diff blocks yet? */
/* How many lines to keep as context from the copy
$keep = $i == count($diffs) - 1 ? $ntrail : $nlead + $ntrail;
if (count($edit->orig) <= $keep) {
/* We have less lines in the block than we want for
* context => keep the whole block. */
/* Create a new block with as many lines as we need
* for the trailing context. */
$context = array_slice($edit->orig, 0, $ntrail);
$block[] = new Text_Diff_Op_copy($context);
$output .= $this->_block($x0, $ntrail + $xi - $x0,
$y0, $ntrail + $yi - $y0,
/* Keep the copy block as the context for the next block. */
/* Don't we have any diff blocks yet? */
/* Extract context lines from the preceding copy block. */
$context = array_slice($context, count($context) - $nlead);
$x0 = $xi - count($context);
$y0 = $yi - count($context);
$block[] = new Text_Diff_Op_copy($context);
$xi += count($edit->orig);
$yi += count($edit->final);
$output .= $this->_block($x0, $xi - $x0,
return $output . $this->_endDiff();
function _block($xbeg, $xlen, $ybeg, $ylen, &$edits)
$output = $this->_startBlock($this->_blockHeader($xbeg, $xlen, $ybeg, $ylen));
foreach ($edits as $edit) {
switch (strtolower(get_class($edit))) {
case 'text_diff_op_copy':
$output .= $this->_context($edit->orig);
$output .= $this->_added($edit->final);
case 'text_diff_op_delete':
$output .= $this->_deleted($edit->orig);
case 'text_diff_op_change':
$output .= $this->_changed($edit->orig, $edit->final);
return $output . $this->_endBlock();
function _blockHeader($xbeg, $xlen, $ybeg, $ylen)
$xbeg .= ',' . ($xbeg + $xlen - 1);
$ybeg .= ',' . ($ybeg + $ylen - 1);
// this matches the GNU Diff behaviour
return $xbeg . ($xlen ? ($ylen ? 'c' : 'd') : 'a') . $ybeg;
function _startBlock($header)
function _lines($lines, $prefix = ' ')
return $prefix . implode("\n$prefix", $lines) . "\n";
function _context($lines)
return $this->_lines($lines, ' ');
return $this->_lines($lines, '> ');
function _deleted($lines)
return $this->_lines($lines, '< ');
function _changed($orig, $final)
return $this->_deleted($orig) . "---\n" . $this->_added($final);