【PHP8.x】mb_strripos()関数の使い方

mb_strripos関数の使い方について、初心者にもわかりやすく解説します。

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

基本的な使い方

mb_strripos関数は、マルチバイト文字列に対応し、ある文字列の中で指定した部分文字列が最後に出現する位置を、大文字と小文字を区別せずに検索する関数です。PHPが標準で提供する文字列操作関数の中には、日本語のような2バイト以上の文字で構成されるマルチバイト文字列を正しく扱えないものがありますが、この関数は、そうしたマルチバイト文字を含む文字列を安全かつ正確に処理するために設計されています。

この関数は、与えられた検索対象文字列の中から、指定した部分文字列がどこにあるかを調べます。特に、複数回出現する可能性がある部分文字列に対して、その一番最後に出現する場所を知りたい場合に有用です。検索は文字列の末尾から逆方向に進みますが、戻り値は文字列の先頭から数えた0始まりの文字位置で示されます。

主な使い方としては、検索したい元の文字列と、見つけたい部分文字列を引数として渡します。さらに、オプションとして、検索を開始する文字位置（オフセット）や、使用する文字エンコーディングを指定することも可能です。エンコーディングが明示的に指定されない場合、PHPの内部エンコーディングが自動的に適用されます。

部分文字列が見つかった場合、その開始位置を示す整数値が返されます。例えば、文字列の先頭で部分文字列が見つかった場合は0が返されます。もし、指定した部分文字列が検索対象の文字列内に全く見つからなかった場合は、falseが返されます。このため、戻り値が0であることとfalseであることには明確な違いがあり、結果を正確に判定するためには、厳密な比較演算子（===）を用いてfalseと比較することが推奨されます。mb_strripos関数は、国際化されたアプリケーションにおいて、文字列の検索処理を堅牢に行うための重要なツールとなります。

構文(syntax)


1<?php
2$haystack_string = "これはマルチバイトのテスト文字列です。テスト";
3$needle_string = "テスト";
4$offset_integer = 0;
5$encoding_string_or_null = "UTF-8";
6
7$found_position_integer_or_false = mb_strripos(
8    $haystack_string,
9    $needle_string,
10    $offset_integer,
11    $encoding_string_or_null
12);

引数(parameters)

string $haystack, string $needle, int $offset = 0, ?string $encoding = null

string $haystack: 検索対象の文字列
string $needle: 検索する文字列
int $offset = 0: 検索を開始する位置（オプション、デフォルトは文字列の末尾から）
?string $encoding = null: 文字エンコーディングを指定する（オプション、デフォルトは内部エンコーディング）

戻り値(return)

int|false

指定された部分文字列が、指定された文字列内で大文字・小文字を区別せずに最初に見つかった位置（インデックス）を整数で返します。見つからなかった場合は false を返します。

サンプルコード

PHP mb_strripos で最後の位置を検索する


