TTServer是什么？
Tokyo Cabinet 是一款 DBM 数据库，该数据库读写非常快，哈希模式写入100万条数据只需0.643秒，读取100万条数据只需0.773秒，是 Berkeley DB 等 DBM 的几倍。利用Tokyo Tyrant构建兼容Memcached协议、支持故障转移、高并发的分布式key-value持久存储系统。key-value分布式存储系统查询速度快、存放数据量大、支持高并发，非常适合通过主键进行查询，但不能进行复杂的条件查询。
 
Tokyo Tyrant 是由同一作者开发的 Tokyo Cabinet 数据库网络接口。它拥有Memcached兼容协议，也可以通过HTTP协议进行数据交换。Tokyo Tyrant 加上 Tokyo Cabinet，构成了一款支持高并发的分布式持久存储系统，对任何原有Memcached客户端来讲，可以将Tokyo Tyrant看成是一个Memcached，但是，它的数据是可以持久存储的。
 
TTServer的安装以及配置：（Linux:CentOS 5.2版本）
1、编译安装 tokyocabinet 数据库
  
 
  
  1. wget http://tokyocabinet.sourceforge.net/tokyocabinet-1.4.28.tar.gz 
  2. tar zxvf tokyocabinet-1.4.28.tar.gz 
  3. cd tokyocabinet-1.4.28/ 
  4. ./configure --prefix=/usr/local/tc 
  5. #./configure --prefix=/usr/local/tc --enable-off64 
 
  
 
  
 
   

     注：在32位操作系统下，作为 Tokyo Tyrant 后端存储的 Tokyo Cabinet 数据库单个文件不能超过2G，而64位操作系统则不受这一限制。所以，如果使用 Tokyo Tyrant，推荐在64位CPU、操作系统上安装运行。在编译Tokyo cabinet的时候，使用如下编译选项就可以突破2G限制：--enable-off64 
   
 
   

     make 
   
 
   

     make install 
   
 
   

     #make uninstall 卸载 
   
 
   

       
   
 
   

     2、编译安装tokyotyrant 
   
 
   
 
   
  1. wget http://tokyocabinet.sourceforge.net/tyrantpkg/tokyotyrant-1.1.29.tar.gz 
  2. tar zxvf tokyotyrant-1.1.29.tar.gz 
  3. cd tokyotyrant-1.1.29/ 
  4. ./configure --prefix=/usr/local/tt --with-tc=/usr/local/tc 
  5. make 
  6. make install 
  7. #make uninstall 卸载 
 
   
 
    

      注：如果安装Tokyo Cabinet时指定了目录，在安装Tokyo Tyrant时用 --with-tc 指定Tokyo Cabinet的目录，如果没指定会报：configure: error: tcutil.h is required 错误。 
    
 
    

        
    
 
    

      3、创建tokyotyrant数据文件存放目录 
    
 
    

      mkdir /var/db/ttserver/ 
    
 
    

        
    
 
    

      4、启动tokyotyrant的主进程（ttserver） 
    
 
    

        
    
 
    
 
    
  1. [root@localhost /]# whereis ttserver -> /usr/local/bin/ttserver  
  2. [root@localhost /]# cd /usr/local/sbin  
  3. [root@localhost bin]# ttserver -host 127.0.0.1 -port 1978 -thnum 8 -dmn -pid /var/db/ttserver/ttserver.pid -log /var/db/ttserver/ttserver.log -le -ulog /var/db/ttserver/ -ulim 128m  
  4. [root@localhost bin]# ps uax |grep ttserver //查找运行的进程 
 
    
 
     

       5、参数说明 
     
 
     

       ttserver [-host name] [-port num] [-thnum num] [-tout num] [-dmn] [-pid path] [-log path] [-ld|-le] [-ulog path] [-ulim num] [-uas] [-sid num] [-mhost name] [-mport num] [-rts path] [dbname] 
     
 
     

       -host name : 指定需要绑定的服务器域名或IP地址。默认绑定这台服务器上的所有IP地址。 
     
 
     

       -port num : 指定需要绑定的端口号。默认端口号为1978 
     
 
     

       -thnum num : 指定线程数。默认为8个线程。 
     
 
     

       -tout num : 指定每个会话的超时时间（单位为秒）。默认永不超时。 
     
 
     

       -dmn : 以守护进程方式运行。 
     
 
     

       -pid path : 输出进程ID到指定文件（这里指定文件名）。 
     
 
     

       -log path : 输出日志信息到指定文件（这里指定文件名）。 
     
 
     

       -ld : 在日志文件中还记录DEBUG调试信息。 
     
 
     

       -le : 在日志文件中仅记录错误信息。 
     
 
     

       -ulog path : 指定同步日志文件存放路径（这里指定目录名）。 
     
 
     

       -ulim num : 指定每个同步日志文件的大小（例如128m）。 
     
 
     

       -uas : 使用异步IO记录更新日志（使用此项会减少磁盘IO消耗，但是数据会先放在内存中，不会立即写入磁盘，如果重启服务器或ttserver进程被kill掉，将导致部分数据丢失。一般情况下不建议使用）。 
     
 
     

       -sid num : 指定服务器ID号（当使用主辅模式时，每台ttserver需要不同的ID号） 
     
 
     

       -mhost name : 指定主辅同步模式下，主服务器的域名或IP地址。 
     
 
     

       -mport num : 指定主辅同步模式下，主服务器的端口号。 
     
 
     

       -rts path : 指定用来存放同步时间戳的文件名。  
     
 
     

         
     
 
     

       如果使用的是哈希数据库，可以指定参数“#bnum=xxx”来提高性能。它可以指定bucket存储桶的数量。例如指定“#bnum=1000000”，就可以将最新最热的100万条记录缓存在内存中： 
     
 
     

         
     
 
     
 
     
  1. [root@localhost ttserver]# ttserver -host 127.0.0.1 -port 1978 -thnum 8 -dmn -pid /var/db/ttserver/ttserver.pid -log /var/db/ttserver/ttserver.log -le -ulog /var/db/ttserver/ -ulim 128m -sid 1 -rts /var/db/ttserver/ttserver.rts /var/db/ttserver/database.tch#bnum=1000000  
 
    
 
    

        
    
 
    
 
     

       应用: 
     
 
     

       1、任何Memcached客户端均可直接调用tokyotyrant。 
     
 
     

       2、还可以通过HTTP方式调用，下面以Linux的curl命令为例，介绍如何操作tokyotyrant： 
     
 
     

       　 (1)、写数据，将数据“value”写入到“key”中：curl -X PUT http://127.0.0.1:1978/key -d "value"  
     
 
     

       (2)、读数据，读取“key”中数据：curl http://127.0.0.1:1978/key  
     
 
     

       (3)、删数据，删除“key”：curl -X DELETE http://127.0.0.1:1978/key  
     
 
     

       3. PHP 的 API 接口程序以及 DEMO 详见：http://openpear.org/repository/Net_TokyoTyrant/  
     
 
     

         
     
 
    
 
    

      注：在32位操作系统下，作为 Tokyo Tyrant 后端存储的 Tokyo Cabinet 数据库单个文件不能超过2G，而64位操作系统则不受这一限制。所以，如果使用 Tokyo Tyrant，推荐在64位CPU、操作系统上安装运行。在编译Tokyo cabinet的时候，使用如下编译选项就可以突破2G限制：--enable-off64  
    
 
    

        
    
 
    
 
     

       ===为PHP安装tokyo_yrant模块=== 
     
 
     

         
     
 
     

       在页面http://pecl.php.net/package/tokyo_tyrant可以找到php的tt扩展最新稳定版本 
     
 
     

         
     
 
     
 
     
  1. tar zxvf tokyo_tyrant-0.5.0.tgz 
  2. cd tokyo_tyrant-0.5.0 
  3. /usr/local/php/bin/phpize 
  4. ./configure --with-tokyo-tyrant=/usr/local/tt/ --with-tokyo-cabinet-dir=/usr/local/tc/ 
  5. #TT指定目录安装时，给出tt和tc的目录位置，否则会提示，reinstall tokyo-tyrant  
  6. make && make install 
 
     

       安装完成以后，在php.ini里面增加一行extension = tokyo_tyrant.so，然后tt扩展就生效了。 
     
 
     

         
     
 
     

       项目中运用的实例：统计论坛中帖子的点击数量 
     
 
     

         
     
 
     
 
     
  1. <?php 
  2. define('TT_PATH', substr(dirname(__FILE__), 0, -7)); 
  3. require_once(TT_PATH.'/bbs/TokyoTyrant.php'); 
  4.  
  5. $ttObject = new Net_TokyoTyrant(); 
  6.  
  7. $memObject = new Memcache(); 
  8. //连接TT 
  9. $memObject->connect('192.168.1.111',1979); 
  10.  
  11. //写入点击数 以 fid_$fid 为 Key 保存对应的域名值 
  12. function hitsSet($fid, $num) 
  13. { 
  14. global $memObject; 
  15. $hitskey = "fid_".$fid; //key 
  16. $res = $memObject->get($hitskey ); 
  17. if(empty($res)) { 
  18. $memObject->set($hitskey ,$num); //设置 fid_id=>num 
  19. } else { 
  20. $memObject->replace($hitskey , $num); //重置替换 
  21. } 
  22. $memObject->close(); //一定要记得关闭，否则 TIME_OUT 进程会越来越多 
  23. } 
  24.  
  25. //获取点击数 
  26. function hitsGet($fid) 
  27. { 
  28. global $memObject; 
  29. $groupkey = "fid_".$fid; //key 
  30. $res = $memObject->get($fid); //获取value 
  31. $num = empty($res) ? '0' : $res; 
  32. return $num; 
  33. $memObject->close(); 
  34. }  
  35. ?>  
 
     
 
      

        注：序列化问题  
      
 
      

        在实际应用中更常用 memcache 协议使用ttserver，当我们从中取数据时，会是一个序列化的字符串，没有自动反序列化处理，但在memcached服务器上却是自动反序列化的哦。这样我们先将数据取出，如： a:1:{s:5:"value";s:14:"this is a value";} ，再利用 unserialize() 函数反序列化就可以使用了。