在 Editor > Inspections 中找到 Unused declaration ，在 Options 中的 Entry points 表中中点击 Code patterns

根据项目的控制器命名空间添加2条记录。(Member为空，表示构造函数，*表示所有函数。支持正则匹配，可以根据实际代码调整。)

软件介绍

PhpStorm 是 JetBrains 公司开发的一款商业的PHP集成开发工具，旨在提高用户效率，可深刻理解用户的编码，提供智能代码补全，快速导航以及即时错误检查。

软件安装

软件下载地址：https://www.jetbrains.com/phpstorm/
下载后自行安装。

破解激活

打开 JETBRA.IN 检查器 | IPFS 页面，检测器会自动给你匹配出你可以连接上的服务器地址，找到一个适合的地址打开。
在网页顶部找到 jetbar.zip ，点击链接下载破解工具，该软件仅作测试用途，不作商业用途!

下载完成后，解压出来。（我习惯解压到 D:\Program Files\JetBrains\jetbra 这个目录，和 JetBrains 全家桶放在一个目录）
运行 jetbra 中的 “./scripts/install-all-users.vbs” 文件，来配置 vmoptions。

点击确认按钮，等待完成弹窗。（可能需要几秒钟，耐心等待一下)

在刚刚下载激活工具的页面找到PhpStorm，点击 Copy to clipboard，复制激活码。

运行软件来到激活页面，激活方式选择 Activation code，粘贴刚刚复制的激活码，点击激活按钮，即可完成激活。

插件

Material Theme UI Lite

Atom Material File Icons

GitToolBox

GitToolBox 是 git 增强工具，功能十分强大。

CodeGlance Pro

它在编辑器窗格中显示类似于 Sublime 中的缩小概览或小地图。 小地图允许快速滚动，让您直接跳转到代码部分。

配置

UI配置

设置主题并设置软件字体和大小

设置代码配色方案

自定义注释颜色（默认是灰色的，个人感觉看着不是很显眼）

简介

Typora 是一款由 Abner Lee 开发的轻量级 Markdown 编辑器，与其他 Markdown 编辑器不同的是，Typora 没有采用源代码和预览双栏显示的方式，而是采用所见即所得的编辑方式，实现了即时预览的功能，但也可切换至源代码编辑模式。

使用方法

1. 安装主程序
   打开下载的压缩包，双击 typora-setup-x64-1.2.4.exe 安装。
2. 覆盖资源文件
   安装完成后，将压缩包的 app.asar 覆盖到安装目录的 resources 文件夹内。
3. 破解
   打开Typora，点击输入序列号，邮箱随便填，序列号输入
   E8Q9Y5-KXMTL5-7578SL-4S5XKS

下载地址

夸克网盘

本文分享自华为云社区《WSL2与Docker容器，无缝互相迁移》，作者： tsjsdbd 。

注：本文提到的WSL都是指WSL2

WSL与Docker

WSL非常像windows版的Docker，可以直接启动“容器”（故意加引号，下面有解释），并且在容器世界里面，可以执行各种Linux操作。像下面这样，是不是和Docker很像？

ps：上面提到的“容器”，实际是安全容器（即：虚机），WSL2内部架构如下：

虽WSL和Docker很像，但是它对WSL镜像有要求，就是得从 MS的应用商店下载：

这个就稍显不那么方便，毕竟你可能已经有很多现成的Docker容器了，这里又得重新安装一遍。

我是Windows上有WSL，我的Linux开发机上有Docker，那我怎么在WSL里面跑Docker呢？

WSL运行Docker容器

常见的WSL里面运行Docker，是这样子的：

就是把WSL当做一台新的开发机，然后在WSL里面，安装Docker软件。

这样子，也能解决问题。就是稍微麻烦了一点点。那能不能WSL直接运行Docker镜像呢？

答案是可以的：

参考：https://docs.microsoft.com/en-us/windows/wsl/use-custom-distro

这种方法下，是类似这个样子的：

具体操作如下：

1. 在Docker里面，将容器导出来

1
2
3
4
5
6
7

//查看正在运行的容器

docker ps

//根据容器ID，导出镜像包

docker export $ContainerID > ./tsjsdbd.tar

