XDIFF_FILE_PATCH(3)							 1						       XDIFF_FILE_PATCH(3)

xdiff_file_patch - Patch a file with an unified diff

SYNOPSIS

       mixed xdiff_file_patch (string  $file, string  $patch, string  $dest, [int  $flags = DIFF_PATCH_NORMAL])

DESCRIPTION

	Patches   a   $file   with   a	 $patch   and	stores	 the   result	in   a	file.  $patch  has  to	be  an	unified  diff  created	by
       xdiff_file_diff(3)/xdiff_string_diff(3) function. An optional $flags parameter specifies mode of operation.

PARAMETERS

	      o $file
		- The original file.

	      o $patch
		- The unified patch file. It has to be created using xdiff_string_diff(3), xdiff_file_diff(3) functions or compatible tools.

	      o $dest
		- Path of the resulting file.

	      o $flags
		- Can be either XDIFF_PATCH_NORMAL (default mode, normal patch) or XDIFF_PATCH_REVERSE (reversed patch).   Starting  from  version
		1.5.0, you can also use binary OR to enable XDIFF_PATCH_IGNORESPACE flag.

RETURN VALUES

	Returns  FALSE	if an internal error happened, string with rejected chunks if patch couldn't be applied or TRUE if patch has been success-
       fully applied.

EXAMPLES

       Example #1

	      xdiff_file_patch(3) example

	       The following code applies unified diff to a file.

	      <?php
	      $old_version = 'my_script-1.0.php';
	      $patch = 'my_script.patch';

	      $errors = xdiff_file_patch($old_version, $patch, 'my_script-1.1.php');
	      if (is_string($errors)) {
		 echo "Rejects:
";
		 echo $errors;
	      }

	      ?>

       Example #2

	      Patch reversing example

	       The following code reverses a patch.

	      <?php
	      $new_version = 'my_script-1.1.php';
	      $patch = 'my_script.patch';

	      $errors = xdiff_file_patch($new_version, $patch, 'my_script-1.0.php', XDIFF_PATCH_REVERSE);
	      if (is_string($errors)) {
		 echo "Rejects:
";
		 echo $errors;
	      }

	      ?>

SEE ALSO

       xdiff_file_diff(3).

PHP Documentation Group 												       XDIFF_FILE_PATCH(3)