xdiff_file_diff
(PECL xdiff >= 0.2.0)
xdiff_file_diff — 2 つのファイルの unified diff を作成する
説明
xdiff_file_diff
( string $old_file
, string $new_file
, string $dest
[, int $context
= 3
[, bool $minimal
= false
]] ) : bool
old_file
と
new_file
の差分を含む unified diff を作成し、ファイル
dest
に保存します。結果は可読形式のファイルとなります。
オプションのパラメータ context
で、
変更部分の前後にどれだけの行を含めるかを指定します。
パラメータ minimal
を true にすると、
できる限り短い長さのパッチファイルを出力します (長い時間がかかります)。
パラメータ
old_file
- 最初のファイルへのパス。"旧" ファイルです。
new_file
- 2 番目のファイルへのパス。"新" ファイルです。
dest
- 結果のパッチファイルへのパス。
context
- diff の結果の前後に含める行の数を指定します。
minimal
- このパラメータを
true
にすると、結果のファイルが最小になります (長い時間がかかります)。
返り値
成功した場合に true
を、失敗した場合に false
を返します。
例
例1 xdiff_file_diff() の例
以下のコードは 2 つの php ファイルの unified diff を context length 2 で作成します。
<?php$old_version = 'my_script.php';$new_version = 'my_new_script.php';xdiff_file_diff($old_version, $new_version, 'my_script.diff', 2);?>
注意
注意:
この関数はバイナリファイルに対しては動作しません。バイナリファイルの 差分を作成するには xdiff_file_bdiff()/xdiff_file_rabdiff() 関数を使用してください。