PHPのstr_ireplace()関数とは？大文字小文字を無視した文字列置換の使い方を解説

PHPのstr_ireplace()関数は、文字列の中から特定の文字や単語を検索し、別の文字列に置き換えるために使用される関数です。

注意：この関数は大文字と小文字を区別しません。そのため、「Amit」と「amit」は同じものとして扱われます。大文字小文字を区別したい場合は、str_replace()関数を使用してください。

構文

str_ireplace(find,replace,str,count)

パラメータ

• find − 検索対象となる値（文字列または配列）

• replace − findで見つかった値を置き換える値

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

• count − （省略可能）実際に置換が行われた回数が格納される変数

戻り値

str_ireplace()関数は、置換後の値を含む文字列または配列を返します。findとreplaceに配列を指定した場合、要素の順番に従って順次置換が行われます。

例1：文字列の置換

以下は、文字列内の単語を別の単語に置き換える基本的な例です。

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

実行結果は以下の通りです。

出力

I am David

例2：配列に対する置換と置換回数の取得

str_ireplace()関数は配列にも適用できます。また、第4引数に変数を指定すると、置換が行われた回数を取得することができます。

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

実行結果は以下の通りです。

出力

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

まとめ

str_ireplace()関数を使うことで、大文字小文字を気にせず柔軟な文字列置換が可能になります。単一の文字列だけでなく配列にも対応しており、置換回数も取得できるため、ログ処理やテキストの一括変換など、さまざまな場面で活用できる便利な関数です。