快取

webman/cache 是以 symfony/cache 為基礎開發的快取元件，相容協程與非協程環境，支援連線池。

安裝

composer require -W webman/cache

範例

<?php
namespace app\controller;

use support\Request;
use support\Cache;

class UserController
{
    public function db(Request $request)
    {
        $key = 'test_key';
        Cache::set($key, rand());
        return response(Cache::get($key));
    }
}

設定檔位置

設定檔位於 config/cache.php，若不存在請手動建立。

設定檔內容

<?php
return [
    'default' => 'file',
    'stores' => [
        'file' => [
            'driver' => 'file',
            'path' => runtime_path('cache')
        ],
        'redis' => [
            'driver' => 'redis',
            'connection' => 'default'
        ],
        'array' => [
            'driver' => 'array'
        ],
        'apcu' => [
            'driver' => 'apcu'
        ]
    ]
];

stores.driver 支援四種驅動：file、redis、array、apcu。

file 檔案驅動

為預設驅動，不依賴其他元件，支援跨行程共用快取資料，不支援多伺服器共用快取資料。

array 記憶體驅動

記憶體儲存，效能最佳，但會佔用記憶體，不支援跨行程跨伺服器共用資料，行程重啟後失效，一般用於快取資料量小的專案。

apcu 記憶體驅動

記憶體儲存，效能僅次於 array，支援跨行程共用快取資料，不支援多伺服器共用快取資料，行程重啟後失效，一般用於快取資料量小的專案。

需安裝並啟用 APCu 擴充套件；不建議用於頻繁寫入/刪除快取的場景，會導致明顯的效能下降。

redis 驅動

依賴 webman/redis 元件，支援跨行程跨伺服器共用快取資料。

stores.redis.connection

stores.redis.connection 對應 config/redis.php 中的 key。使用 redis 時會複用 webman/redis 的設定，包含連線池設定。

建議在 config/redis.php 中新增獨立的設定，例如 cache 類似如下

<?php
return [
    'default' => [
        'password' => 'abc123',
        'host' => '127.0.0.1',
        'port' => 6379,
        'database' => 0,
    ],
    'cache' => [ // <==== 新增
        'password' => 'abc123',
        'host' => '127.0.0.1',
        'port' => 6379,
        'database' => 1,
        'prefix' => 'webman_cache-',
    ]
];

然後將 stores.redis.connection 設為 cache，config/cache.php 最終設定類似如下：

<?php
return [
    'default' => 'redis', // <====
    'stores' => [
        'file' => [
            'driver' => 'file',
            'path' => runtime_path('cache')
        ],
        'redis' => [
            'driver' => 'redis',
            'connection' => 'cache' // <====
        ],
        'array' => [
            'driver' => 'array'
        ]
    ]
];

切換儲存

可透過以下程式碼手動切換 store，以使用不同的儲存驅動，例如：

Cache::store('redis')->set('key', 'value');
Cache::store('array')->set('key', 'value');

提示
Key 名稱受 PSR-6 限制，不得包含 {}()/\@: 中任一字元，此判斷截至 symfony/cache 7.2.4 可暫時透過 PHP ini 設定 zend.assertions=-1 略過。

使用其他 Cache 元件

ThinkCache 元件使用參考 其他資料庫