l1n6yun's Blog

记录学习的技能和遇到的问题

0%

网站性能压力测试是服务器网站性能调优过程中必不可缺少的一环。只有让服务器处在高压情况下,才能真正体现出软件、硬件等各种设置不当所暴露出的问题。

性能测试工具目前最常见的有以下几种:ab、http_load、webbench、siege。今天我们专门来介绍ab。

ab是apache自带的压力测试工具。ab非常实用,它不仅可以对apache服务器进行网站访问压力测试,也可以对或其它类型的服务器进行压力测试。比如nginx、tomcat、IIS等。

ab的原理

ab是apachebench命令的缩写。

ab的原理:ab命令会创建多个并发访问线程,模拟多个访问者同时对某一URL地址进行访问。它的测试目标是基于URL的,因此,它既可以用来测试apache的负载压力,也可以测试nginx、lighthttp、tomcat、IIS等其它Web服务器的压力。

ab命令对发出负载的计算机要求很低,它既不会占用很高CPU,也不会占用很多内存。但却会给目标服务器造成巨大的负载,其原理类似CC攻击。自己测试使用也需要注意,否则一次上太多的负载。可能造成目标服务器资源耗完,严重时甚至导致死机。

ab的安装

ab的安装非常简单,如果是源码安装apache的话,那就更简单了。apache安装完毕后ab命令存放在apache安装目录的bin目录下。如下:

1
/usr/local/apache2/bin

如果apache 是通过yum的RPM包方式安装的话,ab命令默认存放在/usr/bin目录下。如下:

1
2
$ which ab
/usr/bin/ab

注意:如果不想安装apache但是又想使用ab命令的话,我们可以直接安装apache的工具包httpd-tools。如下:

1
$ yum -y install httpd-tools

查看ab是否安装成功,可以切换到上述目录下,使用ab –V命令进行检测。如下:

1
2
3
4
$ ab -V
This is ApacheBench, Version 2.3 <$Revision: 1874286 $>
Copyright 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
Licensed to The Apache Software Foundation, http://www.apache.org/

如果ab安装成功,通过 ab –V 命令则会显示ab的相迎版本。

ab参数说明

