萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Laravel 整合阿里雲 ACE 快取服務自訂驅動

前言

阿里雲 ACE (App Cloud Engine) 快取服務介面與標準 Memcached 不同,需透過 Alibaba::Cache() 取得專用物件。本文示範實作自訂 StoreInterface 並註冊為 Laravel 快取驅動。

ACE 快取介面特性

  • 透過 Alibaba::Cache('空間名稱') 取得快取物件
  • 支援方法:get、set、delete、increment、decrement、flush (可能不支援)
  • 不支援標準 Memcached 協定,無法使用 MemcachedStore

實作步驟

1. 建立自訂 Store 類別

<?php
// src/Ace/AceStore.php
namespace App\Cache;

use Illuminate\Contracts\Cache\Store;
use Illuminate\Contracts\Cache\TaggableStore;

class AceStore implements TaggableStore
{
    protected $cache;
    protected $prefix;

    public function __construct(string $space, string $prefix = '')
    {
        // ACE 環境下自動載入 Alibaba 類別
        if (!class_exists('Alibaba')) {
            throw new \RuntimeException('Alibaba SDK 未載入,請確認運行於 ACE 環境');
        }
        $this->cache = \Alibaba::Cache($space);
        $this->prefix = $prefix ? $prefix . ':' : '';
    }

    protected function getKey($key)
    {
        return $this->prefix . $key;
    }

    public function get($key)
    {
        $value = $this->cache->get($this->getKey($key));
        // ACE 回傳 false 表示不存在,Laravel 期望 null
        return $value === false ? null : $value;
    }

    public function many(array $keys)
    {
        $result = [];
        foreach ($keys as $key) {
            $value = $this->get($key);
            if ($value !== null) {
                $result[$key] = $value;
            }
        }
        return $result;
    }

    public function put($key, $value, $minutes)
    {
        $seconds = $minutes * 60;
        return $this->cache->set($this->getKey($key), $value, $seconds);
    }

    public function putMany(array $values, $minutes)
    {
        foreach ($values as $key => $value) {
            $this->put($key, $value, $minutes);
        }
        return true;
    }

    public function increment($key, $value = 1)
    {
        return $this->cache->increment($this->getKey($key), $value);
    }

    public function decrement($key, $value = 1)
    {
        return $this->cache->decrement($this->getKey($key), $value);
    }

    public function forever($key, $value)
    {
        // ACE 可能不支援永久,用極大值近似
        return $this->cache->set($this->getKey($key), $value, 31536000); // 1 年
    }

    public function forget($key)
    {
        return $this->cache->delete($this->getKey($key));
    }

    public function flush()
    {
        // ACE 可能不支援 flush,回傳 false 表示不支援
        return false;
    }

    public function getPrefix()
    {
        return $this->prefix;
    }

    // TaggableStore 介面 (若不需標籤功能可拋出例外或空實作)
    public function tags(array $names) { throw new \BadMethodCallException('ACE 快取不支援標籤'); }
    public function reconnect() {}
}
?>

2. 註冊驅動 (AppServiceProvider)

<?php
// app/Providers/AppServiceProvider.php
namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use Illuminate\Cache\Repository;
use App\Cache\AceStore;

class AppServiceProvider extends ServiceProvider
{
    public function boot()
    {
        $this->app->booted(function () {
            $this->app['cache']->extend('ace', function ($app) {
                $config = $app['config']['cache.stores.ace'];
                $store = new AceStore($config['space'], $config['prefix'] ?? '');
                return new Repository($store);
            });
        });
    }
}
?>

3. 配置 config/cache.php

'stores' => [
    // ...
    'ace' => [
        'driver' => 'ace',
        'space' => env('ACE_CACHE_SPACE', 'default_space'),
        'prefix' => env('CACHE_PREFIX', 'laravel_'),
    ],
],

4. .env 設定並切換

CACHE_DRIVER=ace
ACE_CACHE_SPACE=my_app_cache

使用方式

<?php
// 完全相容 Laravel Cache 介面
Cache::put('key', 'value', 10);        // 10 分鐘
$value = Cache::get('key');
Cache::has('key');
Cache::forget('key');
Cache::increment('counter');
Cache::decrement('counter');
Cache::tags(['users', 'posts'])->put('key', 'value', 10); // 會拋出例外,ACE 不支援標籤

限制與注意事項

  • 僅限 ACE 環境:本地開發需模擬或使用其他驅動 (如 array、file、redis)
  • 不支援標籤:Cache::tags() 會拋出例外
  • 不支援 flush:回傳 false
  • 序列化:ACE 內部處理序列化,複雜物件直接存取即可
  • 併發:ACE 為分散式快取,天然支援多實例共享

本地開發環境切換技巧

<?php
// config/cache.php
'default' => env('CACHE_DRIVER', app()->environment('production') ? 'ace' : 'file'),
// 或
'default' => env('CACHE_DRIVER', 'file'), // 本地預設 file,部署時用環境變數覆蓋
?>

總結

實作 StoreInterface 並透過 Cache::extend() 註冊,即可將任何快取服務整合進 Laravel 統一介面。ACE 驅動展示了如何包裝非標準快取客戶端。

copyright © 萬盛學電腦網 all rights reserved