1. 缓存文件管理场景概述
在许多应用程序中，缓存目录常用于存储临时文件，例如filename-number.json格式的文件。随着时间的推移，这些文件会不断积累，需要定期清理以释放存储空间。然而，实际场景可能要求对不同类型的缓存文件采取不同的清理策略。例如，某些特定文件（如以-100.json结尾的文件）可能需要更长的保留时间，而其他文件则应更频繁地删除。高效地识别这些文件并应用相应的删除规则是缓存管理的关键。
2. 高效判断文件名后缀：str_ends_with()
在PHP 8及更高版本中，str_ends_with()函数提供了一种简洁高效的方式来判断字符串是否以特定后缀结尾。相较于正则表达式或substr()等方法，str_ends_with()在语义上更清晰，且通常具有更好的性能，特别是在处理大量文件时。
函数签名：str_ends_with(string $haystack, string $needle): bool
- $haystack: 要检查的字符串（即文件名）。
- $needle: 要匹配的后缀字符串。
示例：
$filename = "sifriugh-80.json";
if (str_ends_with($filename, '-80.json')) {
// 文件以 '-80.json' 结尾
}
$specialFilename = "dlifjbhvzique-100.json";
if (str_ends_with($specialFilename, '-100.json')) {
// 文件以 '-100.json' 结尾
}3. 实现基于后缀和时间的条件删除逻辑
结合str_ends_with()函数和文件的时间戳，我们可以构建一个灵活的缓存清理脚本。以下是一个完整的示例，演示如何对以-100.json结尾的文件设置7天删除策略，而对其他文件设置2小时删除策略。
立即学习“PHP免费学习笔记（深入）”；
<?php
/**
* 缓存目录清理脚本
* 根据文件名后缀和文件创建时间，执行有条件的删除操作。
*/
$cacheDir = __DIR__ . '/cache'; // 定义缓存目录路径，使用绝对路径更安全
$now = time(); // 当前时间戳
// 定义删除时间阈值（单位：秒）
$deleteThresholdNormal = 2 * 3600; // 普通文件：2小时
$deleteThresholdSpecial = 7 * 24 * 3600; // 特殊文件（-100.json）：7天
echo "--- 开始清理缓存目录: {$cacheDir} ---\n";
// 确保缓存目录存在
if (!is_dir($cacheDir)) {
echo "错误：缓存目录 '{$cacheDir}' 不存在。\n";
exit(1);
}
try {
// 使用 FilesystemIterator 迭代目录，提高性能
$fileSystemIterator = new FilesystemIterator($cacheDir);
foreach ($fileSystemIterator as $file) {
// 跳过目录，只处理文件
if (!$file->isFile()) {
continue;
}
$filename = $file->getFilename(); // 获取文件名
$filePath = $file->getPathname(); // 获取文件的完整路径
$fileCtime = $file->getCTime(); // 获取文件创建时间戳
$isSpecialFile = false; // 标记是否为特殊文件
// PHP 8+ 使用 str_ends_with()
if (function_exists('str_ends_with')) {
$isSpecialFile = str_ends_with($filename, '-100.json');
} else {
// PHP 7 及以下版本的兼容方案
$suffix = '-100.json';
$suffixLength = strlen($suffix);
if (strlen($filename) >= $suffixLength && substr($filename, -$suffixLength) === $suffix) {
$isSpecialFile = true;
}
}
$shouldDelete = false;
$reason = '';
if ($isSpecialFile) {
// 对于以 '-100.json' 结尾的文件，检查是否超过7天
if (($now - $fileCtime) >= $deleteThresholdSpecial) {
$shouldDelete = true;
$reason = "（特殊文件，已超过7天）";
}
} else {
// 对于其他文件，检查是否超过2小时
if (($now - $fileCtime) >= $deleteThresholdNormal) {
$shouldDelete = true;
$reason = "（普通文件，已超过2小时）";
}
}
if ($shouldDelete) {
// 执行删除操作，并进行错误处理
if (unlink($filePath)) {
echo " [删除成功] {$filename} {$reason}\n";
} else {
echo " [删除失败] {$filename} - 权限不足或文件不存在。\n";
}
} else {
// echo " [保留文件] {$filename}\n"; // 可根据需要取消注释，查看保留的文件
}
}
} catch (UnexpectedValueException $e) {
echo "错误：无法读取目录 '{$cacheDir}'。请检查权限。\n";
exit(1);
} catch (Exception $e) {
echo "发生未知错误: " . $e->getMessage() . "\n";
exit(1);
}
echo "--- 缓存清理完成。---\n";
?>4. 注意事项与最佳实践
- 路径处理： 在实际应用中，建议使用绝对路径（如__DIR__ . '/cache'）来定义缓存目录，以避免因脚本执行环境不同而导致路径解析错误。
- 文件创建时间 (getCTime())： getCTime()在某些文件系统上可能表示inode更改时间而非实际创建时间。如果需要更精确的文件创建时间，可能需要依赖文件内容中的时间戳或自定义的元数据。然而，对于大多数缓存清理场景，getCTime()通常足够使用。
- 错误处理： unlink()操作可能会失败，例如文件不存在或权限不足。在生产环境中，务必对unlink()的返回值进行检查，并记录错误日志。
- PHP 7 兼容性： 对于PHP 7及以下版本，str_ends_with()函数不可用。可以使用substr($string, -$length) === $suffix或mb_substr()（处理多字节字符串）进行替代，如示例代码所示。
- 性能优化： 对于包含大量文件的目录，FilesystemIterator比scandir()更高效，因为它按需加载文件信息，减少了内存消耗。
- 日志记录： 在生产环境中，应将删除操作的成功与失败详细记录到日志文件中，以便追踪和审计。
- 定时任务： 此脚本通常通过Cron Job（Linux/macOS）或任务计划程序（Windows）定时执行。
5. 总结
通过巧妙结合PHP 8+的str_ends_with()函数（或其PHP 7兼容方案）与文件时间戳，我们可以构建出灵活且高效的缓存文件清理机制。这种方法不仅能够满足不同文件类型的差异化管理需求，还能提高代码的可读性和维护性，是优化应用程序性能和存储管理的有效手段。在实施过程中，务必关注路径安全、错误处理和兼容性，以确保脚本的稳定运行。
