http://jackxiang.com/index.php zh-cn http://jackxiang.com/post// jack <xdy108@126.com> Mon, 27 Sep 2010 15:40:04 +0000 http://jackxiang.com/post// 最新memcache 扩展（教大家开始PHP扩展之旅）
今天花了点时间把扩展又重新写了一遍。去掉了旧的ZEND API 启用了新的API  。而且已经支持了数组和对象等存储。 支持：

mc_connect()  

mc_set()

mc_get()

mc_delete()

mc_flush()

mc_quit()

mc_close()

等基本函数。

先上包包：  mc.tar.gz (508.09 KB)
mc.tar.gz (508.09 KB)
下载次数: 114

2008-5-5 21:30


安装前需要先安装libmemcached 库  ，因为这个扩展是基于最新的libmemcached 库开发的。

代码后面慢慢讲解!!!!!

最后要实现的就是压缩算法。  算法已经选好。  gzlib 算法。 有空了就加上去。

同时在这里谢谢6间房网的toplee大哥对我的指点。忠心感谢。

[ 本帖最后由 逆雪寒 于 2008-5-6 14:33 编辑 ]
本帖最近评分记录
PHPChina 开源币 +10 原创内容 2008-5-28 10:03

学海无崖，回头是岸http://laoniphp.com  

UID
24549
帖子
2335
精华
7
积分
5845
开源币
272  
阅读权限
100
在线时间
1118 小时
注册时间
2007-1-24
最后登录
2008-7-21
查看详细资料

引用 使用道具 报告 回复 TOP

第二周获奖名单公布

逆雪寒

版主



  

个人空间
发短消息
加为好友
当前离线
2# 大 中 小 发表于 2008-5-5 21:31  只看该作者
扩展的环境安装。放到最后再说吧。想讲解代码先

我写扩展的环境是 linux ,  php5.2.5  apache2  ,vim 就这么简单

我们生成扩展环境后。就可以看到mc.c文件。这里主要是我们写扩展的文件。首先我们必须定义我们自己的扩展函数名。需要用PHP_FE() 来定义。如果不定义PHP会认不出我们的函数。

看图。我的这个memcache 扩展。写了几个简单的函数 :

  
1.jpg (24.67 KB)

2008-5-6 09:38



上面定义了  mc_connect()连接mc的函数   mc_set() 把对象或数组或字符等存到memcache 内存的函数。  mc_get() 从memcache 内存获取数值  mc_delete() 干掉内存中我们保存的东西。  mc_flush() 清楚内存中我们保存的数据。 mc_quit() 断开mc连接。   mc_close() 关闭 mc资源


下面我们先讲解第一个函数  mc_connect() 连接函数。这个函数可能是最难的一个了。因为涉及到资源。

  
2.jpg (32.16 KB)

2008-5-6 09:41


我们先自定义一个我们自己的函数。这个还不是PHP意义上的函数。只是我们的一个在C文件里自定义的一个函数。要想成为PHP的函数。那还需要这样：

  
3.jpg (6.94 KB)

2008-5-6 09:42


PHP扩展中。PHP的函数需要用 PHP_FUNCTION  这个宏函数来定义声明。其实所有的逻辑多可以在 PHP_FUNCTION(mc_connect){} 里面实现。但这样做是为了以后更好的扩展。


看 _mc_connect() 这个函数  的   INTERNAL_FUNCTION_PARAMETERS   宏参数。这个参数是PHP 里面给我们定义的宏。因为我们函数 _mc_connect() 需要接受 PHP层 的参数。 但这个函数又不属于PHP 的函数。所以我们需要使用 INTERNAL_FUNCTION_PARAMETERS 宏来创建 PHP函数的环境。
复制PHP内容到剪贴板
PHP代码:
_mc_connect(INTERNAL_FUNCTION_PARAMETERS){  }


继续我们再看一个。PHP扩展中用得最多的东西：
复制PHP内容到剪贴板
PHP代码:
ZEND_NUM_ARGS()


这个宏是用来获取我们输入的参数个数，比如：  xnijiji('s','e')    那么我们的  ZEND_NUM_ARGS() 就会得到2  ，因为这个函数有两个参数。写扩展的时候我们十分需要知道用户输入的参数个数。因为下个接参函数十分需要这个，看：
复制PHP内容到剪贴板
PHP代码:
int zend_parse_parameters(int num_args TSRMLS_DC, char *type_spec, ...);


这个是函数原形。我们看下MC扩展中实际的是这样：
复制PHP内容到剪贴板
PHP代码:
char *hostname;
long port;
int s_len;
int args = ZEND_NUM_ARGS();
zend_parse_parameters(args TSRMLS_CC,"sl", &hostname,&s_len,&port)==FAILURE


我们先用整形变量 args 来获取 参数的个数。  然后使用  zend_parse_parameters() 来接收我们的参数值。  

参数： 字符指针  hostname  是 MC服务器地址  .  s_len 当然是字符长度拉。不废话。  port 很简单是  MC服务器端口拉。
OK。这个讲解完了继续

TSRMLS_CC  这个鸟是在多线程的服务器上。为了线程安全的宏。太高级了。我们不鸟。跳过。  

