memcache扩展(0.2版本)源代码讲解(memcache_get_version)

PHP_FUNCTION(memcache_get_version)
{

    zval *id;

    注：zval结构，用来保存调用该方法的当前对象

    mmc_t *mmc;

　注：memcache连接对象

    int inx;
    char *version;
　注：版本信息字符串

    if ((id = getThis()) != 0) {

　　注：只有是对象调用情况下才输出版本信息

       if ((inx = mmc_get_connection(id, &mmc TSRMLS_CC)) == 0) {

　　注：只有在当前对象建立连接才继续

            RETURN_FALSE;

        }
        

        if ( (version = mmc_get_version(mmc)) ) {

            RETURN_STRING(version, 1);

　　　注：在memcache连接对象中获取版本信息

        }

        RETURN_FALSE;

       注：获取不到版本信息返回false

    }
    

    php_error_docref(NULL TSRMLS_CC, E_WARNING, "memcache_get_version() should not be called like this. Use $memcache->getVersion() instead to get server's version");

　注：此行代码一直无效，暂不清楚原因，可能是该api太旧了…………

    RETURN_FALSE;

}

所用到接口，宏，ＡＰＩ列表（上一篇文章介绍过的不再重复介绍）：

getThis()

　　　只有在对象调用情况下才有值，返回值是当前对象在内存中的地址，如果当前不是对象调用，返回0

           例如：memcache->memcache_get_version()返回memcache对象在内存中地址　直接调用memcache_get_version()返回0

mmc_get_connection

返回连接对象，参数：id(memcache对象在内存中地址，通过getThis()获取)，mmc要付值的连接对象(zval结构，通过索引付值)

static int mmc_get_connection(zval *id, mmc_t **mmc TSRMLS_DC)
{
    zval    **connection;
    int        resource_type;

    if (zend_hash_find(Z_OBJPROP_P(id), "connection", sizeof("connection"), (void **)&connection) == FAILURE) {
        php_error_docref(NULL TSRMLS_CC, E_WARNING, "cannot find connection identifier");
        return 0;
    }

   注：在哈希表中根据id查找连接对象，返回值付给coonection变量

    *mmc = (mmc_t *) zend_list_find(Z_LVAL_PP(connection), &resource_type);
    注：根据连接对象返回mmc结构（mmc是自定义的结构，非zval）;
    if (!*mmc || resource_type != le_memcache) {
        php_error_docref(NULL TSRMLS_CC, E_WARNING, "connection identifier not found");
        return 0;
    }
    
    return Z_LVAL_PP(connection);

  返回long型连接id值，就是连接对象(一个zval结构)在内存中的地址
}

mmc_get_version(mmc)

从mmc结构中取出版本信息

mmc结构：

typedef struct mmc {
    int                        id;
    php_stream                *stream;
    char                    inbuf[MMC_BUF_SIZE];
    long                    timeout;
} mmc_t;

/* {{{ mmc_get_version() */
static char *mmc_get_version(mmc_t *mmc)
{
    char *version_str;
    int len;
    
    if (mmc_sendcmd(mmc, "version", 7) < 0) {
        return NULL;
    }

    if ((len = mmc_readline(mmc)) < 0) {
        return NULL;
    }

    if (mmc_str_left(mmc->inbuf,"VERSION ", len, 8)) {
        version_str = estrndup(mmc->inbuf + 8, strlen(mmc->inbuf) - 8 - 2);
        return version_str;
    }
    
    mmc_debug("mmc_get_version: data is not valid version string");    
    return NULL;
}

通过连接服务器端，输入version命令取返回值，获取版本信息，在服务器端telnet上mc后输入version命令

返回格式"VERSION 1.4.5"  从服务器取回的数据，放到inbuf中，然后利用estrndup方法，从inbuf+8的位置copy出一个strlen(mmc->inbuf) - 8 - 2长度的字符串(就是1.4.5)

注意：strlen(mmc->inbuf) - 8 - 2　减８是把"VERSION "(有个空格)减掉，-2是因为返回的“VERSION 1.4.5”后有一个换行符，一个字符串结束符。

RETURN_*

是一组返回值的宏

RETURN_FALSE; 返回false

RETURN_STRING(version, 1); 返回version，第二个参数表示是否copy一份version

还有很多类似的控制返回值的宏…………