本文介绍一种简洁可靠的 php 方法，用于遍历指定目录及其全部子目录，将匹配的图片文件（如 jpg、png 等）直接复制到单一目标文件夹中，不创建任何嵌套子目录结构，适用于实时相册聚合等场景。
本文介绍一种简洁可靠的 php 方法，用于遍历指定目录及其全部子目录，将匹配的图片文件（如 jpg、png 等）直接复制到单一目标文件夹中，不创建任何嵌套子目录结构，适用于实时相册聚合等场景。
在实际项目中（例如婚礼现场照片收集系统），用户上传的图片分散在多个动态生成的子目录中，而前端幻灯片程序仅支持从扁平化目录读取图片。此时，我们需要一个轻量、可定时执行（如通过 cron 每 5 分钟运行一次）的 PHP 脚本，跳过子目录层级，只提取并集中存放图像文件。
核心思路是：递归遍历源目录，对每个文件单独判断是否为图片；若是，则直接复制到固定目标路径，而非按原路径重建目录结构。关键在于——目标路径在 copy() 中硬编码或统一传入，绝不拼接子目录名。
以下是一个健壮、生产可用的实现：
<?php
// 递归提取所有图片文件至单一目标文件夹（不保留子目录结构）
function extractImages($sourceDir, $targetDir = 'C:/TARGET/', $extensions = ['jpg', 'jpeg', 'png', 'gif', 'webp']) {
// (1) 源目录校验
if (!is_dir($sourceDir)) {
exit("错误：源目录 '$sourceDir' 不存在。\n");
}
// (2) 确保目标目录存在（仅创建一级，不递归）
if (!is_dir($targetDir)) {
if (!mkdir($targetDir, 0755, true)) {
exit("错误：无法创建目标目录 '$targetDir'。\n");
}
echo "✓ 目标目录 '$targetDir' 已创建。\n";
}
// (3) 获取当前层级所有项（含目录与文件）
$items = glob($sourceDir . '*', GLOB_MARK);
if (!$items) return;
foreach ($items as $item) {
$basename = basename($item);
$lowerExt = strtolower(pathinfo($item, PATHINFO_EXTENSION));
// (4) 若为目录，递归处理
if (is_dir($item)) {
extractImages($item, $targetDir, $extensions);
}
// (5) 若为图片文件，直接复制到目标目录（覆盖同名文件需谨慎！）
elseif (in_array($lowerExt, $extensions) && $lowerExt !== '') {
$targetPath = $targetDir . $basename;
// 可选：避免文件名冲突（添加时间戳前缀）
// $timestamp = date('His') . '_';
// $targetPath = $targetDir . $timestamp . $basename;
if (copy($item, $targetPath)) {
echo "✓ 已复制: {$item} → {$targetPath}\n";
} else {
echo "⚠ 复制失败: {$item}\n";
}
}
}
}
// 【使用示例】
$sourceRoot = 'C:/UPLOADS/'; // 客户上传根目录（含多层 user_001/、user_002/ 等子目录）
$flatTarget = 'C:/SLIDESHOW/IMAGES/'; // 幻灯片程序唯一读取目录
extractImages($sourceRoot, $flatTarget);
echo "✅ 图片提取完成。\n";
?>✅ 关键设计说明：
立即学习“PHP免费学习笔记（深入）”；
- copy() 的目标路径始终为 $targetDir . $basename，彻底规避子目录路径拼接；
- 支持常见图片扩展名白名单，防止误拷非图像文件；
- 使用 GLOB_MARK 标志精准区分文件与目录；
- 目标目录创建使用 mkdir(..., true) 确保路径完整，但仅建一层（符合“不创建子目录”要求）；
- 输出清晰日志，便于 cron 日志监控。
⚠️ 注意事项：
- 文件名冲突：若不同子目录下存在同名图片（如 photo.jpg），后复制的会覆盖前者。建议在生产环境启用重命名策略（如添加哈希或时间戳前缀）；
- 权限与安全：确保 PHP 进程对源目录有读取权限，对目标目录有写入权限；避免将 $sourceDir 设为 Web 可访问路径，防止路径遍历风险；
- 大文件/大量文件：如需处理海量图片，可增加 set_time_limit(0) 和内存优化（如 gc_collect_cycles()），或改用 CLI 模式运行。
该方案简洁、可维护性强，完美契合“扁平化聚合”需求，是活动实时影像同步的理想自动化工具。
