str_replace 関数は、PHPで文字列内の指定した部分文字列を別の部分文字列で置換するために使用されます。この関数は非常に便利で、テキスト操作や文字列処理においてよく利用されます。以下に str_replace 関数の基本的な構文と説明を示します。

str_replace($search, $replace, $subject, $count);
  • $search: 置換対象となる文字列または文字列の配列。これを探して置換します。
  • $replace: $search にマッチする文字列が見つかった場合に、それを置換するための新しい文字列または文字列の配列。
  • $subject: 置換を行いたい対象の文字列。
  • $count (オプション): 置換が実行された回数をカウントする整数型の変数。省略可能で、指定しない場合は置換が何回行われたかを数えません。

str_replace 関数は、$search$subject 中で見つかった場合、それを $replace で指定した文字列で置換します。もし $search$subject に複数回出現している場合、すべての出現箇所が置換されます。置換が成功すると、新しい文字列が返されます。

以下は str_replace の例です:

$original_string = "This is a sample string. Replace me.";
$search = "Replace";
$replace = "Substitute";
$new_string = str_replace($search, $replace, $original_string);
echo $new_string;

このコードでは、$original_string の中から “Replace” を探して、それを “Substitute” に置換します。出力は次のようになります:

This is a sample string. Substitute me.

str_replace は文字列処理やテキストの操作、文字列の変更などのさまざまな用途で利用できます。