【PHP8.x】str_replace関数の使い方

作成日: 2025年09月11日更新日: 2025年09月29日

str_replace関数は、指定された文字列の中で特定の文字列を探し、別の文字列に置き換える処理を実行する関数です。この関数は、テキストデータの中から不要な部分を削除したり、特定のキーワードを一括で修正したり、フォーマットを整えたりする際に非常に役立ちます。例えば、ウェブサイトのコンテンツの更新や、ユーザーからの入力データの加工など、PHPプログラミングにおける文字列操作の基本的ながらも強力なツールとして幅広く利用されています。

基本的な使い方としては、第一引数に「探す文字列」、第二引数に「置き換える文字列」、第三引数に「処理対象の文字列」を指定します。これらの引数には単一の文字列だけでなく、文字列の配列を渡すことも可能です。配列を渡した場合、str_replace関数は配列の要素を1対1で対応させ、複数の置換処理を一度に効率良く実行します。

この関数は大文字と小文字を区別して置換を行います。そのため、大文字・小文字を区別しない置換を行いたい場合は、関連するstr_ireplace関数をご利用ください。また、オプションとして第四引数に整数型の変数を指定すると、置換が実際に行われた回数をその変数に格納することができます。これにより、置換の実行結果を数値で把握できます。str_replace関数は、日本語などのマルチバイト文字を含む文字列であっても安全かつ正確に置換処理を実行できます。

基本的な使い方

構文(syntax)

<?php

$text = "PHP is a popular scripting language. PHP is widely used.";
$search = "PHP";
$replace = "Python";
$new_text = str_replace($search, $replace, $text);

echo $new_text;

?>

引数(parameters)

array|string $search, array|string $replace, array|string $subject, int &$count = null

PHP:

array|string $search: 置換対象の文字列または文字列の配列
array|string $replace: 置換後の文字列または文字列の配列
array|string $subject: 検索および置換対象の文字列または文字列の配列
int &$count = null: 置換が発生した回数。省略可能

戻り値(return)

array|string

指定された文字列を検索し、別の文字列に置き換えた結果の文字列、または置換が1回も行われなかった場合は元の文字列を返します。置換の回数も配列として返される場合があります。