本教程旨在指导如何在php中高效管理具有特定命名规则的缓存文件，并根据文件后缀实现差异化的清理策略。针对文件名以特定字符串结尾的文件，如-100.json，可设置更长的保留时间；而其他文件则按常规频率清理。文章将重点介绍如何利用PHP 8+的str_ends_with()函数，结合文件系统迭代器，构建一个灵活且性能优越的缓存清理脚本，同时提供PHP 7的兼容方案，确保缓存管理策略的精确执行。
在现代web应用中，缓存机制是提升性能的关键。然而，缓存文件的管理，尤其是当不同类型的缓存需要不同的生命周期时，可能会变得复杂。例如，某些缓存文件可能需要长期保留（如一周），而另一些则需要频繁清理（如两小时）。本教程将展示如何通过检查文件名后缀，实现这种精细化的缓存清理策略，避免不必要的复杂正则表达式，并利用php的内置函数提升效率。
缓存清理策略概述
我们的目标是管理一个包含 filename-number.json 格式文件的缓存目录。具体清理规则如下：
为了实现这一目标，我们需要一个高效的方法来判断文件名是否以特定字符串结尾。
使用 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 块中，以捕获文件系统操作可能抛出的异常。
注意事项与最佳实践
© 版权声明
文章版权归作者所有，未经允许请勿转载。
THE END
喜欢就支持一下吧
相关推荐
