str_ends_with()


WordPressのstr_ends_with()関数は、指定された文字列が特定のサフィックス(末尾の文字列)で終わるかどうかを確認します。

構文

str_ends_with( string $haystack, string $needle ): bool

引数の説明:

  • $haystack (string) — チェック対象の文字列。
  • $needle (string) — 末尾に一致するかどうかを確認する文字列。

戻り値:

  • (bool) — 文字列が指定された末尾で終わる場合はtrue、それ以外の場合はfalse。

使用例

例 1: 文字列が特定の拡張子で終わるかを確認

次のコードは、文字列が.phpで終わるかどうかをチェックします。

<?php
if ( str_ends_with( 'example.php', '.php' ) ) {
    echo 'PHPファイルです。';
}
?>

例 2: URLの末尾をチェック

URLが/contactで終わるかを確認します。

<?php
$url = 'https://example.com/contact';
if ( str_ends_with( $url, '/contact' ) ) {
    echo 'コンタクトページです。';
}
?>

例 3: ユーザー名の末尾を検証

ユーザー名が特定のサフィックスで終わるかをチェックします。

<?php
$username = 'admin_user';
if ( str_ends_with( $username, '_user' ) ) {
    echo 'このユーザー名は有効です。';
}
?>

例 4: ファイル名がバックアップファイルかを確認

ファイル名が.bakで終わるかを判定します。

<?php
$filename = 'database_backup.bak';
if ( str_ends_with( $filename, '.bak' ) ) {
    echo 'バックアップファイルです。';
}
?>

例 5: 投稿のカスタムフィールド値の末尾をチェック

カスタムフィールド値が特定の文字列で終わるかを確認します。

<?php
$custom_field_value = get_post_meta( get_the_ID(), 'custom_field_key', true );
if ( str_ends_with( $custom_field_value, 'suffix' ) ) {
    echo 'カスタムフィールドの値が一致しました。';
}
?>

注意事項

この関数はPHP 8.0以上が必要です。文字列比較は大文字と小文字を区別します。


関連機能: