git tag应用笔记(转) 作者: nbboy 时间: 2020-06-23 分类: 默认分类,软件工程 评论 ### tag主要作用 我们可以创建一个tag来指向软件开发中的一个关键时期，比如版本号更新的时候可以建一个“v2.0”、“v3.1”之类的标签，这样在以后回顾的时候会比较方便。 tag的使用很简单，主要操作有：查看tag、创建tag、验证tag以及共享tag。 ### 查看tag ```shell // 查看tag，列出所有tag，列出的tag是按字母排序的，和创建时间没关系。 $ git tag v0.1 v1.3 ``` ```shell //查看指定版本的tag，git tag -l “v1.4.2.**” $ git tag -l 'v1.4.2.*' v1.4.2.1 v1.4.2.2 v1.4.2.3 v1.4.2.4 ``` ### 显示tag信息 ```shell //显示指定tag的信息 $ git show v1.4 tag v1.4 Tagger: Scott Chacon <schacon@gee-mail.com> Date: Mon Feb 9 14:45:11 2009 -0800 my version 1.4 commit 15027957951b64cf874c3557a0f3547bd83b3ff6 Merge: 4a447f7... a6b4c97... Author: Scott Chacon <schacon@gee-mail.com> Date: Sun Feb 8 19:02:46 2009 -0800 Merge branch 'experiment' ``` ### 创建tag ```shell //创建轻量级tag：这样创建的tag没有附带其他信息 git tag v1.0 ``` ```shell //带信息的tag：-m后面带的就是注释信息，这样在日后查看的时候会很有用 git tag -a v1.0 -m 'first version' ``` ### 共享tag ```shell //我们在执行 git push 的时候，tag是不会上传到服务器的，比如现在的github，创建 tag 后 git push ，在github网页上是看不到tag 的，为了共享这些tag，你必须这样： git push origin v1.0 或者 //将所有tag 一次全部push到github上。 git push origin --tags ``` ### 删除tag ```shell //删除本地tag git tag -d v1.0 //删除github远端的指定tag git push origin :refs/tags/v1.0.0 ``` ### 创建一个基于指定tag的分支 ```shell git checkout -b tset v0.1.0 ``` 使用git checkout tag即可切换到指定tag，例如：git checkout v0.1.0 切换到tag历史记录会处在分离头指针状态，这个时候修改是很危险的，在切换回主线时如果没有合并，之前的修改提交基本都会丢失，如果需要修改可以尝试git checkout -b branch tag创建一个基于指定tag的分支，例如：git checkout -b tset v0.1.0 这个时候就会在分支上进行开发，之后可以切换到主线合并. ### 附带福利 [非常棒的极其简单GIT指南](https://www.bootcss.com/p/git-guide/ "非常棒的极其简单GIT指南") [比较完善的Git基础教程](https://www.liaoxuefeng.com/wiki/896043488029600 "比较完善的Git基础教程")
git stash应用笔记(转) 作者: nbboy 时间: 2020-06-23 分类: 默认分类,软件工程 评论 ### stash当前修改 git stash会把所有未提交的修改（包括暂存的和非暂存的）都保存起来，用于后续恢复当前工作目录。 比如下面的中间状态，通过git stash命令推送一个新的储藏，当前的工作目录就干净了。 ```shell $ git status On branch master Changes to be committed: new file: style.css Changes not staged for commit: modified: index.html $ git stash Saved working directory and index state WIP on master: 5002d47 our new homepage HEAD is now at 5002d47 our new homepage $ git status On branch master nothing to commit, working tree clean ``` 需要说明一点，stash是本地的，不会通过git push命令上传到git server上。 实际应用中推荐给每个stash加一个message，用于记录版本，使用git stash save取代git stash命令。示例如下： ```shell $ git stash save "test-cmd-stash" Saved working directory and index state On autoswitch: test-cmd-stash HEAD 现在位于 296e8d4 remove unnecessary postion reset in onResume function $ git stash list stash@{0}: On autoswitch: test-cmd-stash ``` ### 重新应用缓存的stash 可以通过git stash pop命令恢复之前缓存的工作目录，输出如下： ```shell $ git status On branch master nothing to commit, working tree clean $ git stash pop On branch master Changes to be committed: new file: style.css Changes not staged for commit: modified: index.html Dropped refs/stash@{0} (32b3aa1d185dfe6d57b3c3cc3b32cbf3e380cc6a) ``` 这个指令将缓存堆栈中的第一个stash删除，并将对应修改应用到当前的工作目录下。 你也可以使用git stash apply命令，将缓存堆栈中的stash多次应用到工作目录中，但并不删除stash拷贝。命令输出如下： ```shell $ git stash apply On branch master Changes to be committed: new file: style.css Changes not staged for commit: modified: index.html ``` ### 查看现有stash 可以使用git stash list命令，一个典型的输出如下： ```shell $ git stash list stash@{0}: WIP on master: 049d078 added the index file stash@{1}: WIP on master: c264051 Revert "added file_size" stash@{2}: WIP on master: 21d80a5 added number to log ``` 在使用git stash apply命令时可以通过名字指定使用哪个stash，默认使用最近的stash（即stash@{0}）。 ### 移除stash 可以使用git stash drop命令，后面可以跟着stash名字。下面是一个示例： ```shell $ git stash list stash@{0}: WIP on master: 049d078 added the index file stash@{1}: WIP on master: c264051 Revert "added file_size" stash@{2}: WIP on master: 21d80a5 added number to log $ git stash drop stash@{0} Dropped stash@{0} (364e91f3f268f0900bc3ee613f9f733e82aaed43) ``` 或者使用git stash clear命令，删除所有缓存的stash。 ### 查看指定stash的diff 可以使用git stash show命令，后面可以跟着stash名字。示例如下： ```shell $ git stash show index.html | 1 + style.css | 3 +++ 2 files changed, 4 insertions(+) ``` 在该命令后面添加-p或--patch可以查看特定stash的全部diff，如下： ```shell $ git stash show -p diff --git a/style.css b/style.css new file mode 100644 index 0000000..d92368b --- /dev/null +++ b/style.css @@ -0,0 +1,3 @@ +* { + text-decoration: blink; +} diff --git a/index.html b/index.html index 9daeafb..ebdcbd2 100644 --- a/index.html +++ b/index.html @@ -1 +1,2 @@ +<link rel="stylesheet" href="style.css"/> ``` ### 从stash创建分支 如果你储藏了一些工作，暂时不去理会，然后继续在你储藏工作的分支上工作，你在重新应用工作时可能会碰到一些问题。如果尝试应用的变更是针对一个你那之后修改过的文件，你会碰到一个归并冲突并且必须去化解它。如果你想用更方便的方法来重新检验你储藏的变更，你可以运行 git stash branch，这会创建一个新的分支，检出你储藏工作时的所处的提交，重新应用你的工作，如果成功，将会丢弃储藏。 ```shell $ git stash branch testchanges Switched to a new branch "testchanges" # On branch testchanges # Changes to be committed: # (use "git reset HEAD <file>..." to unstage) # # modified: index.html # # Changes not staged for commit: # (use "git add <file>..." to update what will be committed) # # modified: lib/simplegit.rb # Dropped refs/stash@{0} (f0dfc4d5dc332d1cee34a634182e168c4efc3359) ``` 这是一个很棒的捷径来恢复储藏的工作然后在新的分支上继续当时的工作。 ### 暂存未跟踪或忽略的文件 默认情况下，git stash会缓存下列文件： 添加到暂存区的修改（staged changes） Git跟踪的但并未添加到暂存区的修改（unstaged changes） 但不会缓存一下文件： 在工作目录中新的文件（untracked files） 被忽略的文件（ignored files） git stash命令提供了参数用于缓存上面两种类型的文件。使用-u或者--include-untracked可以stash untracked文件。使用-a或者--all命令可以stash当前目录下的所有修改。 至于git stash的其他命令建议参考Git manual。
php7性能分析(转) 作者: nbboy 时间: 2020-06-18 分类: PHP 评论 xhprof Xhprof是facebook开源出来的一个php轻量级的性能分析工具，跟Xdebug类似，但性能开销更低，还可以用在生产环境中，也可以由程序开关来控制是否进行profile。 xhprof for PHP7 xhprof已经不维护很久了，同事他也不再支持php7.这对我学习性能测试造成了困扰，好在有这个xhprof for PHP7的开源项目，供大家一起使用。 适配PHP版本 7.0 7.1 7.2 安装 git clone https://github.com/longxinH/xhprof.git ./xhprof cd xhprof/extension/ phpize ./configure --with-php-config=/path/to/php7/bin/php-config make && sudo make install 出现 Installing shared extensions: /opt/php-7.0.14/lib/php/extensions/no-debug-non-zts-20151012/ 代表编译成功 编译过程问题 configure: error: Cannot find php-config. Please use --with-php-config=PATH configure: error: Cannot find php-config. Please use –with-php-config=PATH 一般出现这个错误说明你执行 ./configure 时 –with-php-config 这个参数配置路径错误导致的。 查找: find / -name php-config 修改为： ./configure --with-php-config=/usr/local/php/bin/php-config 就可以解决问题，上面的 /usr/local/php/ 是你的 php 安装路径。 配置 添加配置项到php.ini [xhprof] extension=xhprof.so xhprof.output_dir=/Users/machuang/Desktop/project/xhprof/save_output_dir//此处你就留一个存放xhprof记录文件的目录ok了 创建目录 mkdir -p /Users/machuang/Desktop/project/xhprof/save_output_dir 重启php-fpm, php.ini就生效了 machuangdeMacBook-Pro:7.1 machuang$ fpm -n Gracefully shutting down php-fpm -n . done -n Starting php-fpm done 项目地址 https://github.com/longxinH/xhprof 使用 植入xhprof 此处写个脚本就OK，文件命名为b.php。 <?php //1.开启xhprof xhprof_enable(); //2.你需要分析的代码 for($i=1;$i<1000;$i++){ if($i%100 == 0){ echo $i; echo "<br>"; } } //3.关闭xhprof,收集数据 $xhprof_data = xhprof_disable(); include_once './xhprof/xhprof_lib/utils/xhprof_lib.php'; include_once './xhprof/xhprof_lib/utils/xhprof_runs.php'; $xhprof_runs = new XHProfRuns_Default(); $run_id = $xhprof_runs->save_run($xhprof_data, "xhprof_test"); echo "<br>"; echo $run_id;die; //将run_id保存起来或者随代码一起输出 使用php内置部署工具 php -S 127.0.0.1:9001 在浏览器运行脚本 打开：http://127.0.0.1:9001/b.php 输出： 100 200 300 400 500 600 700 800 900 5ad88171addf9 查看结果 在浏览器输入url，HOST为你的项目当前域名，get参数run的值为$run_id HOST/xhpfrof_html/index.php?run=58d3b28b521f6&source=xhprof_test 打开：http://127.0.0.1:9001/xhprof/xhprof_html/ 可见生成的文件，点击一个打开，url地址变为 http://127.0.0.1:9001/xhprof/xhprof_html/index.php?run=5ad88171addf9&source=xhprof_test Function Name Calls Calls% Incl. Wall Time (microsec) IWall% Excl. Wall Time (microsec) EWall% main() 1 50.0% 3 100.0% 3 100.0% xhprof_disable 1 50.0% 0 0.0% 0 0.0% xhprof_enable的参数控制 HPROF_FLAGS_NO_BUILTINS 跳过所有内置（内部）函数。 XHPROF_FLAGS_CPU 输出的性能数据中添加 CPU 数据。 XHPROF_FLAGS_MEMORY 输出的性能数据中添加内存数据。 结果分析 xhprof_html/index.php将记录的结果整理并可视化，默认的UI里列出了： funciton name ： 函数名 calls: 调用次数 Incl. Wall Time (microsec)： 函数运行时间（包括子函数） IWall%：函数运行时间（包括子函数）占比 Excl. Wall Time(microsec)：函数运行时间（不包括子函数） EWall%：函数运行时间（不包括子函数） 在xhprof_html/index.php中还可以看到[View Full Callgraph]链接，点击后可以绘制出一张可视化的性能分析图，如果点击后报错的话，可能是缺少依赖graphviz， graphviz是一个绘制图形的工具，可以更为直观的让你查看性能的瓶颈。 优化读取测试数据 graphviz https://graphviz.gitlab.io/download/ macbook上的安装很简单，brew就可以。 brew install graphviz 安装成功，brew会帮你配置graphviz，所以后面可以直接使用。点击 [View Full Callgraph] ，可以更直观查看所有的性能测试信息。 XHProf报告含义 XHProf报告中有许多列，它们代表的含义见下表： 列名 描述 Function Name 方法名称。 Calls 方法被调用的次数。 Calls% 方法调用次数在同级方法总数调用次数中所占的百分比。 Incl.Wall Time(microsec) 方法执行花费的时间，包括子方法的执行时间。（单位：微秒） IWall% 方法执行花费的时间百分比。 Excl. Wall Time(microsec) 方法本身执行花费的时间，不包括子方法的执行时间。（单位：微秒） EWall% 方法本身执行花费的时间百分比。 Incl. CPU(microsecs) 方法执行花费的CPU时间，包括子方法的执行时间。（单位：微秒） ICpu% 方法执行花费的CPU时间百分比。 Excl. CPU(microsec) 方法本身执行花费的CPU时间，不包括子方法的执行时间。（单位：微秒） ECPU% 方法本身执行花费的CPU时间百分比。 Incl.MemUse(bytes) 方法执行占用的内存，包括子方法执行占用的内存。（单位：字节） IMemUse% 方法执行占用的内存百分比。 Excl.MemUse(bytes) 方法本身执行占用的内存，不包括子方法执行占用的内存。（单位：字节） EMemUse% 方法本身执行占用的内存百分比。 Incl.PeakMemUse(bytes) Incl.MemUse峰值。（单位：字节） IPeakMemUse% ncl.MemUse峰值百分比。 Excl.PeakMemUse(bytes) Excl.MemUse峰值。单位：（字节） EPeakMemUse% Excl.MemUse峰值百分比。 php框架中使用 此处我们有比较优雅的注入方式，首先，把xhprof项目放到laravel项目的public目录下， 然后在index.php的最上面加入如下代码： ini_set('xhprof.output_dir',dirname(__DIR__).'/xhprof_save_dir'); //echo ini_get('xhprof.output_dir'); die; $xhprof_lib_dir = dirname(__DIR__).'/public/xhprof/xhprof_lib/utils/xhprof_lib.php'; $xhprof_runs_dir = dirname(__DIR__).'/public/xhprof/xhprof_lib/utils/xhprof_runs.php'; include_once $xhprof_lib_dir; include_once $xhprof_runs_dir; //开启xhprof xhprof_enable(XHPROF_FLAGS_MEMORY ); //在程序结束后收集数据 register_shutdown_function(function() { $xhprof_data = xhprof_disable(); //让数据收集程序在后台运行 if (function_exists('fastcgi_finish_request')) { fastcgi_finish_request(); } //保存 $xhprof_runs = new XHProfRuns_Default(); $xhprof_runs->save_run($xhprof_data, "xhprof_crm"); }); 然后，在xhprof/xhprof_html/index.php增加一行代码，如下： ini_set('xhprof.output_dir',dirname(dirname(dirname(__DIR__))).'/xhprof_save_dir'); 这是为了保证数据的存储和读取目录一致。 打开类似链接，即可看到测试数据分析了 http://xhprof.your-laravel.app/xhprof/xhprof_html/index.php?run=5adeaebf97d31&source=xhprof_crm 数据如下 Overall Summary Total Incl. Wall Time (microsec): 818,313 microsecs Total Incl. MemUse (bytes): 10,521,952 bytes Total Incl. PeakMemUse (bytes): 10,435,224 bytes Number of Function Calls: 56,935
从线上宕机引起的问题谈开去 作者: nbboy 时间: 2020-06-18 分类: 默认分类,PHP 评论 ### 背景 公司的外网线上项目连续宕机将近2周时间，后来通过查找日志，发现是某度蜘蛛大量爬取造成。因为公司花钱进行了SEO推广，所以也不能直接禁掉蜘蛛，所以一度造成网站打不开的情况。期间增加带宽，扩容cpu,增强搜索引擎集群等方案，都得不到好的效果。 ### 分析 开始优化代码，记录慢日志，在云平台看慢查询，渐渐优化慢查询，但是问题依旧。慢慢通过分析慢日志注意到如下细节：  这里我摘取了两个日志片段，其实类似日志片段还有非常多。可以看到将近相同的时间不同的许多进程都进行了GC,而这里的所谓GC是什么？ 在StartSession.php上看到了如下代码: ```php /** * Remove the garbage from the session if necessary. * * @param \Illuminate\Session\SessionInterface $session * @return void */ protected function collectGarbage(SessionInterface $session) { $config = $this->manager->getSessionConfig(); // Here we will see if this request hits the garbage collection lottery by hitting // the odds needed to perform garbage collection on any given request. If we do // hit it, we'll call this handler to let it delete all the expired sessions. if ($this->configHitsLottery($config)) { $session->getHandler()->gc($this->getSessionLifetimeInSeconds()); } } ``` 这里注释的意思是有一定概率进行GC,并不是每次都进行GC,先来看下GC做了什么事情。 因为配置的是文件session,所以我们找到文件Session的实现文件FileSessionHandler.php,摘取GC函数代码如下: ```php /** * {@inheritdoc} */ public function gc($lifetime) { $files = Finder::create() ->in($this->path) ->files() ->ignoreDotFiles(true) ->date('<= now - '.$lifetime.' seconds'); foreach ($files as $file) { $this->files->delete($file->getRealPath()); } } ``` 代码的意思很简单，就是通过搜索文件，获取到过期的session文件然后进行删除，这里的过期时间在session.php的配置里定义： ```php /* |-------------------------------------------------------------------------- | Session Lifetime |-------------------------------------------------------------------------- | | Here you may specify the number of minutes that you wish the session | to be allowed to remain idle before it expires. If you want them | to immediately expire on the browser closing, set that option. | */ 'lifetime' => 120, 'expire_on_close' => true, ``` 可以看到默认是2个小时，下面一个参数的意义是是否要在浏览器关闭的时候立即过期！刚才说到了，有一定概率执行这个GC,那这个概率多大呢？ ```php /** * Determine if the configuration odds hit the lottery. * * @param array $config * @return bool */ protected function configHitsLottery(array $config) { return random_int(1, 100) <= 2; } ``` 上面代码是我把默认配置替换后的结果，也就是会有2%的可能会触发一次GC!而一次GC我们要回收两个小时之前的过期session文件。如果在并发量稍微有点大的情况下，要删除的文件其实是非常可观的，删除这个IO操作就是直接导致了cpu负荷直接超载的罪魁祸首。 ### 解决方案 方法很简单，就是换driver,比如集中式的redis session方案。 ### 总结 虽然这次项目的主要负责人不是我，不过通过这次抓取日志，跟踪代码，分析代码学到了很多优化的一手资料。Laravel其实是一个相当灵活的框架，文件session方式只能在测试环境进行应用，而在线上环境必须上集中式session方式，不然流量起来的时候，就会吃苦头。Laravel如不经过优化的情况下，他的性能是不高的，好在他也提供了很多可以优化的扩展接口，算的上是目前PHP里相当成熟的框架了。
Beanstalkd协议中文翻译(转) 作者: nbboy 时间: 2020-06-17 分类: 默认分类 评论 总括 beanstalkd协议基于ASCII编码运行在tcp上。客户端连接服务器并发送指令和数据，然后等待响应并关闭连接。对于每个连接，服务器按照接收命令的序列依次处理并响应。所有整型值都非负的十进制数，除非有特别声明。 名称约定 所有名称必须是ASCII码字符串，即包括： 字母 (A-Z and a-z) 数字 (0-9) 连字符 ("-") 加号 ("+") 斜线 ("/") 分号 (";") 点 (".") 美元符 ("$") 下划线 ("_") 括号 ("(" and ")") 注意：名称不能以连字符开始，并且是以空白字符结束，每个名称至少包含一个字符。 错误说明 返回的错误 描述 OUT_OF_MEMORY\r\n 服务器没有足够的内存分配给特定的job，客户端应该稍后重试 INTERNAL_ERROR\r\n 服务器内部错误，该错误不应该发生，如果发生了，请报告：http://groups.google.com/group/beanstalk-talk. BAD_FORMAT\r\n 格式不正确，客户端发送的指令格式出错，有可能不是以\r\n结尾，或者要求整型值等等 UNKNOWN_COMMAND\r\n 未知的命令，客户端发送的指令服务器不理解 job的生命周期 一个工作任务job当client使用put命令时创建。在整个生命周期中job可能有四个工作状态：ready，reserved，delayed，buried。在put之后，一个job的典型状态是ready，在ready队列中，它将等待一个worker取出此job并设置为其为reserved状态。worker占有此job并执行，当job执行完毕，worker可以发送一个delete指令删除此job。 Status Description ready 等待被取出并处理 reserved 如果job被worker取出，将被此worker预订，worker将执行此job delayed 等待特定时间之后，状态再迁移为ready状态 buried 等待唤醒，通常在job处理失败时 job典型的生命周期 put reserve delete -----> [READY] ---------> [RESERVED] --------> *poof* job可能的状态迁移 put with delay release with delay ----------------> [DELAYED] <------------. | | kick | (time passes) | | | put v reserve | delete -----------------> [READY] ---------> [RESERVED] --------> *poof* ^ ^ | | | \ release | | | `-------------' | | | | kick | | | | bury | [BURIED] <---------------' | | delete `--------> *poof* Tubes 一个服务器有一个或者多个tubes，用来储存统一类型的job。每个tube由一个就绪队列与延迟队列组成。每个job所有的状态迁移在一个tube中完成。consumers消费者可以监控感兴趣的tube，通过发送watch指令。consumers消费者可以取消监控tube，通过发送ignore命令。通过watch list命令返回所有监控的tubes，当客户端预订一个job，此job可能来自任何一个它监控的tube。 当一个客户端连接上服务器时，客户端监控的tube默认为defaut，如果客户端提交job时，没有使用use命令，那么这些job就存于名为default的tube中。 tube按需求创建，无论他们在什么时候被引用到。如果一个tube变为空（即no ready jobs，no delayed jobs，no buried jobs）和没有任何客户端引用，它将会被自动删除。 指令说明（Commands） 生产者指令说明（Producer Commands） put 插入一个job到队列 put <pri> <delay> <ttr> <bytes>\r\n <data>\r\n <pri> 整型值，为优先级，可以为0-2^32（4,294,967,295），值越小优先级越高，默认为1024。 <delay> 整型值，延迟ready的秒数，在这段时间job为delayed状态。 <ttr> -- time to run --整型值，允许worker执行的最大秒数，如果worker在这段时间不能delete，release，bury job，那么job超时，服务器将release此job，此job的状态迁移为ready。最小为1秒，如果客户端指定为0将会被重置为1。 <bytes> 整型值，job body的长度，不包含\r\n，这个值必须小于max-job-size，默认为2^16。 <data> job body 响应 INSERTED <id>\r\n 表示插入job成功，id为新job的任务标识，整型值 BURIED <id>\r\n 如服务器为了增加队列的优先级而，内存不足时返回，id为新job的任务标识，整型值 EXPECTED_CRLF\r\n job body必须以\r\n结尾 JOB_TOO_BIG\r\n job body的长度超过max-job-size DRAINING\r\n 表示服务器资源耗尽，表示服务器已经进入了“drain mode”，服务器再也不能接受连接，客户端应该使用另一个服务器或者断开稍后重试 use 说明 producer生产者使用，随后使用put命令，将job放置于对应的tube 格式 use <tube>\r\n tube tube的名称，最大为200字节，不存在时将自动创建 响应 USING <tube>\r\n tube为正在使用的tube名称 消费者指令说明（Worker Commands） reserve 说明 取出（预订）job，待处理。它将返回一个新预订的job，如果没有job，beanstalkd将直到有job时才发送响应。一旦job状态迁移为reserved,取出job的client被限制在指定的时间（如果设置了ttr）完成，否则超时，job状态重装迁移为ready。 格式 reserve\r\n 可选的一个相似的命令 reserve-with-timeout \r\n 设置取job的超时时间，timeout设置为0时，服务器立即响应或者TIMED_OUT，积极的设置超时，将会限制客户端阻塞在取job的请求的时间。 失败响应 DEADLINE_SOON\r\n 在一个预定的任务的运行时间内,最后一秒会被服务器保持为一个安全边际，在此期间，客户端将无法等候另外一个任务。 如果客户端在安全隔离期间发出一个预留命令，或者安全隔离期到了,客户端在等候一个预定命令。 TIMED_OUT\r\n 超时 成功响应 RESERVED <id> <bytes>\r\n <data>\r\n 成功取出job，id为job id,整型值，job body的长度，不包含\r\n，data为job body delete 说明 从队列中删除一个job 格式 delete <id>\r\n id为job id 响应 DELETED\r\n 删除成功 NOT_FOUND\r\n job不存在时，或者job的状态不为ready和buried（这种情况是在job执行超时之前，client发送了delete指令） release 说明 release指令将一个reserved的job放回ready queue。它通常在job执行失败时使用。 格式 release <id> <pri> <delay>\r\n id 为job id，pri为job的优先级，delay为延迟ready的秒数 响应 RELEASED\r\n 表明成功 BURIED\r\n 如服务器为了增加队列的优先级而，内存不足时返回 NOT_FOUND\r\n 如果job不存在或者client没有预订此job bury 说明 将一个job的状态迁移为buried，通过kick命令唤醒 格式 bury <id> <pri>\r\n id为job id，pri为优先级 响应 BURIED\r\n 表明成功 NOT_FOUND\r\n 如果job不存在或者client没有预订此job touch 说明 允许worker请求更多的时间执行job，这个很有用当job需要很长的时间来执行，worker可用周期的告诉服务器它仍然在执行job（可以被DEADLINE_SOON触发） 格式 touch <id>\r\n id为job id 响应 TOUCHED\r\n 表明成功 NOT_FOUND\r\n 如果job不存在或者client没有预订此job watch 说明 添加监控的tube到watch list列表，reserve指令将会从监控的tube列表获取job，对于每个连接，监控的列表默认为default 格式 watch <tube>\r\n tube 为监控的tube名称，名称最大为200字节，如果tube不存在会自动创建 响应 WATCHING <count>\r\n 表明成功 count 整型值，已监控的tube数量 ignore 说明 从已监控的watch list列表中移出特定的tube 格式 ignore <tube>\r\n tube 为移出的tube名称，名称最多为200字节，如果tube不存在会自动创建 响应 WATCHING <count>\r\n 表明成功 count 整型值，已监控的tube数量 NOT_IGNORED\r\n 如果client企图忽略其仅有的tube时的响应 其他指令说明（Other Command） peek 说明 让client在系统中检查job，有四种形式的命令，其中第一种形式的指令是针对当前使用的tube 格式 peek <id>\r\n 返回id对应的job peek-ready\r\n 返回下一个ready job peek-delayed\r\n 返回下一个延迟剩余时间最短的job peek-buried\r\n 返回下一个在buried列表中的job 响应 NOT_FOUND\r\n 如果job不存在，或者没有对应状态的job FOUND <id> <bytes>\r\n <data>\r\n id 为对应的job id bytes job body的字节数 data 为job body kick 说明 此指令应用在当前使用的tube中，它将job的状态迁移为ready或者delayed 格式 kick <bound>\r\n bound 整型值，唤醒的job上限 响应 KICKED <count>\r\n count 为真实唤醒的job数量 kick-job 说明 kick指令的一个变体，可以使单个job被唤醒，使一个状态为buried或者delayed的job迁移为ready，所有的状态迁移都在相同的tube中完成 格式 kick-job <id>\r\n id 为job id 响应 NOT_FOUND\r\n 如果job不存在，或者job是不可唤醒的状态 KICKED\r\n 表明成功 stats-job 说明 统计job的相关信息 格式 stats-job <id>\r\n id 为job id 响应 NOT_FOUND\r\n 如果job不存在 OK <bytes>\r\n<data>\r\n bytes 为接下来的data区块的长度 data 为YAML file的统计信息 其中YAML file包括的key有： id 表示job id tube 表示tube的名称 state 表示job的当前状态 pri 表示job的优先级 age 表示job创建的时间单位秒 delay 是延迟job放入ready队列的整数秒数 ttr 指允许worker执行job的整数秒数 time-left 表示job的状态迁移为ready的时间，仅在job状态为reserved或者delayed时有意义，当job状态为reserved时表示剩余的超时时间。 file 表示包含此job的binlog序号，如果没有开启它将为0 reserves 表示job被reserved的次数 timeouts 表示job处理的超时时间 releases 表示job被released的次数 buries 表示job被buried的次数 kicks 表示job被kiced的次数 stats-tube 说明 统计tube的相关信息 格式 stats-tube <tube>\r\n tube 为对应的tube的名称，最多为200字节 响应 NOT_FOUND\r\n 如果tube不存在 OK <bytes>\r\n<data>\r\n bytes 为接下来的data区块的长度 data 为YAML file的统计信息 其中YAML file包括的key有： name 表示tube的名称 current-jobs-urgent 此tube中优先级小于1024状态为ready的job数量 current-jobs-ready 此tube中状态为ready的job数量 current-jobs-reserved 此tube中状态为reserved的job数量 current-jobs-delayed 此tube中状态为delayed的job数量 current-jobs-bureid 此tube中状态为buried的job数量 total-jobs 此tube中创建的所有job数量 current-using 使用此tube打开的连接数 current-wating 使用此tube打开连接并且等待响应的连接数 current-watching 打开的连接监控此tube的数量 pause 此tube暂停的秒数 cmd-delete 此tube中总共执行的delete指令的次数 cmd-pause-tube 此tube中总共执行pause-tube指令的次数 pause-time-left 此tube暂停剩余的秒数 stats 说明 返回整个消息队列系统的整体信息 格式 stats\r\n 响应 OK <bytes>\r\n<data>\r\n bytes 为接下来的data区块的长度 data 为YAML file的统计信息 其中YAML file包括的key有（所有的信息都累积的，自从beanstalkd进程启动以来，这些信息不储存在binlog中）： current-jobs-urgent 优先级小于1024状态为ready的job数量 current-jobs-ready 状态为ready的job数量 current-jobs-reserved 状态为reserved的job数量 current-jobs-delayed 状态为delayed的job数量 current-jobs-bureid 状态为buried的job数量 cmd-put 总共执行put指令的次数 cmd-peek 总共执行peek指令的次数 cmd-peek-ready 总共执行peek-ready指令的次数 cmd-peek-delayed 总共执行peek-delayed指令的次数 cmd-peek-buried 总共执行peek-buried指令的次数 cmd-reserve 总共执行reserve指令的次数 cmd-use 总共执行use指令的次数 cmd-watch 总共执行watch指令的次数 cmd-ignore 总共执行ignore指令的次数 cmd-release 总共执行release指令的次数 cmd-bury 总共执行bury指令的次数 cmd-kick 总共执行kick指令的次数 cmd-stats 总共执行stats指令的次数 cmd-stats-job 总共执行stats-job指令的次数 cmd-stats-tube 总共执行stats-tube指令的次数 cmd-list-tubes 总共执行list-tubes指令的次数 cmd-list-tube-used 总共执行list-tube-used指令的次数 cmd-list-butes-watched 总共执行list-tubes-watched指令的次数 cmd-pause-tube 总共执行pause-tube指令的次数 job-timeouts 所有超时的job的总共数量 total-jobs 创建的所有job数量 max-job-size job的数据部分最大长度 current-tubes 当前存在的tube数量 current-connections 当前打开的连接数 current-producers 当前所有的打开的连接中至少执行一次put指令的连接数量 current-workers 当前所有的打开的连接中至少执行一次reserve指令的连接数量 current-waiting 当前所有的打开的连接中执行reserve指令但是未响应的连接数量 total-connections 总共处理的连接数 pid 服务器进程的id version 服务器版本号 rusage-utime 进程总共占用的用户CPU时间 rusage-stime 进程总共占用的系统CPU时间 uptime 服务器进程运行的秒数 binlog-oldest-index 开始储存jobs的binlog索引号 binlog-current-index 当前储存jobs的binlog索引号 binlog-max-size binlog的最大容量 binlog-records-written binlog累积写入的记录数 binlog-records-migrated is the cumulative number of records written as part of compaction. id 一个随机字符串，在beanstalkd进程启动时产生 hostname 主机名 list-tubes 说明 列表所有存在的tube 格式 list-tubes\r\n 响应 OK <bytes>\r\n <data>\r\n bytes 为接下来的data区块的长度 data 为YAML file，包含所有的tube名称 list-tube-used 说明 列表当前client正在use的tube 格式 list-tube-used\r\n 响应 USING <tube>\r\n tube 为tube名称 list-tubes-watched 说明 列表当前client watch的tube 格式 list-tubes-watched\r\n 响应 OK <bytes>\r\n <data>\r\n bytes 为接下来的data区块的长度 data 为YAML file，包含所有的tube名称 quit 说明 关闭连接 格式 quit\r\n pause-tube 说明 此指令针对特定的tube内所有新的job延迟给定的秒数 格式 pause-tube <tube-name> <delay>\r\n 响应 PAUSED\r\n 表示成功 NOT_FOUND\r\n tube不存在 Translated by PHPBoy :http://www.phpboy.net/ and fzb.me https://github.com/beanstalkd/beanstalkd/blob/master/doc/protocol.zh-CN.md