HandlerSocket 安装

原文：http://yoshinorimatsunobu.blogspot.com/2010/10/using-mysql-as-nosql-story-for.html
相关的日文PPT：http://www.slideshare.net/akirahiguchi/handlersocket-plugin-for-mysql-4664154

相关新能测试请参考：http://www.cnblogs.com/inrie/archive/2011/02/22/1961415.html

下载地址：https://github.com/ahiguti/HandlerSocket-Plugin-for-MySQL

安装方式：
下载 ahiguti-HandlerSocket-Plugin-for-MySQL-1.0.6-73-g0e63366.tar.gz https://github.com/ahiguti/HandlerSocket-Plugin-for-MySQL/tarball/master
[root@niutian365 tmp]# tar -zxvf ahiguti-HandlerSocket-Plugin-for-MySQL-1.0.6-73-g0e63366.tar.gz
[root@niutian365 tmp]# cd ahiguti-HandlerSocket-Plugin-for-MySQL-0e63366
[root@niutian365 tmp]# ./autogen.sh

##这里 可能会遇到libtool 未安装 yum install libtool 安装下
[root@niutian365 tmp]# ./configure --with-mysql-source=/niutian365/softs/mysql-5.1.54 --with-mysql-bindir=/usr/local/mysql/bin  --with-mysql-plugindir=/usr/local/mysql/lib/mysql/plugin
##注意这里我的mysql版本是mysql-5.1.54 已经安装过 不详述mysql安装 源码目录是/niutian365/softs/mysql-5.1.54,这个地方我经常搞错,配置到mysql安装目录下.
[root@niutian365 tmp]# make
[root@niutian365 tmp]# make install

[root@niutian365 tmp]# vi /etc/my.cnf

[mysqld]
......
#下面添加
loose_handlersocket_port = 9998
loose_handlersocket_port_wr = 9999
loose_handlersocket_threads = 16
loose_handlersocket_threads_wr = 1
open_files_limit = 65535
保存退出
重启mysql
[root@niutian365 tmp]# mysql restart
登录mysql
[root@niutian365 tmp]# mysql -uroot -pniutian
mysql> install plugin handlersocket soname 'handlersocket.so';
mysql> show processlist;

mysql> show plugins;

[root@niutian365 tmp]# mysql restart

安装说明请参考 ahiguti-HandlerSocket-Plugin-for-MySQL-0e63366/docs-ja目录下面的说明文件

安装php模块HandlerSocket文档中提供了三种方式安装：
http://openpear.org/package/Net_HandlerSocket
http://github.com/tz-lom/HSPHP
http://code.google.com/p/php-handlersocket/


这里php模块支持选择http://code.google.com/p/php-handlersocket/
[root@niutian365 tmp]# wget http://php-handlersocket.googlecode.com/files/php-handlersocket-0.0.7.tar.gz
[root@niutian365 tmp]# tar -zxvf php-handlersocket-0.0.7.tar.gz 
[root@niutian365 tmp]# cd php-handlersocket
[root@niutian365 tmp]# /usr/local/php/bin/phpize 
[root@niutian365 tmp]# ./configure --with-php-config=/usr/local/php/bin/php-config
[root@niutian365 tmp]# make
[root@niutian365 tmp]# make install
出现
Installing shared extensions:     /usr/local/php/lib/php/extensions/no-debug-non-zts-20090626/
Installing header files:          /usr/local/php/include/php/
[root@niutian365 tmp]# vi /usr/local/php/etc/php.ini
添加extension=handlersocket.so
保存退出
重启apache或者php-fpm

2011-06-07升级安装 0.2.0
个别包依赖包括re2c等
[root@niutian365 tmp]# yum -y install gcc gcc-c++ autoconf glibc glibc-devel glib2 glib2-devel
[root@niutian365 tmp]# wget http://pkgs.repoforge.org/re2c/re2c-0.13.5-1.el5.rf.i386.rpm
[root@niutian365 tmp]# rpm -ivh re2c-0.13.5-1.el5.rf.i386.rpm
[root@niutian365 tmp]# wget http://php-handlersocket.googlecode.com/files/php-handlersocket-0.2.0.tar.gz
安装方法同上
使用PHP handlersocket的API

复制内容到剪贴板  程序代码

HandlerSocket {
     /* Constants */
    const HandlerSocket : :PRIMARY ;

     /* Methods */
    __construct   ( string $host , string $port  [ , array $options  ] )
     public bool openIndex  (  int $id , string $db , string $table , string $index , string $fields  )
     public mixed executeSingle  (  int $id , string $op , array $fields  [ ,  int $limit ,  int $skip , strint $modop , array $values , array $filters ,  int $invalues_key , array $invalues  ]  )
     public mixed executeMulti  ( array $requests  )
     public mixed executeUpdate  (  int $id , string $op , array $fields , array $values  [ ,  int $limit ,  int $skip , array $filters ,  int $invalues_key , array $invalues ]  ]  )
     public mixed executeDelete  (  int $id , string $op , array $fields  [ ,  int $limit ,  int $skip , array $filters ,  int $invalues_key , array $invalues ]  ]  )
     public mixed executeInsert  (  int $id , array $values  )
     public string getError  (  void  )
}

中文说明：
/*
* String  $host：MySQL ip；
* String  $port：handlersocket插件的监听端口，它有两个端口可选：一个用于读、一个用于写
*/
$hs  =  new HandlerSocket ($host , $port ) ;