1<?php
2
3/**
4 * mb_strripos 関数の使用例を示すスクリプト。
5 *
6 * 指定された文字列の中から、検索文字列が最後に現れる位置を、
7 * 大文字・小文字を区別せず、マルチバイト文字対応で検索します。
8 * 見つからない場合は false を返します。
9 *
10 * PHPのmb_strposに似ていますが、mb_strriposは文字列の最後から検索を開始し、
11 * 大文字・小文字を区別しない点が特徴です。
12 */
13function findLastPositionCaseInsensitive(): void
14{
15    // 検索対象となる文字列（マルチバイト文字を含む）
16    $haystack = "PHPは素晴らしい言語です。phpを学びましょう。PHP!";
17    // 検索する文字列（大文字・小文字を区別しない検索なので、'php'や'PHP'どちらでも同じ結果）
18    $needle = "php";
19
20    // mb_strripos を使用して、検索文字列が最後に現れる位置を取得します。
21    // この関数は、大文字・小文字を区別せず（例: 'php'と'PHP'を同じとみなす）、
22    // マルチバイト文字（日本語など）を正しく扱います。
23    // 検索は文字列の最後から行われ、最初に見つかったマッチの位置（文字列全体の最後から見て）を返します。
24    $lastPosition = mb_strripos($haystack, $needle);
25
26    if ($lastPosition !== false) {
27        echo "文字列 '{$needle}' は、'{$haystack}' の中で最後にインデックス {$lastPosition} で見つかりました。\n";
28        // 見つかった位置からの部分文字列を表示して確認
29        // mb_substr を使用してマルチバイト文字を正しく処理します。
30        echo "その位置からの部分文字列: " . mb_substr($haystack, $lastPosition) . "\n";
31    } else {
32        echo "文字列 '{$needle}' は '{$haystack}' の中で見つかりませんでした。\n";
33    }
34
35    echo "\n";
36
37    // 別の検索文字列で、見つからない場合の例
38    $anotherNeedle = "JavaScript";
39    $notFoundPosition = mb_strripos($haystack, $anotherNeedle);
40
41    if ($notFoundPosition !== false) {
42        echo "文字列 '{$anotherNeedle}' は、'{$haystack}' の中でインデックス {$notFoundPosition} で見つかりました。\n";
43    } else {
44        echo "文字列 '{$anotherNeedle}' は '{$haystack}' の中で見つかりませんでした。\n";
45    }
46}
47
48// サンプル関数を実行します。
49findLastPositionCaseInsensitive();
50

mb_strripos関数は、PHPで特定の文字列（$needle）が別の文字列（$haystack）の中に最後に現れる位置を検索する際に使用します。この関数は、日本語のようなマルチバイト文字を正しく処理できる点が大きな特徴です。また、名前に含まれる「r」は「右から（文字列の末尾から先頭へ）」検索を行うことを意味し、「i」は「大文字・小文字を区別しない」検索を行うことを意味します。そのため、例えば「PHP」と「php」を同じものとして扱います。

引数には、検索対象の文字列（$haystack）と検索したい文字列（$needle）を渡します。オプションで、検索を開始する位置（$offset）や、文字エンコーディング（$encoding）を指定することも可能です。

検索文字列が見つかった場合、その文字列が**最後に出現する位置のインデックス（0から始まる数値）**を返します。このインデックスは、文字列の先頭からの位置を示します。もし見つからなかった場合はfalseを返しますので、結果がfalseでないかを確認することが重要です。

PHPのmb_strpos関数に似ていますが、mb_strriposは最後に出現する位置を大文字・小文字を区別せずに検索するため、より柔軟な文字列検索が可能です。サンプルコードでは、「PHPは素晴らしい言語です。phpを学びましょう。PHP!」の中から「php」が最後に現れる位置を検索し、その結果を表示しています。これにより、日本語を含む文字列で特定のキーワードがどこで最後に使われているかを効率的に見つけ出すことができます。

mb_strripos関数は、指定した文字列が検索対象の中で最後に現れる位置を、大文字・小文字を区別せずマルチバイト文字対応で検索する点に注意が必要です。戻り値は、見つかった位置の数値（先頭は0）か、見つからなかった場合はfalseとなります。そのため、結果が0になる可能性も考慮し、!== falseのような厳密な比較で見つかったかどうかを判断してください。第三引数で検索開始位置を、第四引数で文字エンコーディングを指定することで、さらに柔軟な検索が可能です。

PHP mb_strripos でマルチバイト文字の末尾位置を検索する


