大家好！

您的應(yīng)用程式是否因?yàn)橹匮}的資料庫(kù)查詢而運(yùn)行緩慢？或是在不同的快取庫(kù)之間切換時(shí)遇到困難？讓我們深入探討 PSR-6，這個(gè)標(biāo)準(zhǔn)讓 PHP 中的快取變得可預(yù)測(cè)且可互換！

本文是 PHP PSR 標(biāo)準(zhǔn)系列的一部分。如果您是新手，不妨從 PSR-1 基礎(chǔ)開始。

PSR-6 解決什麼問題？ （2 分鐘）

在 PSR-6 之前，每個(gè)快取庫(kù)都有自己獨(dú)特的工作方式。想要從 Memcached 切換到 Redis？重寫您的程式碼。從一個(gè)框架遷移到另一個(gè)框架？學(xué)習(xí)新的快取 API。 PSR-6 透過提供所有快取庫(kù)都可以實(shí)現(xiàn)的通用介面來解決這個(gè)問題。

核心介面（5 分鐘）

讓我們來看看兩個(gè)主要參與者：

1. CacheItemPoolInterface

這是您的快取管理器。可以將其視為一個(gè)倉(cāng)庫(kù)，您可以在其中儲(chǔ)存和檢索項(xiàng)目：

<?php namespace Psr\Cache;

interface CacheItemPoolInterface
{
    public function getItem($key);
    public function getItems(array $keys = array());
    public function hasItem($key);
    public function clear();
    public function deleteItem($key);
    public function deleteItems(array $keys);
    public function save(CacheItemInterface $item);
    public function saveDeferred(CacheItemInterface $item);
    public function commit();
}

?>

2. CacheItemInterface

這表示快取中的單一項(xiàng)目：

<?php namespace Psr\Cache;

interface CacheItemInterface
{
    public function getKey();
    public function get();
    public function isHit();
    public function set($value);
    public function expiresAt($expiration);
    public function expiresAfter($time);
}

?>

實(shí)際應(yīng)用（10 分鐘）

以下是我們程式碼庫(kù)中的一個(gè)實(shí)際範(fàn)例：

1. 快取項(xiàng)目實(shí)作

<?php namespace JonesRussell\PhpFigGuide\PSR6;

use Psr\Cache\CacheItemInterface;
use DateTimeInterface;
use DateInterval;
use DateTime;

class CacheItem implements CacheItemInterface
{
    private $key;
    private $value;
    private $isHit;
    private $expiration;

    public function __construct(string $key)
    {
        $this->key = $key;
        $this->isHit = false;
    }

    public function getKey(): string
    {
        return $this->key;
    }

    public function get()
    {
        return $this->value;
    }

    public function isHit(): bool
    {
        return $this->isHit;
    }

    public function set($value): self
    {
        $this->value = $value;
        return $this;
    }

    public function expiresAt(?DateTimeInterface $expiration): self
    {
        $this->expiration = $expiration;
        return $this;
    }

    public function expiresAfter($time): self
    {
        if ($time instanceof DateInterval) {
            $this->expiration = (new DateTime())->add($time);
        } elseif (is_int($time)) {
            $this->expiration = (new DateTime())->add(new DateInterval("PT{$time}S"));
        } else {
            $this->expiration = null;
        }
        return $this;
    }

    // Helper method for our implementation
    public function getExpiration(): ?DateTimeInterface
    {
        return $this->expiration;
    }

    // Helper method for our implementation
    public function setIsHit(bool $hit): void
    {
        $this->isHit = $hit;
    }
}

2. 快取池實(shí)作

<?php namespace JonesRussell\PhpFigGuide\PSR6;

use Psr\Cache\CacheItemPoolInterface;
use Psr\Cache\CacheItemInterface;
use RuntimeException;

class FileCachePool implements CacheItemPoolInterface
{
    private $directory;
    private $deferred = [];

    public function __construct(string $directory)
    {
        if (!is_dir($directory) && !mkdir($directory, 0777, true)) {
            throw new RuntimeException("Cannot create cache directory: {$directory}");
        }
        $this->directory = $directory;
    }

