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

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

str_ends_with関数は、文字列が指定された接尾辞で終わっているかどうかを判定する関数です。この関数は、PHP 8.0.0で導入され、文字列の末尾が特定の部分文字列と一致するかどうかを簡単に確認できます。具体的には、str_ends_with(string $haystack, string $needle): boolという形式で使用します。$haystackは検索対象となる文字列であり、$needleは検索する接尾辞です。

関数は、$haystackが$needleで終わる場合にtrueを返し、そうでない場合はfalseを返します。大文字小文字は区別されます。例えば、str_ends_with("Hello World", "World")はtrueを返しますが、str_ends_with("Hello World", "world")はfalseを返します。

この関数は、ファイル名やURLの拡張子をチェックする際、または特定の文字列で終わるデータを処理する際に役立ちます。以前は、substr関数やstrcmp関数などを組み合わせて同様の処理を行う必要がありましたが、str_ends_with関数を使用することで、より簡潔で可読性の高いコードを書くことができます。

例えば、ファイル名が.txtで終わるかどうかを判定する場合、str_ends_with($filename, ".txt")のように使用できます。これにより、初心者でも簡単に文字列の末尾をチェックする処理を実装できます。

基本的な使い方

構文(syntax)

<?php
$text = "PHPプログラミング";
$suffix = "グラミング";

// str_ends_with() は、最初の文字列が2番目の文字列で終わる場合に true を返します。
if (str_ends_with($text, $suffix)) {
    echo "'{$text}' は '{$suffix}' で終わります。\n"; // この行が出力される
} else {
    echo "'{$text}' は '{$suffix}' で終わりません。\n";
}
?>

引数(parameters)

string $haystack, string $needle

string $haystack: haystack（検索対象の文字列）を指定します。
string $needle: needle（検索する文字列）を指定します。

戻り値(return)

bool

指定された文字列が、指定されたサフィックス（末尾の文字列）で終わるかどうかを真偽値（trueまたはfalse）で返します。