本文介绍一种轻量、可靠的 php 方案，用于遍历指定目录及其全部子目录，将符合条件的图片文件（如 jpg、png 等）扁平化拷贝至单一目标文件夹，跳过子目录结构，适用于实时相册聚合等场景。
本文介绍一种轻量、可靠的 php 方案，用于遍历指定目录及其全部子目录，将符合条件的图片文件（如 jpg、png 等）扁平化拷贝至单一目标文件夹，跳过子目录结构，适用于实时相册聚合等场景。
在实际项目中（例如婚礼照片收集系统），用户上传的图片分散在多个动态生成的子目录中，而前端轮播组件仅支持读取单一层级的图片列表。此时，需一个自动化脚本定期扫描所有子目录，提取图片并集中存放——关键在于跳过目录层级，只保留文件名扁平拷贝。
以下是一个经过优化、生产可用的递归拷贝函数：
<?php
/**
* 递归扫描源目录及其所有子目录，将匹配扩展名的图片文件拷贝至指定目标文件夹（不创建子目录）
* @param string $from 源目录路径（必须存在）
* @param string $to 目标文件夹路径（自动创建）
* @param array $exts 允许的图片扩展名数组，小写，如 ['jpg', 'jpeg', 'png', 'gif', 'webp']
*/
function flattenCopyImages($from, $to, $exts = ['jpg', 'jpeg', 'png', 'gif', 'webp']) {
// (1) 源目录校验
if (!is_dir($from)) {
exit("错误：源目录 '$from' 不存在。\n");
}
// (2) 确保目标目录存在
if (!is_dir($to)) {
if (!mkdir($to, 0755, true)) {
exit("错误：无法创建目标目录 '$to'。\n");
}
echo "✓ 目标目录 '$to' 已创建。\n";
}
// (3) 获取当前层级所有项（含目录与文件）
$items = glob($from . '*', GLOB_MARK);
if ($items === false) {
echo "⚠ 警告：无法读取目录 '$from'。\n";
return;
}
foreach ($items as $item) {
$basename = basename($item);
if (is_dir($item)) {
// 递归处理子目录（不传递 $to，避免路径嵌套）
flattenCopyImages($item, $to, $exts);
} else {
// 检查是否为允许的图片扩展名
$ext = strtolower(pathinfo($item, PATHINFO_EXTENSION));
if (in_array($ext, $exts)) {
$targetPath = $to . '/' . $basename;
// 防重名：若文件已存在，添加时间戳前缀（可选增强）
if (file_exists($targetPath)) {
$name = pathinfo($basename, PATHINFO_FILENAME);
$extPart = pathinfo($basename, PATHINFO_EXTENSION);
$timestamp = date('His', filemtime($item));
$targetPath = $to . '/' . $name . '_' . $timestamp . '.' . $extPart;
}
if (copy($item, $targetPath)) {
echo "✓ 已拷贝: $item → $targetPath\n";
} else {
echo "✗ 复制失败: $item\n";
}
}
}
}
}
// 使用示例（Linux/macOS 或 Windows 均适用）
$sourceDir = '/var/www/uploads/guests/'; // 替换为你的源目录
$targetDir = '/var/www/slideshow/images/'; // 替换为目标目录
flattenCopyImages($sourceDir, $targetDir);
?>✅ 核心要点说明：
- 扁平化逻辑：copy() 的目标路径始终为 $to . '/' . $basename，完全忽略原始子目录层级；
- 安全扩展过滤：显式限定常见图片扩展名，避免误拷非图片文件（如 .txt 或 .php）；
- 防重名处理：当同名文件已存在时，自动追加时间戳（如 photo_143245.jpg），保障数据完整性；
- 权限与路径兼容性：使用 mkdir($to, 0755, true) 支持多层目录创建，适配不同操作系统路径分隔符（PHP 自动处理）；
- 可调度集成：该脚本可直接通过 crontab 每 5 分钟执行一次（例如 */5 * * * * /usr/bin/php /path/to/copy_images.php），实现准实时同步。
⚠️ 注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 确保 Web 服务器或 CLI 用户对源目录有读取权限，对目标目录有写入权限；
- 大量文件时建议启用 set_time_limit(0) 并检查 memory_limit；
- 生产环境建议增加日志记录（如 error_log()）替代 echo，便于排查；
- 若需去重（基于内容哈希），可在拷贝前计算 md5_file($item) 并比对已有文件。
此方案简洁、健壮、无依赖，完美契合“多级上传 → 单层展示”的典型需求，是活动摄影、展会互动等场景的理想后端支持脚本。
