説明
array wp_check_filetype_and_ext( string $file, string $filename [ , array $mimes = null ] )
ファイルタイプと拡張子を調べる。
パラメータ
- $fileファイルのフルパス名を指定。
- $filenameファイル名を指定。
- $mimesMIMEタイプの連想配列を指定。
返り値
ファイルタイプと拡張子情報としてキーが'ext'、'type'、'proper_filename'の連想配列を返す。ファイルは有効なMIMEタイプでない場合は'ext'と'type'の値はfalseとなり、ファイルが見つからない場合は'proper_filename'の値はfalseとなる。注意
パラメータ$filenameから取得したMIMEタイプが画像ファイルのもので、$fileの内容を精査して取得したMIMEタイプと異なる場合は、後者を優先し、$filenameの拡張子を変更したものがキー'proper_filename'の値となる。
[5.1.0]'wp_check_filetype_and_ext'フィルターに第5パラメータ$real_mimeが追加された。$real_mimeにはファイルを読み込んで判定したMIMEタイプが格納されている。（MIMEタイプを判定できなかった場合はfalseとなる）
使用例
- アップロードしたファイル'file1'のファイルタイプと拡張子を調べる。<?php $filetye_and_ext = wp_check_filetype_and_ext( $_FILES['file1']['tmp_name'], $_FILES['file1']['name'] ); ?>
フィルター
[3.0.0]MIMEタイプが画像ファイルで実際のファイルから取得したものと一致しない場合、'getimagesize_mimes_to_exts'フィルターを呼び出す。パラメータ$image_mime_to_extはキーがMIMEタイプ、値が拡張子の連想配列（標準ではJPEG、PNG、GIF、BMP、TIFF）となる。$mime_to_ext = apply_filters( 'getimagesize_mimes_to_exts', $image_mime_to_ext );
[3.0.0]取得したファイルタイプと拡張子情報を返す直前、'wp_check_filetype_and_ext'フィルターを呼び出す。パラメータ$filetye_and_extはファイルタイプと拡張子情報、その他は本関数が受け取った同名のパラメータの値となる。[5.1.0]$real_mimeにはファイルを読み込んで判定したMIMEタイプが格納されている。
return apply_filters( 'wp_check_filetype_and_ext', $filetye_and_ext, $file, $filename, $mimes, $real_mime );
アクション
実行するアクションはありません。ソースファイル
/wp-includes/functions.php最終更新 : 2019年02月23日 09:54
関連
お勧め
ショートコードを使ってテーマ内の画像URLを簡単に指定する（2018年5月27日 更新）
投稿記事の中で画像パーツを使いたいときがある。画像パーツの配置場所は、/imgディレクトリのようなテーマ外の場合と、/wp-content/themes/mytheme/imagesディレクトリのようなテーマ内の場合があり、今回は後者のケース。ショートコードを使って投稿記事の画像ファイルのURLを記述する方法を紹介したい。リクエスト応答を終了する前に何かを処理する（2013年9月26日 更新）
PHPでは、register_shutdown_function関数を使うことでリクエストに対してレスポンスを返した後に何らかの処理を行うことができる。WordPressでもregister_shutdown_function関数は使えると思うのだが、テーマ内のテンプレートでページを表示した後で何かを行う場合はどうすればいいのか、ちょっと調べてみた。
投稿情報を連想配列で参照する（2018年5月27日 更新）
投稿情報は、タイトルや本文、投稿日時といったいくつかのデータが含んでおり、多くの場合オブジェクトになっている。これを連想配列で扱いたい場合はキャストして型変換することが多かった。基本的にはキャストで問題ないのだが、ふと目に留まったto_arrayメソッドが興味深かったのでメモとして残しておく。
段落ブロックに日付・時刻の入力支援を実装した（2023年1月25日 更新）
ブロックエディターには文字入力を支援するAutocompleteがある。自作ブロックだけでなく既存のブロックに適用できるため、ブロックの利用シーンを踏まえた入力支援機能を追加できる。
ブロックエディターのタグ入力にタグクラウド機能を追加した（2019年1月10日 更新）
ブロックエディターのタグ入力には「よく使われているタグから選択」から表示される「タグクラウド」がない。ブロックエディターの不満なところのひとつがこれであり、うまく解消することができないか考えてみた。