有关ab命令的使用,我们可以通过帮助命令进行查看。如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
$ ab --help
ab: wrong number of arguments
Usage: ab [options] [http://]hostname[:port]/path
Options are:
-n requests Number of requests to perform
-c concurrency Number of multiple requests to make at a time
-t timelimit Seconds to max. to spend on benchmarking
This implies -n 50000
-s timeout Seconds to max. wait for each response
Default is 30 seconds
-b windowsize Size of TCP send/receive buffer, in bytes
-B address Address to bind to when making outgoing connections
-p postfile File containing data to POST. Remember also to set -T
-u putfile File containing data to PUT. Remember also to set -T
-T content-type Content-type header to use for POST/PUT data, eg.
'application/x-www-form-urlencoded'
Default is 'text/plain'
-v verbosity How much troubleshooting info to print
-w Print out results in HTML tables
-i Use HEAD instead of GET
-x attributes String to insert as table attributes
-y attributes String to insert as tr attributes
-z attributes String to insert as td or th attributes
-C attribute Add cookie, eg. 'Apache=1234'. (repeatable)
-H attribute Add Arbitrary header line, eg. 'Accept-Encoding: gzip'
Inserted after all normal header lines. (repeatable)
-A attribute Add Basic WWW Authentication, the attributes
are a colon separated username and password.
-P attribute Add Basic Proxy Authentication, the attributes
are a colon separated username and password.
-X proxy:port Proxyserver and port number to use
-V Print version number and exit
-k Use HTTP KeepAlive feature
-d Do not show percentiles served table.
-S Do not show confidence estimators and warnings.
-q Do not show progress when doing more than 150 requests
-l Accept variable document length (use this for dynamic pages)
-g filename Output collected data to gnuplot format file.
-e filename Output CSV file with percentages served
-r Don't exit on socket receive errors.
-m method Method name
-h Display usage information (this message)

下面我们对这些参数,进行相关说明。如下:

选项 描述
-n 在测试会话中所执行的请求个数。默认时,仅执行一个请求。
-c 一次产生的请求个数。默认是一次一个。
-t 测试所进行的最大秒数。其内部隐含值是-n 50000,它可以使对服务器的测试限制在一个固定的总时间以内。默认时,没有时间限制。
-p 包含了需要POST的数据的文件。
-P 对一个中转代理提供BASIC认证信任。用户名和密码由一个:隔开,并以base64编码形式发送。无论服务器是否需要(即, 是否发送了401认证需求代码),此字符串都会被发送。
-T POST数据所使用的Content-type头信息。
-v 设置显示信息的详细程度-4或更大值会显示头信息,3或更大值可以显示响应代码(404,200等),2或更大值可以显示警告和其他信息。
-V 显示版本号并退出。
-w 以HTML表的格式输出结果。默认时,它是白色背景的两列宽度的一张表。
-i 执行HEAD请求,而不是GET。
-x 设置<table>属性的字符串。
-X 对请求使用代理服务器。
-y 设置<tr>属性的字符串。
-z 设置<td>属性的字符串。
-C 对请求附加一个Cookie:行。其典型形式是name=value的一个参数对,此参数可以重复。
-H 对请求附加额外的头信息。此参数的典型形式是一个有效的头信息行,其中包含了以冒号分隔的字段和值的对(如,”Accept-Encoding:zip/zop;8bit”)。
-A 对服务器提供BASIC认证信任。用户名和密码由一个:隔开,并以base64编码形式发送。无论服务器是否需要(即,是否发送了401认证需求代码),此字符串都会被发送。
-h 显示使用方法。
-d 不显示”percentage served within XX [ms] table”的消息(为以前的版本提供支持)。
-e 产生一个以逗号分隔的(CSV)文件,其中包含了处理每个相应百分比的请求所需要(从1%到100%)的相应百分比的(以微妙为单位)时间。由于这种格式已经“二进制化”,所以比’gnuplot’格式更有用。
-g 把所有测试结果写入一个’gnuplot’或者TSV(以Tab分隔的)文件。此文件可以方便地导入到Gnuplot,IDL,Mathematica,Igor甚至Excel中。其中的第一行为标题。
-i 执行HEAD请求,而不是GET。
-k 启用HTTP KeepAlive功能,即在一个HTTP会话中执行多个请求。默认时,不启用KeepAlive功能。
-q 如果处理的请求数大于150,ab每处理大约10%或者100个请求时,会在stderr输出一个进度计数。此-q标记可以抑制这些信息。

ab性能指标

在进行性能测试过程中有几个指标比较重要:

  1. 吞吐率(Requests per second)

    服务器并发处理能力的量化描述,单位是reqs/s,指的是在某个并发用户数下单位时间内处理的请求数。某个并发用户数下单位时间内能处理的最大请求数,称之为最大吞吐率。
    记住:吞吐率是基于并发用户数的。这句话代表了两个含义:

    1. 吞吐率和并发用户数相关
    2. 不同的并发用户数下,吞吐率一般是不同的

    计算公式:总请求数/处理完成这些请求数所花费的时间,即
    Request per second=Complete requests/Time taken for tests
    必须要说明的是,这个数值表示当前机器的整体性能,值越大越好。

  2. 并发连接数(The number of concurrent connections)

    并发连接数指的是某个时刻服务器所接受的请求数目,简单的讲,就是一个会话。

  3. 并发用户数(Concurrency Level)

    要注意区分这个概念和并发连接数之间的区别,一个用户可能同时会产生多个会话,也即连接数。在HTTP/1.1下,IE7支持两个并发连接,IE8支持6个并发连接,FireFox3支持4个并发连接,所以相应的,我们的并发用户数就得除以这个基数。

  4. 用户平均请求等待时间(Time per request)

    计算公式:处理完成所有请求数所花费的时间/(总请求数/并发用户数),即:
    Time per request=Time taken for tests/(Complete requests/Concurrency Level)

  5. 服务器平均请求等待时间(Time per request:across all concurrent requests)

    计算公式:处理完成所有请求数所花费的时间/总请求数,即:
    Time taken for/testsComplete requests
    可以看到,它是吞吐率的倒数。
    同时,它也等于用户平均请求等待时间/并发用户数,即
    Time per request/Concurrency Level

ab实际使用

ab的命令参数比较多,我们经常使用的是-c和-n参数。

下面我们就实际进行操作下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
$ ab -c 10 -n 100 http://www.baidu.com/
This is ApacheBench, Version 2.3 <$Revision: 1874286 $>
Copyright 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
Licensed to The Apache Software Foundation, http://www.apache.org/

Benchmarking www.baidu.com (be patient).....done


Server Software: BWS/1.1
Server Hostname: www.baidu.com
Server Port: 80

Document Path: /
Document Length: 347961 bytes

Concurrency Level: 10
Time taken for tests: 4.771 seconds
Complete requests: 100
Failed requests: 97
(Connect: 0, Receive: 0, Length: 97, Exceptions: 0)
Total transferred: 34933333 bytes
HTML transferred: 34811246 bytes
Requests per second: 20.96 [#/sec] (mean)
Time per request: 477.127 [ms] (mean)
Time per request: 47.713 [ms] (mean, across all concurrent requests)
Transfer rate: 7150.00 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 36 44 5.5 43 66
Processing: 181 396 65.9 399 589
Waiting: 39 91 48.2 85 330
Total: 223 440 66.3 443 629

Percentage of the requests served within a certain time (ms)
50% 443
66% 462
75% 469
80% 475
90% 509
95% 551
98% 608
99% 629
100% 629 (longest request)

-c 10 表示并发用户数为10

`-n100 表示请求总数为100

http://www.baidu.com/ 表示请求的目标URL

这行表示同时处理100个请求并运行10次。

测试结果也一目了然,apache测试出的吞吐率为:Requests per second: 20.96 [#/sec] (mean)

除此之外还有其他一些信息,需要说明下,如下:

Server Software 表示被测试的Web服务器软件名称。

Server Hostname 表示请求的URL主机名。

Server Port 表示被测试的Web服务器软件的监听端口。

Document Path 表示请求的URL中的根绝对路径,通过该文件的后缀名,我们一般可以了解该请求的类型。

Document Length 表示HTTP响应数据的正文长度。

Concurrency Level 表示并发用户数,这是我们设置的参数之一。

Time taken for tests 表示所有这些请求被处理完成所花费的总时间。

Complete requests 表示总请求数量,这是我们设置的参数之一。

Failed requests 表示失败的请求数量,这里的失败是指请求在连接服务器、发送数据等环节发生异常,以及无响应后超时的情况。如果接收到的HTTP响应数据的头信息中含有2XX以外的状态码,则会在测试结果中显示另一个名为“Non-2xx responses”的统计项,用于统计这部分请求数,这些请求并不算在失败的请求中。

Total transferred 表示所有请求的响应数据长度总和,包括每个HTTP响应数据的头信息和正文数据的长度。注意这里不包括HTTP请求数据的长度,仅仅为web服务器流向用户PC的应用层数据总长度。

HTML transferred 表示所有请求的响应数据中正文数据的总和,也就是减去了Total transferred中HTTP响应数据中的头信息的长度。

Requests per second 吞吐率,计算公式:Complete requests/Time taken for tests

Time per request 用户平均请求等待时间,计算公式:Time token for tests/(Complete requests/Concurrency Level)。

Time per requet (across all concurrent request)服务器平均请求等待时间,计算公式:Time taken for tests/Complete requests,正好是吞吐率的倒数。也可以这么统计:Time per request/Concurrency Level。

Transfer rate 表示这些请求在单位时间内从服务器获取的数据长度,计算公式:Total trnasferred/ Time taken for tests,这个统计很好的说明服务器的处理能力达到极限时,其出口宽带的需求量。

Percentage of the requests served within a certain time (ms)这部分数据用于描述每个请求处理时间的分布情况,比如以上测试,80%的请求处理时间都不超过6ms,这个处理时间是指前面的Time per request,即对于单个用户而言,平均每个请求的处理时间。

测试京东性能

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
$ ab -c 10 -n 100 http://www.jd.com/
This is ApacheBench, Version 2.3 <$Revision: 1874286 $>
Copyright 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
Licensed to The Apache Software Foundation, http://www.apache.org/

Benchmarking www.jd.com (be patient).....done


Server Software: nginx
Server Hostname: www.jd.com
Server Port: 80

Document Path: /
Document Length: 138 bytes

Concurrency Level: 10
Time taken for tests: 1.734 seconds
Complete requests: 100
Failed requests: 0
Non-2xx responses: 100
Total transferred: 42300 bytes
HTML transferred: 13800 bytes
Requests per second: 57.66 [#/sec] (mean)
Time per request: 173.433 [ms] (mean)
Time per request: 17.343 [ms] (mean, across all concurrent requests)
Transfer rate: 23.82 [Kbytes/sec] received

Connection Times (ms)
min mean[+/-sd] median max
Connect: 13 17 2.8 16 23
Processing: 15 146 30.4 150 189
Waiting: 15 88 44.5 91 182
Total: 29 163 30.8 168 206

Percentage of the requests served within a certain time (ms)
50% 168
66% 176
75% 179
80% 182
90% 189
95% 195
98% 204
99% 206
100% 206 (longest request)

通过上图,测试结果也一目了然,京东测试出的吞吐率为:Requests per second:57.66 [#/sec] (mean)

composer 是 PHP 的依赖管理工具,本篇文章就来说明如何构建一个包,并提交到 Packagist ,这样别人就可以方便地通过 composer 使用你的包了。

初始化

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
# composer init


Welcome to the Composer config generator



This command will guide you through creating your composer.json config.

Package name (<vendor>/<name>) [l1n6yun/hello]: l1n6yun/hello
Description []: This is a demo package
Author [l1n6yun <l1n6yun@gmail.com>, n to skip]:
Minimum Stability []: dev
Package Type (e.g. library, project, metapackage, composer-plugin) []: library
License []: MIT

Define your dependencies.

Would you like to define your dependencies (require) interactively [yes]? no
Would you like to define your dev dependencies (require-dev) interactively [yes]? no
Add PSR-4 autoload mapping? Maps namespace "L1n6yun\Hello" to the entered relative path. [src/, n to skip]:

{
"name": "l1n6yun/hello",
"description": "This is a demo package",
"type": "library",
"license": "MIT",
"autoload": {
"psr-4": {
"L1n6yun\\Hello\\": "src/"
}
},
"authors": [
{
"name": "l1n6yun",
"email": "l1n6yun@gmail.com"
}
],
"minimum-stability": "dev",
"require": {}
}

Do you confirm generation [yes]?
Generating autoload files
Generated autoload files
PSR-4 autoloading configured. Use "namespace L1n6yun\Hello;" in src/
Include the Composer autoloader with: require 'vendor/autoload.php';

Package name

包的名称。它是由供应商名称和项目名称组成,由 / 隔开。

Description

包的简短描述。用来告诉使用者这个包是干什么用的。

Author

包的作者名。

Minimum Stability

最小稳定版本。越往下,稳定性越高,BUG越少。

  • dev
  • alpha
  • beta
  • RC(补丁)
  • stable

Package Type

包的类型。用于自定义安装逻辑。

  • library:这个是默认设置。它会将文件复制到 vendor 目录
  • project:项目。注意这里的项目不是库。
  • metapackage:一个包含需求的空包,会触发 他们的安装,但不包含文件,不会向 文件系统。 因此,它不需要 dist 或 source 键 可安装。
  • composer-plugin:类型的包 composer-plugin可以提供一个 具有自定义类型的其他软件包的安装程序。

License

包的许可证。 这可以是字符串或字符串数组。

最常见许可证

  • Apache-2.0
  • BSD-2-Clause
  • BSD-3-Clause
  • BSD-4-Clause
  • GPL-2.0-only / GPL-2.0-or-later
  • GPL-3.0-only / GPL-3.0-or-later
  • LGPL-2.1-only / LGPL-2.1-or-later
  • LGPL-3.0-only / LGPL-3.0-or-later
  • MIT

闭源项目可以使用 proprietary

撸码

在项目的 src 目录下创建 Tools

1
2
3
4
5
6
7
8
9
10
11
<?php

namespace L1n6yun\Hello;

class Tools
{
public static function hello()
{
echo 'Hello, World!';
}
}

测试一下

1
2
3
4
5
6
# php -a
Interactive shell

php > require 'vendor/autoload.php';
php > L1n6yun\Hello\Tools::hello();
Hello, World!

发布

上传代码

添加 .gitignore 文件,来忽略不需要的文件

1
2
3
.idea/
/vendor/
composer.lock

自行上传到自己的 GitHub 上

提交包

Packagist 上的 提交页面 填写自己的仓库地址,点击 Check ,然后点击 Submit 不出意外的话就发布成功了。

upload successful

简介

Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯。 它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的HTML文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。

特点

  • 轻量化
  • 跨平台
  • 易读易写

文件后缀名

  • .md
  • .markdown

Markdown语法

文字样式

描述 代码 效果
斜体 *斜体*
_斜体_
斜体
斜体
粗体 **粗体** 粗体
斜粗体 ***斜粗体*** 斜粗体
删除线 ~~删除线~~ 删除线
插入链接 [链接名称](链接地址 “标题”) 链接名称
插入图片 ![alt](图片地址 “标题”) alt text
代码行 `print()` print()
HTML 元素 <kbd> <b> <i> <em> <sup> <sub> 使用 Ctrl+C 复制
emoji :hammer: :hammer:

标题

1
2
3
4
5
6
7
8
9
10
11
12
一级标题
======

二级标题
-------

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

有序列表

1
2
3
4
5
6
7
1. 列表条目1
2. 列表条目2
1. 列表条目2.1
1. 列表条目2.1.1
2. 列表条目2.1.2
3. 列表条目2.2
4. 列表条目3
  1. 列表条目1
  2. 列表条目2
    1. 列表条目2.1
    2. 列表条目2.2
      1. 列表条目2.2.1
      2. 列表条目2.2.2
      3. 列表条目2.2.3
    3. 列表条目2.3
  3. 列表条目3

无需列表

1
2
3
4
5
6
7
- 列表条目1
- 列表条目2
- 列表条目2.1
- 列表条目2.1.1
- 列表条目2.1.2
- 列表条目2.2
- 列表条目3
  • 列表条目1
  • 列表条目2
    • 列表条目2.1
      • 列表条目2.1.1
      • 列表条目2.1.2
    • 列表条目2.2
  • 列表条目3

代码块

1
2
3
```[语言]
代码块
```
1
echo ("hello,world");

引用

1
2
> 引用内容
>> 引用内容

引用内容

引用内容

分割线

1
2
3
4
5
***
* * *
*****
- - -
----------





表格

左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

大纲

[toc]

公式

$$
f(x)=sin(x)+12
$$

$$
\begin{Bmatrix}
a & b \
c & d
\end{Bmatrix}
$$

$$
\begin{CD}
A @>a>> B \
@VbVV @AAcA \
C @= D
\end{CD}
$$

流程图、时序图、甘特图

1、横向流程图源码格式:

1
2
3
4
5
6
graph LR
A[方形] -->B(圆角)
B --> C{条件a}
C -->|a=1| D[结果1]
C -->|a=2| E[结果2]
F[横向流程图]

2、竖向流程图源码格式:

1
2
3
4
5
6
graph TD
A[方形] --> B(圆角)
B --> C{条件a}
C --> |a=1| D[结果1]
C --> |a=2| E[结果2]
F[竖向流程图]

3、标准流程图源码格式:

1
2
3
4
5
6
7
8
9
st=>start: 开始框
op=>operation: 处理框
cond=>condition: 判断框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 输入输出框
e=>end: 结束框
st->op->cond
cond(yes)->io->e
cond(no)->sub1(right)->op

4、标准流程图源码格式(横向):

1
2
3
4
5
6
7
8
9
st=>start: 开始框
op=>operation: 处理框
cond=>condition: 判断框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 输入输出框
e=>end: 结束框
st(right)->op(right)->cond
cond(yes)->io(bottom)->e
cond(no)->sub1(right)->op

5、UML时序图源码样例:

1
2
3
4
5
对象A->对象B: 对象B你好吗?(请求)
Note right of 对象B: 对象B的描述
Note left of 对象A: 对象A的描述(提示)
对象B-->对象A: 我很好(响应)
对象A->对象B: 你真的好吗?

6、UML时序图源码复杂样例:

1
2
3
4
5
6
7
8
9
10
11
Title: 标题:复杂使用
对象A->对象B: 对象B你好吗?(请求)
Note right of 对象B: 对象B的描述
Note left of 对象A: 对象A的描述(提示)
对象B-->对象A: 我很好(响应)
对象B->小三: 你好吗
小三-->>对象A: 对象B找我了
对象A->对象B: 你真的好吗?
Note over 小三,对象B: 我们是朋友
participant C
Note right of C: 没人陪我玩

7、UML标准时序图样例:

1
2
3
4
5
6
7
8
9
10
11
12
%% 时序图例子,-> 直线,-->虚线,->>实线箭头
sequenceDiagram
participant 张三
participant 李四
张三->王五: 王五你好吗?
loop 健康检查
王五->王五: 与疾病战斗
end
Note right of 王五: 合理 食物 <br/>看医生...
李四-->>张三: 很好!
王五->李四: 你怎么样?
李四-->王五: 很好!

8、甘特图样例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
%% 语法示例
gantt
dateFormat YYYY-MM-DD
title 软件开发甘特图
section 设计
需求 :done, des1, 2014-01-06,2014-01-08
原型 :active, des2, 2014-01-09, 3d
UI设计 : des3, after des2, 5d
未来任务 : des4, after des3, 5d
section 开发
学习准备理解需求 :crit, done, 2014-01-06,24h
设计框架 :crit, done, after des2, 2d
开发 :crit, active, 3d
未来任务 :crit, 5d
耍 :2d
section 测试
功能测试 :active, a1, after des3, 3d
压力测试 :after a1 , 20h
测试报告 :48h

Boost your productivity with Snipaste

Snipaste is a simple but powerful snipping tool, and also
allows you to pin the screenshot back onto the screen.
Download and start the application, press F1 to start snipping,
then press F3 to paste it as a floating window. That’s it!

You can also convert text or color info in the clipboard into a floating image window.
Such windows can be zoomed, rotated, flipped, made translucent, and even made click-through!
If you are a programmer, a designer or whoever works much time before the computer,
you will be surprised how it can help you get your work done more efficiently!

Snipaste is easy and intuitive to use,
but there are also many hidden features that can make your life even more efficient.
Read the manual
if you are interested.

Intuitive snipping

upload successful

  • Auto detect UI elements
  • Pixel-level control
  • Color picker (try F1, C, F3)
  • History play back (,/.)
  • Multi-screen support
  • HiDPI (retina display) support

Paste images as topmost floating windows

upload successful

  • The source (in the clipboard) could be
    • Image
    • Plain text
    • HTML text
    • Color info text
    • Image files: PNG, JPG, BMP, TGA, ICO, TIFF and GIF
  • Supported operations
    • Zoom (mouse scroll or +/-) or set speed for GIF
    • Rotate (1/2) or jump to previous/next frame for GIF
    • Flip (3/4)
    • Set transparency (Ctrl + mouse scroll or Ctrl + +/-)
    • Mouse click-through (X, and use F4 to cancel)
    • Image editing (Space)
    • Thumbnail mode (Shift + Double click)
    • Hide (Double click)
  • Color picker (Alt)
  • Drag & drop
  • Grouping
  • Auto backup & restore

Easy image annotation

upload successful

  • Rich shapes
    • Rectangle
    • Ellipse
    • Linestrip
    • Arrow
    • Pencil
    • Marker pen
    • Text
  • Advanced annotation tools
    • Mosaic
    • Gaussian blur
    • Eraser
  • Undo & redo

Customization

upload successful

  • Theme color, interface font, tray icon, and more
  • Hot keys
  • Detailed functionality options

顶部选项

Top section

  • 切换网站”可将目前网站加入忽略列表(或从忽略列表中移除)。
  • 开启/关闭”可启用或停用扩展。
  • 点选按键下方的链接以修改快捷键
  • 若切换按键为灰色,则表示浏览器限制脚本注入当前网页。

滤镜设置

Filter settings

可调整各项滤镜数值,以适应您的屏幕参数和室内环境亮度。

个别网站设置

Custom settings

点击“仅适用于”按键将设置值设为仅应用于当前网站。

要使用该功能,请先单击按钮(该按钮将突出显示),然后根据当前网站的需要调整设置。 再次单击按钮以取消。

网站列表

Site list

  • 使用“反色列表”让 Dark Reader 仅对列表中的网站生效。
  • 使用“不反色列表”避免扩展应用于列表中的网站。
  • 可填入 google.commail.google.comgoogle.*google.com/maps 等等。
  • 点击“切换”按键将网站加入相应列表。

更多选项

More tab

  • 从列表选择字体(或在 Firefox 输入字体名称),勾选方框。
  • 调整文字描边
  • 选择主题生成模式

主题生成模式

Filter+ vs. Static vs. Dynamic mode

过滤+、静态、动态模式比较

  • 过滤”是 Dark Reader 最一开始的模式,基于 CSS 滤镜。 网页色彩会全部反转,再回复部分的颜色。 必须用到 GPU 的资源。 虽然渲染快速且有效,但有几个问题: 停用文字的子像素渲染(sub-pixel rendering)、 将已经是暗色的部分转成亮色、 大型页面会发生延迟、 Firefox 会无法渲染某些网页。
  • “**过滤+**”效果和“过滤”一样,但是基于 SVG 滤镜,

色彩处理得更好,让图片不那么呆板。 在 Firefox 上效果不佳。

  • 静态”会迅速生成基本样式表。
  • 动态”会深入分析网站的样式表、背景图片、向量图形。 在网页载入时会占用一些资源, 但能产生最好的视觉效果。 虽然动态模式还在开发中, 但已能顺利应用于许多现代化的网站。

底部选项

Bottom section

  • 阅读我们的隐私政策,关注我们的 Twitter
  • 捐赠”──若您喜欢这个扩展,请考虑支持活跃的 Dark Reader 开发团队。 群众募资由 Open Collective 主导,目前以 Stripe 处理帐款。
  • 新闻”──版本资讯和重要活动的通知。
  • 开发者工具”──对当前主题开启设置编辑器。

使用开发者工具

若您熟悉 CSS 选择器,欢迎对某些网站提供修正建议。 请阅读开发者工具的使用说明

常见问题

为何扩展要求读取网站数据的权限

扩展需要这些权限才能分析和修改网站的外观, 并判断是否要根据您的设置来停用或应用特殊规则。 我们不会插入广告,也不会搜集任何数据,或将数据送到任何地方。 该扩展是完全开源的,没有混淆的代码。 我们的获利是透明的——来自用户捐助。

网上应用店和设置的页面怎么还是白的

本扩展对这些页面没有权限。

新标签页和浏览器主题怎么还是白的

本扩展无法改变新标签页或浏览器外观(但 Firefox 60 以后可以)。 请从网上应用店下载其他暗色主题或新标签页扩展。

开启新标签页或浏览网站时屏幕会闪白光

当载入网页时,Chrome 预设会呈现浏览器主题的背景色, 所以您应该从网上应用店安装暗色主题。

扩展完全无效

如果您有安装其他类似的扩展,请先停用它们,再重新载入标签页。 点击 Dark Reader 图标,检查右上角按键是否已开启。 打开“网站列表”,确认已选取“不反色列表”。 若依然无效,则存在问题,请发 Email 给我们。

网站呈现错误或运行缓慢

请发 Email 告诉我们该网站网址、网页截图、您的操作系统和浏览器版本。 起码对知名网站,我们会试着调查原因。 也请试试看更改“主题生成模式”或使用“明亮模式”。 检查该网站是否不在“网站列表”选项下。

扩展在无痕模式下无效

开启“chrome://extensions”页面,找到“Dark Reader”,点击“在无痕模式下启用”。

扩展对本地文件无效

开启“chrome://extensions”页面,找到“Dark Reader”,点击“允许访问文件网址”。

在“过滤”模式下整个网站没有画面

若您是在 Mac OS 上使用 Chrome,请将 Mac OS 更新至 10.13,此举应该会更新显示驱动程序。 若您使用 Firefox,则很有可能是浏览器漏洞,请改用其他模式。

Async-Await

异步编程的最高境界,就是根本不用关心它异步。

async 函数就是隧道尽头的亮光,很多人认为它是异步操作的终极解决方案。

async-await 与 promise 的关系

不存在谁替代谁,因为 async-await 是寄生于 Promise。Generator 的语法糖。

async :声明一个方法是异步的

await :可以认为是 async wait 的简写,等待一个异步方法执行完成。

基本语法

1
2
3
4
5
async function demo(params){

}

demo()

async 函数返回的是一个 Promise 对象

必须了解的 AsyncFunction console.log(async function(){}.constructor)

在 Chrome 里申明这样一个函数,可以在控制台看到返回的其实就是一个 Promise 对象。

扩展需要了解的就是 Chrome 现在也支持 AsyncFunction , 可以在 Chrome 控制台测试:

1
2
console.log(async function(){}.constructor)
function AsyncFunction()

规则

  1. async 表示这是一个 async 函数,await 只能用在这个函数里面。
  2. await 表示在这里等待 Promise 对象返回结果后,在继续执行。
  3. await 后面跟着的应该是一个 Promise 对象(当然,其他返回值也没关系,只是会立即执行,不过那样就没有意义了)
1
2
3
4
5
async function demo() {
let result = await Promise.resolve(123);
console.log(result);
}
demo();

应用

Promise 虽然一方面解决了 callback 的回调地狱,但是相对的把回调“纵向发展”了,形成了一个回调链。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
function sleep(wait) {
return new Promise((res, rej) => {
setTimeout(() => {
res(wait)
}, wait)
})
}

// 回调地狱
sleep(100).then(result01 => {
return sleep(result01 + 100);
}).then(result02 => {
return sleep(result02 + 100);
}).then(result03 => {
console.log(result03); // 300
})

// 改成async/await写法就是
async function demo(){
// await 是强制把异步变成了同步,这一句代码执行完,才会执行下一句
let result01 = await sleep(100);
let result02 = await sleep(result01 + 100);
let result03 = await sleep(result02 + 100);
return result03;
}

demo().then(result => {
console.log(result); // 300
});

错误处理

既然 .then(...) 不用写了,那么 .catch(...) 也不用写,可以直接用标准的 try catch 语法捕捉错误。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
let p = new Promise((resolve,reject)=>{
setTimeout(()=>{
reject('error')
},1000)
})

async function demo(params){
try{
let result = await p;
}catch(e){
console.log(e)
}
}

demo(); // error

这是基本的错误处理,但是当内部出现错一些错误时,和上面Promise有点类似,demo() 函数不会报错,函数需要catch回调捕捉吗,这就是内部错误被‘静默’处理了。

1
2
3
4
5
6
7
8
9
10
11
12
13
let p = new Promise((resolve,reject) => {
setTimeout(() => {
reject('error');
},1000);
});

async function demo(params) {
let result = await p;
}

demo().catch((err) => {
console.log(err);
})

注意你的并行执行和循环

如果这你想异步发出AJAX请求,使用 await 代码会同步执行,所以 async/await 需要谨慎使用。

await in for 循环:await 的执行上下文必须是 async 函数

现在有一些 .forEach 或者 .map 的循环里,比如在 .forEach 里使用 await , 这时候的上下文就变成了 Array ,而不是 async function ,就会报错。这时候你就要想到是什么错误。

Promise 对象代表了未来将要发生的事件,用来传递异步操作的消息。简单来说就是一个容器,里面保存着某个未来才会结束的事件(通常是一个异步操作的结果)

简介

ECMAscript 6 原生提供了 Promise 对象。

Promise 对象代表了未来将要发生的事件,用来传递异步操作的消息。简单来说就是一个容器,里面保存着某个未来才会结束的事件(通常是一个异步操作的结果)

Promise 对象的基本语法:

1
2
3
4
var promise = new Promise(function(resolve, reject) {
// 异步处理
// 处理结束后、调用resolve 或 reject
});

特点

  1. 对象的状态不受外界影响

    Promise 对象表示一个异步操作,有三种状态

    • pending: 初始状态

    • fulfilled: 操作成功

    • rejected: 操作失败

  2. 一旦状态改变,就不会再变,状态就凝固了

列如:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
var promise = new Promise(function(resolve, reject) {
resolve('success')
console.log('after resolve')
reject('error')
});

promise.then(result => {
console.log(result);
});

promise.catch(result => {
console.log(result);
})

// 运行结果
after resolve
success
Promise { <state>: "fulfilled", <value>: "success" }

resolve 后面的语句其实是可以执行的。那么为什么 reject 的状态信息在下面没有接受到呢?这就是 Promise 对象的状态凝固特点。new 出一个 Promise 对象时,这个对象的起始状态就是 pending 状态,再根据 resolvereject 返回 fulfilled 状态或 rejected 状态。

传递回调

Promise 对象可以调用 promise.then() 方法,传递 resolve , reject 方法的回调。

1
2
3
4
5
6
promise.then(onFulfilled, onRejected)
promise.then(onFulfilled) // 只用于接受 resolve 处理
promise.then(null,onFulfilled) // 只用于接受 reject 处理

// promise简化了对error的处理
promise.then(onFulfilled).catch(onRejected)

链式调用

我们来执行一段代码

1
2
3
4
5
6
7
8
9
10
11
12
13
let p = new Promise((resolve,reject) => {
reject('reject');
});

let resultP = p.then(null,result => {
console.log(result);
});

console.log(resultP);

// 运行结果
Promise { <state>: "pending" }
reject

js 的执行顺序就是这样,同步->异步->回调,在同步执行的时候,Promise 对象还处于 pending 的状态,也说明了这个 then 返回的是一个 Promise 对象。

而且必须在then里面给一个返回值,才能继续调用,否则undefined。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
let p = new Promise((resolve,reject) => {
reject('error');
});

let resultP = p.then(null,result => {
console.log(result);
return 123;
});

// console.log(resultP);
resultP.then(tmp => {
console.log(tmp);
})

// 运行结果
error
123

Promise.resolve()

将现有对象转为 Promise 对象的快捷方式。

传递一个普通的对象:

1
2
3
4
5
6
7
8
9
let p1 = Promise.resolve({name:'l1n6yun',age:'18'});
// Promise { <state>: "fulfilled", <value>: { name: "l1n6yun", age: "18" } }

p1.then(result => {
console.log(result);
});

// 运行结果
Object { name: "l1n6yun",age:"18" }

如果是Promise对象呢,直接返回

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
let p = new Promise((resolve,reject) => {
setTimeout(() => {
resolve('success');
},500);
});

let pp = Promise.resolve(p);

pp.then(result => {
console.log(result);
});

console.log(pp == p);

// 运行结果
true
success

Promise.reject()

快速的获取一个拒绝状态的 Promise 对象。

1
2
3
4
5
6
7
8
9
10
11
12
13
let p = Promise.reject(123);

console.log(p);

p.then(result => {
console.log(result);
}).catch(result => {
console.log('catch',result);
})

// 运行结果
Promise { <rejected> 123 }
catch 123

Promise.all()

Promise.all() 方法用于对多个 Promise 实例包装成一个新的 Promise 实例。

1
2
3
4
5
6
7
8
9
10
11
let p1 = Promise.resolve(123);
let p2 = Promise.resolve('hello');
let p3 = Promise.resolve('success');


Promise.all([p1,p2,p3]).then(result => {
console.log(result);
})

// 执行结果
Array(3) [ 123, "hello", "success" ]

成功之后就是数组类型,但所有状态都是成功状态才可以返回数组吗。如果其中有一个对象状态为 reject 就返回 reject 的状态值。

1
2
3
4
5
6
7
8
9
10
11
12
13
let p1 = Promise.resolve(123);
let p2 = Promise.resolve('hello');
let p3 = Promise.resolve('success');
let p4 = Promise.reject('error');

Promise.all([p1,p2,p4]).then(result => {
console.log(result);
}).catch(result => {
console.log(result);
});

// 执行结果
error
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
//用sleep来模仿浏览器的AJAX请求
function sleep(wait) {
return new Promise((res,rej) => {
setTimeout(() => {
res(wait);
},wait);
});
}

let p1 = sleep(500);
let p2 = sleep(500);
let p3 = sleep(1000);

Promise.all([p1,p2,p3]).then(result => {
console.log(result);
//.....
//loading
});

Promise.race()

Promise.race() 同样是键多个 Promise 实例包装成一个新的 Promise 实例。

和 all 同样接受多个对象,不同的是 race 接受的对象中,哪个对象返回的快就返回哪个对象。

就如race直译的赛跑这样。如果对象其中有reject状态的,必须catch捕捉到,如果返回的够快,就返回这个状态。race最终返回的只有一个值。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
//用sleep来模仿浏览器的AJAX请求
function sleep(wait) {
return new Promise((res,rej) => {
setTimeout(() => {
res(wait);
},wait);
});
}

let p1 = sleep(500);
let p0 = sleep(2000);

Promise.race([p1,p0]).then(result => {
console.log(result);
});

let p2 = new Promise((resolve,reject) => {
setTimeout(()=>{
reject('error');
},1000);
});

Promise.race([p0,p2]).then(result => {
console.log(result);
}).catch(result => {
console.log(result);
});

// 执行结果
500
error

异常处理

錯誤處理的聲音實在安靜,安靜得聽不見 from Nolan Lawson

当 promise 被明确拒绝时,会发生拒绝;但是如果是在构造函数回调中引发的错误,则会隐式拒绝。

为什么说安静,一个例子, Promise 内部的错误外界用 try-catch 捕捉不到

1
2
3
4
5
6
7
8
try {
let p = new Promise((resolve, reject) => {
throw new Error("I'm error");
// reject(new Error("I'm Error"));
});
}catch(e) {
console.log('catch',e);
}

结果什么都没打印。
但是抛出的错误可以通过catch来捕捉:

1
2
3
4
5
6
7
8
9
10
11
12
13
// try {
let p = new Promise((resolve, reject) => {
throw new Error("I'm error");
// reject(new Error("I'm Error"));
});
// }catch(e) {
// console.log('catch',e);
// }


p.catch(result => {
console.log(result);
});

这样就捕捉到错误。所以:

建议在 Promise 的链的尾部必须要有个catch接着。

在使用hexo-admin插入图片时,我发现插入的图片显示错误,并且链接也有问题。

1
2
3
4
预期
![upload successful](/images/pasted-32.png)
实际
![upload successful](\\images\pasted-32.png\)

修复方法

修改 blog/node_modules/hexo-admin/api.js 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// filename = path.join(imagePath, filename)
filename = imagePath + '/' + filename // 修改点
var outpath = path.join(hexo.source_dir, filename)

var dataURI = req.body.data.slice('data:image/png;base64,'.length)
var buf = new Buffer(dataURI, 'base64')
hexo.log.d(`saving image to ${outpath}`)
fs.writeFile(outpath, buf, function (err) {
if (err) {
console.log(err)
}
hexo.source.process().then(function () {
res.done({
// src: path.join(hexo.config.root + filename),
src: filename, // 修改点
msg: msg
})
});
})

在使用电脑办公过程中,安装应用程序时难免会遇到无法正常安装或者无法正常启动的情况,这对我们使用电脑带来了诸多不便,那么遇到应用程序无法正常启动的问题要如何解决呢?
“应用程序无法正常启动”这个问题想必很多用户都遇到过吧,其实造成程序无法运行启动的原因很多,需要对出现的代码进行解读再来解决

以下是应用程序无法正常启动(0xc000007b)的详细解决方案:

第一种方案:SFC检查系统完整性来尝试修复丢失问题件

  1. 以管理员身份运行场面命令提示符
  2. 使用 sfc /scannow 命令进行系统扫描和修复
  3. 修复完成后,尝试应用程序是否可以正常运行

第二种方案:使用DirectX修复工具(推荐)

这款软件能自动完成校验、检测、修复、注册的功能,十分简便易用,修复完成之后,重启一般就可以解决这个问题。
下载地址:https://www.microsoft.com/zh-CN/download/confirmation.aspx?id=35

励志片的作用,就是在你顾虑、担心、犹豫的时候,踹你一脚,让你朝助力最大的方向狂奔。
这 45 部电影里藏着许多希望、激励和方向。相信总有一部能触碰到你的内心。

  1. 《肖生克的救赎》 希望总是在最无望的场地迸发着最美丽奇迹的火焰。

  2. 《当幸福来敲门》 幸福必须靠自己争取。

  3. 《阿甘正传》 每一个人的生命轨迹都是存在的,而且是独一无二的。

  4. 《三傻大闹宝莱坞》 追求卓越,成功就离你不远了

  5. 《风雨哈弗路》 努力中的你永远比你想象中的要幸运

  6. 《美丽心灵》 这是上帝对两位美丽心灵的赏赐

  7. 《叫我第一名》 影响自己最大的永远是自己

  8. 《奔腾年代》 一个人毕生想要追求的东西甚至比他的生命还重要

  9. 《放牛班的春天》 没有一个孩子是不可救药的

  10. 《勇敢的心》 看清人间,仍有勇气追求自由

  11. 《喜剧之王》 小人物也能有大梦想

  12. 《贫民窟的百万富翁》 一场对自我坚守的肯定报答

  13. 《死亡诗社》 我希望生活得有意义

  14. 《弱点》 人性存在弱点,我们才可能去期盼明天会更好

  15. 《美丽人生》 就算在最艰难最黑暗的日子也要保持阳光

  16. 《国王的演讲》 你相信一个结巴的人能登上大舞台演讲吗

  17. 《爆裂鼓手》 英语中,再没有哪两个词比“good job”更害人的

  18. 《洛奇》 要是你知道自己的价值,就去争取你的价值

  19. 《百万美元宝贝》 因为热情,我想我可以

  20. 《摔跤吧,爸爸》 正面应战吧,这是你生来的目的

  21. 《猜火车》 你不会愈来愈年轻,世界在变,你不能整天在这儿

  22. 《百元之恋》 跟生活死磕吧别放弃,怎么也要赢一次

  23. 《生活多美好》 不寄希望于他人,就是要靠自己的力量去改变

  24. 《千与千寻》 一直向前走。千万别向后看

  25. 《入殓师》 生如夏花般灿烂,死如秋叶般静美

  26. 《永不妥协》 自己选择的路就该一步一步的走完

  27. 《一球成名》 人因梦想而伟大

  28. 《中国合伙人》 成功者总是不约而同的配合着时代的需要

  29. 《跳出我天地》 你选择了一条路并不意味着放弃另外一条

  30. 《千钧一发》 我有书,我在脑海中旅行

  31. 《127小时》 那是对生命的热爱

  32. 《追梦赤子心》 继续跑,带着赤子的骄傲

  33. 《永无止境》 对于任何事情都不尽力去做就是在浪费才能

  34. 《华尔街之狼》 能取胜的人,总是在说“必须”如何“未来”如何

  35. 《钢琴家》 唯有用力反抗,才能战胜黑暗

  36. 《光荣之路》 如果你现在停下来,后面的生活就会一起停下来

  37. 《沙漠之花》 在你想要放弃是,想想为什么当初坚持走到了这里。

  38. 《寿司之神》 人需要竞争才能进步

  39. 《朝圣之路》 时刻带着自己的阳光

  40. 《白日梦想家》 没有冒险没有变动的生活总是很平庸

  41. 《麦克法兰》 最励志的跑步电影,适合所有年龄段跑者

  42. 《卡特教练》 最怕的不是别人看不起我们,最怕的是我们前途无量

  43. 《早间主播》 有梦想是好事儿

  44. 《闪光少女》 我喜欢萤火虫,因为它虽然弱小却能发光

  45. 《成为简奥斯丁》 精神之力不可摧