基于HTTP协议的轻量级开源简单队列服务：HTTPSQS

素颜马尾好姑娘i 2022-06-15 10:22 200阅读 0赞

HTTPSQS（HTTP Simple Queue Service）是一款基于 HTTP GET/POST 协议的轻量级开源简单消息队列服务，使用 Tokyo Cabinet 的 B+Tree Key/Value 数据库来做数据的持久化存储。  
  
　　 项目网址：[http://code.google.com/p/httpsqs/][http_code.google.com_p_httpsqs]  
　　 使用文档：[http://blog.zyan.cc/httpsqs/][http_blog.zyan.cc_httpsqs]  
　　 使用环境： Linux（同时支持32位、64位操作系统，推荐使用64位操作系统）  
　　 软件作者： 张宴  
  
　　队列（Queue）又称先进先出表（First In First Out），即先进入队列的元素，先从队列中取出。加入元素的一头叫“队头”，取出元素的一头叫“队尾”。利用消息队列可以很好地异步处理数据传送和存储，当你频繁地向数据库中插入数据、频繁地向搜索引擎提交数据，就可采取消息队列来异步插入。另外，还可以将较慢的处理逻辑、有并发数量限制的处理逻辑，通过消息队列放在后台处理，例如FLV视频转换、发送手机短信、发送电子邮件等。  
  
　　 HTTPSQS 具有以下特征：  
  
　　● 非常简单，基于 HTTP GET/POST 协议。PHP、Java、Perl、Shell、Python、Ruby等支持HTTP协议的编程语言均可调用。  
　　● 非常快速，入队列、出队列速度超过10000次/秒。  
　　● 高并发，支持上万的并发连接， [C10K][] 不成问题。  
　　● 支持多队列。  
　　● 单个队列支持的最大队列数量高达10亿条。  
　　● 低内存消耗，海量数据存储，存储几十GB的数据只需不到100MB的物理内存缓冲区。  
　　● 可以在不停止服务的情况下便捷地修改单个队列的最大队列数量。  
　　● 可以实时查看队列状态（入队列位置、出队列位置、未读队列数量、最大队列数量）。  
　　● 可以查看指定队列ID（队列点）的内容，包括未出、已出的队列内容。  
　　● 查看队列内容时，支持多字符集编码。  
　　● 源代码不超过800行，适合二次开发。  
  
　　 [![点击在新窗口中浏览此图片][httpsqs_elements.png]][httpsqs_elements.png]

--------------------

1、HTTPSQS 1.7 压力测试：  
  
　　采用Apache ab命令进行压力测试，开启10个线程，放入10万条文本数据（每条512字节）到队列中:  
　　使用HTTP Keep-Alive时：23018 requests/sec  
　　关闭HTTP Keep-Alive时：11840 requests/sec  
  
　　采用Apache ab命令进行压力测试，开启10个线程，从队列中取出10万条文本数据（每条512字节）:  
　　使用HTTP Keep-Alive时：25982 requests/sec  
　　关闭HTTP Keep-Alive时：13294 requests/sec  
  
　　详细测试内容： [http://code.google.com/p/httpsqs/wiki/BenchmarkTest][http_code.google.com_p_httpsqs_wiki_BenchmarkTest]  
  
　　生产环境应用：在 [金山游戏官网][Link 1] 中，新闻、论坛帖子、客服公告、SNS社区等发生的增、删、改操作，文本内容实时写入HTTPSQS队列，全站搜索引擎增量索引准实时（1分钟内）更新的数据源取自HTTPSQS。HTTPSQS 2009年12月18日上线至今，运行稳定，既有来自Web服务器的入队列操作，也有来自命令行脚本的批量入、出队列操作。

--------------------

2、HTTPSQS 的生产环境应用：  
  
　　●金山通行证（ [https://my.xoyo.com][https_my.xoyo.com] ）  
　　队列应用类型：手机短信上行、手机短信下发、邮件下发  
　　队列应用要求：稳定性高，存储数据量大  
　　队列部署结构：一主、一备两台 HTTPSQS 热备模式  
  
　　●金山用户行为分析系统（ [http://kbi.xoyo.com][http_kbi.xoyo.com] ）  
　　队列应用类型：用户鼠标点击、访问URL原始数据采集  
　　队列应用要求：并发性能高，存储数据量大  
　　队列部署结构：多台 HTTPSQS 应用层哈希分布式模式  
  
　　●金山网络游戏运营平台 KingEyes  
　　队列应用类型：用户操作日志记录  
  
　　●金山逍遥网站内搜索  
　　队列应用类型：索引准实时更新。在 [金山游戏官网][Link 1] 中，新闻、论坛帖子、客服公告、SNS社区等发生的增、删、改操作，文本内容实时写入HTTPSQS队列，全站搜索引擎增量索引准实时（1分钟内）更新的数据源取自HTTPSQS。  
  
　　●金山逍遥网全站通用评论系统  
　　队列应用类型：评论发表  
  
　　●金山《剑侠情缘》电视连续剧四大角色人物选秀活动（ [http://zt.xoyo.com/haixuan/][http_zt.xoyo.com_haixuan] ）  
　　队列应用类型：用户上传的照片异步裁剪、缩放处理  
  
　　●新浪邮箱（ [http://mail.sina.com.cn][http_mail.sina.com.cn] ）  
　　队列应用类型：用户登陆日志记录

--------------------

3、HTTPSQS 编译安装：

ulimit -SHn 65535  
  
wget  [http://httpsqs.googlecode.com/files/libevent-2.0.12-stable.tar.gz][http_httpsqs.googlecode.com_files_libevent-2.0.12-stable.tar.gz]  
tar zxvf libevent-2.0.12-stable.tar.gz  
cd libevent-2.0.12-stable/  
./configure --prefix=/usr/local/libevent-2.0.12-stable/  
make  
make install  
cd ../  
  
wget  [http://httpsqs.googlecode.com/files/tokyocabinet-1.4.47.tar.gz][http_httpsqs.googlecode.com_files_tokyocabinet-1.4.47.tar.gz]  
tar zxvf tokyocabinet-1.4.47.tar.gz  
cd tokyocabinet-1.4.47/  
./configure --prefix=/usr/local/tokyocabinet-1.4.47/  
\#注：在32位Linux操作系统上编译Tokyo cabinet，请使用./configure --enable-off64代替./configure，可以使数据库文件突破2GB的限制。  
\#./configure --enable-off64 --prefix=/usr/local/tokyocabinet-1.4.47/  
make  
make install  
cd ../  
  
wget  [http://httpsqs.googlecode.com/files/httpsqs-1.7.tar.gz][http_httpsqs.googlecode.com_files_httpsqs-1.7.tar.gz]  
tar zxvf httpsqs-1.7.tar.gz  
cd httpsqs-1.7/  
make  
make install  
cd ../

--------------------

4、HTTPSQS 服务器使用文档：  
  
　　 [![点击在新窗口中浏览此图片][httpsqs.png]][httpsqs.png]  
  
　　\[root@xoyo ~\]\# httpsqs -h

\-l <ip\_addr> 监听的IP地址，默认值为 0.0.0.0   
\-p <num> 监听的TCP端口（默认值：1218）  
\-x <path> 数据库目录，目录不存在会自动创建（例如：/opt/httpsqs/data）  
\-t <second> HTTP请求的超时时间（默认值：3）  
\-s <second> 同步内存缓冲区内容到磁盘的间隔秒数（默认值：5）  
\-c <num> 内存中缓存的最大非叶子节点数（默认值：1024）  
\-m <size> 数据库内存缓存大小，单位：MB（默认值：100）  
\-i <file> 保存进程PID到文件中（默认值：/tmp/httpsqs.pid）  
\-a <auth> 访问HTTPSQS的验证密码（例如：mypass123）  
\-d 以守护进程运行  
\-h 显示这个帮助

示例：

ulimit -SHn 65535   
httpsqs -d -p 1218 -x /data0/queue

请使用命令“killall httpsqs”、“pkill httpsqs”和“kill \`cat /tmp/httpsqs.pid\`”来停止httpsqs。  
  
　　 注意：请不要使用命令“pkill -9 httpsqs”和“kill -9  httpsqs的进程ID”来结束httpsqs，否则，内存中尚未保存到磁盘的数据将会丢失。

--------------------

5、HTTPSQS 客户端使用文档：  
  
　　 (1)、入队列（将文本消息放入队列）：  
  
　　HTTP GET 协议（以curl命令为例）：

curl "http://host:port/?name=your\_queue\_name&opt=put&data=经过URL编码的文本消息&auth=mypass123"

HTTP POST 协议（以curl命令为例）：

curl -d "经过URL编码的文本消息" "http://host:port/?name=your\_queue\_name&opt=put&auth=mypass123"

以浏览器为例：  
　　 [![点击在新窗口中浏览此图片][put.png]][put.png]  
  
　　如果入队列成功，返回：

HTTPSQS\_PUT\_OK

如果入队列失败，返回：

HTTPSQS\_PUT\_ERROR

如果队列已满，返回：

HTTPSQS\_PUT\_END

从HTTPSQS 1.2版本开始，在返回给客户端的HTTP Header头中增加了一行“Pos: xxx”，输出当前队列的读取位置点，例如：

HTTP/1.1 200 OK  
Content-Type: text/plain  
Keep-Alive: 120  
Pos: 19  
Date: Thu, 18 Mar 2010 04:57:08 GMT  
Content-Length: 14  
  
HTTPSQS\_PUT\_OK

--------------------

(2)、出队列（从队列中取出文本消息）：  
  
　　HTTP GET 协议（以curl命令为例）：

curl "http://host:port/?charset=utf-8&name=your\_queue\_name&opt=get&auth=mypass123"

curl "http://host:port/?charset=gb2312&name=your\_queue\_name&opt=get&auth=mypass123"

以浏览器为例：  
　　 [![点击在新窗口中浏览此图片][get.png]][get.png]  
  
　　返回消息队列的内容给客户端。  
  
　　如果没有未取出的消息队列，则返回：

HTTPSQS\_GET\_END

从HTTPSQS 1.2版本开始，在返回给客户端的HTTP Header头中增加了一行“Pos: xxx”，输出当前队列的读取位置点，例如：

HTTP/1.1 200 OK  
Content-Type: text/plain; charset=utf-8  
Keep-Alive: 120  
Pos: 7  
Date: Thu, 18 Mar 2010 04:56:01 GMT  
Content-Length: 18  
  
消息队列内容

参数charset说明（例如：/?charset=utf-8）：  
　　指定HTTP输出Header头的字符编码，即：  
　　Content-Type: text/plain; charset=utf-8   
  
　　任何 [在IANA注册的字符编码][IANA] 均可使用，但是，并不是所有的浏览器都能解析全部的字符编码。对于中文，常用的字符编码有：utf-8、gb2312、gbk、gb18030、big5等。

--------------------

(3)、查看队列状态（普通方式，便于浏览器查看）：  
  
　　HTTP GET 协议（以curl命令为例）：

curl "http://host:port/?name=your\_queue\_name&opt=status&auth=mypass123"

返回（示例）：

HTTP Simple Queue Service v1.7  
\------------------------------  
Queue Name: xoyo  
Maximum number of queues: 1000000  
Put position of queue (1st lap): 45  
Get position of queue (1st lap): 6  
Number of unread queue: 39

如果“队列写入点值”大于“最大队列数量值”，将重置“队列写入点”为1，即又从1开始存储新的队列内容，覆盖原来队列位置点的内容：

HTTP Simple Queue Service v1.7  
\------------------------------  
Queue Name: xoyo  
Maximum number of queues: 1000000  
Put position of queue (2st lap): 4562  
Get position of queue (1st lap): 900045  
Number of unread queue: 104517

以浏览器为例：  
　　 [![点击在新窗口中浏览此图片][status.png]][status.png]

--------------------

(4)、查看队列状态（JSON方式，便于程序处理返回内容）：  
  
　　从HTTPSQS 1.3版本开始支持此功能。  
  
　　HTTP GET 协议（以curl命令为例）：

curl "http://host:port/?name=your\_queue\_name&opt=status\_json&auth=mypass123"

返回（示例）：

\{"name":"xoyo","maxqueue":1000000,"putpos":45,"putlap":1,"getpos":6,"getlap":1,"unread":39\}

如果“队列写入点值”大于“最大队列数量值”，将重置“队列写入点”为1，即又从1开始存储新的队列内容，覆盖原来队列位置点的内容：

\{"name":"xoyo","maxqueue":1000000,"putpos":4562,"putlap":2,"getpos":900045,"getlap":1,"unread":104517\}

--------------------

(5)、查看指定队列位置点的内容：  
  
　　跟一般的队列系统不同的是，HTTPSQS 可以查看指定队列ID（队列点）的内容，包括未出、已出的队列内容。可以方便地观测进入队列的内容是否正确。  
  
　　另外，假设有一个发送手机短信的队列，由客户端守护进程从队列中取出信息，并调用“短信网关接口”发送短信。但是，如果某段时间“短信网关接口”有故障，而这段时间队列位置点300~900的信息已经出队列，但是发送短信失败，我们还可以在位置点300~900被覆盖前，查看到这些位置点的内容，作相应的处理。  
  
　　HTTP GET 协议（以curl命令为例）：

curl "http://host:port/?charset=utf-8&name=your\_queue\_name&opt=view&pos=5&auth=mypass123"

curl "http://host:port/?charset=gb2312&name=your\_queue\_name&opt=view&pos=19&auth=mypass123"

pos >=1 并且 <= 1000000000  
  
　　返回指定队列位置点的内容。

--------------------

(6)、重置指定队列：  
  
　　HTTP GET 协议（以curl命令为例）：

curl "http://host:port/?name=your\_queue\_name&opt=reset&auth=mypass123"

如果重置成功，返回：

HTTPSQS\_RESET\_OK

如果重置失败，返回：

HTTPSQS\_RESET\_ERROR

--------------------

(7)、更改指定队列的最大队列数量：  
  
　　默认的最大队列长度（100万条）：1000000  
  
　　HTTP GET 协议（以curl命令为例）：

curl "http://host:port/?name=your\_queue\_name&opt=maxqueue&num=1000000000&auth=mypass123"

num >=10 并且 <= 1000000000  
  
　　如果更改最大队列数量成功，则返回：

HTTPSQS\_MAXQUEUE\_OK

更改的最大队列数量必须大于当前的“队列写入点”。另外，当“队列写入点”小于“队列读取点”时（即PUT位于圆环的第二圈，而GET位于圆环的第一圈时），本操作将被取消，然后返回给客户端以下信息：

HTTPSQS\_MAXQUEUE\_CANCEL

--------------------

(8)、不停止服务的情况下，修改定时刷新内存缓冲区内容到磁盘的间隔时间：  
  
　　从HTTPSQS 1.3版本开始支持此功能。  
  
　　默认间隔时间：5秒 或 httpsqs -s <second> 参数设置的值。  
  
　　HTTP GET 协议（以curl命令为例）：

curl "http://host:port/?name=your\_queue\_name&opt=synctime&num=10&auth=mypass123"

num >=1 and <= 1000000000  
  
　　如果修改间隔时间成功，则返回：

HTTPSQS\_SYNCTIME\_OK

如果 num 不在 1 ～ 1000000000 之间，本操作将被取消，然后返回给客户端以下信息：

HTTPSQS\_SYNCTIME\_CANCEL

--------------------

(9)、密码校验失败：  
  
　　从HTTPSQS 1.5版本开始支持此功能。  
  
　　如果密码校验失败（/?auth=xxx），将返回以下信息：

HTTPSQS\_AUTH\_FAILED

--------------------

(10)、全局错误：  
  
　　如果发生全局错误（即指令、参数错误等），将返回以下信息：

HTTPSQS\_ERROR

--------------------

6、HTTPSQS 客户端  
  
　　(1)、PHP 客户端说明文档：  
  
　　A、PHP 客户端扩展（第三方提供，详情请访问： [http://code.google.com/p/php-httpsqs-client/][http_code.google.com_p_php-httpsqs-client] ）  
  
　　 B、PHP 客户端 Class 文件（官方提供：适用于 HTTPSQS 1.7 以上版本，推荐使用。）  
  
　　查看 PHP Class 源代码： [httpsqs\_client.php][httpsqs_client.php]  
  
　　PHP Client 所有函数使用示例： [test\_example.php][test_example.php]  
  
　　PHP Client 命令行运行示例： [test\_commandline.php][test_commandline.php]  
  
　　用法：

[view plain][] [print][view plain] [?][view plain]

1.  <?php  
2.  include\_once("httpsqs\_client.php");   
3.  $httpsqs = new httpsqs($httpsqs\_host, $httpsqs\_port, $httpsqs\_auth, $httpsqs\_charset);   
4.     
5.  /\*  
6.  1. 将文本信息放入一个队列（注意：如果要放入队列的PHP变量是一个数组，需要事先使用序列化、json\_encode等函数转换成文本） 
7.      如果入队列成功，返回布尔值：true  
8.      如果入队列失败，返回布尔值：false  
9.  \*/   
10. $result = $httpsqs\->put($queue\_name, $queue\_data);   
11.    
12. /\*  
13. 2. 从一个队列中取出文本信息 
14.     返回该队列的内容 
15.     如果没有未被取出的队列，则返回文本信息：HTTPSQS\_GET\_END 
16.     如果发生错误，返回布尔值：false  
17. \*/   
18. $result = $httpsqs\->get($queue\_name);   
19.   
20. /\*  
21. 3. 从一个队列中取出文本信息和当前队列读取点Pos 
22.     返回数组示例：array("pos" => 7, "data" => "text message") 
23.     如果没有未被取出的队列，则返回数组：array("pos" => 0, "data" => "HTTPSQS\_GET\_END") 
24.     如果发生错误，返回布尔值：false 
25. \*/   
26. $result = $httpsqs\->gets($queue\_name);  
27.   
28. /\*  
29. 4. 查看队列状态（普通方式） 
30. \*/   
31. $result = $httpsqs\->status($queue\_name);  
32.   
33. /\*  
34. 5. 查看队列状态（JSON方式） 
35.     返回示例：\{"name":"queue\_name","maxqueue":5000000,"putpos":130,"putlap":1,"getpos":120,"getlap":1,"unread":10\} 
36. \*/   
37. $result = $httpsqs\->status\_json($queue\_name);  
38.    
39. /\*  
40. 6. 查看指定队列位置点的内容 
41.     返回指定队列位置点的内容。 
42. \*/   
43. $result = $httpsqs\->view($queue\_name, $queue\_pos);  
44.    
45. /\*  
46. 7. 重置指定队列 
47.     如果重置队列成功，返回布尔值：true  
48.     如果重置队列失败，返回布尔值：false  
49. \*/   
50. $result = $httpsqs\->reset($queue\_name);  
51.    
52. /\*  
53. 8. 更改指定队列的最大队列数量 
54.    如果更改成功，返回布尔值：true 
55.    如果更改操作被取消，返回布尔值：false 
56. \*/   
57. $result = $httpsqs\->maxqueue($queue\_name, $num);  
58.   
59. /\* 
60. 9. 修改定时刷新内存缓冲区内容到磁盘的间隔时间 
61.    如果更改成功，返回布尔值：true 
62.    如果更改操作被取消，返回布尔值：false 
63. \*/  
64. $result = $httpsqs\->synctime($num);  
65. ?>

--------------------

(2)、Perl 客户端说明文档（第三方提供，作者：[tonny0830][]）：  
  
　　查看Perl客户端源代码： [perl client][]

HttpSQS 模块参数说明  
开发平台：CentOS 5.4  
Perl版本：5.8.8  
Editor: VIM  
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#  
new 方法：  
  
参数个数：4个  
  
参数说明：  
  1.HttpSQS-服务器IP地址。  
  2.HttpSQS-工作端口号。  
  3.Proto-连接服务器协议类型，TCP 还是UDP. 默认是TCP连接。  
  4.Charset-字符集。默认是UTF-8。  
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#  
put方法：  
  
参数个数：2个  
  
传递参数：  
  1.队列名  
    2.以POST方式提交的字符串  
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#  
get方法：  
  
参数个数：1个  
  
传递参数：  
    1.队列名  
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#  
status方法：  
  
参数个数：1个  
  
传递参数：  
    1.队列名  
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#  
view方法：  
  
参数个数：2个  
  
传递参数：  
    1.队列名  
    2.查看队列的编号  
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#  
reset方法：  
  
参数个数：1个  
  
传递参数：  
    1.队列名  
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#  
maxqueue方法：  
  
参数个数：2个  
  
传递参数：  
    1.队列名  
    2.指定的最大队列数  
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#  
pput方法：  
  
参数个数：2个  
  
传递参数：  
    1.队列名  
    2.POST方式提交的数据。  
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#  
pget方法：  
  
参数个数：1个  
  
传递参数：  
    1.队列名  
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#  
pstatus方法：  
  
参数个数：1个  
  
传递参数：  
    1.队列名  
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#  
pview方法：  
  
参数个数：2个  
  
传递参数：  
    1.队列名  
    2.查看队列的编号。  
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#  
pmaxqueue方法：  
  
参数个数：2个  
  
传递参数：  
    1.队列名  
    2.指定队列的最大数。  
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#  
preset方法：  
  
参数个数：1个  
  
传递参数：  
    1.队列名  
\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#  
  
使用的例子见：  
httpsqs\_cmdline\_test.pl  
httpsqs\_cmdline\_loop\_test.pl

--------------------

(3)、C 客户端示例（第三方提供，作者：[李博][Link 2]）：  
  
　　查看C客户端示例源代码： [C client][]

--------------------

(4)、Java 客户端  
  
　　A、第一款客户端（推荐）（第三方提供，作者：[Snow Young][]）：  
  
　　下载 1.0 版本： [http://httpsqs.googlecode.com/files/httpsqs4j-java-client-1.0.zip][http_httpsqs.googlecode.com_files_httpsqs4j-java-client-1.0.zip]  
  
　　从SVN下载最新代码：svn checkout  [http://httpsqs.googlecode.com/svn/trunk/client/httpsqs4j/][http_httpsqs.googlecode.com_svn_trunk_client_httpsqs4j]  httpsqs4j  
  
　　帮助文档： [http://blog.zyan.cc/book/httpsqs/client/httpsqs4j/][http_blog.zyan.cc_book_httpsqs_client_httpsqs4j]  
  
  
　　 B、第二款客户端（第三方提供，作者：[李博][Link 2]）：  
  
　　查看Java客户端示例源代码： [Java client][]

--------------------

(5)、Python客户端（第三方提供，作者：[Wendal][]）：  
  
　　下载： [http://wendal.net/261.html][http_wendal.net_261.html]

--------------------

7、HTTPSQS 生产环境典型应用案例架构：  
  
　　 [![点击在新窗口中浏览此图片][httpsqs_error_handling.png]][httpsqs_error_handling.png]  
  
　　一个采用PHP编写的HTTPSQS客户端简单守护进程框架如下：  
  
　　环境，假设PHP安装路径为/usr/local/webserver/php，使用PHP编写一个文件/opt/httpsqs\_client\_daemon.php：

[view plain][] [print][view plain] [?][view plain]

1.  <?php  
2.  include\_once dirname(\_\_FILE\_\_)."/httpsqs\_client.php";     
3.  $httpsqs = new httpsqs($host, $port, $auth, $charset);  
4.  while(true) \{  
5.    $result = $httpsqs\->gets($name);  
6.    $pos = $result\["pos"\]; //当前队列消息的读取位置点  
7.    $data = $result\["data"\]; //当前队列消息的内容  
8.    if ($data != "HTTPSQS\_GET\_END" && $data != "HTTPSQS\_ERROR") \{  
9.      ...去做应用操作...  
10.   \} else \{  
11.     sleep(1); //暂停1秒钟后，再次循环  
12.   \}  
13. \}  
14. ?>

在Linux下，推送到后台执行即可：

nohup /usr/local/webserver/php/bin/php /opt/httpsqs\_client\_daemon.php 2>&1 > /dev/null &

--------------------

8、HTTPSQS 软件版本修改历史：  
  
　　● \[2009年12月29日\] HTTPSQS 1.1 版本发布。这是第一个开源发布版本。  
　　● \[2010年03月18日\] HTTPSQS 1.2 版本发布。 [点击这儿查看该版本的新增功能][Link 3] 。  
　　● \[2010年06月28日\] HTTPSQS 1.3 版本发布。 [点击这儿查看该版本的新增功能][Link 4] 。  
　　● \[2011年04月21日\] HTTPSQS 1.6 版本发布。 [点击这儿查看该版本的新增功能][Link 5] 。  
　　● \[2011年07月26日\] HTTPSQS 1.7 版本发布。 [点击这儿查看该版本的新增功能][Link 6] 。

--------------------

附：本使用文档修改历史  
  
　　● \[2009年12月30日\] \[Version 1.1.0\] HTTPSQS 1.1 版本使用文档。  
　　● \[2010年03月18日\] \[Version 1.2.0\] HTTPSQS 1.2 版本使用文档。增加了 HTTPSQS 1.2 版本新增功能的说明，以及生产环境典型应用案例架构图。  
　　● \[2010年03月19日\] \[Version 1.2.1\] 在第7节中，增加了一个采用PHP编写的HTTPSQS客户端简单守护进程框架代码。  
　　● \[2010年04月07日\] \[Version 1.2.2\] 在第6节中，增加了第三方的C客户端示例和Java客户端示例。  
　　● \[2010年04月30日\] \[Version 1.2.3\] 在第6节中，再增加了一款第三方Java客户端：httpsqs4j。  
　　● \[2010年05月11日\] \[Version 1.2.4\] 解决了在某些Linux系统上，默认动态链接库目录中找不到TC动态链接库的问题：/usr/bin/httpsqs: error while loading shared libraries: libtokyocabinet.so.9: cannot open shared object file: No such file or directory。  
　　● \[2010年06月29日\] \[Version 1.3.0\] HTTPSQS 1.3 版本使用文档。增加了 HTTPSQS 1.3 版本新增功能的说明。  
　　● \[2010年08月26日\] \[Version 1.3.1\] 在第6节中，增加了第三方PHP客户端扩展链接。  
　　● \[2011年04月21日\] \[Version 1.6.0\] HTTPSQS 1.6 版本使用文档。增加了 HTTPSQS 1.6 版本新增功能的说明。  
　　● \[2011年07月26日\] \[Version 1.7.0\] HTTPSQS 1.7 版本使用文档。修复一处BUG，改为动态编译HTTPSQS。  
　　● \[2011年11月04日\] \[Version 1.7.1\] 增加支持 HTTPSQS 1.7 版本的 PHP Client Class。

[http_code.google.com_p_httpsqs]: http://code.google.com/p/httpsqs/
[http_blog.zyan.cc_httpsqs]: http://blog.zyan.cc/httpsqs/
[C10K]: http://www.kegel.com/c10k.html
[httpsqs_elements.png]: /images/20220615/65bcf761ad0e4197bc970926328d8a62.png
[http_code.google.com_p_httpsqs_wiki_BenchmarkTest]: http://code.google.com/p/httpsqs/wiki/BenchmarkTest
[Link 1]: http://www.xoyo.com/
[https_my.xoyo.com]: https://my.xoyo.com/
[http_kbi.xoyo.com]: http://kbi.xoyo.com/
[http_zt.xoyo.com_haixuan]: http://zt.xoyo.com/haixuan/
[http_mail.sina.com.cn]: http://mail.sina.com.cn/
[http_httpsqs.googlecode.com_files_libevent-2.0.12-stable.tar.gz]: http://httpsqs.googlecode.com/files/libevent-2.0.12-stable.tar.gz
[http_httpsqs.googlecode.com_files_tokyocabinet-1.4.47.tar.gz]: http://httpsqs.googlecode.com/files/tokyocabinet-1.4.47.tar.gz
[http_httpsqs.googlecode.com_files_httpsqs-1.7.tar.gz]: http://httpsqs.googlecode.com/files/httpsqs-1.7.tar.gz
[httpsqs.png]: /images/20220615/f465c1685b9140b891b2abb99b541a9a.png
[put.png]: /images/20220615/9aff4638a37c4522a271db0adca1e98e.png
[get.png]: /images/20220615/84e9ba9a46da41c2b7e21d838782a79b.png
[IANA]: http://www.iana.org/assignments/character-sets
[status.png]: /images/20220615/b7bc2c42e1044ad689def29337ce27fc.png
[http_code.google.com_p_php-httpsqs-client]: http://code.google.com/p/php-httpsqs-client/
[httpsqs_client.php]: http://code.google.com/p/httpsqs/source/browse/trunk/client/php/httpsqs_client.php
[test_example.php]: http://code.google.com/p/httpsqs/source/browse/trunk/client/php/test_example.php
[test_commandline.php]: http://code.google.com/p/httpsqs/source/browse/trunk/client/php/test_commandline.php
[view plain]: http://zyan.cc/#
[tonny0830]: http://code.google.com/u/tonny0830/
[perl client]: http://code.google.com/p/httpsqs/source/browse/trunk/client/perl
[Link 2]: http://code.google.com/u/lb13810398408/
[C client]: http://code.google.com/p/httpsqs/source/browse/trunk/client/c
[Snow Young]: https://twitter.com/Snow_Young
[http_httpsqs.googlecode.com_files_httpsqs4j-java-client-1.0.zip]: http://httpsqs.googlecode.com/files/httpsqs4j-java-client-1.0.zip
[http_httpsqs.googlecode.com_svn_trunk_client_httpsqs4j]: http://httpsqs.googlecode.com/svn/trunk/client/httpsqs4j/
[http_blog.zyan.cc_book_httpsqs_client_httpsqs4j]: http://blog.zyan.cc/book/httpsqs/client/httpsqs4j/
[Java client]: http://code.google.com/p/httpsqs/source/browse/trunk/client/java
[Wendal]: http://wendal.net/
[http_wendal.net_261.html]: http://wendal.net/261.html
[httpsqs_error_handling.png]: /images/20220615/aba99b6bbb42419683f03abfb79ee53e.png
[Link 3]: http://blog.zyan.cc/httpsqs_1_2/
[Link 4]: http://blog.zyan.cc/httpsqs_1_3/
[Link 5]: http://blog.zyan.cc/httpsqs_1_6/
[Link 6]: http://blog.zyan.cc/httpsqs_1_7/