PHP 數據文件緩存方案全景：序列化存儲、陣列導出、Memcached 落地與現代化替代

三大主流文件緩存模式

方案一：PHP 陣列導出類（原文 DataCache）

<?php
class PhpArrayCache {
    public static function write(string $file, string $varName, array $data): bool {
        $code = " $v) {
            $key = is_int($k) ? $k : var_export($k, true);
            $val = self::exportValue($v, $level + 1);
            $parts[] = "$nextIndent$key => $val";
        }
        return "$varName = [\n" . implode(",\n", $parts) . "\n$indent];";
    }
    
    private static function exportValue($v, int $level): string {
        if (is_array($v)) return self::varExport($v, '', $level);
        if (is_string($v)) return var_export($v, true);
        if (is_bool($v)) return $v ? 'true' : 'false';
        if (is_null($v)) return 'null';
        if (is_numeric($v)) return (string)$v;
        // 物件/資源/閉包無法導出
        throw new \Exception("Unsupported type: " . gettype($v));
    }
}

方案二：序列化文件緩存類（原文 Cache_FileCache）

<?php
class SerializeFileCache {
    private string $dir;
    private int $defaultTtl;
    
    public function __construct(string $dir, int $defaultTtl = 3600) {
        $this->dir = rtrim($dir, '/');
        $this->defaultTtl = $defaultTtl;
        if (!is_dir($this->dir)) mkdir($this->dir, 0755, true);
    }
    
    public function set(string $key, $data, int $ttl = 0): bool {
        $ttl = $ttl ?: $this->defaultTtl;
        $file = $this->path($key);
        $payload = [
            'data'   => $data,
            'expire' => $ttl ? time() + $ttl : 0,
            'mtime'  => time(),
        ];
        $content = serialize($payload);
        return $this->atomicWrite($file, $content);
    }
    
    public function get(string $key) {
        $file = $this->path($key);
        if (!is_file($file)) return null;
        
        $payload = @unserialize(file_get_contents($file));
        if (!$payload) return $this->delete($key) ?: null;
        
        if ($payload['expire'] && $payload['expire'] < time()) {
            return $this->delete($key) ?: null;
        }
        return $payload['data'];
    }
    
    public function delete(string $key): bool {
        return @unlink($this->path($key));
    }
    
    public function clear(): void {
        foreach (glob($this->dir . '/*.cache') as $f) @unlink($f);
    }
    
    private function path(string $key): string {
        return $this->dir . '/' . md5($key) . '.cache';
    }
    
    private function atomicWrite(string $file, string $content): bool {
        $tmp = $file . '.tmp.' . random_bytes(4);
        if (file_put_contents($tmp, $content, LOCK_EX) === false) return false;
        return rename($tmp, $file);
    }
}

方案三：Memcached 分散式緩存（生產首選）

<?php
class MemcachedCache {
    private \Memcached $mc;
    
    public function __construct(array $servers = [['127.0.0.1', 11211]]) {
        $this->mc = new \Memcached();
        $this->mc->addServers($servers);
        // 關鍵優化配置
        $this->mc->setOption(\Memcached::OPT_BINARY_PROTOCOL, true);
        $this->mc->setOption(\Memcached::OPT_TCP_NODELAY, true);
        $this->mc->setOption(\Memcached::OPT_NO_BLOCK, true);
        $this->mc->setOption(\Memcached::OPT_COMPRESSION, true);
        $this->mc->setOption(\Memcached::OPT_COMPRESSION_TYPE, \Memcached::COMPRESSION_FASTLZ);
        $this->mc->setOption(\Memcached::OPT_SERIALIZER, \Memcached::SERIALIZER_IGBINARY);  // 需安裝 igbinary
    }
    
    public function get(string $key) {
        return $this->mc->get($key);
    }
    
    public function set(string $key, $value, int $ttl = 3600): bool {
        return $this->mc->set($key, $value, $ttl);
    }
    
    public function delete(string $key): bool {
        return $this->mc->delete($key);
    }
    
    public function getMulti(array $keys): array {
        return $this->mc->getMulti($keys);
    }
    
    public function flush(): bool {
        return $this->mc->flush();
    }
}

統一抽象層：PSR-16 Simple Cache 實作

<?php
interface CacheInterface extends \Psr\SimpleCache\CacheInterface {}

class UnifiedCache implements CacheInterface {
    private CacheInterface $driver;
    
    public function __construct(string $driver = 'memcached', array $config = []) {
        $this->driver = match ($driver) {
            'memcached' => new MemcachedCache($config['servers'] ?? []),
            'redis'     => new RedisCache($config),
            'file'      => new SerializeFileCache($config['dir'] ?? '/tmp/cache'),
            'array'     => new PhpArrayCache(),
            default     => throw new \InvalidArgumentException("Unknown driver: $driver"),
        };
    }
    
    // 代理所有方法...
    public function get($key, $default = null) { return $this->driver->get($key) ?? $default; }
    public function set($key, $value, $ttl = null) { return $this->driver->set($key, $value, $ttl ?? 3600); }
    public function delete($key) { return $this->driver->delete($key); }
    public function clear() { return $this->driver->clear(); }
    public function getMultiple($keys, $default = null) { /* ... */ }
    public function setMultiple($values, $ttl = null) { /* ... */ }
    public function deleteMultiple($keys) { /* ... */ }
    public function has($key) { return $this->driver->get($key) !== null; }
}

選型決策樹

需要跨進程/跨機器共享？
  ├─ 是 → 需要亞毫秒延遲？
  │       ├─ 是 → Memcached (純記憶體、多線程、簡單)
  │       └─ 否 → Redis (持久化、豐富資料結構、Lua 腳本)
  └─ 否 → 單機、低併發、配置型數據？
          ├─ 需要 OPcache 加速、可讀性強 → PHP 陣列導出
          ├─ 需要存儲複雜物件、寫入頻繁 → 序列化文件
          └─ 需要跨語言、調試友好 → JSON 文件

避坑指南

文件緩存適合單機、低頻、結構固定的場景；分散式系統的核心緩存層必須使用 Memcached/Redis。建立統一的 CacheInterface 抽象，讓業務代碼零成本遷移、測試雙模式（陣列驅動測試、Redis 驅動生產），是現代 PHP 架構的基本功。