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

説明

基本構文

wp_get_video_extensions(): string[]

引数

引数はありません。

戻り値

拡張子の配列。

使い方（サンプル）

$exts = wp_get_video_extensions();

注意点

• フィルターで拡張子を追加できます。

実務での使いどころ

• 動画として扱える、拡張子の一覧を取得するとき。
• アップロードされた動画ファイルの、拡張子を確認するとき。

よくあるミスと対処

• 一覧が、固定だと考えている。wp_video_extensions フィルターで、変更されることがある。
• ファイル名の拡張子だけで、動画かどうかを判断している。
• 一覧にない拡張子の動画を、アップロードできると考えている。

NG例

if ( in_array( $ext, array( 'mp4', 'mov' ), true ) ) { // 一覧を、自分で決め打ちしている
	// ...
}

OK例

$ext = strtolower( pathinfo( $file, PATHINFO_EXTENSION ) );
if ( in_array( $ext, wp_get_video_extensions(), true ) ) {
	// WordPressが動画として扱う拡張子
}

使い分け早見表

関連項目

wp_get_audio_extensions()、wp_check_filetype()

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