    public function getItem($key): CacheItemInterface
    {
        $this->validateKey($key);

        if (isset($this->deferred[$key])) {
            return $this->deferred[$key];
        }

        $item = new CacheItem($key);
        $path = $this->getPath($key);

        if (file_exists($path)) {
            try {
                $data = unserialize(file_get_contents($path));
                if (!$data['expiration'] || $data['expiration'] > new DateTime()) {
                    $item->set($data['value']);
                    $item->setIsHit(true);
                    return $item;
                }
                unlink($path);
            } catch (\Exception $e) {
                // Log error and continue with cache miss
            }
        }

        return $item;
    }

    public function getItems(array $keys = []): iterable
    {
        $items = [];
        foreach ($keys as $key) {
            $items[$key] = $this->getItem($key);
        }
        return $items;
    }

    public function hasItem($key): bool
    {
        return $this->getItem($key)->isHit();
    }

    public function clear(): bool
    {
        $this->deferred = [];
        $files = glob($this->directory . '/*.cache');

        if ($files === false) {
            return false;
        }

        $success = true;
        foreach ($files as $file) {
            if (!unlink($file)) {
                $success = false;
            }
        }
        return $success;
    }

    public function deleteItem($key): bool
    {
        $this->validateKey($key);
        unset($this->deferred[$key]);

        $path = $this->getPath($key);
        if (file_exists($path)) {
            return unlink($path);
        }
        return true;
    }

    public function deleteItems(array $keys): bool
    {
        $success = true;
        foreach ($keys as $key) {
            if (!$this->deleteItem($key)) {
                $success = false;
            }
        }
        return $success;
    }

    public function save(CacheItemInterface $item): bool
    {
        $path = $this->getPath($item->getKey());
        $data = [
            'value' => $item->get(),
            'expiration' => $item->getExpiration()
        ];

        try {
            if (file_put_contents($path, serialize($data)) === false) {
                return false;
            }
            return true;
        } catch (\Exception $e) {
            return false;
        }
    }

    public function saveDeferred(CacheItemInterface $item): bool
    {
        $this->deferred[$item->getKey()] = $item;
        return true;
    }

    public function commit(): bool
    {
        $success = true;
        foreach ($this->deferred as $item) {
            if (!$this->save($item)) {
                $success = false;
            }
        }
        $this->deferred = [];
        return $success;
    }

    private function getPath(string $key): string
    {
        return $this->directory . '/' . sha1($key) . '.cache';
    }

    private function validateKey(string $key): void
    {
        if (!is_string($key) || preg_match('#[{}()/@:\\]#', $key)) {
            throw new InvalidArgumentException(
                'Invalid key: ' . var_export($key, true)
            );
        }
    }
}

實(shí)際使用（5 分鐘）

讓我們看看如何在實(shí)際程式碼中使用它：

// 基本用法
$pool = new FileCachePool('/path/to/cache');

try {
    // 存儲(chǔ)值
    $item = $pool->getItem('user.1');
    if (!$item->isHit()) {
        $userData = $database->fetchUser(1); // 您的數(shù)據(jù)庫(kù)調(diào)用
        $item->set($userData)
             ->expiresAfter(3600); // 1 小時(shí)
        $pool->save($item);
    }
    $user = $item->get();
} catch (\Exception $e) {
    // 優(yōu)雅地處理錯(cuò)誤
    log_error('緩存操作失?。? . $e->getMessage());
    $user = $database->fetchUser(1); // 回退到數(shù)據(jù)庫(kù)
}

常見陷阱（3 分鐘）

1. 鍵驗(yàn)證
2. 錯(cuò)誤處理

下一步是什麼？

明天，我們將討論 PSR-7（HTTP 訊息介面）。如果您對(duì)更簡(jiǎn)單的快取感興趣，請(qǐng)繼續(xù)關(guān)注我們即將推出的 PSR-16（簡(jiǎn)單快?。┪恼?，該文章提供了比 PSR-6 更直接的替代方案。

資源

• 官方 PSR-6 規(guī)範(fàn)
• 我們的範(fàn)例程式碼庫(kù) (v0.6.0 - PSR-6 實(shí)作)
• Symfony 快取元件
• PHP 快取

以上是PHP 中的 PSR 快取接口的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！