Laravel中扩展Memcached缓存驱动实现使用阿里云OCS缓存

laravel 是我最近用得非常多而且越用就越喜欢的一款php框架，由于没有向下兼容的历史包袱，完全面向对象的风格，借助 facades 优雅的ioc container 实现，采用 composer 进行包管理，可以方便地引入和使用开源社区里的优秀组件……总而言之，这是一款真正让你能够 "" 的“巨匠级php开发框架”。

在尝试把自己的 laravel app 部署到阿里云的时候，遇到了一个问题： laravel 支持 memcached 缓存，阿里云的 ocs 也是基于 memcached 的缓存，但是阿里云 ocs 采用 sasl 认证，而 laravel 的 memcached 驱动并没有实现相关的方法，即使在服务器上编译php memcached 的时候启用了 sasl 认证选项，也没办法设定用户名和密码。

在 laravel 中，解决这样的问题，有很多方法。我选择了最快捷最省事的方法：扩展 laravel 自己的 memcached 驱动，通过 memcached 对象自身的 setsaslauthdata 方法，指定用户名和密码。

背景知识

这是利用了 illuminate\cache\cachemanager 的 extend 方法（继承自illuminate\support\manager）。先看一下这个方法的定义：

/**
 * register a custom driver creator closure.
 *
 * @param  string   $driver
 * @param  closure  $callback
 * @return \illuminate\support\manager|static
 */
public function extend($driver, closure $callback){}

这个方法接收两个参数，第一个是代表你自定义的驱动名称的字符串，第二个是一个闭包回调函数，这个函数就是当调用你的自定义驱动时要执行的方法。通过阅读 illuminate\cache\cachemanager 的源代码，我们可以发现创建驱动的函数要返回一个 illuminate\cache\repository 的实例，illuminate\cache\repository 的构造函数如下：

/**
 * create a new cache repository instance.
 *
 * @param  \illuminate\cache\storeinterface  $store
 */
public function __construct(storeinterface $store)
{
    $this->store = $store;
}

它需要一个实现了 illuminate\cache\storeinterface 接口的对象，这个接口中定义了 cache 对象能够执行的方法。由于我计划是扩展原有的 memcached 缓存驱动，在 illuminate\cache\cachemanager 的源代码中，可以看到 laravel 是这样创建 memcached 驱动的：

/**
 * create an instance of the memcached cache driver.
 *
 * @return \illuminate\cache\memcachedstore
 */
protected function creatememcacheddriver()
{
    $servers = $this->app['config']['cache.memcached'];
 
    $memcached = $this->app['memcached.connector']->connect($servers);
 
    return $this->repository(new memcachedstore($memcached, $this->getprefix()));
}

它先从配置文件中读取你定义的 memcached 服务器，然后创建一个 memcached 对象（通过 illuminate\cache\memcachedconnector 实现，实际上就是创建一个标准的 memcached 对象，然后调用 memcached 的 addserver 方法来指定要连接的服务器，然后返回实例化的 memcached 对象。)

扩展自己的缓存驱动

了解了上述的背景知识之后，就可以来扩展自己的缓存驱动了。思路如下：

1.在 app/config/cache.php 文件中，增加三个配置项，用来设定“是否使用sasl认证”,“sasl认证账户”，“sasl认证密码”。
2.在 bootstrap/start.php 文件中，调用 cache::extend 方法扩展驱动。
3.在 app/config/cache.php 文件中，修改 driver 配置项，指定系统使用自己扩展的驱动。

增加配置项

首先，打开 app/config/cache.php 文件，找到：

'memcached' => array(
        array('host' => '127.0.0.1', 'port' => 11211, 'weight' => 100),
    ),

修改为：

'memcached' => array(
        array('host' => '127.0.0.1', 'port' => 11211, 'weight' => 100),
    ),
 
    'memcached_sasl' => 'true', // 启用sasl认证
    'memcached_user' => 'your ocs username', // 你的 ocs 用户名
    'memcached_pass' => 'your ocs password', // 你的 ocs 密码

扩展驱动

然后，打开 bootstrap/start.php 文件，在最后一行 return $app; 前面插入代码：

// 基于系统自己的 memcached 缓存驱动，扩展一个名为 saslmemcached 的缓存驱动
cache::extend('saslmemcached', function($app){
    // 从配置文件中读取 memcached 服务器配置
    $servers = $app['config']['cache.memcached'];
    
    // 利用 illuminate\cache\memcachedconnector 类来创建新的 memcached 对象
    $memcached = $app['memcached.connector']->connect($servers);
 
    // 如果服务器上的 php memcached 扩展支持 sasl 认证
    if(ini_get('memcached.use_sasl')){
        
        // 从配置文件中读取 sasl 认证用户名
        $user = $app['config']['cache.memcached_user'];
 
        // 从配置文件中读取 sasl 认证密码
        $pass = $app['config']['cache.memcached_pass'];
        
        // 禁用 memcached 压缩 （阿里云的文档里这样做了……）
        $memcached->setoption(memcached::opt_compression, false);
 
        // 指定 memcached 使用 binary protocol ( sasl 认证要求 )
        $memcached->setoption(memcached::opt_binary_protocol, true);
 
        // 指定用于 sasl 认证的账号密码
        $memcached->setsaslauthdata($user, $pass);
    }
 
    // 从配置文件中读取缓存前缀
    $prefix = $app['config']['cache.prefix'];
 
    // 创建 memcachedstore 对象
    $store = new \illuminate\cache\memcachedstore($memcached, $prefix);
    
    // 创建 repository 对象，并返回
    return new \illuminate\cache\repository($store);
});

修改配置，使用自己扩展的缓存驱动

打开 app/config/cache.php 文件，找到：

"driver" => "file", // 默认是使用文件缓存

修改为：

"driver" => "saslmemcached", // 刚才扩展实现的驱动名称

现在，你就可以在你的 阿里云 ecs 服务器上， 让 laravel 使用 阿里云 ocs 缓存服务了。（前提是你的 php 支持 memcached 扩展，并且启用了 sasl 认证，参考：