打开一个数据表：
/*
* Int       $index：这个数字相当于文件操作里的句柄，HandlerSocket的所有其他方法都会依据这个数字来操作由这个　　　openIndex打开的表，
* String  $dbname：库名
* String  $table：表名
* String  $key：表的“主键”（HandlerSocket::PRIMARY）或“索引名”作为搜索关键字段，这就是说表必须有主键或索引
*                 个人理解：要被当做where条件的key字段，这样可以认为handlersocket只有一个where条件
* String  $column：'column1,column2' 所打开表的字段（以逗号隔开），就是说$table表的其他字段不会被操作
*/
$hs - >openIndex ($index , $dbname , $table , $key , $column ) ;

查询：
/*
* Int     $index: openIndex()所用的$index
* String  $operation：openIndex方法中指定的$key字段所用的操作符，目前支持'=', '>=', '<=', '>',and '<'；可以理解为where条件
* Array   $value
* Int       $number（默认是1）：获取结果的最大条数；相当于SQL中limit的第二个参数
* Int     $skip（默认是0）：跳过去几条；相当于SQL中limit的第一个参数
*/
$retval  = $hs - >executeSingle ($index , $operation , $value , $number , $skip ) ;

插入（注意：此处的openIndex要用$port_wr，即读写端口）：
/*
* Int     $index: openIndex()所用的$index
* Array   $arr：数字元素数与openIndex的$column相同
*/
$retval  = $hs - >executeInsert ($index , $arr ) ;

删除（注意：此处的openIndex要用$port_wr，即读写端口）：
/*
* Int     $index: openIndex()所用的$index
* String  $operation：openIndex方法中指定的$key字段所用的操作符，目前支持'=', '>=', '<=', '>',and '<'；可以理解为where条件
* Array   $value
* Int     $number（默认是1）：获取结果的最大条数；相当于SQL中limit的第二个参数
* Int     $skip（默认是0）：跳过去几条；相当于SQL中limit的第一个参数
*/
$retval  = $hs - >executeDelete ($index , $operation , $value , $number , $skip ) ;

更新（注意：此处的openIndex要用$port_wr，即读写端口）：
/*
* Int     $index: openIndex()所用的$index
* String  $operation：openIndex方法中指定的$key字段所用的操作符，目前支持'=', '>=', '<=', '>',and '<'；可以理解为where条件
* Array   $value
* Int       $number（默认是1）：获取结果的最大条数；相当于SQL中limit的第二个参数
* Int     $skip（默认是0）：跳过去几条；相当于SQL中limit的第一个参数
*/
$retval  = $hs - >executeUpdate ($index , $operation , $value , $number , $skip ) ;

实例：
< ?php
$host  =  'localhost' ;
$port  = 9998 ;
$port_wr  = 9999 ;
$dbname  =  'hstestdb' ;
$table  =  'hstesttbl' ;

/** GET **/
$hs  =  new HandlerSocket ($host , $port ) ;
if  ( ! ($hs - >openIndex (1 , $dbname , $table , HandlerSocket : :PRIMARY ,  'k,v' ) ) )  {
    echo $hs - >getError ( ) , PHP_EOL ;
    die ( ) ;
}
$retval  = $hs - >executeSingle (1 ,  '=' , array ( 'k1' ) , 1 , 0 ) ;
var_dump ($retval ) ;
$retval  = $hs - >executeMulti (
    array (array (1 ,  '=' , array ( 'k1' ) , 1 , 0 ) ,
          array (1 ,  '=' , array ( 'k2' ) , 1 , 0 ) ) ) ;
var_dump ($retval ) ;
unset ($hs ) ;


/** Update **/
$hs  =  new HandlerSocket ($host , $port_wr ) ;
if  ( ! ($hs - >openIndex (2 , $dbname , $table ,  '' ,  'v' ) ) )  {
    echo $hs - >getError ( ) , PHP_EOL ;
    die ( ) ;
}
if  ($hs - >executeUpdate (2 ,  '=' , array ( 'k1' ) , array ( 'V1' ) , 1 , 0 )  = = =  false )  {
    echo $hs - >getError ( ) , PHP_EOL ;
    die ( ) ;
}
unset ($hs ) ;


/** Insert **/
$hs  =  new HandlerSocket ($host , $port_wr ) ;
if  ( ! ($hs - >openIndex (3 , $dbname , $table ,  '' ,  'k,v' ) ) )  {
    echo $hs - >getError ( ) , PHP_EOL ;
    die ( ) ;
}

if  ($hs - >executeInsert (3 , array ( 'k2' ,  'v2' ) )  = = =  false )  {
    echo $hs - >getError ( ) , PHP_EOL ;
}
if  ($hs - >executeInsert (3 , array ( 'k3' ,  'v3' ) )  = = =  false )  {
    echo  'A' , $hs - >getError ( ) , PHP_EOL ;
}
if  ($hs - >executeInsert (3 , array ( 'k4' ,  'v4' ) )  = = =  false )  {
    echo  'B' , $hs - >getError ( ) , PHP_EOL ;
}
unset ($hs ) ;

/** Delete **/
$hs  =  new HandlerSocket ($host , $port_wr ) ;
if  ( ! ($hs - >openIndex (4 , $dbname , $table ,  '' ,  '' ) ) )  {
    echo $hs - >getError ( ) , PHP_EOL ;
    die ( ) ;
}

if  ($hs - >executeDelete (4 ,  '=' , array ( 'k2' ) )  = = =  false )  {
    echo $hs - >getError ( ) , PHP_EOL ;
    die ( ) ;
}