"sl"   这个又是什么东西呢。    s  代表我们接受的第一个参数是字符形的  l  当表我们接受长整形的。   C语言就是类型很严格。还是PHP爽。那里还管你什么鸟类型。 类型一定要对哦。要不会出现错误。

如果用户输入参数过多。或是类型不对。那么我们就用宏  ：

WRONG_PARAM_COUNT;

来发出一个错误。看E文就知道。就是说 参数个数太多了。

如果用户输入参数正确。那么我们就可以 做进一步的处理了。就是拿那些参数的值做我们想做的事。

我们拿什么操作memcache 呢？  我选择了比较新的libmemcached 库。 所以我们也要懂这个库。这个是C语言中操作memcache 的一个库。下面我们来简单的看下这个库
复制PHP内容到剪贴板
PHP代码:
memcached_st *yhm_memc;
memcached_return yhm_rc;


memcached_st 是  libmemcached 库自己定义的数据类型。是接受MC资源或是说句柄或是说字符描述符的。
memcached_return 呢 这个是来接受返回结果的。结果有 MEMCACHED_SUCCESS  等等信息。


看下怎么用。我们用libmemcached 来连接memcache ：
复制PHP内容到剪贴板
PHP代码:
yhm_memc = memcached_create(NULL);
yhm_rc = memcached_server_add(yhm_memc,hostname,port);


memcached_create 是初始化 一个句柄。
memcached_server_add  这个才是主菜。大家看就知道了。 它是用来连接mc服务器的。
memcached_server_add(yhm_memc,hostname,port);   hostname  和port 两个变量都是用户输入的。上面有讲解。就这样。  mc在PHP扩展中给连接了。   yhm_memc  这个变量很重要。因为我们连接了MC后。这个变量成了资源。我们在以后的扩展函数中都需要用到。所以存在一个资源保存的问题。


资源怎么保存呢。怎么给每个扩展中的函数使用呢。在注册资源的时候我们需要先在我们这个MC模块启动的时候就注册一个资源注销函数，方便让模块卸载的时候调用清除MC资源

  
6.jpg (36.79 KB)

2008-5-6 10:47



_close_mc_link 函数是我们自定义的  参数：  zend_rsrc_list_entry *rsrc TSRMLS_DC 是一个结构体：里面保存着我们的资源。大概鸟样是这样的：
复制PHP内容到剪贴板
PHP代码:
typedef struct _zend_rsrc_list_entry {
   void *ptr;
   int type;
   int refcount;
} zend_rsrc_list_entry;


成员 void *ptr 才真正指向你的资源。

其实我们不用管那么多。用就是了。
复制PHP内容到剪贴板
PHP代码:
memcached_st *link = (memcached_st *)rsrc->ptr;
memcached_quit(link);


我们使用libmemcached 库的  memcached_quit() 来断开资源连接。逻辑是实现了。但还要注册到PHP内核才行。

注册到内核我们使用:
复制PHP内容到剪贴板
PHP代码:
le_link=zend_register_list_destructors_ex(_close_mc_link,NULL,RESOURCE_TAG,module_number);


le_link  和  RESOURCE_TAG 和  module_number 都是在头文件定义的。那么上菜看下先：

  
4.jpg (13.44 KB)

2008-5-6 11:01


le_link  静态变量就是我们在注册函数析构函数时返回的资源类型句柄。

资源名  宏RESOURCE_TAG   定义为  yhm_mc  也就是这个资源 var_dump() 的名字为yhm_mc ： 看下var_dump() 后的显示
复制PHP内容到剪贴板
PHP代码:
resource(2) of type (yhm_mc)


PHP中注册资源的函数是  zend_register_resource()  



因为常用到所以我再一次封装成自己的宏：
复制PHP内容到剪贴板
PHP代码:
#define YHM_REGISTER_RESOURCE(lk) \
{
    zend_register_resource(return_value,lk,le_link);
}


lk  为需要注册的资源。 le_link 是注册构释时候返回的资源。都是需要的。  return_value 是PHP核心定义的。  是一个zval 容器。里面装的就是返回给PHP层面的值。

OK。大家都了解了吧。我们回到  PHP_FUNCTION(mc_connect) 函数里。里面有这么段：
复制PHP内容到剪贴板
PHP代码:
yhm_memc = memcached_create(NULL);

    yhm_rc = memcached_server_add(yhm_memc,hostname,port);
    if(yhm_rc == MEMCACHED_SUCCESS){
        YHM_REGISTER_RESOURCE(yhm_memc);
    }else{
        RETURN_FALSE;
    }


明白了吧。使用自己的宏 YHM_REGISTER_RESOURCE() 把资源  yhm_memc  注册到PHP里面去。不成功就。RETURN_FALSE;   这个是PHP提供给我们返回 false 的一个宏。

OK。粗略讲完了这个函数。 学扩展需要先看一遍扩展的手册。最好这样拉。要不会有点郁闷

来源：http://fyp832008.blog.163.com/blog/static/91439416200810462028349/ ]]> http://jackxiang.com/post//#blogcomment <user@domain.com> Thu, 01 Jan 1970 00:00:00 +0000 http://jackxiang.com/post//#blogcomment