在现代web应用中，缓存机制是提升性能的关键。然而，缓存文件的管理，尤其是当不同类型的缓存需要不同的生命周期时，可能会变得复杂。例如，某些缓存文件可能需要长期保留（如一周），而另一些则需要频繁清理（如两小时）。本教程将展示如何通过检查文件名后缀，实现这种精细化的缓存清理策略，避免不必要的复杂正则表达式，并利用php的内置函数提升效率。
缓存清理策略概述
我们的目标是管理一个包含 filename-number.json 格式文件的缓存目录。具体清理规则如下：
- 文件名以 -100.json 结尾的文件，保留 7 天。
- 其他 filename-number.json 格式的文件，保留 2 小时。
- 超过各自保留时间的文件将被删除。
为了实现这一目标，我们需要一个高效的方法来判断文件名是否以特定字符串结尾。
使用 str_ends_with() 进行后缀判断 (PHP 8+)
PHP 8 引入了 str_ends_with() 函数，它提供了一种简洁高效的方式来检查字符串是否以指定后缀结尾。这比使用 substr() 或正则表达式更加直观和性能优越。
函数签名:
立即学习“PHP免费学习笔记（深入）”；
str_ends_with(string $haystack, string $needle): bool
其中 $haystack 是要检查的字符串（文件名），$needle 是要匹配的后缀。
示例:
<?php $filename1 = "sifriugh-80.json"; $filename2 = "dlifjbhvzique-100.json"; var_dump(str_ends_with($filename1, '-100.json')); // 输出: bool(false) var_dump(str_ends_with($filename2, '-100.json')); // 输出: bool(true) ?>
构建差异化缓存清理脚本
结合 str_ends_with() 函数和 FilesystemIterator，我们可以构建一个功能完善的缓存清理脚本。
<?php
/**
* 缓存清理脚本：根据文件后缀实现差异化保留策略
*
* 文件名以 '-100.json' 结尾的文件保留 7 天。
* 其他文件保留 2 小时。
*/
// 缓存目录路径
const CACHE_DIR = 'cache';
// 定义保留时间（秒）
const RETENTION_PERIOD_LONG = 7 * 24 * 3600; // 7 天
const RETENTION_PERIOD_SHORT = 2 * 3600; // 2 小时
// 确保缓存目录存在
if (!is_dir(CACHE_DIR)) {
mkdir(CACHE_DIR, 0777, true);
echo "缓存目录 '" . CACHE_DIR . "' 已创建。\n";
}
// PHP 7 兼容性处理：如果 str_ends_with 不存在，则定义一个 polyfill
if (!function_exists('str_ends_with')) {
function str_ends_with(string $haystack, string $needle): bool
{
$needleLen = strlen($needle);
return ($needleLen === 0 || (substr($haystack, -$needleLen) === $needle));
}
}
$now = time();
$deletedCount = 0;
try {
$fileSystemIterator = new FilesystemIterator(CACHE_DIR);
echo "开始清理缓存目录: " . CACHE_DIR . "\n";
foreach ($fileSystemIterator as $file) {
// 确保是文件且文件名符合我们的模式（例如，以 .json 结尾）
if (!$file->isFile() || !str_ends_with($file->getFilename(), '.json')) {
continue;
}
$filename = $file->getFilename();
$filePath = $file->getPathname();
$fileCreationTime = $file->getCTime(); // 获取文件的创建时间
$isLongRetentionFile = str_ends_with($filename, '-100.json');
$retentionThreshold = $isLongRetentionFile ? RETENTION_PERIOD_LONG : RETENTION_PERIOD_SHORT;
if (($now - $fileCreationTime) >= $retentionThreshold) {
// 文件已过期，执行删除
if (unlink($filePath)) {
echo "已删除过期文件: " . $filename . " (创建时间: " . date('Y-m-d H:i:s', $fileCreationTime) . ")\n";
$deletedCount++;
} else {
error_log("无法删除文件: " . $filePath);
echo "错误：无法删除文件: " . $filename . "\n";
}
}
}
echo "缓存清理完成。共删除 " . $deletedCount . " 个文件。\n";
} catch (UnexpectedValueException $e) {
echo "错误：无法读取缓存目录 '" . CACHE_DIR . "': " . $e->getMessage() . "\n";
error_log("FilesystemIterator error for " . CACHE_DIR . ": " . $e->getMessage());
} catch (Exception $e) {
echo "发生未知错误: " . $e->getMessage() . "\n";
error_log("General error during cache cleanup: " . $e->getMessage());
}
?>代码解析:
- 常量定义: CACHE_DIR 定义缓存目录路径，RETENTION_PERIOD_LONG 和 RETENTION_PERIOD_SHORT 定义了两种不同的保留时间（以秒为单位）。
- 目录检查与创建: 脚本首先检查缓存目录是否存在，如果不存在则尝试创建，确保脚本能够正常运行。
- PHP 7 兼容性: 为了确保脚本在 PHP 7 环境下也能运行，我们提供了一个 str_ends_with 的 polyfill 实现。它检查函数是否存在，如果不存在则定义一个功能相同的函数。
- 文件系统迭代: FilesystemIterator(CACHE_DIR) 提供了一种高效遍历目录中所有文件和子目录的方式。它比 scandir() 更节省内存，尤其是在处理大量文件时。
- 文件类型过滤: if (!$file->isFile() || !str_ends_with($file->getFilename(), '.json')) 确保我们只处理实际的文件，并且只关注 .json 格式的文件，避免误删目录或不相关文件。
- 获取文件信息: $file->getFilename() 获取文件名，$file->getPathname() 获取文件的完整路径，$file->getCTime() 获取文件的创建时间。
- 差异化判断: str_ends_with($filename, '-100.json') 用于判断当前文件是否属于需要长期保留的类型。
- 设置保留阈值: 根据 isLongRetentionFile 的布尔值，动态选择 RETENTION_PERIOD_LONG 或 RETENTION_PERIOD_SHORT 作为当前文件的保留阈值。
- 过期判断与删除: ($now - $fileCreationTime) >= $retentionThreshold 判断文件是否已过期。如果过期，则调用 unlink($filePath) 删除文件。
- 错误处理: unlink() 操作可能会失败，因此通过 if (unlink($filePath)) 进行检查，并在失败时记录错误日志，向用户输出提示。整个清理过程被包裹在 try-catch 块中，以捕获文件系统操作可能抛出的异常。
注意事项与最佳实践
- 文件时间戳: getCTime() 通常返回文件的 inode 更改时间，这在某些文件系统上可能与创建时间不同。如果需要严格的创建时间，可能需要在文件创建时记录额外的信息（例如，在文件名或文件内容中）。但在大多数缓存清理场景中，getCTime() 或 getMTime()（修改时间）通常足够。
- 并发问题: 如果有多个进程同时运行清理脚本，可能会导致竞态条件。对于生产环境，可以考虑使用文件锁机制（如 flock()）来避免并发问题。
- 权限问题: 确保
