使用apidoc为你的项目编写api文档

在使用apidoc之前，我一直使用wiki来写文档，后来发现这种方式更新起来比较痛苦，时间一长甚至就忘记了更新了。一直在寻找能够使用注释直接生成文档的程序。某一天同事推荐了apidoc，发现这正是我想要的工具。

apidoc原理

apidoc的原理是扫描你的代码文件，提取出注释部分，根据一些规则生成相应的文档。默认的模板久很美观，十分适合作为api文档的生成器。目前apidoc支持的注释基本涵盖了大部分语言的风格了，c，java，php，js，python，perl，lua, Erlang…

安装

需要使用npm安装，如果没有安装npm，请先去https://www.npmjs.com/下载npm并且安装。安装之后使用如下命令安装apidoc

npm install apidoc -g

开始API文档

通常我们的api的是通过一个方法的调用，在mvc架构的c层。如果一个api是 /foo/bar ,那么可以在相关的方法调用中这样写注释

 

/**
 * @api {GET} /foo/bar 一个测试的接口
 * @apiName  foobar
 * @apiVersion 0.1.0
 * @apiGroup foo
 * @apiDescription 这是一个测试的接口，会输出一个hello world
 */

（更多…）

从融资(融券)，融资买入（融券卖出）量，资融(融券)余额看多空博弈

股票市场，除了使用自有资金买卖之外，还可以使用融资和融券的方式去买卖股票。

融资

融资，表示用户看好这只股票，认为会上涨，不惜借钱买入股票，等待上涨之后卖出之后，偿还之前的借款。

举个例子，比如股票10元1股，借10000元可以买入1000股，那么当股票按照期望上涨到11元之后，再卖出就能卖到11000，偿还10000之后盈利1000。

融券

融券，表示用户不看好这只股票，认为会下跌，不惜借股票卖出换钱，等股票下跌之后再买入相同的股票偿还。

举个例子，比如股票10元1股，借1000股之后卖出，当股票按照预期下跌到9元的时候，再买入1000股，只需要花9000，偿还1000股之后，手中盈利1000元。 （更多…）

matplotlib使用：画柱状图

matplotlib画柱状图十分简单，首先需要导入matplotlib中的pyplot，这个就是能够画图的类啦

import matplotlib.pyplot as plt

画柱状图十分简单，使用bar方法，比如画一个各个班级的人数吧，先准备一些数据，有两组数据，students为人数，这里放到y坐标系中，变量x就放在x坐标系中

students = [42,51,30,49]
x = [1,2,3,4]

好了，现在我们可以直接画出来，调用bar方法，最后再调用show就能画图啦，代码如下

plt.bar(x=x, height=students)
plt.show()

完整代码如下

#coding:utf-8
import matplotlib.pyplot as plt

students = [42,51,30,49]
x = [1,2,3,4]

plt.bar(x=x, height=students)
plt.show()

效果是这样的

（更多…）

SQLAlchemy介绍

SQLAlchemy是python下十分流行的orm(对象关系映射)框架。官方的介绍是这样的：

SQLAlchemy将数据库视为关系代数引擎，而不仅仅是表的集合。行不仅可以从表中选择，还可以选择连接其他的选择语句; 这些单元中的任一个可以组成更大的结构。SQLAlchemy的核心表达语言正是基于这个概念。

SQLAlchemy以其对象关系映射器（ORM）而闻名，它提供一个数据映射器模式的可选组件，其中可以通过多种方式将类映射到数据库，实际上对象模型和数据库模式从一开始就可以完整分离。

SQLAlchemy的对这些问题的总体思路来源于其它优秀的 SQL/ORM 工具，植根于所谓的完全不同complimentarity-导向的方法; 而不是隐藏SQL并将对象的关系细节隐藏在自动化的墙壁之后，所有进程都被完全暴露在一系列可组合的透明工具中。该库负责自动执行冗余任务，而开发人员仍然可以控制数据库的组织方式以及SQL的构建方式。

SQLAlchemy的主要目标是改变您对数据库和SQL的思考方式！

记一次进程异常退出的问题排查

机器搬家之后，之前一直稳定的PHP多进程程序子进程突然异常退出，但是退出的不是很频繁，查看进程日志并也没有发现有什么导致退出的，问题比较诡异。于是开启了一段问题排查之路。

首先查看内核日志，使用dmesg，拉到最后发现有一些这样的错误，看来确实是崩溃了。

