本文介绍一个安全、高效的 PHP 脚本，用于读取指定文本文件（如 images.txt）中的合法文件名列表，并自动删除目标图片目录下所有不在该列表中的 JPEG 文件，适用于定期清理冗余图片的运维场景。
本文介绍一个安全、高效的 php 脚本，用于读取指定文本文件（如 images.txt）中的合法文件名列表，并自动删除目标图片目录下所有不在该列表中的 jpeg 文件，适用于定期清理冗余图片的运维场景。
在实际项目中（例如图片托管服务或 CMS 媒体库），常需根据动态维护的白名单（如 images.txt）同步清理过期或无效文件。原始脚本失败的核心原因在于：glob() 返回的是带完整路径的文件名（如 /home/user/images/1.jpeg），而 images.txt 中仅存储纯文件名（如 1.jpeg），直接比对必然失效。
以下是经过修正与增强的完整 PHP 脚本：
<?php
// 配置路径（请按实际环境修改）
$whitelistFile = '/home/user/images.txt';
$targetDir = '/home/user/images/';
// 1. 安全读取白名单 —— 自动去除换行符和空行
if (!file_exists($whitelistFile)) {
die("错误：白名单文件不存在 — $whitelistFile\n");
}
$allowedNames = file($whitelistFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
$allowedNames = array_map('trim', $allowedNames); // 进一步清理首尾空格
$allowedSet = array_flip($allowedNames); // 转为关联数组提升查找效率（O(1)）
// 2. 获取目标目录下所有 JPEG 文件（更精准：限定 .jpeg/.jpg）
$files = glob($targetDir . "*.{jpeg,jpg}", GLOB_BRACE);
if ($files === false) {
die("错误：无法读取目录 — $targetDir\n");
}
// 3. 遍历并删除非白名单文件
$deletedCount = 0;
foreach ($files as $fullPath) {
$filename = basename($fullPath);
// 检查是否在白名单中（注意大小写敏感性）
if (!isset($allowedSet[$filename])) {
if (unlink($fullPath)) {
echo "已删除：$filename\n";
$deletedCount++;
} else {
error_log("警告：无法删除文件 — $fullPath");
echo "警告：跳过删除 $filename（权限不足或文件被占用）\n";
}
}
}
echo "操作完成：共处理 " . count($files) . " 个文件，删除 $deletedCount 个非白名单文件。\n";
?>✅ 关键改进说明：
- 使用 file(..., FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES) 替代 explode("\n", ...)，避免因 Windows/Linux 换行符差异或空行导致匹配失败；
- 通过 array_flip() 构建哈希映射表，将 in_array() 的 O(n) 查找优化为 O(1)，大幅提升大列表性能；
- glob() 显式限定 {jpeg,jpg} 扩展名，避免误删其他类型文件；
- 添加基础错误校验（文件存在性、目录可读性）、日志记录及用户反馈，便于部署与调试；
- basename() 正确提取文件名，确保路径与白名单内容语义对齐。
⚠️ 重要注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 务必先备份数据！ 建议首次运行前添加 echo "将删除：$filename\n"; 并注释 unlink() 行进行模拟验证；
- 确保 PHP 进程对 $targetDir 目录具有 rwx 权限，且对目标文件有 w 权限；
- 白名单文件中的文件名需严格匹配（包括大小写、扩展名），例如 1.JPG ≠ 1.jpg；
- 如需支持更多格式（如 PNG、WEBP），可扩展 glob() 模式：*.{jpeg,jpg,png,webp}；
- 生产环境建议配合 cron 定时执行，并将输出重定向至日志文件便于审计。
该脚本兼顾健壮性与可维护性，可直接集成至自动化运维流程，实现图片资源的精准生命周期管理。
