如何让WordPress识别/uploads下新增的历史年月目录与媒体文件？

一、让年月目录在媒体库日期筛选中显示的方法 #

WordPress媒体库的「所有日期」筛选依赖附件对应的post记录（存储在wp_posts表），手动上传到年月目录的文件没有生成这些记录，所以无法被识别。以下是无需付费插件的解决方法：

步骤1：备份数据 #

操作前务必备份WordPress数据库和wp-content/uploads目录，避免数据丢失。

步骤2：批量注册附件的自定义脚本 #

编写PHP脚本遍历年月目录，为每个图片生成对应的附件post记录，并设置正确的post_date（对应目录的年月），这样日期筛选器就能识别。

将以下代码保存为register-media.php，放到WordPress根目录：

<?php
require_once('wp-load.php');

// 调整超时和内存限制，适配大文件量
set_time_limit(0);
ini_set('memory_limit', '256M');

$uploads = wp_upload_dir();
$base_dir = $uploads['basedir'];

// 遍历年份目录
$year_dirs = glob($base_dir . '/*', GLOB_ONLYDIR);
foreach ($year_dirs as $year_dir) {
    $year = basename($year_dir);
    if (!is_numeric($year)) continue;

    // 遍历月份目录
    $month_dirs = glob($year_dir . '/*', GLOB_ONLYDIR);
    foreach ($month_dirs as $month_dir) {
        $month = basename($month_dir);
        if (!is_numeric($month) || strlen($month) != 2) continue;

        // 设置当前目录文件的发布日期（用于日期筛选）
        $post_date = "{$year}-{$month}-01 00:00:00";
        $post_date_gmt = get_gmt_from_date($post_date);

        // 遍历目录下的图片文件（可扩展支持的后缀）
        $image_files = glob("{$month_dir}/*.{jpg,jpeg,png,gif,webp}", GLOB_BRACE);
        foreach ($image_files as $file_path) {
            $file_name = basename($file_path);
            $file_type = wp_check_filetype($file_name);
            if (!$file_type['ext']) continue;

            // 生成相对于uploads目录的路径
            $relative_path = "{$year}/{$month}/{$file_name}";

            // 跳过已注册的附件
            $existing = get_posts([
                'post_type' => 'attachment',
                'meta_key' => '_wp_attached_file',
                'meta_value' => $relative_path,
                'posts_per_page' => 1,
                'post_status' => 'inherit',
                'fields' => 'ids'
            ]);
            if (!empty($existing)) continue;

            // 创建附件post
            $attach_id = wp_insert_post([
                'post_mime_type' => $file_type['type'],
                'post_title' => sanitize_file_name($file_name),
                'post_content' => '',
                'post_status' => 'inherit',
                'post_date' => $post_date,
                'post_date_gmt' => $post_date_gmt
            ]);

            // 生成并更新附件元数据（包含缩略图信息）
            $attach_meta = wp_generate_attachment_metadata($attach_id, $file_path);
            wp_update_attachment_metadata($attach_id, $attach_meta);

            // 关联文件路径到附件
            update_post_meta($attach_id, '_wp_attached_file', $relative_path);

            echo "已注册：{$relative_path}\n";
        }
    }
}

echo "批量注册完成！";
?>

步骤3：执行脚本 #

通过命令行执行（比浏览器更稳定，适合大数量）：

# 直接用PHP执行
php register-media.php

# 或者用WP-CLI执行（推荐，权限更匹配）
wp eval-file register-media.php

执行完成后，刷新媒体库，「所有日期」筛选器就能看到对应的年月选项了。

二、目录拆分对效率的影响分析 #

你假设将文件分到300个年月目录能提升效率，这个结论是正确的，具体影响分两层面：

1. 文件系统层面（核心提升点） #

现代文件系统（如ext4、NTFS）在单个目录下存储大量文件时，目录索引的查找开销会显著增加。将50万张文件（原图+缩略图）拆分到300个目录，每个目录平均约1600个文件，能大幅降低单个目录的文件密度，提升：

• 文件的读写、删除、查找速度
• WordPress生成缩略图时的文件操作效率
• 避免部分文件系统因单个目录文件过多出现性能瓶颈

2. WordPress数据库层面 #

数据库查询效率和目录结构无关，因为媒体库的日期筛选是基于wp_posts表的post_date字段（只要该字段有索引，查询速度不受目录影响）。但文件系统的效率提升会间接加快WordPress处理媒体文件的速度（比如加载附件、生成元数据时）。

额外建议 #

• 确保服务器文件系统的inode数量充足（50万文件需要至少50万+的inode，可通过df -i命令查看）
• 批量操作时优先用WP-CLI或命令行脚本，避免浏览器超时
• 若后续新增文件，建议通过WordPress媒体库上传，或复用上述脚本的逻辑自动注册

内容的提问来源于stack exchange，提问作者Swapot