説明
string wp_unique_filename( string $dir, string $filename [ , mixed $unique_filename_callback = null ] )
ユニークなファイル名を取得する。
パラメータ
- $dirディレクトリ名を指定。
- $filenameファイル名を指定。
- $unique_filename_callbackユニークなファイル名を生成するコールバック関数を指定（省略時はnull）。
返り値
ユニークなファイル名を返す。注意
パラメータ$unique_filename_callbackがnullでディレクトリに同名のファイルが存在する場合は、ファイル名の拡張子前に数字を追加したものを順に調べ、存在しなかった名前が返り値となる。例えば、パラメータ$filenameに'a.txt'が指定され、保存先のディレクトリに同名のファイルが存在する場合は、'a1.txt'、'a2.txt'、'a3.txt'の順にファイルが存在するか調べられる。
パラメータ$unique_filename_callbackに有効な関数が指定されている場合は、その関数の返り値が本関数の返り値となる。
使用例
- ディレクトリ$pathにて'log20141127_123456.txt'のユニークなファイル名を取得する。<?php $filename = wp_unique_filename( $path, 'log20141127_123456.txt' ); ?>
フィルター
[4.5.0]ユニークなファイル名を返す前に'wp_unique_filename'フィルターを呼び出す。パラメータ$filenameにはユニークなファイル名が、$extにはピリオド.を含む拡張子が、$dirと$unique_filename_callbackには本関数が受け取った内容が格納される。return apply_filters( 'wp_unique_filename', $filename, $ext, $dir, $unique_filename_callback );アクション
実行するアクションはありません。ソースファイル
/wp-includes/functions.php最終更新 : 2018年05月27日 10:46
関連
お勧め
子カテゴリのアーカイブページを親カテゴリ用のテンプレートファイルで表示しよう（2011年12月8日 更新）
少し前に投稿した「適切なテンプレートファイルを用意してテンプレート内の振り分け処理を無くす」で説明した通り、特定のカテゴリ専用のテンプレートとしてcategory-○○.phpを用意することで、category.phpやarchive.php内で振り分けを行う必要がなくなる。ただ、すべてのカテゴリ分を用意するのは効率的ではないし、特に子カテゴリについては親カテゴリと共通内容になるケースが多いのではないだろうか。ここでは、子カテゴリの個別テンプレートファイルを作らず、親カテゴリのテンプレートを利用する方法を紹介する。固定ページを投稿ページ用テンプレートファイル（single.php）で表示する（2013年7月31日 更新）
固定ページと投稿ページのデザインが共通の場合、同じ内容のsingle.phpとpage.phpを用意すれば事足りるが、デザインの修正時は二度手間になってしまう。そこで、固定ページをsingle.phpで表示するようにできないか考えてみた。
もうquery_postsは呼ばない（2011年9月27日 更新）
トップページやカテゴリーページで標準の条件に少し手を加えた投稿情報を表示するケースがある。そんな時、テンプレートファイルの先頭で query_posts関数を呼び出して投稿情報を再抽出していたのだが、フィルター処理をうまく使えばquery_posts関数を呼び出さなくても大丈夫みたいだ。使っていないか確認しないとね！（2017年11月18日 更新）
2003年に誕生したWordPress。その歴史の中には、廃止予定（deprecated）となっている関数がいくつも存在する。それらの関数をテーマやプラグインで使用するべきではないし、使用しているなら代替の関数に書き換えるべきである。ここではホームディレクトリから過去のファイルを削除する（2013年1月27日 更新）
WordPressで構築したサイトのホームディレクトリには、現在使われていないファイルが残っている時がある。3.5.1もリリースされたことだし、これを機にホームディレクトリを整理整頓した。