[4791991.998535] php[16776]: segfault at 7f6443ee18c8 ip 00007f6443ee18c8 sp 00007fff4d4ba818 error 15 in libc-2.17.so[7f6443ee1000+2000]
[4792165.192628] php[609]: segfault at 0 ip 000000000075919d sp 00007fff0c6e0578 error 4 in php[400000+94b000]
[4792423.164949] traps: php[2337] general protection ip:75919d sp:7fff0c6e0578 error:0 in php[400000+94b000]
[4793914.900298] traps: php[589] general protection ip:7576b6 sp:7fff0c6e0460 error:0 in php[400000+94b000]
[4794155.124685] php[25418]: segfault at 35007265746c ip 000000000075919d sp 00007fff0c6e0578 error 4 in php[400000+94b000]
[4794677.119847] traps: php[2314] general protection ip:75959b sp:7fff4d4ba840 error:0 in php[400000+94b000]
[4795121.747090] php[4642]: segfault at 0 ip 000000000075919d sp 00007fff0c6e0578 error 4 in php[400000+94b000]
[4795666.787427] php[2372]: segfault at 40 ip 000000000075958c sp 00007fff0c6e0500 error 4 in php[400000+94b000]
[4796212.001686] php[6224]: segfault at 10 ip 000000000075919d sp 00007fff0c6e0578 error 4 in php[400000+94b000]
[4796224.510583] traps: php[6156] general protection ip:75919d sp:7fff0c6e0578 error:0 in php[400000+94b000]
[4796337.623455] php[562]: segfault at 247ec40 ip 000000000247ec40 sp 00007fff0c6e04d8 error 15
[4796427.436886] php[1711]: segfault at ffffffffffffffff ip 00000000007576b6 sp 00007fff0c6e0460 error 5 in php[400000+94b000]
[4796554.025960] php[6662]: segfault at 6b6f01000040 ip 000000000075958c sp 00007fff0c6e0500 error 4 in php[400000+94b000]
[4797141.552356] php[6658]: segfault at 18 ip 0000000000758daf sp 00007fff0c6e04d0 error 4 in php[400000+94b000]
[4797495.302089] php[7239]: segfault at 110 ip 00000000007576d2 sp 00007fff0c6e0460 error 4 in php[400000+94b000]
[4797867.446166] php[8265]: segfault at 247e730 ip 000000000247e730 sp 00007fff0c6e04d8 error 15
[4798245.596106] php[8223]: segfault at 247ef40 ip 000000000247ef40 sp 00007fff0c6e04d8 error 15
[4798514.326132] traps: php[8152] general protection ip:75919d sp:7fff0c6e0578 error:0 in php[400000+94b000]
[4798769.904337] traps: php[7255] general protection ip:7576d2 sp:7fff0c6e0460 error:0 in php[400000+94b000]
[4799427.934198] php[2297]: segfault at 17b57d0 ip 00000000017b57d0 sp 00007fff4d4ba838 error 15
[4800091.548467] php[9826]: segfault at 247ed10 ip 000000000247ed10 sp 00007fff0c6e04d8 error 15
[4800607.342570] php[11239]: segfault at 100000007 ip 000000000075919d sp 00007fff0c6e0578 error 4 in php[400000+94b000]
[4800806.439680] php[9796]: segfault at 247ec90 ip 000000000247ec90 sp 00007fff0c6e04d8 error 15
[4801110.909591] php[8317]: segfault at 247ed20 ip 000000000247ed20 sp 00007fff0c6e04d8 error 15
[4801417.477197] php[9326]: segfault at 0 ip 00000000007576d2 sp 00007fff0c6e0460 error 4 in php[400000+94b000]

运气不错，现在居然就有眉目了。上面的信息一般是内存访问越界导致的。现在找一条看看 （更多…）

发布composer包到packagist让所有人都能用

创建了composer包之后，要让所有人都能使用你的包，就必须要发布到packagist上。

首选你的包需要使用git

大多数人可能都有github了，进入packagist的提交页面：https://packagist.org/packages/submit，输入包的github地址，提交即可。

使用hook自动更新

当提交了github之后，想让你的包自动更新可以使用webhook。按照相应的提示去设置就可以了。

创建自己的composer包之怎样制作composer包

项目做多了之后，可能会慢慢总结出自己的代码库出来，当在新的项目中使用的时候，总不能一直是复制粘贴。这个时候，composer就能派上用场了。一个项目开始，使用composer就能够加载所需要的依赖，非常方便。这个时候，来做一个自己的包吧！

使用命名空间

