萬盛學電腦網

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

Laravel 擴充 Memcached 驅動支援阿里雲 OCS (SASL 認證)

前言

阿里雲 OCS (Open Cache Service) 採用 SASL 認證,Laravel 內建 Memcached 驅動未提供設定用戶名/密碼介面。本文示範如何透過 Cache::extend() 擴充自訂驅動,注入 SASL 認證參數。

背景知識

  • Laravel CacheManager::extend() 接受驅動名稱與回呼函式,回呼需回傳 Illuminate\Cache\Repository 實例。
  • Repository 需要實作 StoreInterface 的儲存類別 (如 MemcachedStore)
  • MemcachedStore 建構子需 Memcached 實例與前綴
  • PHP Memcached 類別提供 setSaslAuthData($user, $pass) 方法 (需編譯時啟用 --enable-memcached-sasl)

實作步驟

1. 修改配置檔 config/cache.php

<?php
return [
    'default' => env('CACHE_DRIVER', 'file'),

    'stores' => [
        // ... 其他驅動

        'memcached' => [
            'driver' => 'memcached',
            'servers' => [
                ['host' => env('MEMCACHED_HOST', '127.0.0.1'), 'port' => env('MEMCACHED_PORT', 11211), 'weight' => 100],
            ],
        ],

        // 新增 OCS 專用設定
        'ocs' => [
            'driver' => 'ocs', // 自訂驅動名稱
            'servers' => [
                ['host' => env('OCS_HOST', 'xxx.m.cnqdalicm9pub001.ocs.aliyuncs.com'), 'port' => 11211, 'weight' => 100],
            ],
            'username' => env('OCS_USERNAME'),
            'password' => env('OCS_PASSWORD'),
            'sasl' => true,
            'options' => [
                Memcached::OPT_BINARY_PROTOCOL => true,
                Memcached::OPT_COMPRESSION => false,
            ],
        ],
    ],

    'prefix' => env('CACHE_PREFIX', 'laravel_'),
];
?>

2. 在 AppServiceProvider 或 bootstrap/app.php 註冊驅動

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

use Illuminate\Support\ServiceProvider;
use Illuminate\Cache\MemcachedStore;
use Illuminate\Cache\Repository;
use Memcached;

class AppServiceProvider extends ServiceProvider
{
    public function boot()
    {
        $this->app->booted(function () {
            $this->registerOcsDriver();
        });
    }

    protected function registerOcsDriver()
    {
        $this->app['cache']->extend('ocs', function ($app) {
            $config = $app['config']['cache.stores.ocs'];

            // 建立 Memcached 實例
            $memcached = $app['memcached.connector']->connect($config['servers']);

            // SASL 認證設定
            if (!empty($config['sasl']) && ini_get('memcached.use_sasl')) {
                $memcached->setOption(Memcached::OPT_BINARY_PROTOCOL, true);
                $memcached->setOption(Memcached::OPT_COMPRESSION, false);
                $memcached->setSaslAuthData($config['username'], $config['password']);
            }

            // 套用其他選項
            if (!empty($config['options'])) {
                foreach ($config['options'] as $option => $value) {
                    $memcached->setOption($option, $value);
                }
            }

            // 建立 Store -> Repository
            $store = new MemcachedStore($memcached, $config['prefix'] ?? '');
            return new Repository($store);
        });
    }
}
?>

3. 設定 .env 並切換驅動

CACHE_DRIVER=ocs
OCS_HOST=xxx.m.cnqdalicm9pub001.ocs.aliyuncs.com
OCS_USERNAME=your_ocs_username
OCS_PASSWORD=your_ocs_password

驗證與測試

<?php
// routes/web.php 或 tinker
Route::get('/test-ocs', function () {
    Cache::put('test_key', 'OCS 連線成功! ' . now(), 60);
    return Cache::get('test_key');
});

常見問題

問題解決
Class 'Memcached' not found安裝 php-memcached 擴充套件,並確認編譯啟用 SASL
SASL 認證失敗檢查用戶名/密碼、確認 OCS 白名單 IP、PHP memcached.use_sasl=On
連線逾時安全組/防火牆未放行 11211、VPC 網路不通
資料不一致確認 prefix 設定一致、序列化器一致 (igbinary vs php)

總結

透過 Cache::extend() 註冊自訂驅動,在建立 Memcached 實例後呼叫 setSaslAuthData(),即可無縫整合阿里雲 OCS,程式碼極少、維護性高。

copyright © 萬盛學電腦網 all rights reserved