PHPのstr_replace()関数とは？文字列置換の基本から配列への応用まで解説

PHPのstr_replace()関数は、文字列の中にある特定の値を検索し、別の文字列に置き換えるために使用される組み込み関数です。

注意： str_replace()関数は大文字と小文字を区別します。「Amit」と「amit」は別の値として扱われるため、大文字小文字が一致しない場合は置換されません。大文字小文字を区別せずに置換したい場合は、str_ireplace()関数を使用してください。

基本構文

str_replace(find, replace, str, count)

パラメータ

• find（必須） − 検索したい値。文字列または配列を指定できます。

• replace（必須） − findで見つかった値を置き換える文字列。

• str（必須） − 検索・置換の対象となる文字列または配列。

• count（任意） − 実際に行われた置換の回数が格納される変数。この引数を渡すことで、何回置換が行われたかを取得できます。

戻り値

str_replace()関数は、置換後の値を含む文字列または配列を返します。対象が配列の場合は、各要素に対して置換処理が適用された配列が返されます。

例1：文字列の置換

基本的な文字列の置換例を見てみましょう。

<?php
$str = "I am Amit";
$res = str_replace("Amit", "David", $str);
echo $res;
?>

出力結果

I am David

この例では、「I am Amit」という文字列の中の「Amit」が「David」に置き換えられています。

例2：配列の要素を置換し、置換回数を取得する

第4引数のcountを使うと、置換が何回行われたかを確認できます。

<?php
$myArr = array("one","two","three");
print_r(str_replace("three","four",$myArr,$c));
echo "<br>" . "Number of Replacements = $c";
?>

出力結果

Array (
    [0] => one
    [1] => two
    [2] => four
)
<br> Number of Replacements = 1

この例では、配列内の「three」が「four」に置き換えられ、count変数には置換回数である「1」が格納されています。

まとめ

• str_replace()は文字列や配列内の値を簡単に置換できる便利な関数です。

• 大文字・小文字を区別するため、必要に応じてstr_ireplace()の利用を検討しましょう。

• 第4引数のcountを指定すると、置換回数を取得できます。