PHP实现自定义文件缓存的两种方法与代码示例

沿途有光

发布时间：2026-10-13 | 2人浏览过

原创

本文将介绍在PHP中实现自定义文件缓存的两种常用方法。通过这两种方法，开发者可以根据实际需求选择合适的缓存策略，提高应用性能。

什么是文件缓存及其优势

文件缓存是将PHP脚本的执行结果保存到文件中的技术。当有相同的请求再次发生时，系统会先检查是否存在未过期的缓存文件。如果存在，则直接读取缓存内容返回给客户端，而无需重新执行脚本。这种方式可以有效降低服务器负载，提高响应速度。

写法一：为每个缓存项创建独立文件

这种方法的思路是为每个缓存键（key）生成一个唯一的文件名。通常使用MD5哈希值作为文件名的一部分，以确保文件名的唯一性和避免冲突。其优点是实现简单，读写操作互不干扰；缺点是当缓存项数量巨大时，会产生大量的文件，可能导致文件系统性能下降。

第1步：定义基本参数与路径

首先，确定缓存目录和默认的过期时间。为了方便测试，这里使用了本地绝对路径，实际部署时应考虑动态获取当前脚本目录。

$cacheDir: 缓存文件的存储目录，如 D:\\phpstudy_pro\\WWW\\cache\\
$expiry: 缓存有效期（秒），默认为 3600

第2步：构建完整的缓存文件路径

使用md5()函数对缓存键进行哈希处理，拼接后缀名（如.txt）生成唯一的文件路径：

$cacheFile = $cacheDir . md5($key) . '.txt';

第3步：判断缓存是否有效

利用file_exists()和filemtime()检查文件是否存在且未过期。如果有效，直接返回文件内容：

if (file_exists($cacheFile) && (time() - filemtime($cacheFile) < $expiry)) {
    return file_get_contents($cacheFile);
}

第4步：写入新缓存或更新旧缓存

如果传入的$value不为空，则将新值保存到对应的缓存文件中，并返回该值：

if ($value !== null) {
    file_put_contents($cacheFile, $value);
    return $value;
}
// 如果是为了刷新缓存（例如传入null），也需要更新文件
file_put_contents($cacheFile, $value); // 注意：此处原文逻辑有误，若$value为null，将导致清空缓存

写法二：将所有数据存储在单一文件中

这种方案将所有缓存数据封装成一个数组，并使用序列化函数（如serialize()）将整个数组保存到一个文件中。每次读写都需要加载整个文件并反序列化数组。优点是管理集中，不存在大量文件的问题；缺点是当数据量增大时，单个文件会变得很大，频繁的I/O操作会影响性能，且涉及并发时需要处理锁机制。

function getFileCacheSingleFile($key, $value = null, $expiry = 3600) {
    $cacheDir = "D:\\phpstudy_pro\\WWW\\cache\\";
    $cacheFile = $cacheDir . 'cache.txt';
    
    // 初始化数据容器
    $data = [];
    if (file_exists($cacheFile)) {
        $serializedData = file_get_contents($cacheFile);
        if (!empty($serializedData)) {
            $data = unserialize($serializedData);
            if (!is_array($data)) $data = [];
        }
    }

    if ($value !== null) {
        // 存入新值或更新旧值，同时记录过期时间
        $data[$key] = [
            "data" => $value,
            'expiry' => time() + $expiry
        ];
        // 写回文件
        file_put_contents($cacheFile, serialize($data));
        return true;
    } else {
        // 尝试读取缓存
        if (isset($data[$key]) && $data[$key]['expiry'] > time()) {
            return $data[$key]['data'];
        }
        // 过期或未找到，可选：在此处触发清理过期数据的逻辑
        return null;
    }
}