_wp_check_existing_file_names()


WordPressの_wp_check_existing_file_names()関数は、アップロードされたファイル名が既に存在するかどうかをチェックします。

構文

_wp_check_existing_file_names( array $files );
  • $files (array) — チェックするファイルの配列

例1: 基本的な使用法

アップロードされたファイルの名前をチェックします。

$files = array('name' => 'test.jpg'); _wp_check_existing_file_names($files);

例2: 複数ファイルのチェック

複数のファイル名を一度にチェックします。

$files = array('name' => array('file1.jpg', 'file2.png')); _wp_check_existing_file_names($files);

例3: メディアライブラリとの比較

既存のメディアライブラリとファイル名を比較します。

$files = array('name' => 'existing-image.jpg'); _wp_check_existing_file_names($files);

例4: フィルターフックの追加

ファイル名チェック前にフィルターフックを追加します。

add_filter('wp_handle_upload_prefilter', 'custom_upload_filter'); function custom_upload_filter($file) { return _wp_check_existing_file_names($file); }

例5: エラーハンドリング

ファイル名が重複した場合のエラーハンドリング。

$result = _wp_check_existing_file_names($files); if(is_wp_error($result)) { error_log($result->get_error_message()); }

例6: カスタムアップロードディレクトリ

カスタムアップロードディレクトリでのファイル名チェック。

add_filter('upload_dir', 'custom_upload_dir'); $files = array('name' => 'custom.jpg'); _wp_check_existing_file_names($files);

例7: ファイル名の変更

重複ファイル名を自動的に変更します。

$files = array('name' => 'duplicate.jpg', 'tmp_name' => '/tmp/duplicate.jpg'); $result = _wp_check_existing_file_names($files); if(!is_wp_error($result)) { wp_handle_upload($result, array('test_form' => false)); }

注意事項:

  • この関数は内部使用を目的としており、直接呼び出すことは推奨されません
  • ファイルアップロード処理中に自動的に呼び出されます
  • 大量のファイルを処理する場合、パフォーマンスに影響する可能性があります

関連機能：