1<?php
2
3/**
4 * PHPのmb_strripos関数は、大文字小文字を区別せず、マルチバイト文字列（日本語など）から
5 * 指定された部分文字列が最後に現れる位置を検索します。
6 * 戻り値は、見つかった場合は0から始まる文字オフセット、見つからない場合はfalseです。
7 */
8
9// 検索対象の文字列（日本語を含む）
10$text = "PHPはプログラミング言語です。PHPはWeb開発によく使われます。";
11// 検索する部分文字列（大文字小文字は区別されません）
12$search = "php";
13
14// mb_strripos を使って、'php' が最後に出現する位置を検索します。
15// エンコーディングを指定しない場合、PHPの設定 (mbstring.internal_encoding) が使われます。
16$position = mb_strripos($text, $search);
17
18if ($position !== false) {
19    echo "ケース1: '{$search}' は文字列の最後に位置 {$position} で見つかりました。\n";
20    // mb_substr を使って、見つかった位置から検索文字列の長さ分だけ切り出し、確認します。
21    // mb_strlen もエンコーディングを考慮して文字数を正確に取得します。
22    $foundString = mb_substr($text, $position, mb_strlen($search));
23    echo "  -> 見つかった部分: '{$foundString}'\n\n";
24} else {
25    echo "ケース1: '{$search}' は見つかりませんでした。\n\n";
26}
27
28// UTF-8 エンコーディングを明示的に指定する例
29// 日本語などのマルチバイト文字を扱う際、エンコーディングの指定は重要です。
30$textUtf8 = "これはUTF-8の日本語テキストです。UTF-8は多言語対応です。";
31$searchUtf8 = "utf-8";
32
33// 最後の引数でエンコーディングを 'UTF-8' と指定します。
34// これにより、文字列がUTF-8として正しく処理されます。
35$positionUtf8 = mb_strripos($textUtf8, $searchUtf8, 0, 'UTF-8');
36
37if ($positionUtf8 !== false) {
38    echo "ケース2: '{$searchUtf8}' (UTF-8指定) は文字列の最後に位置 {$positionUtf8} で見つかりました。\n";
39    // エンコーディングを明示して mb_substr と mb_strlen を使用します。
40    $foundStringUtf8 = mb_substr($textUtf8, $positionUtf8, mb_strlen($searchUtf8, 'UTF-8'), 'UTF-8');
41    echo "  -> 見つかった部分: '{$foundStringUtf8}'\n\n";
42} else {
43    echo "ケース2: '{$searchUtf8}' (UTF-8指定) は見つかりませんでした。\n\n";
44}
45
46// 検索文字列が見つからない場合の例
47$nonExistentSearch = "Python";
48$positionNotFound = mb_strripos($text, $nonExistentSearch);
49
50if ($positionNotFound === false) {
51    echo "ケース3: '{$nonExistentSearch}' は見つかりませんでした (期待通り)。\n";
52}
53

PHPのmb_strripos関数は、日本語のようなマルチバイト文字を含む文字列から、特定の部分文字列が最後に現れる位置を検索するために使用されます。この関数は、大文字小文字を区別せずに検索を実行します。

主な引数は以下の通りです。検索対象の文字列を$haystack、検索したい部分文字列を$needleとして指定します。オプションの引数として、検索を開始するオフセット位置を$offsetで指定でき、デフォルトは0です。また、文字エンコーディングを$encodingで明示的に指定することが推奨されます。例えば、日本語を扱う場合は'UTF-8'と指定することで、文字の認識が正確になります。エンコーディングを省略した場合、PHPの内部設定が適用されます。

関数が部分文字列を見つけた場合、その文字列が始まる位置を0から始まる整数値で返します。見つからなかった場合はfalseを返します。サンプルコードでは、まずエンコーディングを指定しない場合と、'UTF-8'を明示的に指定した場合の二つのケースで検索を行い、検索結果の数値オフセットからmb_substrやmb_strlenを組み合わせて実際に切り出し、位置が正しいことを確認しています。また、存在しない文字列を検索した際にfalseが返される例も示しており、この戻り値を確認することで、検索が成功したかどうかを判断できます。

mb_strripos関数は、日本語などのマルチバイト文字を正しく扱い、大文字小文字を区別せずに文字列中の部分文字列が最後に出現する位置を検索します。検索文字列が見つからない場合はfalseを返しますが、見つかった場合は0からの整数を返すため、結果の確認は!== falseのように厳密な比較で行うことが重要です。また、文字化けなどの問題を避けるため、特に日本語を扱う際は、引数で'UTF-8'などのエンコーディングを明示的に指定することをお勧めします。この関数で見つけた位置を利用して文字列を切り出す場合などは、mb_substrやmb_strlenといったマルチバイト対応の関数を使い、エンコーディングも統一すると安全に処理できます。