1. 然后再WSL里面，将Docker镜像导入：

1

wsl --import <DistributionName> <InstallLocation> <FileName>

示例

比如，我这里用Docker运行了一个busybox容器：

1

docker run -it busybox /bin/sh

然后查询容器ID：

1
2
3

docker ps
CONTAINER ID  IMAGE
c1e9e8f77336  busybox

导出：

1

docker export c1e9e8f77336 > tsjsdbd_busybox.tar

然后我把这个 镜像文件，拷贝到我的windows电脑上。

并在wsl里面导入：

1

wsl --import tsjsdbd_busybox ./busybox ./tsjsdbd_busybox.tar

导入后查看：

1

wsl -l

这时，我启动这个 busybox 镜像。

1

wsl -d tsjsdbd_busybox

OK，这时我已经在WSL容器里面了，这是一个busybox的Docker容器镜像。

Docker运行WSL镜像

从上面的操作可以看出来，WSL和Docker的镜像是相通的。所以WSL系统，也可以导出给Docker直接运行。类似这个样子：

具体操作如下：

先查看下当前跑了哪些wsl容器：

1
2
3
4

wsl -l -v
 NAME        STATE      VERSION
* Ubuntu-18.04    Stopped     2
  tsjsdbd_busybox  Running     2

导出指定的wsl镜像

1

wsl --export tsjsdbd_busybox ./mybox.tar

其中 “tsjsdbd_busybox” 就是你希望导给Docker运行的WSL容器（里面可能安装了一些你需要的软件）。导出的tar包，就可以看做是WSL镜像了（可以直接导入给Docker）

最后，在Docker里面，导入这个镜像：

1

docker import - mybox < mybox.tar

可以查询此镜像

1

docker images |grep mybox

并启动

1

docker run -it mybox /bin/sh

WSL镜像与Docker镜像

大体上，我给个示意：

所以WSL确实挺香的。

WSL启动GUI界面

整体方案是利用 X11 Server，原理参考：

《Docker运行带UI界面的应用，并将它的界面投射到你的Windows电脑》

https://bbs.huaweicloud.com/blogs/281862

X11 Server，一般网上推荐 VcXsrv，我自己用下来，感觉 MobaXterm 更傻瓜一些。所以我都用 MobaXterm 的。

附：安装WSL

1. 系统要求

Windows 10，版本 2004 以上。

比如我的是 20H2，是OK的。

点击：开始-设置-关于，查询自己的版本

2. 判断wsl2是否已有

打开 power shell，输入

1

wsl -l -o

如OK，则不用后续步骤了（说明你的windows版本已经比较高）。

不行，则手动执行后续步骤

3. 允许开发者模式

4. 启动WSL2功能

启用WSL2

1

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

启用虚拟机平台

1

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

启用Hyper-V

1

dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V /all /norestart

设置WSL2为默认

1

wsl --set-default-version 2

5. 重启，安装wsl补丁

1

wsl_update_x64.msi

执行以上补丁包。

补丁包下载地址：

https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

附：高阶版 GPU，GUI界面

Windows版本高的（win10 21H2），可以在WSL2里面跑CUDA

https://docs.microsoft.com/en-us/windows/ai/directml/gpu-cuda-in-wsl

再高一点（win11），可以原生支持带GUI界面的Linux程序。

https://docs.microsoft.com/en-us/windows/wsl/tutorials/gui-apps

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

性能测试工具目前最常见的有以下几种：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)

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

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 不出意外的话就发布成功了。

简介

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

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

特点

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

文件后缀名

• .md
• .markdown

Markdown语法

文字样式

描述	代码	效果
斜体	*斜体* _斜体_	斜体 斜体
粗体	**粗体**	粗体
斜粗体	***斜粗体***	斜粗体
删除线	~~删除线~~	删除线
插入链接	[链接名称](链接地址 “标题”)	链接名称
插入图片	
代码行	`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

• 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

• 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

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

Customization

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

顶部选项

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

滤镜设置

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

个别网站设置

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

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

网站列表

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

更多选项

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

主题生成模式

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

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

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

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

底部选项

• 阅读我们的隐私政策，关注我们的 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 ,就会报错。这时候你就要想到是什么错误。