composer自动加载需要用到命名空间，因此所有的代码库都需要使用命名空间，如果没有，那就改吧！使用命名空间之后你可能会打开新世界的大门。

创建composer.json

我假设你已经安装了composer，并且已经会使用了。创建自己的包我们首先需要创建一个composer.json，示例文件如下

{
    "name": "cmhc/tests",
    "description": "a test",
    "type": "library",
    "license": "MIT",
    "authors": [
        {
            "name": "huchao",
            "email": "hu_chao@139.com"
        }
    ],
    "minimum-stability": "stable",
    "require": {},
    "autoload":{
        "psr-4":{
            "test\\":"src/"
        }
    }
}

上面的composer.json有一个比较重要的是autoload，这个表示的是根据某种规范实现自动加载，使用psr4。key为这个包的根命名空间，value为根命名空间的文件夹。 （更多…）

xshell 部分版本存在后门 登录凭证或将被泄露

刚收到邮件，说Xshell官方提供的多个版本存在后门，会向 nylalobghyhirgh.com 发送登录凭证信息。

已知受影响的版本为：

Xshell Build 5.0.1322

Xshell Build 5.0.1325

Xmanager Enterprise 5.0 Build 1232

Xmanager 5.0 Build 1045

Xftp 5.0 Build 1218

Xftp 5.0 Build 1221

Xlpd 5.0 Build 1220

 

已知不受影响的版本为：

Xmanager Enterprise Build 1236

Xmanager Build 1049

Xshell Build 1326

Xftp Build 1222

Xlpd Build 1224

Xshell是一款强大、著名的终端模拟软件，被广泛的用于服务器运维和管理,Xshell支持SSH，SFTP，TELNET，RLOGIN和SERIAL功能。它提供业界领先的性能和强大功能，在免费终端模拟软件中有着不可替代的地位。企业版中拥有更专业的功能其中包括:标签式的环境、动态端口转发、自定义键映射、用户定义按钮、VB脚本和用于显示2 byte字符和支持国际语言的UNICODE终端。

Xshell提供许多用户友好的，在其他终端终端模拟软件没有的功能。这些功能包括:通过拖放文件进行Zmodem文件上传，简单模式，全屏模式，透明度选项和自定义布局模式下载Zmodem文件。使用Xshell执行终端任务节省时间和精力。

近日，安全公司发现官方发布的软件版本中，nssock2.dll模块源码被植入后门。目前xshell最高版本为 Xshell 5 Build 1326 该版本更新于2017年8月5日。

如需继续使用请升级到官方的最新版本 1326， 相关下载链接：https://www.netsarang.com/download/down_xsh.html

锤子线

锤子线，多么好的一个名词，看到锤子线，就仿佛市场上面有一只锤子正在夯实股市的底部，让股价不再跌下去了。

锤子线的出现一般是看涨的，看到锤子线，意味着该买入了。但是一定要记住，锤子线的出现只是表示未来几天内可能会有涨。

锤子线的特征

1.实体很短，下影线很长，超过实体的两倍以上，无上影线或者上影线很短

2.出现在连续的跌势之后

3.锤子线的颜色任意 （更多…）

查看varnish统计信息命令：varnishstat

varnishstat是一个查看当前varnish实例的实时运行状态信息。命令以及参数如下：

varnishstat [-1] [-f <glob>] [-h] [-j] [-l] [-n <dir>] [-N <filename>] [-t <seconds | off>] [-V ] [-X]

以下选项可用：

-1 不再显示不断更新的显示，而是将统计信息打印到stdout。
-f <glob> Field inclusion glob. Use backslash to escape characters. If the argument starts with ‘^’ it is used as an exclusion glob. Multiple -f arguments may be given, and they will be applied in order.
-h 显示帮助信息
-j 统计信息为JSON格式输出到stdout。
-l 列出与-f选项一起使用的可用字段。
-n <dir> 指定varnishd工作目录（也称为实例名称）以获取日志。如果未指定-n，则使用主机名。
-N <filename> 指定一个陈旧的VSM实例的文件名。使用此选项时，放弃检查被禁用。
-t <seconds|off>
在初始VSM连接返回错误之前超时。如果设置VSM连接在0.5秒钟内重试这段时间。如果为零，则仅尝试连接一次，如果不成功，将立即失败。如果设置为“关闭”，连接将不会失败，允许该实用程序启动并等待不明确地显示该Varnish实例。默认为5秒。
-V 打印版本信息
-x 输出xml格式到stdout

在服务端使用varnishstat命令之后，会出现如下输出，并且每秒刷新一次。 （更多…）