PHP如何将所有子文件夹中的图片复制到单个文件夹（不创建子文件夹）

修改原有递归复制的逻辑即可：遍历源目录时遇到子目录只做递归读取，不在目标目录创建对应子文件夹，所有匹配的图片文件直接复制到目标目录根路径。针对5分钟执行一次cron的场景，脚本额外增加了重复文件跳过、同名文件冲突处理逻辑，避免资源浪费和文件覆盖。

可直接使用的PHP脚本 #

<?php
// -------------------------- 按需修改以下配置 --------------------------
$sourceDir = '/path/to/your/guest_uploads/'; // 宾客上传文件的根目录，末尾需加斜杠
$targetDir = '/path/to/your/slideshow_pool/'; // 幻灯片读取的目标目录，末尾需加斜杠
$allowedImageExt = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'bmp']; // 允许同步的图片格式
$skipExistingFiles = true; // 定时任务场景建议开启，跳过已同步的相同文件减少IO
// -------------------------------------------------------------------

// 自动创建目标目录（如果不存在）
if (!is_dir($targetDir)) {
    if (!mkdir($targetDir, 0755, true)) {
        exit("错误：无法创建目标目录 " . $targetDir);
    }
}

/**
 * 递归遍历源目录，将所有图片平铺复制到目标目录
 */
function syncImagesToFlatDir(string $source, string $target, array $allowExt, bool $skipExist): void
{
    if (!is_dir($source)) {
        exit("错误：源目录 " . $source . " 不存在");
    }

    $dirIterator = new FilesystemIterator($source);
    foreach ($dirIterator as $item) {
        // 跳过.、..特殊目录
        if ($item->isDot()) {
            continue;
        }

        // 遇到子目录：递归遍历，不在目标目录创建对应子文件夹
        if ($item->isDir()) {
            syncImagesToFlatDir($item->getPathname() . '/', $target, $allowExt, $skipExist);
            continue;
        }

        // 校验文件扩展名，非图片直接跳过
        $fileExt = strtolower($item->getExtension());
        if (!in_array($fileExt, $allowExt)) {
            continue;
        }

        // 生成目标文件路径，处理同名冲突
        $targetFilePath = $target . $item->getFilename();
        if (file_exists($targetFilePath)) {
            // 开启跳过时，文件大小一致判定为已同步，直接跳过
            if ($skipExist && filesize($targetFilePath) === $item->getSize()) {
                continue;
            }
            // 同名但文件大小不同，加唯一后缀避免覆盖不同用户上传的同名照片
            $fileNameWithoutExt = pathinfo($item->getFilename(), PATHINFO_FILENAME);
            $targetFilePath = $target . $fileNameWithoutExt . '_' . uniqid() . '.' . $fileExt;
        }

        // 执行复制
        if (!copy($item->getPathname(), $targetFilePath)) {
            echo "复制失败：" . $item->getPathname() . " -> " . $targetFilePath . PHP_EOL;
        } else {
            echo "复制成功：" . $item->getPathname() . " -> " . $targetFilePath . PHP_EOL;
        }
    }
}

// 启动同步
syncImagesToFlatDir($sourceDir, $targetDir, $allowedImageExt, $skipExistingFiles);
echo "=== 本次图片同步完成 ===" . PHP_EOL;
?>

核心逻辑特性 #

• 不保留任何源目录结构，所有图片直接存放在目标目录根路径，幻灯片工具无需遍历子目录即可读取全部文件
• 内置图片格式白名单，仅同步指定后缀的图片文件，不会复制其他无关文件
• 自动处理同名文件冲突：不同用户上传的同名照片不会互相覆盖，会自动追加唯一ID生成新文件名
• 支持跳过已同步文件：开启$skipExistingFiles后，会自动识别已经复制过、大小完全一致的文件，定时任务反复执行时不会重复复制占用服务器资源

部署注意事项 #

• 先修改脚本顶部的$sourceDir和$targetDir配置，替换为服务器上的实际目录路径，注意路径末尾要保留斜杠
• 给PHP脚本和目标目录配置正确的读写权限，避免cron执行时因权限不足无法写入文件
• 配置cron定时任务时建议将脚本输出重定向到日志文件，方便后续排查问题，参考配置：

*/5 * * * * /usr/bin/php /path/to/your/sync_images.php >> /path/to/your/image_sync.log 2>&1

内容的提问来源于stack exchange，提问作者Florian D. Mücke