PHPで文字列内に部分文字列が含まれるかチェックする方法

PHPで文字列の中に特定の部分文字列（サブストリング）が含まれているかどうかを確認するには、strpos() 関数を使用するのが一般的です。ここでは、具体的なコード例をもとにその方法を解説します。

例1：strpos() を使った部分文字列の検索

<?php
   $subStr = "Mother";
   $str = "How I Met Your Mother";
   echo "String = $str";
   echo "\nSubstring = $subStr";
   if(strpos($str, $subStr) !== false){
      echo "\nSubstring found successfully";
   } else{
      echo "\nSubstring not found";
   }
?>

出力結果

上記のコードを実行すると、次のような出力が得られます。

String = How I Met Your Mother
Substring = Mother
Substring found successfully

ポイント：!== false と比較する理由

strpos() 関数は、部分文字列が見つかった位置（インデックス）を返します。もし部分文字列が文字列の先頭（0番目）に見つかった場合、戻り値は 0 になります。0 は緩い比較（==）では false と同等に評価されてしまうため、「見つからない」と誤判定される恐れがあります。そのため、必ず厳密な比較演算子 !== を使うことが重要です。

例2：部分文字列が見つからない場合

続いて、指定した部分文字列が対象の文字列に存在しない場合の例を見てみましょう。

<?php
   $subStr = "Ocean";
   $str = "In the Heart of Sea";
   echo "String = $str";
   echo "\nSubstring = $subStr";
   if(strpos($str, $subStr) !== false){
      echo "\nSubstring found successfully";
   } else{
      echo "\nSubstring not found";
   }
?>

出力結果

このコードを実行すると、次の出力が得られます。

String = In the Heart of Sea
Substring = Ocean
Substring not found

補足：PHP 8以降なら str_contains() が便利

PHP 8.0以降では、さらに直感的に記述できる str_contains() 関数が利用できます。この関数は、部分文字列が含まれていれば true、含まれていなければ false を返すため、位置情報との比較処理が不要になります。

<?php
   $str = "How I Met Your Mother";
   if(str_contains($str, "Mother")){
      echo "Substring found successfully";
   }
?>

このように、PHPで部分文字列の有無をチェックする場面では、PHP 7以前の環境では strpos() と !== false の組み合わせ、PHP 8以降では str_contains() を使い分けると、安全で読みやすいコードになります。