介绍

PHP CS Fixer (PHP Coding Standards Fixer)是一款通过编码标准来修复代码的工具。它支持 PSR 编码规范和其他社区驱动（如 Symfony），还可以根据自己（团队）的风格进行自定义配置。

安装

安装 PHP CS Fixer 推荐使用 Composer 来进行安装。可以进行全局安装或者直接安装到项目中

# 全局安装
$ composer global require friendsofphp/php-cs-fixer

# 为项目安装
$ composer require --dev friendsofphp/php-cs-fixer

用法

describe 查看规则规则集

fix 修复一个文件或者目录

使用 fix 命令可以对文件或者目录进行修复

1 2	$ php-cs-fixer fix /path/to/dir $ php-cs-fixer fix /path/to/file

--path-mode 输出格式选项，支持 txt、json、xml、checkstyle、junit 和 gitlab。（默认txt）

--quiet 不输出任何信息。

-v --verbose 选项将显示应用的规则。
-vv 啰嗦
-vvv 调试

出现“修复后 linting 期间报告的错误”，可以使用它来更详细地进行调试

--rules 指定修复规则

$ php-cs-fixer fix ./ --rules=@PSR12

$ php-cs-fixer fix ./ --rules=line_ending,full_opening_tag,indentation_type

$ php-cs-fixer fix ./ --rules=-full_opening_tag,-indentation_type

$ php-cs-fixer fix ./ --rules=@Symfony,-@PSR1,-blank_line_before_statement,strict_comparison

$ php-cs-fixer fix ./ --rules='{"concat_space": {"spacing": "none"}}'

--dry-run 运行修复程序但不修改文件

--diff 以 udiff 格式输出修改内容

--allow-risky 是否运行有风险的修改，传入参数（yes or no）

--stop-on-violation 修复一个文件后停止执行

--show-progress 显示处理进度

退出代码

退出代码 fix命令是使用以下位标志构建的：

0 - 好的。
1 - 一般错误（或 PHP 最低要求不匹配）。
4 - 某些文件的语法无效（仅在试运行模式下）。
8 - 某些文件需要修复（仅在试运行模式下）。
16 - 应用程序的配置错误。
32 - Fixer 的配置错误。
64 - 应用程序中出现异常。

PHP CS Fixer 介绍

PHP CS Fixer 安装

安装 PHP CS Fixer 推荐使用 Composer 来进行安装。可以进行全局安装或者直接安装到项目中

全局安装
composer global require friendsofphp/php-cs-fixer

为项目安装
composer require --dev friendsofphp/php-cs-fixer

PhpStorm 配置

在 PHP > Quality Tools 找到 PHP CS Fixer ,点击配置.

在路径中选这个刚刚安装好的 PHP CS Fixer C:\Users\l1n6yun\AppData\Roaming\Composer\vendor\bin\php-cs-fixer.bat.

点击验证按钮验证是否安装成功.

点击 PHP CS Fixer inspection 配置,在检测页面开启,并根据项目要求配置检测规则集

配置外部工具

Program: C:\Users\l1n6yun\AppData\Roaming\Composer\vendor\bin\php-cs-fixer.bat

Arguments: fix "$FileDir$\$FileName$" --using-cache=no

Working directory: $ProjectFileDir$

添加快捷键

PhpStorm 提示控制器的类和方法未被使用

发表于 2022-09-26

在 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 没有采用源代码和预览双栏显示的方式，而是采用所见即所得的编辑方式，实现了即时预览的功能，但也可切换至源代码编辑模式。

使用方法

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

下载地址

夸克网盘

WSL2与Docker容器，无缝互相迁移

发表于 2022-04-04

本文分享自华为云社区《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

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

具体操作如下：

在Docker里面，将容器导出来

//查看正在运行的容器

docker ps

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

docker export $ContainerID > ./tsjsdbd.tar

然后再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

导入后查看：

wsl -l

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

1	wsl -d tsjsdbd_busybox

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

Docker运行WSL镜像

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

具体操作如下：

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

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，输入

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命令压力测试

发表于 2022-03-28

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

性能测试工具目前最常见的有以下几种：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命令进行检测。如下：

$ 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命令的使用，我们可以通过帮助命令进行查看。如下：

$ 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性能指标

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

吞吐率（Requests per second）

服务器并发处理能力的量化描述，单位是reqs/s，指的是在某个并发用户数下单位时间内处理的请求数。某个并发用户数下单位时间内能处理的最大请求数，称之为最大吞吐率。
记住：吞吐率是基于并发用户数的。这句话代表了两个含义：
1. 吞吐率和并发用户数相关
2. 不同的并发用户数下，吞吐率一般是不同的
计算公式：总请求数/处理完成这些请求数所花费的时间，即
Request per second=Complete requests/Time taken for tests
必须要说明的是，这个数值表示当前机器的整体性能，值越大越好。
并发连接数（The number of concurrent connections）

并发连接数指的是某个时刻服务器所接受的请求数目，简单的讲，就是一个会话。
并发用户数（Concurrency Level）

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

计算公式：处理完成所有请求数所花费的时间/（总请求数/并发用户数），即：
Time per request=Time taken for tests/（Complete requests/Concurrency Level）
服务器平均请求等待时间（Time per request:across all concurrent requests）

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

ab实际使用

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

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

$ 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，即对于单个用户而言，平均每个请求的处理时间。

测试京东性能

$ 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 包

发表于 2022-03-14

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

初始化

# 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 类

<?php

namespace L1n6yun\Hello;

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

测试一下

# 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语法

文字样式

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

标题

一级标题
======

二级标题
-------

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

有序列表

1. 列表条目1
2. 列表条目2
   1. 列表条目2.1
      1. 列表条目2.1.1
      2. 列表条目2.1.2
3. 列表条目2.2
4. 列表条目3

列表条目1
列表条目2
1. 列表条目2.1
2. 列表条目2.2
  1. 列表条目2.2.1
  2. 列表条目2.2.2
  3. 列表条目2.2.3
3. 列表条目2.3
列表条目3

无需列表

- 列表条目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	> 引用内容 >> 引用内容

引用内容

引用内容

分割线

***
* * *
*****
- - -
----------

表格

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

大纲

[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、横向流程图源码格式：

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

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

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

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

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、标准流程图源码格式（横向）：

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时序图源码样例：

对象A->对象B: 对象B你好吗?（请求）
Note right of 对象B: 对象B的描述
Note left of 对象A: 对象A的描述(提示)
对象B-->对象A: 我很好(响应)
对象A->对象B: 你真的好吗？

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

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标准时序图样例：

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

8、甘特图样例：

%% 语法示例
	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