xdiff_string_diff

(PECL xdiff >= 0.2.0)

xdiff_string_diff — 2 つの文字列の unified diff を作成する

説明

xdiff_string_diff(
    string $old_data,
    string $new_data,
    int $context = 3,
    bool $minimal = false
): string

old_data 文字列と new_data 文字列の差分を含む unified diff を作成し、結果を返します。結果は可読形式となります。オプションのパラメータ context で、変更部分の前後にどれだけの行を含めるかを指定します。パラメータ minimal を true にすると、できる限り短い長さのパッチファイルを出力します (長い時間がかかります)。

パラメータ

old_data: データを含む最初の文字列。"旧" データです。
new_data: データを含む 2 番目の文字列。"新" データです。
context: diff の結果の前後に含める行の数を指定します。
minimal: このパラメータを true にすると、結果のファイルが最小になります (非常に時間がかかります)。結果のファイルは可読形式となります。

戻り値

成功した場合はその結果の diff、内部エラーが発生した場合に false を返します。

例

例1 xdiff_string_diff() の例

以下のコードは 2 つの記事の unified diff を作成します。

<?php
$old_article = file_get_contents('./old_article.txt');
$new_article = $_REQUEST['article']; /* Let's say that someone pasted a new article to html form */

$diff = xdiff_string_diff($old_article, $new_article, 1);
if (is_string($diff)) {
    echo "2 つの記事の差分:\n";
    echo $diff;
}

?>

注意

注意:
この関数はバイナリ文字列に対しては動作しません。バイナリ文字列の差分を作成するには xdiff_string_bdiff()/xdiff_string_rabdiff() を使用してください。

参考

xdiff_string_patch() - 文字列に unified diff 形式のパッチを適用する