PHPでの文字列置換方法 – str_replace関数の使い方徹底解説

PHPの文字列置換方法であるstr_replace関数の使い方を具体例とともに解説します。

PHPで文字列を置き換えたいのですが、どのようにすればいいですか？

PHPにはstr_replace関数という便利な関数があります。この関数を使うと、特定の文字列を別の文字列に置き換えることができます。この記事では、この関数の使い方をサンプルプログラムを交えて詳しく解説します。

受講者数No.1！初心者からプロへ導く信頼のスクール

短期間で習得可能！未経験から実践力を磨く充実のプログラム

テックアカデミー公式ページへ ≫

今なら無料相談でAmazonギフトカードがもらえる！

str_replace関数とは

str_replace関数は、PHPで指定した文字列を別の文字列に置き換えるための関数です。この関数を使うことで、テキストの中の特定の部分を簡単に変更することができます。例えば、テンプレート文書における変数の置き換えや、ユーザー入力のサニタイズなど、様々な用途に利用されます。

構文

str_replace(search, replace, subject, count)

search: 置き換えたい文字列。配列も指定可能。
replace: 置き換える文字列。配列も指定可能。
subject: 操作対象の文字列。配列も指定可能。
count (オプション): 置き換えが行われた回数を格納する変数。

具体例

例えば、以下の例では「World」を「PHP」に置き換えています。

<?php
$original = "Hello, World!";
$search = "World";
$replace = "PHP";
$new_string = str_replace($search, $replace, $original);
echo $new_string;
?>

結果: Hello, PHP!

このように、str_replace関数を使うことで、簡単に文字列を置き換えることができます。応用例や詳細な使い方については、以下のセクションでさらに詳しく解説していきます。

基本的な使い方

str_replace関数の基本的な使い方を具体例を交えて解説します。まずは単純な文字列置換から見ていきましょう。

単一の文字列置換

1つの文字列を別の文字列に置き換える基本的な例です。

「World」を「PHP」に置き換えます。

<?php
$original = "Hello, World!";
$search = "World";
$replace = "PHP";
$new_string = str_replace($search, $replace, $original);
echo $new_string; // 結果: Hello, PHP!
?>

配列を使った複数の文字列置換

複数の文字列を一度に置き換えることもできます。配列を使用して、複数の検索文字列と置き換え文字列を指定します。

「World」と「PHP」をそれぞれ「Universe」と「Programming」に置き換えます。

<?php
$original = "Hello, World! Welcome to the World of PHP.";
$search = array("World", "PHP");
$replace = array("Universe", "Programming");
$new_string = str_replace($search, $replace, $original);
echo $new_string; // 結果: Hello, Universe! Welcome to the Universe of Programming.
?>

置き換え回数の取得

str_replace関数は、置き換えが行われた回数を取得することもできます。これは、特定の文字列が何回置き換えられたかを知りたい場合に便利です。

「is」を「was」に置き換え、その回数を取得します。

<?php
$original = "This is a test. This is only a test.";
$search = "is";
$replace = "was";
$count = 0;
$new_string = str_replace($search, $replace, $original, $count);
echo $new_string; // 結果: Thwas was a test. Thwas was only a test.
echo "置き換え回数: $count"; // 結果: 置き換え回数: 4
?>

配列を操作対象にする

操作対象の文字列に配列を指定することも可能です。複数の文字列に対して一括で置き換えを行えます。

複数の文を一度に処理します。

<?php
$original = array("Hello, World!", "Welcome to the World of PHP.");
$search = "World";
$replace = "Universe";
$new_string = str_replace($search, $replace, $original);
print_r($new_string); // 結果: Array ( [0] => Hello, Universe! [1] => Welcome to the Universe of PHP. )
?>

これらの基本的な使い方を理解することで、str_replace関数を効果的に利用できるようになります。次のセクションでは、さらに高度な応用例について見ていきましょう。

サンプルプログラム

ここでは、str_replace関数の使い方を理解するための具体的なサンプルプログラムを紹介します。基本的な使い方から応用的な例まで、さまざまなケースを取り上げます。

基本例: 単一文字列の置き換え

まずは、基本的な使い方から始めます。特定の文字列を別の文字列に置き換えるシンプルな例です。

<?php
// 元の文字列
$original = "Hello, World!";
// 置き換えたい文字列
$search = "World";
// 置き換える文字列
$replace = "PHP";
// str_replace関数を使って置き換え
$new_string = str_replace($search, $replace, $original);
// 結果を表示
echo $new_string; // 結果: Hello, PHP!
?>

応用例: 複数文字列の置き換え

次に、複数の文字列を一度に置き換える方法です。配列を使用して、複数の検索文字列と置き換え文字列を指定します。

<?php
// 元の文字列
$original = "Hello, World! Welcome to the World of PHP.";
// 置き換えたい文字列の配列
$search = array("World", "PHP");
// 置き換える文字列の配列
$replace = array("Universe", "Programming");
// str_replace関数を使って置き換え
$new_string = str_replace($search, $replace, $original);
// 結果を表示
echo $new_string; // 結果: Hello, Universe! Welcome to the Universe of Programming.
?>

応用例: 置き換え回数の取得

特定の文字列が何回置き換えられたかを取得する方法です。置き換え回数は、str_replace関数の第4引数で取得できます。

<?php
// 元の文字列
$original = "This is a test. This is only a test.";
// 置き換えたい文字列
$search = "is";
// 置き換える文字列
$replace = "was";
// 置き換え回数を格納する変数
$count = 0;
// str_replace関数を使って置き換え
$new_string = str_replace($search, $replace, $original, $count);
// 結果を表示
echo $new_string; // 結果: Thwas was a test. Thwas was only a test.
echo "置き換え回数: $count"; // 結果: 置き換え回数: 4
?>

応用例: 配列の置き換え

操作対象の文字列に配列を指定して、一括で複数の文字列に対して置き換えを行う方法です。

<?php
// 元の文字列の配列
$original = array("Hello, World!", "Welcome to the World of PHP.");
// 置き換えたい文字列
$search = "World";
// 置き換える文字列
$replace = "Universe";
// str_replace関数を使って置き換え
$new_string = str_replace($search, $replace, $original);
// 結果を表示
print_r($new_string); // 結果: Array ( [0] => Hello, Universe! [1] => Welcome to the Universe of PHP. )
?>