PHPのsimilar_text()関数とは？文字列の類似度を計算する方法を解説

PHPのsimilar_text()関数は、2つの文字列間の類似度を計算するために使用される組み込み関数です。この関数を使うことで、2つの文字列がどれだけ一致しているかを、一致する文字数やパーセンテージとして把握できます。

構文

similar_text(str1, str2, percent)

パラメータ

• str1 − 比較対象となる最初の文字列

• str2 − 比較対象となる2番目の文字列

• percent − 類似度をパーセンテージで格納するための変数名（第3引数は省略可能で、参照渡しにより結果を受け取ります）

戻り値

similar_text()関数は、2つの文字列に含まれる一致した文字の数を返します。また、第3引数に変数を指定した場合は、類似度がパーセンテージ（%）としてその変数に格納されます。

使用例

以下は、「mobile」と「mobility」という2つの文字列の類似度を調べる例です。

<?php
   $res = similar_text("mobile", "mobility", $percent);
   echo "一致した文字数 : $res\n";
   echo "類似度 : {$percent}%";
?>

出力

一致した文字数 : 5

この例では、「mobile」と「mobility」の共通する文字が5つであることがわかります。

空文字列を比較した場合の例

次に、2つの空文字列（""）を比較した場合の動作を確認してみましょう。

<?php
   similar_text("", "", $res);
   echo $res;
?>

出力

0

比較する文字列が空の場合、一致する文字は存在しないため、戻り値は「0」となります。

注意点

similar_text()関数による比較では、大文字と小文字が区別されます。例えば「Apple」と「apple」は完全には一致しないため、大文字小文字を無視して比較したい場合は、あらかじめmb_strtolower()などの関数で文字列を揃えておくことをおすすめします。