XDIFF_FILE_DIFF(3) 1 XDIFF_FILE_DIFF(3)
xdiff_file_diff - Make unified diff of two files
SYNOPSIS
bool xdiff_file_diff (string $old_file, string $new_file, string $dest, [int $context = 3], [bool $minimal = false])
DESCRIPTION
Makes an unified diff containing differences between $old_file and $new_file and stores it in $dest file. The resulting file is human-
readable. An optional $context parameter specifies how many lines of context should be added around each change. Setting $minimal parameter
to true will result in outputting the shortest patch file possible (can take a long time).
PARAMETERS
o $old_file
- Path to the first file. This file acts as "old" file.
o $new_file
- Path to the second file. This file acts as "new" file.
o $dest
- Path of the resulting patch file.
o $context
- Indicates how many lines of context you want to include in diff result.
o $minimal
- Set this parameter to TRUE if you want to minimalize size of the result (can take a long time).
RETURN VALUES
Returns TRUE on success or FALSE on failure.
EXAMPLES
Example #1
xdiff_file_diff(3) example
The following code makes unified diff of two php files with context length of 2.
<?php
$old_version = 'my_script.php';
$new_version = 'my_new_script.php';
xdiff_file_diff($old_version, $new_version, 'my_script.diff', 2);
?>
NOTES
Note
This function doesn't work well with binary files. To make diff of binary files use xdiff_file_bdiff(3)/xdiff_file_rabdiff(3) func-
tion.
SEE ALSO
xdiff_file_patch(3).
PHP Documentation Group XDIFF_FILE_DIFF(3)
