阿里雲 OCS (Open Cache Service) 採用 SASL 認證,Laravel 內建 Memcached 驅動未提供設定用戶名/密碼介面。本文示範如何透過 Cache::extend() 擴充自訂驅動,注入 SASL 認證參數。
CacheManager::extend() 接受驅動名稱與回呼函式,回呼需回傳 Illuminate\Cache\Repository 實例。Repository 需要實作 StoreInterface 的儲存類別 (如 MemcachedStore)MemcachedStore 建構子需 Memcached 實例與前綴Memcached 類別提供 setSaslAuthData($user, $pass) 方法 (需編譯時啟用 --enable-memcached-sasl)<?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_'),
];
?>
<?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);
});
}
}
?>
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,程式碼極少、維護性高。