wp_get_audio_extensions() の使い方｜説明・引数・注意点

説明

基本構文

wp_get_audio_extensions(): string[]

引数

引数はありません。

戻り値

拡張子の配列。

使い方（サンプル）

$ext = strtolower( pathinfo( $file, PATHINFO_EXTENSION ) );
if ( in_array( $ext, wp_get_audio_extensions(), true ) ) {
	// 音声ファイル
}

注意点

• 一覧は、wp_audio_extensions フィルターで変更されることがあります。
• 動画の拡張子は、wp_get_video_extensions()。

実務での使いどころ

• アップロードされたファイルが、音声かを、拡張子で判断するとき。

よくあるミスと対処

• 一覧を、自分で決め打ちしている。
• 拡張子だけで、音声かどうかを判断している。

NG例

if ( in_array( $ext, array( 'mp3', 'wav' ), true ) ) { // 一覧を、決め打ちしている
	// ...
}

OK例

if ( in_array( $ext, wp_get_audio_extensions(), true ) ) {
	// ...
}

使い分け早見表

関連項目

wp_get_video_extensions()、wp_check_filetype()

公式リファレンス：wp_get_audio_extensions() | WordPress Developer Resources