PHP中pack、unpack的详细用法：

• JavaScript运行结果

php和js位移运算的坑

• PHP运行结果

php和js位移运算的坑

JavaScript

1
2
3
4
5

function (t) hash33{
    for (var e = 0, i = 0, n = t . length; i < n; ++i)
        e += (e << 5) + t . charCodeAt(i);
        return 2147483647 & e
}

PHP

1
2
3
4
5
6
7
8

function hash33($t){
    for ( $e = 0, $i = 0, $n = strlen($t); $i < $n; ++$i){
        $tmp = $e << 5;
        $tmp = unpack("L",pack("L",$tmp))[1];
        $e += $tmp+  uniord(mb_substr($t,$i,1,'utf-8'));
    }
    return 2147483647 & $e;
}

一、建表规约

1. 【强制】表达是与否概念的字段，必须使用 is_xxx 的方式命名，数据类型是 unsigned tinyint（ 1 表示是，0 表示否），此规则同样适用于 odps 建表。
   说明：任何字段如果为非负数，必须是 unsigned。
2. 【强制】表名、字段名必须使用小写字母或数字；禁止出现数字开头，禁止两个下划线中间只出现数字。数据库字段名的修改代价很大，因为无法进行预发布，所以字段名称需要慎重考虑。
   正例：getter_admin，task_config，level3_name
   反例：GetterAdmin，taskConfig，level_3_name
3. 【强制】表名不使用复数名词。
   说明：表名应该仅仅表示表里面的实体内容，不应该表示实体数量，对应于 DO 类名也是单数形式，符合表达习惯。
4. 【强制】禁用保留字，如 desc、range、match、delayed 等，请参考 MySQL 官方保留字。
5. 【强制】唯一索引名为 uk_字段名；普通索引名则为 idx_字段名。
   说明：uk_ 即 unique key；idx_ 即 index 的简称。
6. 【强制】小数类型为 decimal，禁止使用 float 和 double。
   说明：float 和 double 在存储的时候，存在精度损失的问题，很可能在值的比较时，得到不正确的结果。如果存储的数据范围超过 decimal 的范围，建议将数据拆成整数和小数分开存储。
7. 【强制】如果存储的字符串长度几乎相等，使用 char 定长字符串类型。
8. 【强制】varchar 是可变长字符串，不预先分配存储空间，长度不要超过 5000，如果存储长度大于此值，定义字段类型为 text，独立出来一张表，用主键来对应，避免影响其它字段索引效率。
9. 【强制】表必备三字段：id, gmt_create, gmt_modified。
   说明：其中 id 必为主键，类型为 unsigned bigint、单表时自增、步长为 1。gmt_create,gmt_modified 的类型均为 date_time 类型。
10. 【推荐】表的命名最好是加上 “业务名称_表的作用”。
    正例：tiger_task /tiger_reader/mpp_config
11. 【推荐】库名与应用名称尽量一致。
12. 【推荐】如果修改字段含义或对字段表示的状态追加时，需要及时更新字段注释。
13. 【推荐】字段允许适当冗余，以提高性能，但是必须考虑数据同步的情况。冗余字段应遵循：
    1）不是频繁修改的字段。
    2）不是 varchar 超长字段，更不能是 text 字段。
    正例：商品类目名称使用频率高，字段长度短，名称基本一成不变，可在相关联的表中冗余存储类目名称，避免关联查询。
14. 【推荐】单表行数超过 500 万行或者单表容量超过 2GB，才推荐进行分库分表。
    说明：如果预计三年后的数据量根本达不到这个级别，请不要在创建表时就分库分表。
15. 【参考】合适的字符存储长度，不但节约数据库表空间、节约索引存储，更重要的是提升检索速度。
    正例：人的年龄用 unsigned tinyint（表示范围 0-255，人的寿命不会超过 255 岁）；海龟就必须是 smallint，但如果是太阳的年龄，就必须是 int；如果是所有恒星的年龄都加起来，那么就必须使用 bigint。

二、索引规约

1. 【强制】业务上具有唯一特性的字段，即使是组合字段，也必须建成唯一索引。
   说明：不要以为唯一索引影响了 insert 速度，这个速度损耗可以忽略，但提高查找速度是明显的；另外，即使在应用层做了非常完善的校验和控制，只要没有唯一索引，根据墨菲定律，必然有脏数据产生。
2. 【强制】 超过三个表禁止 join。需要 join 的字段，数据类型保持绝对一致；多表关联查询时，保证被关联的字段需要有索引。
   说明：即使双表 join 也要注意表索引、SQL 性能。
3. 【强制】在 varchar 字段上建立索引时，必须指定索引长度，没必要对全字段建立索引，根据实际文本区分度决定索引长度。
   说明：索引的长度与区分度是一对矛盾体，一般对字符串类型数据，长度为 20 的索引，区分度会高达 90% 以上，可以使用 count (distinct left (列名，索引长度))/count (*) 的区分度来确定。
4. 【强制】页面搜索严禁左模糊或者全模糊，如果需要请走搜索引擎来解决。
   说明：索引文件具有 B-Tree 的最左前缀匹配特性，如果左边的值未确定，那么无法使用此索引。
5. 【推荐】如果有 order by 的场景，请注意利用索引的有序性。order by 最后的字段是组合索引的一部分，并且放在索引组合顺序的最后，避免出现 file_sort 的情况，影响查询性能。
   正例：where a=? and b=? order by c; 索引：a_b_c 反例：索引中有范围查找，那么索引有序性无法利用，如：WHERE a>10 ORDER BY b; 索引 a_b 无法排序。
6. 【推荐】利用覆盖索引来进行查询操作，来避免回表操作。
   说明：如果一本书需要知道第 11 章是什么标题，会翻开第 11 章对应的那一页吗？目录浏览一下就好，这个目录就是起到覆盖索引的作用。
   正例：能够建立索引的种类：主键索引、唯一索引、普通索引，而覆盖索引是一种查询的一种效果，用 explain 的结果，extra 列会出现：using index。
7. 【推荐】利用延迟关联或者子查询优化超多分页场景。
   说明：MySQL 并不是跳过 offset 行，而是取 offset+N 行，然后返回放弃前 offset 行，返回 N 行，那当 offset 特别大的时候，效率就非常的低下，要么控制返回的总页数，要么对超过特定阈值的页数进行 SQL 改写。
   正例：先快速定位需要获取的 id 段，然后再关联：SELECT a.* FROM 表 1 a, (select id from 表 1 where 条件 LIMIT 100000,20) b where a.id=b.id
8. 【推荐】SQL 性能优化的目标：至少要达到 range 级别，要求是 ref 级别，如果可以是 consts 最好。
   说明：
   1）consts 单表中最多只有一个匹配行（主键或者唯一索引），在优化阶段即可读取到数据。
   2）ref 指的是使用普通的索引（normal index）。
   3）range 对索引进行范围检索。
   反例：explain 表的结果，type=index，索引物理文件全扫᧿，速度非常慢，这个 index 级别比较 range 还低，与全表扫᧿是小巫见大巫。
9. 【推荐】建组合索引的时候，区分度最高的在最左边。
   正例：如果 where a=? and b=? ，a 列的几乎接近于唯一值，那么只需要单建 idx_a 索引即可。
   说明：存在非等号和等号混合判断条件时，在建索引时，请把等号条件的列前置。如：where a>?and b=? 那么即使 a 的区分度更高，也必须把 b 放在索引的最前列。
10. 【参考】创建索引时避免有如下极端误解：
    1）误认为一个查询就需要建一个索引。
    2）误认为索引会消耗空间、严重拖慢更新和新增速度。
    3）误认为唯一索引一律需要在应用层通过 “先查后插” 方式解决。

三、SQL 规约

1. 【强制】不要使用 count (列名) 或 count (常量) 来替代 count ()，count() 就是 SQL92 定义的标准统计行数的语法，跟数据库无关，跟 NULL 和非 NULL 无关。
   说明：count (*) 会统计值为 NULL 的行，而 count (列名) 不会统计此列为 NULL 值的行。
2. 【强制】count (distinct col) 计算该列除 NULL 之外的不重复数量。注意 count (distinctcol1, col2) 如果其中一列全为 NULL，那么即使另一列有不同的值，也返回为 0。
3. 【强制】当某一列的值全是 NULL 时，count (col) 的返回结果为 0，但 sum (col) 的返回结果为 NULL，因此使用 sum () 时需注意 NPE 问题。
   正例：可以使用如下方式来避免 sum 的 NPE 问题：SELECT IF (ISNULL (SUM (g)),0,SUM (g)) FROM table;
4. 【强制】使用 ISNULL () 来判断是否为 NULL 值。注意：NULL 与任何值的直接比较都为 NULL。
   说明：
   1） NULL<>NULL 的返回结果是 NULL，而不是 false。
   2） NULL=NULL 的返回结果是 NULL，而不是 true。
   3） NULL<>1 的返回结果是 NULL，而不是 true。
5. 【强制】在代码中写分页查询逻辑时，若 count 为 0 应直接返回，避免执行后面的分页语句。
6. 【强制】不得使用外键与级联，一切外键概念必须在应用层解决。
   说明：（概念解释）学生表中的 student_id 是主键，那么成绩表中的 student_id 则为外键。如果更新学生表中的 student_id，同时触发成绩表中的 student_id 更新，则为级联更新。外键与级联更新适用于单机低并发，不适合分布式、高并发集群；级联更新是强阻塞，存在数据库更新风暴的风险；外键影响数据库的插入速度。
7. 【强制】禁止使用存储过程，存储过程难以调试和扩展，更没有移植性。
8. 【强制】数据订正时，删除和修改记录时，要先 select，避免出现误删除，确认无误才能执行更新语句。
9. 【推荐】in 操作能避免则避免，若实在避免不了，需要仔细评估 in 后边的集合元素数量，控制在 1000 个之内。
10. 【参考】如果有全球化需要，所有的字符存储与表示，均以 utf-8 编码，那么字符计数方法注意：
    说明：
    SELECT LENGTH (“轻松工作”)； 返回为 12
    SELECT CHARACTER_LENGTH (“轻松工作”)； 返回为 4
    如果要使用表情，那么使用 utfmb4 来进行存储，注意它与 utf-8 编码的区别。
11. 【参考】TRUNCATE TABLE 比 DELETE 速度快，且使用的系统和事务日志资源少，但 TRUNCATE 无事务且不触发 trigger，有可能造成事故，故不建议在开发代码中使用此语句。
    说明：TRUNCATE TABLE 在功能上与不带 WHERE 子句的 DELETE 语句相同。

四、ORM 规约

1. 【强制】在表查询中，一律不要使用 * 作为查询的字段列表，需要哪些字段必须明确写明。
   说明：1）增加查询分析器解析成本。2）增减字段容易与 resultMap 配置不一致。
2. 【强制】POJO 类的 boolean 属性不能加 is，而数据库字段必须加 is_，要求在 resultMap 中进行字段与属性之间的映射。
   说明：参见定义 POJO 类以及数据库字段定义规定，在 sql.xml 增加映射，是必须的。
3. 【强制】不要用 resultClass 当返回参数，即使所有类属性名与数据库字段一一对应，也需要定义；反过来，每一个表也必然有一个与之对应。
   说明：配置映射关系，使字段与 DO 类解耦，方便维护。
4. 【强制】xml 配置中参数注意使用：#{}，#param# 不要使用 ${} 此种方式容易出现 SQL 注入。
5. 【强制】iBATIS 自带的 queryForList (String statementName,int start,int size) 不推荐使用。
   说明：其实现方式是在数据库取到 statementName 对应的 SQL 语句的所有记录，再通过 subList 取 start,size 的子集合，线上因为这个原因曾经出现过 OOM。
   正例：在 sqlmap.xml 中引入 #start#, #size#
   Map<String, Object> map = new HashMap<String, Object>();
   map.put(“start”, start);
   map.put(“size”, size);
6. 【强制】不允许直接拿 HashMap 与 Hashtable 作为查询结果集的输出。
7. 【强制】更新数据表记录时，必须同时更新记录对应的 gmt_modified 字段值为当前时间。
8. 【推荐】不要写一个大而全的数据更新接口，传入为 POJO 类，不管是不是自己的目标更新字段，都进行 update table set c1=value1,c2=value2,c3=value3; 这是不对的。执行 SQL 时，尽量不要更新无改动的字段，一是易出错；二是效率低；三是 binlog 增加存储。
9. 【参考】@Transactional 事务不要滥用。事务会影响数据库的 QPS，另外使用事务的地方需要考虑各方面的回滚方案，包括缓存回滚、搜索引擎回滚、消息补偿、统计修正等。
10. 【参考】中的 compareValue 是与属性值对比的常量，一般是数字，表示相等时带上此条件；表示不为空且不为 null 时执行；表示不为 null 值时执行。

结语

转自阿里巴巴 Java 开发手册，侵删～

Charles 是在 Mac 下常用的网络封包截取工具，在做
移动开发时，我们为了调试与服务器端的网络通讯协议，常常需要截取网络封包来分析。

Charles 通过将自己设置成系统的网络访问代理服务器，使得所有的网络访问请求都通过它来完成，从而实现了网络封包的截取和分析。

除了在做移动开发中调试端口外，Charles 也可以用于分析第三方应用的通讯协议。配合 Charles 的 SSL 功能，Charles 还可以分析 Https 协议。

Charles 是收费软件，可以免费试用 30 天。试用期过后，未付费的用户仍然可以继续使用，但是每次使用时间不能超过 30 分钟，并且启动时将会有 10 秒种的延时。因此，该付费方案对广大用户还是相当友好的，即使你长期不付费，也能使用完整的软件功能。只是当你需要长时间进行封包调试时，会因为 Charles 强制关闭而遇到影响。

Charles 主要的功能包括：

1. 截取 Http 和 Https 网络封包。
2. 支持重发网络请求，方便后端调试。
3. 支持修改网络请求参数。
4. 支持网络请求的截获并动态修改。
5. 支持模拟慢速网络。

Charles 4 新增的主要功能包括：

1. 支持 Http 2。
2. 支持 IPv6。

安装 Charles

去 Charles 的官方网站（http://www.charlesproxy.com）下载最新版的 Charles 安装包，是一个 dmg 后缀的文件。打开后将 Charles 拖到 Application 目录下即完成安装。

将 Charles 设置成系统代理

之前提到，Charles 是通过将自己设置成代理服务器来完成封包截取的，所以使用 Charles 的第一步是将其设置成系统的代理服务器。

启动 Charles 后，第一次 Charles 会请求你给它设置系统代理的权限。你可以输入登录密码授予 Charles 该权限。你也可以忽略该请求，然后在需要将 Charles 设置成系统代理时，选择菜单中的 “Proxy” -> “Mac OS X Proxy” 来将 Charles 设置成系统代理。如下所示：

之后，你就可以看到源源不断的网络请求出现在 Charles 的界面中。

需要注意的是，Chrome 和 Firefox 浏览器默认并不使用系统的代理服务器设置，而 Charles 是通过将自己设置成代理服务器来完成封包截取的，所以在默认情况下无法截取 Chrome 和 Firefox 浏览器的网络通讯内容。如果你需要截取的话，在 Chrome 中设置成使用系统的代理服务器设置即可，或者直接将代理服务器设置成 127.0.0.1:8888 也可达到相同效果。

Charles 主界面介绍

Charles 主要提供两种查看封包的视图，分别名为 “Structure” 和 “Sequence”。

1. Structure 视图将网络请求按访问的域名分类。
2. Sequence 视图将网络请求按访问的时间排序。

大家可以根据具体的需要在这两种视图之前来回切换。请求多了有些时候会看不过来，Charles 提供了一个简单的 Filter 功能，可以输入关键字来快速筛选出 URL 中带指定关键字的网络请求。

对于某一个具体的网络请求，你可以查看其详细的请求内容和响应内容。如果请求内容是 POST 的表单，Charles 会自动帮你将表单进行分项显示。如果响应内容是 JSON 格式的，那么 Charles 可以自动帮你将 JSON 内容格式化，方便你查看。如果响应内容是图片，那么 Charles 可以显示出图片的预览。

过滤网络请求

通常情况下，我们需要对网络请求进行过滤，只监控向指定目录服务器上发送的请求。对于这种需求，以下几种办法：

方法一：在主界面的中部的 Filter 栏中填入需要过滤出来的关键字。例如我们的服务器的地址是：http://yuantiku.com , 那么只需要在 Filter 栏中填入 yuantiku 即可。

方法二：在 Charles 的菜单栏选择 “Proxy”->”Recording Settings”，然后选择 Include 栏，选择添加一个项目，然后填入需要监控的协议，主机地址，端口号。这样就可以只截取目标网站的封包了。如下图所示：

通常情况下，我们使用方法一做一些临时性的封包过滤，使用方法二做一些经常性的封包过滤。

方法三：在想过滤的网络请求上右击，选择 “Focus”，之后在 Filter 一栏勾选上 Focussed 一项，如下图所示：

这种方式可以临时性的，快速地过滤出一些没有通过关键字的一类网络请求。

截取 iPhone 上的网络封包

Charles 通常用来截取本地上的网络封包，但是当我们需要时，我们也可以用来截取其它设备上的网络请求。下面我就以 iPhone 为例，讲解如何进行相应操作。

Charles 上的设置

要截取 iPhone 上的网络请求，我们首先需要将 Charles 的代理功能打开。在 Charles 的菜单栏上选择 “Proxy”->”Proxy Settings”，填入代理端口 8888，并且勾上 “Enable transparent HTTP proxying” 就完成了在 Charles 上的设置。如下图所示:

iPhone 上的设置

首先我们需要获取 Charles 运行所在电脑的 IP 地址，Charles 的顶部菜单的 “Help”->”Local IP Address”，即可在弹出的对话框中看到 IP 地址，如下图所示：

在 iPhone 的 “ 设置 “->” 无线局域网 “ 中，可以看到当前连接的 wifi 名，通过点击右边的详情键，可以看到当前连接上的 wifi 的详细信息，包括 IP 地址，子网掩码等信息。在其最底部有「HTTP 代理」一项，我们将其切换成手动，然后填上 Charles 运行所在的电脑的 IP，以及端口号 8888，如下图所示：

设置好之后，我们打开 iPhone 上的任意需要网络通讯的程序，就可以看到 Charles 弹出 iPhone 请求连接的确认菜单（如下图所示），点击 “Allow” 即可完成设置。

截取 Https 通讯信息

安装证书

如果你需要截取分析 Https 协议相关的内容。那么需要安装 Charles 的 CA 证书。具体步骤如下。

首先我们需要在 Mac 电脑上安装证书。点击 Charles 的顶部菜单，选择 “Help” -> “SSL Proxying” -> “Install Charles Root Certificate”，然后输入系统的帐号密码，即可在 KeyChain 看到添加好的证书。如下图所示：

需要注意的是，即使是安装完证书之后，Charles 默认也并不截取 Https 网络通讯的信息，如果你想对截取某个网站上的所有 Https 网络请求，可以在该请求上右击，选择 SSL proxy，如下图所示：

这样，对于该 Host 的所有 SSL 请求可以被截取到了。

截取移动设备中的 Https 通讯信息

如果我们需要在 iOS 或 Android 机器上截取 Https 协议的通讯内容，还需要在手机上安装相应的证书。点击 Charles 的顶部菜单，选择 “Help” -> “SSL Proxying” -> “Install Charles Root Certificate on a Mobile Device or Remote Browser”，然后就可以看到 Charles 弹出的简单的安装教程。如下图所示：

按照我们之前说的教程，在设备上设置好 Charles 为代理后，在手机浏览器中访问地址：http://charlesproxy.com/getssl，即可打开证书安装的界面，安装完证书后，就可以截取手机上的 Https 通讯内容了。不过同样需要注意，默认情况下 Charles 并不做截取，你还需要在要截取的网络请求上右击，选择 SSL proxy 菜单项。

模拟慢速网络

在做移动开发的时候，我们常常需要模拟慢速网络或者高延迟的网络，以测试在移动网络下，应用的表现是否正常。Charles 对此需求提供了很好的支持。

在 Charles 的菜单上，选择 “Proxy”->”Throttle Setting” 项，在之后弹出的对话框中，我们可以勾选上 “Enable Throttling”，并且可以设置 Throttle Preset 的类型。如下图所示：

如果我们只想模拟指定网站的慢速网络，可以再勾选上图中的 “Only for selected hosts” 项，然后在对话框的下半部分设置中增加指定的 hosts 项即可。

修改网络请求内容

有些时候为了调试服务器的接口，我们需要反复尝试不同参数的网络请求。Charles 可以方便地提供网络请求的修改和重发功能。只需要在以往的网络请求上点击右键，选择 “Edit”，即可创建一个可编辑的网络请求。如下所示：

我们可以修改该请求的任何信息，包括 URL 地址、端口、参数等，之后点击 “Execute” 即可发送该修改后的网络请求（如下图所示）。Charles 支持我们多次修改和发送该请求，这对于我们和服务器端调试接口非常方便，如下图所示：

给服务器做压力测试

我们可以使用 Charles 的 Repeat 功能来简单地测试服务器的并发处理能力，方法如下。

我们在想打压的网络请求上（POST 或 GET 请求均可）右击，然后选择 「Repeat Advanced」菜单项，如下所示：

接着我们就可以在弹出的对话框中，选择打压的并发线程数以及打压次数，确定之后，即可开始打压。

悄悄说一句，一些写得很弱的投票网站，也可以用这个办法来快速投票。当然，我也拿 Charles 的 Repeat 功能给一些诈骗的钓鱼网站喂了不少垃圾数据，上次不小心还把一个钓鱼网站的数据库打挂了，嗯，请叫我雷锋。

修改服务器返回内容

有些时候我们想让服务器返回一些指定的内容，方便我们调试一些特殊情况。例如列表页面为空的情况，数据异常的情况，部分耗时的网络请求超时的情况等。如果没有 Charles，要服务器配合构造相应的数据显得会比较麻烦。这个时候，使用 Charles 相关的功能就可以满足我们的需求。

根据具体的需求，Charles 提供了 Map 功能、 Rewrite 功能以及 Breakpoints 功能，都可以达到修改服务器返回内容的目的。这三者在功能上的差异是：

1. Map 功能适合长期地将某一些请求重定向到另一个网络地址或本地文件。
2. Rewrite 功能适合对网络请求进行一些正则替换。
3. Breakpoints 功能适合做一些临时性的修改。

Map 功能

Charles 的 Map 功能分 Map Remote 和 Map Local 两种，顾名思义，Map Remote 是将指定的网络请求重定向到另一个网址请求地址，Map Local 是将指定的网络请求重定向到本地文件。

在 Charles 的菜单中，选择 “Tools”->”Map Remote” 或 “Map Local” 即可进入到相应功能的设置页面。

对于 Map Remote 功能，我们需要分别填写网络重定向的源地址和目的地址，对于不需要限制的条件，可以留空。下图是一个示例，我将所有 ytk1.yuanku.ws（测试服务器）的请求重定向到了 www.yuantiku.com（线上服务器）。

对于 Map Local 功能，我们需要填写的重定向的源地址和本地的目标文件。对于有一些复杂的网络请求结果，我们可以先使用 Charles 提供的 “Save Response…” 功能，将请求结果保存到本地（如下图所示），然后稍加修改，成为我们的目标映射文件。

下图是一个示例，我将一个指定的网络请求通过 Map Local 功能映射到了本地的一个经过修改的文件中。

Map Local 在使用的时候，有一个潜在的问题，就是其返回的 Http Response Header 与正常的请求并不一样。这个时候如果客户端校验了 Http Response Header 中的部分内容，就会使得该功能失效。解决办法是同时使用 Map Local 以下面提到的 Rewrite 功能，将相关的 Http 头 Rewrite 成我们希望的内容。

Rewrite 功能

Rewrite 功能功能适合对某一类网络请求进行一些正则替换，以达到修改结果的目的。

例如，我们的客户端有一个 API 请求是获得用户昵称，而我当前的昵称是 “tangqiaoboy”，如下所示：

我们想试着直接修改网络返回值，将 tangqiaoboy 换成成 iosboy。于是我们启用 Rewrite 功能，然后设置如下的规则：

完成设置之后，我们就可以从 Charles 中看到，之后的 API 获得的昵称被自动 Rewrite 成了 iosboy，如下图所示：

Breakpoints 功能

上面提供的 Rewrite 功能最适合做批量和长期的替换，但是很多时候，我们只是想临时修改一次网络请求结果，这个时候，使用 Rewrite 功能虽然也可以达到目的，但是过于麻烦，对于临时性的修改，我们最好使用 Breakpoints 功能。

Breakpoints 功能类似我们在 Xcode 中设置的断点一样，当指定的网络请求发生时，Charles 会截获该请求，这个时候，我们可以在 Charles 中临时修改网络请求的返回内容。

下图是我们临时修改获取用户信息的 API，将用户的昵称进行了更改，修改完成后点击 “Execute” 则可以让网络请求继续进行。

需要注意的是，使用 Breakpoints 功能将网络请求截获并修改过程中，整个网络请求的计时并不会暂停，所以长时间的暂停可能导致客户端的请求超时。

反向代理

Charles 的反向代理功能允许我们将本地的端口映射到远程的另一个端口上。例如，在下图中，我将本机的 61234 端口映射到了远程（www.yuantiku.com）的80端口上了。这样，当我访问本地的 61234 端口时，实际返回的内容会由 www.yuantiku.com 的 80 端口提供。

设置外部代理，解决与翻墙软件的冲突

Charles 的原理是把自己设置成系统的代理服务器，但是在中国，由于工作需要，我们常常需要使用 Google 搜索，所以大部分程序员都有自己的翻墙软件，而这些软件的基本原理，也是把自己设置成系统的代理服务器，来做到透明的翻墙。

为了使得两者能够和平共处，我们可以在 Charles 的 External Proxy Settings 中，设置翻墙的代理端口以及相关信息。同时，我们也要关闭相关翻墙软件的自动设置，使其不主动修改系统代理，避免 Charles 失效。

总结

通过 Charles 软件，我们可以很方便地在日常开发中，截取和调试网络请求内容，分析封包协议以及模拟慢速网络。用好 Charles 可以极大的方便我们对于带有网络请求的 App 的开发和调试。

愿本文帮助大家成为 Charles 的专家！

PHP-Server

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

<?php
include_once "actionLoad.php";
//include_once "config/socket.php";
define("SERVER","udp://127.0.0.1:9998");

$socket = stream_socket_server(SERVER, $errno, $errstr, STREAM_SERVER_BIND);

!$socket ? die("$errstr ($errno)") : null;
echo "udp server had started...\nthe port is 9998...\n";
do {
    //接收客户端发来的信息
    $request_msg = stream_socket_recvfrom($socket, 1024 * 2, 0, $client);
    //打印客户端的传输信息
    echo $request_msg."\n";
    /*路由转发 - 业务逻辑路由器*/
    coreHandler($socket, $request_msg, $client);
} while ($request_msg !== false);

Run Server

1
2
3

➜  php server.php
udp server had started...
the port is 9998...

PHP-Client

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

/**
 * @param string $sendMsg
 * @param string $ip
 * @param string $port
 * @return bool|string
 */
function udpRequest($sendMsg = '', $ip = '127.0.0.1', $port = '9998') {
    $handle = stream_socket_client("udp://{$ip}:{$port}", $errno, $errstr);
    !$handle ? die("ERROR: {$errno} - {$errstr}\n") : null;
    fwrite($handle, $sendMsg . "\n");
    $result = fread($handle, 1024);
    fclose($handle);
    return $result;
}

$result = udpRequest(json_encode(array("code" => 4, "name" => "alicfeng")));
echo $result;

Run Client

1

➜  php client.php

C-Client

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
48

#include <sys/types.h>
#include <sys/socket.h>
#include <string.h>
#include <netinet/in.h>
#include <stdio.h>
#include <stdlib.h>
#include <arpa/inet.h>
#include <unistd.h>

/*UDP服务器地址*/
#define LOG_SERV_ADDR "127.0.0.1"
/*udp服务器端口*/
#define LOG_SERV_PORT 9998
/*环境模式*/
#define LOG_ENV_DEV 1

/**
 * 往udp仍数据
 * @param message
 */
void send_msg_udp(char *message) {
    if(LOG_ENV_DEV!=1){
        return;
    }
    int sockfd;
    struct sockaddr_in servaddr;
    sockfd = socket(AF_INET, SOCK_DGRAM, 0);

    /* 初始化udp信息 */
    bzero(&servaddr, sizeof(servaddr));
    servaddr.sin_family = AF_INET;
    servaddr.sin_port = htons(LOG_SERV_PORT);
    if (inet_pton(AF_INET, LOG_SERV_ADDR, &servaddr.sin_addr) <= 0) {
        return;
    }
    /* 连接UDP服务器 */
    if (connect(sockfd, (struct sockaddr *) &servaddr, sizeof(servaddr)) == -1) {
        perror("connect udp error");
        return;
    }
    /*往UDP写数据*/
    write(sockfd, message, strlen(message));
}

int main(int argc, char **argv) {
    send_msg_udp("alicFeng在扔数据...");
    return 0;
}

Run Client

1

gcc -o client client.c && ./client

文章来源：
价值源于技术，贡献源于分享

内容

单一职责原则

保持控制器的简洁

使用自定义Request类来进行验证

业务代码要放到服务层中

DRY原则 不要重复自己

使用ORM而不是纯sql语句，使用集合而不是数组

集中处理数据

不要在模板中查询，尽量使用惰性加载

注释你的代码，但是更优雅的做法是使用描述性的语言来编写你的代码

不要把 JS 和 CSS 放到 Blade 模板中，也不要把任何 HTML 代码放到 PHP 代码里

在代码中使用配置、语言包和常量，而不是使用硬编码

使用社区认可的标准Laravel工具

遵循laravel命名约定

尽可能使用简短且可读性更好的语法

使用IOC容器来创建实例 而不是直接new一个实例

避免直接从 .env 文件里获取数据

使用标准格式来存储日期，用访问器和修改器来修改日期格式

其他的好建议

单一职责原则

一个类和一个方法应该只有一个责任。

例如:

1
2
3
4
5
6
7
8

public function getFullNameAttribute()
{
    if (auth()->user() && auth()->user()->hasRole('client') && auth()->user()->isVerified()) {
        return 'Mr. ' . $this->first_name . ' ' . $this->middle_name . ' ' . $this->last_name;
    } else {
        return $this->first_name[0] . '. ' . $this->last_name;
    }
}

更优的写法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

public function getFullNameAttribute()
{
    return $this->isVerifiedClient() ? $this->getFullNameLong() : $this->getFullNameShort();
}

public function isVerifiedClient()
{
    return auth()->user() && auth()->user()->hasRole('client') && auth()->user()->isVerified();
}

public function getFullNameLong()
{
    return 'Mr. ' . $this->first_name . ' ' . $this->middle_name . ' ' . $this->last_name;
}

public function getFullNameShort()
{
    return $this->first_name[0] . '. ' . $this->last_name;
}

🔝 返回目录

保持控制器的简洁

如果您使用的是查询生成器或原始SQL查询，请将所有与数据库相关的逻辑放入Eloquent模型或Repository类中。

例如:

1
2
3
4
5
6
7
8
9
10

public function index()
{
    $clients = Client::verified()
        ->with(['orders' => function ($q) {
            $q->where('created_at', '>', Carbon::today()->subWeek());
        }])
        ->get();

    return view('index', ['clients' => $clients]);
}

更优的写法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

public function index()
{
    return view('index', ['clients' => $this->client->getWithNewOrders()]);
}

class Client extends Model
{
    public function getWithNewOrders()
    {
        return $this->verified()
            ->with(['orders' => function ($q) {
                $q->where('created_at', '>', Carbon::today()->subWeek());
            }])
            ->get();
    }
}

🔝 返回目录

使用自定义Request类来进行验证

把验证规则放到 Request 类中.

例子:

1
2
3
4
5
6
7
8
9
10

public function store(Request $request)
{
    $request->validate([
        'title' => 'required|unique:posts|max:255',
        'body' => 'required',
        'publish_at' => 'nullable|date',
    ]);

    ....
}

更优的写法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

public function store(PostRequest $request)
{    
    ....
}

class PostRequest extends Request
{
    public function rules()
    {
        return [
            'title' => 'required|unique:posts|max:255',
            'body' => 'required',
            'publish_at' => 'nullable|date',
        ];
    }
}

🔝 返回目录

业务代码要放到服务层中

控制器必须遵循单一职责原则，因此最好将业务代码从控制器移动到服务层中。

例子:

1
2
3
4
5
6
7
8

public function store(Request $request)
{
    if ($request->hasFile('image')) {
        $request->file('image')->move(public_path('images') . 'temp');
    }
    
    ....
}

更优的写法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

public function store(Request $request)
{
    $this->articleService->handleUploadedImage($request->file('image'));

    ....
}

class ArticleService
{
    public function handleUploadedImage($image)
    {
        if (!is_null($image)) {
            $image->move(public_path('images') . 'temp');
        }
    }
}

🔝 返回目录

DRY原则 不要重复自己

尽可能重用代码，SRP可以帮助您避免重复造轮子。 此外尽量重复使用Blade模板，使用Eloquent的 scopes 方法来实现代码。

例子:

1
2
3
4
5
6
7
8
9
10
11

public function getActive()
{
    return $this->where('verified', 1)->whereNotNull('deleted_at')->get();
}

public function getArticles()
{
    return $this->whereHas('user', function ($q) {
            $q->where('verified', 1)->whereNotNull('deleted_at');
        })->get();
}

更优的写法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

public function scopeActive($q)
{
    return $q->where('verified', 1)->whereNotNull('deleted_at');
}

public function getActive()
{
    return $this->active()->get();
}

public function getArticles()
{
    return $this->whereHas('user', function ($q) {
            $q->active();
        })->get();
}

🔝 返回目录

使用ORM而不是纯sql语句，使用集合而不是数组

使用Eloquent可以帮您编写可读和可维护的代码。 此外Eloquent还有非常优雅的内置工具，如软删除，事件，范围等。

例子:

1
2
3
4
5
6
7
8
9
10
11
12

SELECT *
FROM `articles`
WHERE EXISTS (SELECT *
              FROM `users`
              WHERE `articles`.`user_id` = `users`.`id`
              AND EXISTS (SELECT *
                          FROM `profiles`
                          WHERE `profiles`.`user_id` = `users`.`id`) 
              AND `users`.`deleted_at` IS NULL)
AND `verified` = '1'
AND `active` = '1'
ORDER BY `created_at` DESC

更优的写法:

1

Article::has('user.profile')->verified()->latest()->get();

🔝 返回目录

集中处理数据

例子:

1
2
3
4
5
6
7

$article = new Article;
$article->title = $request->title;
$article->content = $request->content;
$article->verified = $request->verified;
// Add category to article
$article->category_id = $category->id;
$article->save();

更优的写法:

1

$category->article()->create($request->validated());

🔝 返回目录

不要在模板中查询，尽量使用惰性加载

例子 (对于100个用户，将执行101次DB查询):

1
2
3

@foreach (User::all() as $user)
    {{ $user->profile->name }}
@endforeach

更优的写法 (对于100个用户，使用以下写法只需执行2次DB查询):

1
2
3
4
5
6
7

$users = User::with('profile')->get();

...

@foreach ($users as $user)
    {{ $user->profile->name }}
@endforeach

🔝 返回目录

注释你的代码，但是更优雅的做法是使用描述性的语言来编写你的代码

例子:

1

if (count((array) $builder->getQuery()->joins) > 0)

加上注释:

1
2

// 确定是否有任何连接
if (count((array) $builder->getQuery()->joins) > 0)

更优的写法:

1

if ($this->hasJoins())

🔝 返回目录

不要把 JS 和 CSS 放到 Blade 模板中，也不要把任何 HTML 代码放到 PHP 代码里

例子:

1

let article = `{{ json_encode($article) }}`;

更好的写法:

1
2
3
4
5

<input id="article" type="hidden" value="@json($article)">

Or

<button class="js-fav-article" data-article="@json($article)">{{ $article->name }}<button>

在Javascript文件中加上:

1

let article = $('#article').val();

当然最好的办法还是使用专业的PHP的JS包传输数据。

🔝 返回目录

在代码中使用配置、语言包和常量，而不是使用硬编码

例子:

1
2
3
4
5
6

public function isNormal()
{
    return $article->type === 'normal';
}

return back()->with('message', 'Your article has been added!');

更优的写法:

1
2
3
4
5
6

public function isNormal()
{
    return $article->type === Article::TYPE_NORMAL;
}

return back()->with('message', __('app.article_added'));

🔝 返回目录

使用社区认可的标准Laravel工具

强力推荐使用内置的Laravel功能和扩展包，而不是使用第三方的扩展包和工具。
如果你的项目被其他开发人员接手了，他们将不得不重新学习这些第三方工具的使用教程。
此外，当您使用第三方扩展包或工具时，你很难从Laravel社区获得什么帮助。 不要让你的客户为额外的问题付钱。

🔝 返回目录

遵循laravel命名约定

来源 PSR standards.

另外，遵循Laravel社区认可的命名约定：

🔝 返回目录

尽可能使用简短且可读性更好的语法

例子:

1
2

$request->session()->get('cart');
$request->input('name');

更优的写法:

1
2

session('cart');
$request->name;

更多示例:

🔝 返回目录

使用IOC容器来创建实例 而不是直接new一个实例

创建新的类会让类之间的更加耦合，使得测试越发复杂。请改用IoC容器或注入来实现。

例子:

1
2

$user = new User;
$user->create($request->validated());

更优的写法:

1
2
3
4
5
6
7
8

public function __construct(User $user)
{
    $this->user = $user;
}

....

$this->user->create($request->validated());

🔝 返回目录

避免直接从 .env 文件里获取数据

将数据传递给配置文件，然后使用config（）帮助函数来调用数据

例子:

1

$apiKey = env('API_KEY');

更优的写法:

1
2
3
4
5

// config/api.php
'key' => env('API_KEY'),

// Use the data
$apiKey = config('api.key');

🔝 返回目录

使用标准格式来存储日期，用访问器和修改器来修改日期格式

例子:

1
2

{{ Carbon::createFromFormat('Y-d-m H-i', $object->ordered_at)->toDateString() }}
{{ Carbon::createFromFormat('Y-d-m H-i', $object->ordered_at)->format('m-d') }}

更优的写法:

1
2
3
4
5
6
7
8
9
10

// Model
protected $dates = ['ordered_at', 'created_at', 'updated_at'];
public function getSomeDateAttribute($date)
{
    return $date->format('m-d');
}

// View
{{ $object->ordered_at->toDateString() }}
{{ $object->ordered_at->some_date }}

🔝 返回目录

其他的一些好建议

永远不要在路由文件中放任何的逻辑代码。

尽量不要在Blade模板中写原始 PHP 代码。

🔝 返回目录

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

CanvasRenderingContext2D.prototype.wrapText = function (text, x, y, maxWidth, lineHeight) {
    if (typeof text != 'string' || typeof x != 'number' || typeof y != 'number') {
        return;
    }
    
    var context = this;
    var canvas = context.canvas;
    
    if (typeof maxWidth == 'undefined') {
        maxWidth = (canvas && canvas.width) || 300;
    }
    if (typeof lineHeight == 'undefined') {
        lineHeight = (canvas && parseInt(window.getComputedStyle(canvas).lineHeight)) || parseInt(window.getComputedStyle(document.body).lineHeight);
    }
    
    // 字符分隔为数组
    var arrText = text.split('');
    var line = '';
    
    for (var n = 0; n < arrText.length; n++) {
        var testLine = line + arrText[n];
        var metrics = context.measureText(testLine);
        var testWidth = metrics.width;
        if (testWidth > maxWidth && n > 0) {
            context.fillText(line, x, y);
            line = arrText[n];
            y += lineHeight;
        } else {
            line = testLine;
        }
    }
    context.fillText(line, x, y);
};

• canvas 文本绘制自动换行、字间距、竖排等实现
• example:自动换行扩展 API wrapText 演示 demo

1. 在链接页面还带着一些特效

借助 SVG 直接把 CSS 效果绘制上去

1
2
3
4
5
6
7
8
9
10
11
12
13

var canvas = document.querySelector('canvas');
var context = canvas.getContext('2d');
context.font = '16px sans-serif';
var width = canvas.width;
var height = canvas.height;
var tempImg = new Image();
tempImg.width = width;
tempImg.height = height;
tempImg.onload = function () {
    // 把img绘制在canvas画布上
    context.drawImage(this, 0, 0, width, height);
};
tempImg.src = 'data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg"><foreignObject width="'+ width +'" height="'+ height +'"><body xmlns="http://www.w3.org/1999/xhtml" style="margin:0;font:'+ context.font +';">我是一段需要换行的文字啦啦啦</body></foreignObject></svg>';

canvas借助SVG foreignObject实现文本自动换行demo

2. canvas 支持字符间距

   使用 css 的 letter-spacing 属性

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

var canvas = document.querySelector('canvas');
var context = canvas.getContext('2d');
var range = document.querySelector('input[type=range]');
// 绘制方法
var draw = function () {
    // 清除之前的绘制
    context.clearRect(0, 0, canvas.width, canvas.height);
    // 字符间距设置
    canvas.style.letterSpacing = range.value + 'px';
    // 并绘制文本，font属性值设置一定要在这里
    context.font = '32px sans-serif';
    context.fillText('我是一段文本', 0, 50);
};
// 改变字符间距后重绘
range.addEventListener('change', draw);
// 一进来根据默认值绘制
draw();

使用 canvas 计算逐字绘制

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

CanvasRenderingContext2D.prototype.letterSpacingText = function (text, x, y, letterSpacing) {
    var context = this;
    var canvas = context.canvas;
    
    if (!letterSpacing && canvas) {
        letterSpacing = parseFloat(window.getComputedStyle(canvas).letterSpacing);
    }
    if (!letterSpacing) {
        return this.fillText(text, x, y);
    }
    
    var arrText = text.split('');
    var align = context.textAlign || 'left';
    
    // 这里仅考虑水平排列
    var originWidth = context.measureText(text).width;
    // 应用letterSpacing占据宽度
    var actualWidth = originWidth + letterSpacing * (arrText.length - 1);
    // 根据水平对齐方式确定第一个字符的坐标
    if (align == 'center') {
        x = x - actualWidth / 2;
    } else if (align == 'right') {
        x = x - actualWidth;
    }
    
    // 临时修改为文本左对齐
    context.textAlign = 'left';
    // 开始逐字绘制
    arrText.forEach(function (letter) {
        var letterWidth = context.measureText(letter).width;
        context.fillText(letter, x, y);
        // 确定下一个字符的横坐标
        x = x + letterWidth + letterSpacing;
    });
    // 对齐方式还原
    context.textAlign = align;
};

3.canvas 支持竖直排列

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
48
49
50
51
52

CanvasRenderingContext2D.prototype.fillTextVertical = function (text, x, y) {
    var context = this;
    var canvas = context.canvas;
    
    var arrText = text.split('');
    var arrWidth = arrText.map(function (letter) {
        return context.measureText(letter).width;
    });
    
    var align = context.textAlign;
    var baseline = context.textBaseline;
    
    if (align == 'left') {
        x = x + Math.max.apply(null, arrWidth) / 2;
    } else if (align == 'right') {
        x = x - Math.max.apply(null, arrWidth) / 2;
    }
    if (baseline == 'bottom' || baseline == 'alphabetic' || baseline == 'ideographic') {
        y = y - arrWidth[0] / 2;
    } else if (baseline == 'top' || baseline == 'hanging') {
        y = y + arrWidth[0] / 2;
    }
    
    context.textAlign = 'center';
    context.textBaseline = 'middle';
    
    // 开始逐字绘制
    arrText.forEach(function (letter, index) {
        // 确定下一个字符的纵坐标位置
        var letterWidth = arrWidth[index];
        // 是否需要旋转判断
        var code = letter.charCodeAt(0);
        if (code <= 256) {
            context.translate(x, y);
            // 英文字符，旋转90°
            context.rotate(90 * Math.PI / 180);
            context.translate(-x, -y);
        } else if (index > 0 && text.charCodeAt(index - 1) < 256) {
            // y修正
            y = y + arrWidth[index - 1] / 2;
        }
        context.fillText(letter, x, y);
        // 旋转坐标系还原成初始态
        context.setTransform(1, 0, 0, 1, 0, 0);
        // 确定下一个字符的纵坐标位置
        var letterWidth = arrWidth[index];
        y = y + letterWidth;
    });
    // 水平垂直对齐方式还原
    context.textAlign = align;
    context.textBaseline = baseline;
};

看本文章的前提是你使用过github的pages服务，如果没有，请参考 GitHub Pages和自定义github pages 域名为自己的域名，然后再来查看本文。如果一切就绪，那请接着往下看。

准备工作

• 阿里云域名一个&VIP域名解析功能
• 清楚https的原理并了解letsencrypt，如果不清楚请自行补充知识。参考
  HTTPS详解&letsencrypt官网

正题

当我们具备以上条件后我们开始正题。

• 检查github pages 自定义域名设置正确。例如我的github pages的域名为 justmd5.github.io ，首先这个是能正常访问的。
• 其次如果以上没问题，那检查https://github.com/yourname/yourname.github.io/settings的设置是否正确

  

  设置

  
  确保设置成功自定义域名

  

  自定义域名

• 现在我们来操作阿里云，操作之前我们使用一条命令，查看下当前justmd5.github.io的解析情况。如图所示：

  

  dig结果

  ,此处的结果请记录下来，后边会用到。
• 登陆阿里云的域名解析，删除之前自定义域名的cname（如果之前你自定义过域名，应该懂我说的是什么）。
• 设置 A记录，加入刚才dig查询的结果，记住：有几条，设置几条A记录，如：我的自定义域名设置的是：dinghaijun.com，dig查justmd5.github.io 出来的是四条解析记录，那就添加四条A记录指向dig对应的四个IP地址。
• 接下来的事情就是重点了，使用VIP版（只有VIP版才支持 CAA）的域名解析，设置一条CAA解析，内容为：

  0 issue “letsencrypt.org”
  * 设置成功CAA后的解析情况如图：

  

  解析记录

到此，阿里云的工作就完成了。这时候你去使用https协议访问你的自定义域名，你猜会怎么样？作为技术人猜什么猜，访问下嘛！不好，浏览器拦截，告诉你证书不对。这时候想知道为什么嘛？我反正是在这里被坑了的。?给你几个提示Troubleshooting custom domains看完再朝下看解决方案。

• 如果你看到我给你的提示网址，里边有一段描述，设置自定义域名https的CAA解析后，记得删除一次自定义域名设置，确保自定义域名栏为空，保存。然后再设置一次自定义域名。这样操作的目的是触发github服务器的自定义域名查找和https证书签名生成。
• 做完上边一步，你发现设置中https那个勾还是灰色的，是不是有点沮丧?‍♂ 。先别沮丧，灰色选择框的文字，你仔细看了么。对了，就是等待域名证书的生成，当生成完成后，你会发现灰色选择框变为可选了（这个过程有点长，官方说24h，通常过一夜应该就好了。）看一下最终成功吧～！

  

  解析记录

  
  现在去使用https访问下你的博客，是不是瞬间感觉高大上（装B）了?！

附其他github pages对应自定义域名对应关系

购买阿里云产品

Laravel 提供了一些超赞的组件，在我看来，它是目前所有 Web 框架中提供组件支持最好的一个。它不仅提供了开箱即用的视图（views）、身份认证（authentication）、会话（sessions）、缓存（caching）、Eloquent、队列（queues）、数据校验（data validation）等组件。甚至还提供了开发工具（Valet 和 Homestead）。

但是，这个框架功能中最强大的一个特性常常被萌新们视而不见 - Collection（集合） 类。在这篇文章，我们将探寻如何使用集合提升编码效率、代码的易读行，及编写出更精简的编码。

预览

最初接触到使用集合的场景来自于研发人员使用 Eloquent 执行数据库查询，并从返回数据中使用 foreach 语句遍历获取模型集合。

不过，初学者可能并没有注意到，集合提供了超过 90 个以上的方法来操作底层数据。更妙的是几乎所有的方法都支持链式操作，能够让你的代码读起来就像一篇散文一样。这样使得你的代码更易阅读，无论是你还是其他使用者都是如此。

还没有进入正题？好吧，让我们回顾一个简单的代码片段，来看看我们如何使用集合编写粗、快、猛的代码吧。

代码示例

让我们构建一个真实的世界。假设我们查询某些 API 接口并获取到如下以数组保存的结果集：

1
2
3
4
5
6
7

<?php
// API 请求返回的结果
$data = [
    ['first_name' => 'John', 'last_name' => 'Doe', 'age' => 'twenties'],
    ['first_name' => 'Fred', 'last_name' => 'Ali', 'age' => 'thirties'],
    ['first_name' => 'Alex', 'last_name' => 'Cho', 'age' => 'thirties'],
];

我们看到数组包含名字（first name）、姓氏（last name） 和年龄（age）范围。现在，我们假设从记录中获取一名 年龄（age） 为 30 岁（thirties） 的用户，然后依据 姓氏（last name） 进行 排序（sort）。最后，我们还希望返回的结果为 一个字符串（single string），这样每个用户独占 一行（new line）。最后，我们还希望返回的结果为

这个需求看起来不难实现，现在让我们看看使用 PHP 如何实现这一功能：

// 依据姓氏排序

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

usort($data, function ($item1, $item2) {
    return $item1['last_name'] <=> $item2['last_name'];
});


// 依据年龄范围分组
$new_data = [];

foreach ($data as $key => $item) {
    $new_data[$item['age']][$key] = $item;
}

ksort($new_data, SORT_NUMERIC);

// 从年龄为 30 岁组里获取用户全名
$result = array_map(function($item) {
    return $item['first_name'].' '.$item['last_name'];
}, $new_data['thirties']);

// 将数组转换为字符串并以行分隔符分隔
$final = implode("\n", $result);

// 译注：原文是 $final = implode($results, “\n”); implode函数接收两种顺序的参数，为了保持与文档一致所以我这边做了调整。
我们的实现代码超过 20 行，并且很不优雅。移除掉注释及换行相关代码，这段代码会变得难以阅读。再者，我们还需要借助临时变量以及 PHP 中内置的不友好的 sort 方法。

现在，让我们看下借助 Collection 类实现起来是多么简单吧：

1
2
3
4
5
6

collection($data)->where('age', 'thirties')
                 ->sortBy('last_name')
                 ->map(function($item){
                    return $item['first_name'].' '.$item['last_name'];
                 })
                 ->implode("\n");

哇哦！我们的代码从 20 行变成了 6 行。现在的代码不仅顺畅不少，并且在方法实现时无需借助注释告诉我们它们在处理什么问题。

不过，还存在一个问题阻止我们的代码不如完美阶段… 就是用于比较 first name 和 last name 的 map 方法。坦白说，这真的不是什么大问题，但是它为我们探索 macro（宏） 概念提供了动力。

扩展集合（Extending Collections）

Collection 类，同其它 Laravel 组件一样，支持宏（macroable），就是说你可以给它添加方法随后使用。

提示： 如果你希望新方法随处可用，你应该将它们添加到服务提供中。我喜欢创建一个 MacroServiceProvider 实先这个功能，对于你来说随你喜欢就好。

让我们添加一个方法它会连接由数组提供的任意数量的字段并返回字符串结果：

1
2
3
4
5
6
7
8

Collection::macro('toConcatenatedString', function ($fields = [], $separator = ' ') {
    return $this->map(function($item) use ($fields, $separator) {
        return implode($separator, array_map(function ($el) use ($item) {
                return $item[$el];
            }, $fields)
        );
    })->implode("\n");
});

添加完这个方法后，我们的代码基本上就完美了：

1
2
3

collect($data)->where('age', 'thirties')
              ->sortBy('last_name')
              ->toConcatenatedString(['first_name', 'last_name']);

我们的代码从混乱的 20 多行精简到了 3 行，代码干净整洁功能清晰任何人都可以立马理解。

又一个示例

现在让我们看下第二个示例，假设我们一个用户列表，我们需要基于角色（role）过滤出来，然后进一步如果他们的注册时间为 5 年或以上且 last name 以字母 A-M 开始的仅获取第一个用户。

数据类似如下：

1
2
3
4
5
6
7

<?php
// API 请求返回的结果
$users = [
    ['name' => 'John Doe', 'role' => 'vip', 'years' => 7],
    ['name' => 'Fred Ali', 'role' => 'vip', 'years' => 3],
    ['name' => 'Alex Cho', 'role' => 'user', 'years' => 9],
];

如果我们使用的是 PHP 实现，我们的代码看下来如下：

1
2
3
4
5
6
7
8
9

$subset = [];
foreach ($users as $user) {
    if ($user['role'] === 'vip' && $user['years'] >= 5) {
        if (preg_match('/\s[A-Z]/', $user['name'])) {
            $subset[] = $user;
        }
    }
}
return reset($subset)

注意： 你可以将第二个 if 语句移至第一个里面，但是我个人喜欢在单个 if 语句中使用不超过两个条件语句，因为我认为超过 2 个条件语句回事代码难以阅读。

这段代码不至于太糟糕，但是我们依然需要使用临时变量，我们还需要使用 reset 函数将指针重置到第一个用户。我们的代码还有四层缩进，这使得代码解析变得更有挑战性。

相反，我们来看看集合是如何处理这个问题的：

1
2
3
4
5

collect($users)->where('role', 'vip')
              ->map(function($user) {
                  return preg_match('/\s[A-Z]/', $user['name']);
              })
              ->firstWhere('years', '>=', '5');

我们将代码简化到了之前的一般左右，每一步过滤处理清晰明了，并且我们不需要引入临时变量。

遗憾的是目前集合还不支持正则匹配，所以我们使用 map 方法，不过我们可以为这个功能创建一个宏：

1
2
3
4
5

Collection::macro('whereRegex', function($expression, $field) {
    return $this->map(function ($item) use ($expression, $field) {
        return preg_match($expression, $item[$field]);
    })
});

得益于宏方法，我们的代码现在看起来如下：

1
2
3

collect($users) -> where('role', 'vip')
                -> whereRegex('/\s[A-Z]/', 'name')
                -> firstWhere('years', '>=', 5);

注意： 为了简单起见，我们的红仅仅适用于数组集合。如果你计划让它们可以在 Eloquent 集合上使用，你需要在此场景下做相应的代码处理才行。

不同的视角

我们可以继续列出无数的示例，但仍然无法涵盖所有可用的集合方法，并且这从来都不是本文的真正目的。

需要注意的是，通过使用 Collection 类，您不仅可以获得一个方法库来简化编程工作，还可以选择一种从根本上改善代码的方法。

你会情不自禁的将你的代码结构从代码块重构简化成一行，同时减少代码的缩进，临时变量的使用和技巧性方法，另外你还可以使用链式编程方法，这让你的代码更加便于阅读和解析，此外最重要的是减少了编码工作！

查看官方文档获取更多这个迷人的类库的使用细节：https://laravel-china.org/docs/laravel/collections

提示： 你还可以获取这个 Collection 类独立安装包，在使用非 laravel 项目是会非常有帮助。感谢 Tighten Co 团队做出的努力 https://github.com/tightenco/collect。

感谢阅读，快乐编码！

原文

How Laravel Collections lead to Zen Code

项目地址：https://github.com/justmd5/tencent-ai

腾讯AI开放平台 SDK

Tencent AI open platform sdk

Requirement

1. PHP >= 7.0
2. Composer
3. ext-curl 拓展
4. ext-json 拓展

安装

composer require justmd5/tencent-ai

使用

1
2
3
4
5
6
7

$config  = [
    'appKey'    => '1106944xxx',
    'appSecret' => 'dsgnbnWnX8Yxxxxxx',
    'debug'     => 0,//1 show debug info 
];
$AI      = new \Justmd5\TencentAi\Ai($config);

接口调用示例

智能闲聊 url: https://api.ai.qq.com/fcgi-bin/nlp/nlp_textchat
请求示例如下：

1
2
3
4
5
6
7
8
9

$params = [
'question'=>'腾讯人工智能',
'session'=>123,
];
try {
    dd($AI->nlp->request('textchat', $params));
} catch (\Justmd5\TencentAi\Exception\NotFoundException $e) {
    dd($e);
}

文档

Tencent AI · Official Documents

帮助

qq群

Todo

• parameter verify

感谢

• thanks to hanson/foundation-sdk

源码列表

License

MIT

他说：“结果，结果就是做业务要同时操作三四套系统……”
就我所见，把原有系统“推倒重来”的喜好不只程序员有，使用者更有。拿我几年前的那份工作来说，刚入职老大们就来跟我讨论系统重做的打算：需要多少人，多少钱，多长时间，能把原有系统推翻重来。毕竟大家每天都忍受切肤之痛：速度慢、经常出错、不安全、客户抱怨、架构糟糕…… 所以都想拿出“敢叫日月换新天”的劲头，来个干脆的彻底解决。

这种心情可以理解，但在我任内“重做系统”一直没有被提上日程，整个技术团队所做的都是“改良”的工作，内容就像我上面说的：系统稳定性、安全性、增加冗余、理清各模块职责、API通讯机制的建立、内部分层的整理。这个选择我有充分把握，而且在我看来，如果断然“推倒重来”，我未必能比继任者做得更好，甚至可能更糟糕，因为“推倒重来”绝不是那么简单的事情。

众所周知，软件开发的难点之一就是控制复杂度。但是在不同的领域，复杂度有不同的表现。

对于纯互联网业务，或者IT基础架构来说，其复杂度在于软件本身，架构的制定、类库的选择、编码的质量等等。
对于其它IT系统——尤其是公司迅速成长，业务不断复杂化的IT系统——而言，其复杂度并不在于软件本身，安全、性能、负载的问题都套用现成的IT解决方案，真正的复杂度来自系统承载的业务本身。
比如最简单的：系统里有哪些单据，各种单据承载什么信息，用在什么场景，这些单据是怎样流转的，各种单据存在怎样的约束关系，出现异常情况应当如何处理才能保证业务数据的一致性……这些问题没有准确而稳定的答案，IT再怎样努力也是白搭。

对于已经能在线下规范运行的业务，或者是有经典解决方案的工作（比如财务、仓库管理），这些知识都是现成的，可以直接拿来用。但对于新兴领域、新兴业务来说，往往不存在“经典解决方案”。加上很多公司成长速度飞快，一开始并没有构筑好的IT基础（其实是业务架构基础）。

典型的情况就是：业务概念混乱不清，业务逻辑层也是杂乱无章，很多系统里干脆把数据库当作业务逻辑层（这可不是说笑，因为数据库无法推脱责任了）。结果，混乱的业务逻辑依附于糟糕的IT系统，乱上加乱最终成了一锅粥。

对IT来说，已有业务的问题层出不穷，每次出问题都需要花费大量精力，寻找蛛丝马迹来“破案”；对业务来说，新增业务往往会影响到原有业务，但谁也不知道会不会影响，会如何影响。系统日渐庞大的另一面是内部日趋无序，复杂度和维护成本飞速增长，远远超过可控范围。

吊诡的是，许多人的解决办法不是针对问题的根本原因，评估业务复杂度、整理业务逻辑、整理业务关系，反而认为“推倒重来”、新做一套系统就能解决。持这种观点的人，通常对系统与业务的关系也有误解。

对希望“推倒重来”的人来说，系统和业务的关系，有点像车辆对人员：一辆车我开了一段时间觉得不好，就想换一辆车来开，这是很自然的。但是在信息化深入工作各个角落的今天，系统和业务的关系远不是“车辆对人员”那么疏远，而更像“心脏起搏器对人”，或者“人造骨骼与肌肉”的关系，已经如胶似漆缠在了一起，系统对业务的支持越多越广（暂时不论质量），双方纠缠得也就越紧密。更换心脏起搏器或者人造骨骼的难度，远远比换车的难度要大，所以需要慎重考虑，不能单纯因为心脏起搏器“不那么好”就轻率决定更换。对系统来说，也是如此。
如果要对基础不好的遗留系统做脱胎换骨的改造，我有几点经验可以参考：

第一：一定要有非常优秀的业务人员和开发人员。

对业务人员来说，不但要熟悉自己手头的操作，还必须明白操作背后的逻辑，并且需要超越本职工作，能从全局角度来思考自己的业务（有时甚至要让自己操作更复杂，来提高系统安全性等收益），这样才能真正把握住业务的复杂度。对开发人员来说，要能够完整理解领域知识，同时必须有高超的编程能力来应对遗留代码，敢于出手而不是畏缩不前，谨慎出手而不是贸然行动——如果原有系统开发人员的技术能力可以打30分，全新开发系统的技术要求是60分，那么要成功改造遗留系统的技术人员，往往需要有80以上的分数才能胜任。

第二：“推倒重来”往往不如“逐步改良”。

所谓“逐步改良”，指的是大家先通过讨论确认未来系统的设计蓝图，然后需要开发用于过渡的接口层。于是，新开发的模块一定要严格按照新的规范开发（这也就是我说的“理清各模块职责、API通讯机制的建立、内部分层的整理”），同时通过过渡的接口层与原有系统对接，原有的模块则在理清业务逻辑的情况下，按需切出合适的接口，逐部分在测试通过的情况下进行迁移。最终新的系统是像拼图一样慢慢拼出来到最后一天才成型的，而不是平底盖楼造起来的。在这个过程中，最关键的是找到合适的切入点，搭建出合适的接口或者接口层。这些工作就像盖房子的脚手架，哪怕之后不会用到，中途也不能省略，还必须仔细对待。当然，这是一个考验人的工作——我曾经遇到过数据库事务里跨库连表的查询，这个糟糕的设计严重阻碍了单数据库实例拆分成多实例的进展，回想起来真是如噩梦一般。

如果你对改造遗留系统有自己的见解，或者在这个过程中有什么有意思的经历，欢迎留言给我。

最后推荐一本有意思的书。其实不管是软件开发还是社会变革，对于不喜欢的现状，大家往往喜欢来个“干脆”、“彻底”的解决方案，但真正成功的往往不是这些方案。在第二次世界大战结束时，世界上到底发生了哪些事情，遇到了哪些问题，又是怎样重建社会秩序的呢？广西师大《理想国》丛书第9册《零年：1945现代世界诞生的时刻》，用翔实的文笔全面记录了“终战”之后的情景，许多画面相信会让读者大吃一惊——很多时候“文明”堪称被打回原形，“零年”这个名字可谓名副其实。

Posted by Yurii under Yurii谈开发

Root Package（根目录包）

根目录包就是在你的项目的根目录由 composer.json 定义的包。主要就是由 composer.json 来定义你的项目的依赖。
某些字段只能在根目录包的中使用，比如 config 字段，只有根目录包能定义自己的配置。依赖包中的 config 字段是被忽略的。所以 config 字段是 root-only 的。
如果你克隆了其中一个依赖包并在上面工作，那么这个包就是根目录包。composer.json 还是一样的，但上下文不同。
（注：一个包是不是根目录包，取决于上下文。）

composer.json 中的各个属性（字段）

• name。包的名字。由供应方（vendor）名和项目名组成，用 / 分隔。==在发布包的时候需要填==。
• description 对包的一个简短描述，通常是一行的长度。==在发布包的时候需要填==。
• version 包的版本。格式必须是 X.Y.Z，选择性后缀：-dev、-alphaN、-betaN、-RCN。
• type包的类型，默认为 library。==包类型用于定制安装逻辑==。如果你的包的安装需要一些特殊的逻辑，你可以定义一个定制的类型。它可以是一个 symfony-bundle 的类型，或者 wordpress-plugin，或者 typo3-module。这些类型将被特定的项目所用，它们将提供安装器来安装这些类型的包。

Composer 支持 3 种类型：

• library：默认值。它将复制文件到 vendor 目录。
• project：它表示这是个项目，而不是库。比如像 Symfony 标准版这种应用。
• metapackage：一个含有依赖的空包，能触发安装，但不包含文件，不会向文件系统写任何东西。
• composer-install：为其他的定制类型的包提供安装器的包。
• keywords 一个与包相关的关键词数组。用于包的搜索和过滤。可选。

homepage

• 项目的网站 URL。
• 可选。

time

• 版本发布时间。
• 必须是 YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS 格式。
• 可选。

license

• 包的许可证。
• 可以是字符串或字符串数组。
• 可选，但强烈建议加上。

authors包的作者。是个对象数组。每个 author 对象有这些属性：

• name：作者名字
• email：作者邮箱
• homepage：作者网站 URL
• role：作者在项目中的角色（如：developer 或 translator）

support各种关于该项目如何获取支持的信息。包含这些属性：

• email：获取支持的邮箱
• issues：问题跟踪的 URL
• forum：论坛的 URL
• wiki：Wiki 的 URL
• irc：IRC 的频道
• source：查看或下载源码的 URL
• 可选。

Package links

依赖包的映射表，由包名映射版本约束。如：

1
2
3
4
5

{
    "require": {
        "monolog/monolog": "1.0.*"
    }
}

require列出包所依赖的包。

除非这些依赖已经存在，否则这个包不会被安装。

require-dev（root-only）列出开发这个包（或跑测试等等）所依赖的包。

在使用 install 命令时，只有带上 “–dev” 参数才能安装 dev 包。在使用 update 命令时，带上 “–no-dev” 则不更新。

conflict列出包会和哪些包发生冲突。

它们将不被允许和你的包一起安装。如果约束了版本，则只会针对特定的版本。

replace列出哪些包要被这个包替代。

provide这个包所推荐的包列表。

这个对公共接口最有用，一个包可以依赖一个虚拟的 logger 包，而实现 logger 接口的库可以放到 provide 字段中。

suggest建议一些能让这个包工作的更好或得到增强的包列表。

这些信息只在包安装完成时给出，暗示用户可以添加更多包，虽然不是必须要安装的。
格式是，包名映射文字说明，如：

1
2
3
4
5

{
    "suggest": {
        "monolog/monolog": "Allows more advanced logging of the application flow"
    }
}

autoload

提供给 PHP autoloader 的自动加载映射。
目前支持的有：PSR-0 自动加载规范，classmap 生成器，还有 files。
PSR-0 是比较推荐的，因为它的优秀的扩展性（在添加新的类的适合，不需要重新生成自动加载器）。
PSR-0
在 psr-0 键名下，定义一个命名空间到路径的映射表，相对于包的根目录。注意，这也同样支持 PEAR-style 的没有命名空间的风格。
请注意命名空间的声明得以 \ 结尾，确保自动加载器正确响应。
PSR-0 的引用可以在安装或更新时生成的文件中查看：
vendor/composer/autoload_namespaces.php
例子：

1
2
3
4
5
6
7
8
9

{
    "autoload": {
        "psr-0": {
            "Monolog\\": "src/",
            "Vendor\\Namespace\\": "src/",
            "Vendor_Namespace_": "src/"
        }
    }
}

如果你需要在多个目录里查找同一个前缀的命名空间，你可以用数组，如：

1
2
3
4
5

{
    "autoload": {
        "psr-0": { "Monolog\\": ["src/", "lib/"] }
    }
}

PSR-0 风格并不局限于加载命名空间的声明的东西，也可以用于类这个层级。当库中只有一个在全局命名空间中的类时，这种方式就能用上。比如你有个 PHP 源文件放在项目的根目录，你可以这样声明：

1
2
3
4
5
6

{
    "autoload": {
        "psr-0": { "UniqueGlobalClass": "" }
    }

}

如果你有个目录下全是用命名空间组织的，你可以用空前缀：

1
2
3
4
5

{
    "autoload": {
        "psr-0": { "": "src/" }
    }
}

（2）Classmap

classmap 的引用可以在安装或更新时生成的文件中查看：
vendor/composer/autoload_classmap.php
类映射表是通过扫描指定的目录或文件下的所有的 .php 和 .inc 文件生成的。
你可以给任何不支持 PSR-0 的库用 classmap 生成器实现自动加载。配置上只要指定类所在的目录或文件即可：

1
2
3
4
5

 {
    "autoload": {
        "classmap": ["src/", "lib/", "Something.php"]
    }
}

（3）files

如果你确定需要在任何请求中都加载某些文件，你可以使用 files 自动加载机制。对于那些包中有些 PHP 函数但不能自动加载时特别有用。例如：

1
2
3
4
5

{
    "autoload": {
        "files": ["src/MyLibrary/functions.php"]
    }
}

include-path

（将被弃用，它的功能由 autoload 代替。其实就是设置 include_path，可选）

target-dir

指定安装目标路径。

如果包的根目录是在命名空间下，自动加载就不正确了，所以才有 target-dir 来解决这个问题。

Symfony 就是个例子。它由很多组件包组成。Yaml 组件是在

Symfony\Component\Yaml
命名空间下的，它的根目录是 Yaml 目录。要让自动加载正常工作，我们要确保它不是安装在
vendor/symfony/yaml
，而是在
vendor/symfony/yaml/Symfony/Component/Yaml
，这样自动加载器才能从 vendor/symfony/yaml 加载它。
所以要定义 target-dir 如下：

1
2
3
4
5
6

{
    "autoload": {
        "psr-0": { "Symfony\\Component\\Yaml\\": "" }
    },
    "target-dir": "Symfony/Component/Yaml"
}

minimum-stability（root-only）

定义根据稳定性如何过滤包。默认是 stable，如果你信赖一个 dev 包，你需要指明。

prefer-stable（root-only）

如果开启，Composer 会在稳定包和不稳定包中选择前者。

repositories（root-only）

定制包的仓库地址。

默认的，Composer 只使用 Packagist 仓库。通过指定仓库地址，你可以从任何地方获取包。

仓库不能递归。你只能将它们添加到主的 composer.json 中。所依赖包中 composer.json 文件中的仓库定义是被忽略的。

支持的仓库的类型有：

• composer
  composer 仓库通过网络提供 packages.json 文件，它包含一个 composer.json 对象的列表，还有额外的 dist 或 source 信息。packages.json 文件通过 PHP 流加载。
• vcs
  版本控制系统仓库，如：git、svn、hg。
• pear
  通过它，你可以导入任何 pear 仓库到你的项目中。
• package
  如果你依赖一个不支持 composer 的项目，你可以定义一个 package 类型的仓库，然后将 composer.json 对象直接写入。

完整的例子：

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

{
    "repositories": [
        {
            "type": "composer",
            "url": "http://packages.example.com"
        },
        {
            "type": "composer",
            "url": "https://packages.example.com",
            "options": {
                "ssl": {
                    "verify_peer": "true"
                }
            }
        },
        {
            "type": "vcs",
            "url": "https://github.com/Seldaek/monolog"
        },
        {
            "type": "pear",
            "url": "http://pear2.php.net"
        },
        {
            "type": "package",
            "package": {
                "name": "smarty/smarty",
                "version": "3.1.7",
                "dist": {
                    "url": "http://www.smarty.net/files/Smarty-3.1.7.zip",
                    "type": "zip"
                },
                "source": {
                    "url": "http://smarty-php.googlecode.com/svn/",
                    "type": "svn",
                    "reference": "tags/Smarty_3_1_7/distribution/"
                }
            }
        }
    ]
}

config（root-only）

针对项目的一些配置：

process-timeout：默认 300 秒，Composer 进程执行超时时间；
use-include-path：默认 false，如果是 true，Composer 自动加载器也会到 PHP 的 include_path 中查找；
preferred-install：默认 auto，设置 Composer 安装方式；
github-protocols：默认 [“git”, “https”]，设置与 github 通信协议；
github-oauth：设置 oauth；
vendor-dir：默认 vendor，你可以换成别的；
bin-dir：默认 vendor/bin，如果项目有二进制文件，会链接到这；
cache-dir：默认 $home/cache，存放 Composer 运行时产生的缓存；
cache-files-dir：默认 $cache-dir/files，存放包的 zip 文件；
cache-repo-dir：默认 $cache-dir/repo，存放仓库元数据；
cache-vcs-dir：默认 $cache-dir/vcs，存放 vcs 克隆；
cache-files-ttl：默认六个月，缓存的过期时间；
cache-files-maxsize：默认 300M；
notify-no-install：默认 true，从仓库安装包会有个通知，可以关掉；
discard-changes：默认false，如何处理脏的更新；

• scripts（root-only）Composer 允许你在安装进程中安装钩子脚本，钩子是基于事件的；
• extra供 scripts 消费的额外数据；
• bin指定哪些文件必须被当做二进制文件处理的；
• archive
  设置创建包时的选项，exclude 属性可以设置排除哪些目录，例如：

1
2
3
4
5

{
    "archive": {
        "exclude": ["/foo/bar", "baz", "/*.test", "!/foo/bar/baz"]
    }
}

这篇看下来，再看 Symfony 的标准版中的 composer.json，应该了然了吧。

版本格式：主版本号.次版本号.修订号，版本号递增规则如下：

• 主版本号：当你做了不兼容的 API 修改，
• 次版本号：当你做了向下兼容的功能性新增，
• 修订号：当你做了向下兼容的问题修正。
• 先行版本号及版本编译信息可以加到“主版本号.次版本号.修订号”的后面，作为延伸。

简介

在软件管理的领域里存在着被称作“依赖地狱”的死亡之谷，系统规模越大，加入的套件越多，你就越有可能在未来的某一天发现自己已深陷绝望之中。

在依赖高的系统中发布新版本套件可能很快会成为恶梦。如果依赖关系过高，可能面临版本控制被锁死的风险（必须对每一个相依套件改版才能完成某次升级）。而如果依赖关系过于松散，又将无法避免版本的混乱（假设兼容于未来的多个版本已超出了合理数量）。当你专案的进展因为版本相依被锁死或版本混乱变得不够简便和可靠，就意味着你正处于依赖地狱之中。

作为这个问题的解决方案之一，我提议用一组简单的规则及条件来约束版本号的配置和增长。这些规则是根据（但不局限于）已经被各种封闭、开放源码软件所广泛使用的惯例所设计。为了让这套理论运作，你必须先有定义好的公共 API 。这可以透过文件定义或代码强制要求来实现。无论如何，这套 API 的清楚明了是十分重要的。一旦你定义了公共 API，你就可以透过修改相应的版本号来向大家说明你的修改。考虑使用这样的版本号格式：XYZ （主版本号.次版本号.修订号）修复问题但不影响API 时，递增修订号；API 保持向下兼容的新增及修改时，递增次版本号；进行不向下兼容的修改时，递增主版本号。

我称这套系统为“语义化的版本控制”，在这套约定下，版本号及其更新方式包含了相邻版本间的底层代码和修改内容的信息。

语义化版本控制规范（SemVer）

• 以下关键词 MUST、MUST NOT、REQUIRED、SHALL、SHALL NOT、SHOULD、SHOULD NOT、 RECOMMENDED、MAY、OPTIONAL 依照 RFC 2119 的叙述解读。（译注：为了保持语句顺畅， 以下文件遇到的关键词将依照整句语义进行翻译，在此先不进行个别翻译。）

• 使用语义化版本控制的软件“必须 MUST ”定义公共 API。该 API 可以在代码中被定义或出现于严谨的文件内。无论何种形式都应该力求精确且完整。

• 标准的版本号“必须 MUST ”采用 XYZ 的格式，其中 X、Y 和 Z 为非负的整数，且“禁止 MUST NOT”在数字前方补零。X 是主版本号、Y 是次版本号、而 Z 为修订号。每个元素“必须 MUST ”以数值来递增。例如：1.9.1 -> 1.10.0 -> 1.11.0。

• 标记版本号的软件发行后，“禁止 MUST NOT ”改变该版本软件的内容。任何修改都“必须 MUST ”以新版本发行。

• 主版本号为零（0.y.z）的软件处于开发初始阶段，一切都可能随时被改变。这样的公共 API 不应该被视为稳定版。

• 1.0.0 的版本号用于界定公共 API 的形成。这一版本之后所有的版本号更新都基于公共 API 及其修改内容。

• 修订号 Z（x.y.Z | x > 0）“必须 MUST ”在只做了向下兼容的修正时才递增。这里的修正指的是针对不正确结果而进行的内部修改。

• 次版本号 Y（x.Y.z | x > 0）“必须 MUST ”在有向下兼容的新功能出现时递增。在任何公共 API 的功能被标记为弃用时也“必须 MUST ”递增。也“可以 MAY ”在内部程序有大量新功能或改进被加入时递增，其中“可以 MAY ”包括修订级别的改变。每当次版本号递增时，修订号“必须 MUST ”归零。

• 主版本号 X（X.y.z | X > 0）“必须 MUST ”在有任何不兼容的修改被加入公共 API 时递增。其中“可以 MAY ”包括次版本号及修订级别的改变。每当主版本号递增时，次版本号和修订号“必须 MUST ”归零。

• 先行版本号“可以 MAY ”被标注在修订版之后，先加上一个连接号再加上一连串以句点分隔的标识符号来修饰。标识符号“必须 MUST ”由 ASCII 码的英数字和连接号 [0-9A-Za-z-] 组成，且“禁止 MUST NOT ”留白。数字型的标识符号“禁止 MUST NOT ”在前方补零。先行版的优先级低于相关联的标准版本。被标上先行版本号则表示这个版本并非稳定而且可能无法达到兼容的需求。范例：1.0.0-alpha、1.0.0-alpha.1、1.0.0-0.3.7、1.0.0-x.7.z.92。

• 版本编译信息“可以 MAY ”被标注在修订版或先行版本号之后，先加上一个加号再加上一连串以句点分隔的标识符号来修饰。标识符号“必须 MUST ”由 ASCII 的英数字和连接号 [0-9A-Za-z-] 组成，且“禁止 MUST NOT ”留白。当判断版本的优先层级时，版本编译信息“可 SHOULD ”被忽略。因此当两个版本只有在版本编译信息有差别时，属于相同的优先层级。范例：1.0.0-alpha+001、1.0.0+20130313144700、1.0.0-beta+exp.sha.5114f85。

• 版本的优先层级指的是不同版本在排序时如何比较。判断优先层级时，“必须 MUST ”把版本依序拆分为主版本号、次版本号、修订号及先行版本号后进行比较（版本编译信息不在这份比较的列表中）。由左到右依序比较每个标识符号，第一个差异值用来决定优先层级：主版本号、次版本号及修订号以数值比较，例如：1.0.0 < 2.0.0 < 2.1.0 < 2.1.1。当主版本号、次版本号及修订号都相同时，改以优先层级比较低的先行版本号决定。例如：1.0.0-alpha < 1.0.0。有相同主版本号、次版本号及修订号的两个先行版本号，其优先层级“必须 MUST ”透过由左到右的每个被句点分隔的标识符号来比较，直到找到一个差异值后决定：只有数字的标识符号以数值高低比较，有字母或连接号时则逐字以 ASCII 的排序来比较。数字的标识符号比非数字的标识符号优先层级低。若开头的标识符号都相同时，栏位比较多的先行版本号优先层级比较高。范例：1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-alpha.beta < 1.0.0-beta < 1.0.0-beta.2 < 1.0.0-beta.11 < 1.0.0- rc.1 < 1.0.0。

为什么要使用语义化的版本控制？

这并不是一个新的或者革命性的想法。实际上，你可能已经在做一些近似的事情了。问题在于只是“近似”还不够。如果没有某个正式的规范可循，版本号对于依赖的管理并无实质意义。将上述的想法命名并给予清楚的定义，让你对软件使用者传达意向变得容易。一旦这些意向变得清楚，弹性（但又不会太弹性）的依赖规范就能达成。

举个简单的例子就可以展示语义化的版本控制如何让依赖地狱成为过去。假设有个名为“救火车”的函式库，它需要另一个名为“梯子”并已经有使用语义化版本控制的套件。当救火车创建时，梯子的版本号为 3.1.0。因为救火车使用了一些版本 3.1.0 所新增的功能， 你可以放心地指定相依于梯子的版本号大等于 3.1.0 但小于 4.0.0。这样，当梯子版本 3.1.1 和 3.2.0 发布时，你可以将直接它们纳入你的套件管理系统，因为它们能与原有相依的软件兼容。

作为一位负责任的开发者，你理当确保每次套件升级的运作与版本号的表述一致。现实世界是复杂的，我们除了提高警觉外能做的不多。你所能做的就是让语义化的版本控制为你提供一个健全的方式来发行以及升级套件，而无需推出新的相依套件，节省你的时间及烦恼。

如果你对此认同，希望立即开始使用语义化版本控制，你只需声明你的函式库正在使用它并遵循这些规则就可以了。请在你的 README 文件中保留此页连结，让别人也知道这些规则并从中受益。

FAQ

在 0.y.z 初始开发阶段，我该如何进行版本控制？

最简单的做法是以 0.1.0 作为你的初始化开发版本，并在后续的每次发行时递增次版本号。

如何判断发布 1.0.0 版本的时机？

当你的软件被用于正式环境，它应该已经达到了 1.0.0 版。如果你已经有个稳定的 API 被使用者依赖，也会是 1.0.0 版。如果你很担心向下兼容的问题，也应该算是 1.0.0 版了。

这不会阻碍快速开发和迭代吗？

主版本号为零的时候就是为了做快速开发。如果你每天都在改变 API，那么你应该仍在主版本号为零的阶段（0.y.z），或是正在下个主版本的独立开发分支中。

对于公共 API，若即使是最小但不向下兼容的改变都需要产生新的主版本号，岂不是很快就达到 42.0.0 版？

这是开发的责任感和前瞻性的问题。不兼容的改变不应该轻易被加入到有许多依赖代码的软件中。升级所付出的代价可能是巨大的。要递增主版本号来发行不兼容的改版，意味着你必须为这些改变所带来的影响深思熟虑，并且评估所涉及的成本及效益比。

为整个公共 API 写文件太费事了！

为供他人使用的软件编写适当的文件，是你作为一名专业开发者应尽的职责。保持专案高效一个非常重要的部份是掌控软件的复杂度，如果没有人知道如何使用你的软件或不知道哪些函数的调用是可靠的，要掌控复杂度会是困难的。长远来看，使用语义化版本控制以及对于公共 API 有良好规范的坚持，可以让每个人及每件事都运行顺畅。

万一不小心把一个不兼容的改版当成了次版本号发行了该怎么办？

一旦发现自己破坏了语义化版本控制的规范，就要修正这个问题，并发行一个新的次版本号来更正这个问题并且恢复向下兼容。即使是这种情况，也不能去修改已发行的版本。可以的话，将有问题的版本号记录到文件中，告诉使用者问题所在，让他们能够意识到这是有问题的版本。

如果我更新了自己的依赖但没有改变公共 API 该怎么办？

由于没有影响到公共 API，这可以被认定是兼容的。若某个软件和你的套件有共同依赖，则它会有自己的依赖规范，作者也会告知可能的冲突。要判断改版是属于修订等级或是次版等级，是依据你更新的依赖关系是为了修复问题或是加入新功能。对于后者，我经常会预期伴随着更多的代码，这显然会是一个次版本号级别的递增。

如果我变更了公共 API 但无意中未遵循版本号的改动怎么办呢？（意即在修订等级的发布中，误将重大且不兼容的改变加到代码之中）

自行做最佳的判断。如果你有庞大的使用者群在依照公共 API 的意图而变更行为后会大受影响，那么最好做一次主版本的发布，即使严格来说这个修复仅是修订等级的发布。记住， 语义化的版本控制就是透过版本号的改变来传达意义。若这些改变对你的使用者是重要的，那就透过版本号来向他们说明。

我该如何处理即将弃用的功能？

弃用现存的功能是软件开发中的家常便饭，也通常是向前发展所必须的。当你弃用部份公共 API 时，你应该做两件事：（1）更新你的文件让使用者知道这个改变，（2）在适当的时机将弃用的功能透过新的次版本号发布。在新的主版本完全移除弃用功能前，至少要有一个次版本包含这个弃用信息，这样使用者才能平顺地转移到新版 API。

语义化版本对于版本的字串长度是否有限制呢？

没有，请自行做适当的判断。举例来说，长到 255 个字元的版本已过度夸张。再者，特定的系统对于字串长度可能会有他们自己的限制。

关于

语义化版本控制的规范是由 Gravatars 创办者兼 GitHub 共同创办者 Tom Preston-Werner 所建立。

原文

地址

译文

每个框架可能需求有一个或多个安装路径不同的依赖包。通过使用composer/installers，Composer能够把包安装到除vendor外的其他文件夹里面。

如果你是包的作者，并且你想把包安装到指定路径，最简单的办法就是require composer/installers 并且设置合适的type 属性。对于类似CakePHP，Drupal 和 WordPress等框架，这是非常普通的需求。下面以WordPress主题的一个composer.json文件为例：

1
2
3
4
5
6
7

{
    "name": "you/themename",
    "type": "wordpress-theme",
    "require": {
        "composer/installers": "~1.0"
    }
}

当使用Composer安装这个主题时，将会安装到wp-content/themes/themename/文件夹中。目前直接类型，请点击查看。

使用额外的installer-paths配置，自定包可以定义或重写依赖包的安装路径。一个有用的例子，Drupal配置多站点时，需要将包安装到站点的子目录中。现在，我们使用compser/installers为模块重写安装路径：

1
2
3
4
5
6
7

{
    "extra": {
        "installer-paths": {
            "sites/example.com/modules/{$name}": ["vendor/package"]
        }
    }
}

现在，依赖包就不会安装在composer/installers指定的位置，而是安装到你指定的文件位置中了。

PHP7已经到7.0.6版本了，是时候来尝试下小象飞的时候了，哈哈，那么就来配个PHP7的环境来玩玩…

更换时区

1
2

$ sudo cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
$ ntpdate time.windows.com && hwclock -w

查看CentOS 版本

$ cat /etc/redhat-release
顺便看看linux环境内核、gcc信息
$ cat /proc/version

更换163 yum 源

• 登录mirrors.163.com
• 点击centos后面的“centos使用帮助”
• $ mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup
• 下载对应版本repo文件, 放入/etc/yum.repos.d/(操作前请做好相应备份),我的是CentOS6

1
2
3

$ cd /etc/yum.repos.d/&&wget http://mirrors.163.com/.help/CentOS6-Base-163.repo
$ yum clean all
$ yum makecache

升级gcc版本

• 先升级到4.7版本

1
2
3
4
5
6
7
8
9
10

$ cd /etc/yum.repos.d
$ sudo wget http://people.centos.org/tru/devtools-1.1/devtools-1.1.repo 
$ sudo yum --enablerepo=testing-1.1-devtools-6 install devtoolset-1.1-gcc devtoolset-1.1-gcc-c++
$ mv /usr/bin/gcc /usr/bin/gcc-4.4.7
$ mv /usr/bin/g++ /usr/bin/g++-4.4.7
$ mv /usr/bin/c++ /usr/bin/c++-4.4.7
$ ln -s /opt/centos/devtoolset-1.1/root/usr/bin/gcc /usr/bin/gcc
$ ln -s /opt/centos/devtoolset-1.1/root/usr/bin/c++ /usr/bin/c++
$ ln -s /opt/centos/devtoolset-1.1/root/usr/bin/g++ /usr/bin/g++
$ gcc --version

• 升级到4.8

1
2
3
4
5
6
7
8
9
10

$ cd /etc/yum.repos.d
$ wget http://people.centos.org/tru/devtools-2/devtools-2.repo
$ yum install devtoolset-2-gcc devtoolset-2-binutils devtoolset-2-gcc-c++
$ mv /usr/bin/gcc /usr/bin/gcc-4.4.7
$ mv /usr/bin/g++ /usr/bin/g++-4.4.7
$ mv /usr/bin/c++ /usr/bin/c++-4.4.7
$ ln -s /opt/rh/devtoolset-2/root/usr/bin/gcc /usr/bin/gcc
$ ln -s /opt/rh/devtoolset-2/root/usr/bin/c++ /usr/bin/c++
$ ln -s /opt/rh/devtoolset-2/root/usr/bin/g++ /usr/bin/g++
$ gcc --version

安装先导库

1

$ yum install php-mcrypt libmcrypt libmcrypt-devel  libxml2-devel  openssl-devel  libcurl-devel libjpeg.x86_64 libpng.x86_64 freetype.x86_64 libjpeg-devel.x86_64 libpng-devel.x86_64 freetype-devel.x86_64  libjpeg-turbo-devel   libmcrypt-devel   mysql-devel  -y

安装php7

• 下载php7最新源码

1

$ cd ~&&wget http://cn2.php.net/distributions/php-7.0.6.tar.gz

• 解压

1

$ tar zxvf php-7.0.6.tar.gz&&cd cd php-7.0.6

• 编译安装

1
2

$ ./configure --prefix=/usr/local/php7 --with-config-file-path=/usr/local/php7/etc --with-mcrypt=/usr/include --enable-mysqlnd --with-gd --with-iconv --with-zlib --enable-bcmath --enable-shmop --enable-sysvsem --enable-inline-optimization --enable-mbregex --enable-fpm --enable-mbstring --enable-ftp --enable-gd-native-ttf --with-openssl --enable-pcntl --enable-sockets --with-xmlrpc --enable-zip --enable-soap --with-gettext --with-curl --with-jpeg-dir --with-freetype-dir --with-mysqli --enable-embedded-mysqli  --with-pdo-mysql --with-config-file-scan-dir=/usr/local/php7/etc/conf.d
$make&&sudo make install

• 建立软连接到/usr/local/bin/

1

$ sudo ln -s /usr/local/php7/bin/php* /usr/local/bin/

• 配置php

1
2
3
4
5

$ cp php.ini-production /usr/local/php7/etc/php.ini
$ cp sapi/fpm/init.d.php-fpm /etc/init.d/php7-fpm
$ chmod +x /etc/init.d/php7-fpm
$ cp /usr/local/php7/etc/php-fpm.conf.default /usr/local/php7/etc/php-fpm.conf
$ cp /usr/local/php7/etc/php-fpm.d/www.conf.default /usr/local/php7/etc/php-fpm.d/www.conf

• 加入opcache

1

$ sudo vim /usr/local/php7/etc/conf.d/opcache.ini

加入： zend_extension=/usr/local/php7/lib/php/extensions/no-debug-non-zts-20151012/opcache.so
参考：

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

[opcache]
zend_extension=/usr/local/php7/lib/php/extensions/no-debug-non-zts-20151012/opcache.so
; Determines if Zend OPCache is enabled 启用opcache
opcache.enable=1
; Determines if Zend OPCache is enabled for the CLI version of PHP 在cli下启用opcache
opcache.enable_cli=1
; The OPcache shared memory storage size. opcache使用的内存,单位MB
opcache.memory_consumption=256
; The amount of memory for interned strings in Mbytes.
opcache.interned_strings_buffer=8
; The maximum number of keys (scripts) in the OPcache hash table.
; Only numbers between 200 and 100000 are allowed. 存储最大的对象数目
opcache.max_accelerated_files=100000
; The maximum percentage of "wasted" memory until a restart is scheduled. 最大浪费内存百分比,超出将会GC
opcache.max_wasted_percentage=5
; When this directive is enabled, the OPcache appends the current working
; directory to the script key, thus eliminating possible collisions between
; files with the same name (basename). Disabling the directive improves
; performance, but may break existing applications.
opcache.use_cwd=1
; When disabled, you must reset the OPcache manually or restart the
; webserver for changes to the filesystem to take effect. 验证文件改动时间错,开启之后将由validate_timestamps来提供刷新频率,对于加载文件很多的程序性能有极大影响,关闭之后将会杜绝验证文件的时候造成的抖动,但是更新文件之后需要手动重启服务或者刷新全部内容
opcache.validate_timestamps=0
; How often (in seconds) to check file timestamps for changes to the shared
; memory storage allocation. ("1" means validate once per second, but only
; once per request. "0" means always validate) 验证时间间隔,1表示1秒,0表示总是验证
opcache.revalidate_freq=5
; Enables or disables file search in include_path optimization
opcache.revalidate_path=1
; If disabled, all PHPDoc comments are dropped from the code to reduce the
; size of the optimized code. 缓存中保存文档信息
opcache.save_comments=1
; If disabled, PHPDoc comments are not loaded from SHM, so "Doc Comments"
; may be always stored (save_comments=1), but not loaded by applications
; that don't need them anyway. 加载文档信息
opcache.load_comments=1

• 启动

1

$ sudo /etc/init.d/php7-fpm start

• ==为了安全最好是去掉头信息 X-Powered-By: PHP/7.则修改 php.ini 文件 设置 expose_php = Off==

1

$ vim /usr/local/php7/etc/php.ini

找到 expose_php = On
改为 expose_php = Off

安装redis扩展

• 首先要安装依赖 igbinary

1
2
3
4
5
6

$ cd ~&&wget https://github.com/igbinary/igbinary7/archive/master.zip -O igbinary7.zip&&unzip igbinary7.zip&&cd igbinary7-master
$ phpize
$./configure
$ make&&sudo make install
$ cd /usr/local/php7/etc/conf.d/&&sudo cp opcache.ini igbinary.ini
$ vim igbinary.ini加入：extension=/usr/local/php7/lib/php/extensions/no-debug-non-zts-20151012/igbinary.so

• 安装redis
  安装git

  1	$ sudo yum install git

• 检出redis

1
2
3
4
5
6
7
8

$ git clone https://github.com/phpredis/phpredis.git
$ cd phpredis&&git branch -r
$ git branch --track php7 origin/php7
$ git checkout php7
$ phpize&&./configure --enable-redis-igbinary
$ make &&sudo make install
$ cd /usr/local/php7/etc/conf.d&&sudo cp igbinary.ini redis.ini
$ vim redis.ini加入：extension=/usr/local/php7/lib/php/extensions/no-debug-non-zts-20151012/redis.so

安装mongodb扩展

1
2
3
4
5
6
7

$ git clone https://github.com/mongodb/mongo-php-driver.git &&cd mongo-php-driver
$ git submodule sync && git submodule update --init
$ phpize
$ ./configure --with-php-config=/usr/local/php7/bin/php-config
$ make all -j 5&& sudo make install
$ cd /usr/local/php7/etc/conf.d&&sudo cp redis.ini mongodb.ini
$ vim  mongodb.ini加入：extension=/usr/local/php7/lib/php/extensions/no-debug-non-zts-20151012/mongodb.so

安装mamcache扩展

• 检出git仓库

1
2
3
4
5
6
7
8
9

$ git clone git clone https://github.com/websupport-sk/pecl-memcache.git
$ cd pecl-memcache&git branch -r
$ git branch --track php7 origin/php7
$ git checkout php7
$ phpize
$ ./configure&&make
$ sudo make install
$ cd /usr/local/php7/etc/conf.d&&sudo cp redis.ini memcache.ini
$ sudo vim  memcache.ini加入：extension=/usr/local/php7/lib/php/extensions/no-debug-non-zts-20151012/memcache.so

安装mamcached扩展

• 源码安装libmemcached

1
2
3
4

$ wget https://launchpad.net/libmemcached/1.0/1.0.18/+download/libmemcached-1.0.18.tar.gz&&tar zxvf libmemcached-1.0.18.tar.gz
$ cd libmemcached-1.0.18
$ ./configure --prefix=/usr/local/libmemcached --enable-sasl
$make && sudo make install

• 检出git仓库

1
2
3
4
5
6
7

$ git clone https://github.com/php-memcached-dev/php-memcached.git
$ cd php-memcached&&git checkout php7 orgin/php7&&git pull
$ phpize
$ ./configure --with-libmemcached-dir=/usr/local/libmemcached
$ sudo make &&make install
$ cd /usr/local/php7/etc/conf.d&&sudo cp memcache.ini memcached.ini
$ sudo vim  memcached.ini加入：extension=/usr/local/php7/lib/php/extensions/no-debug-non-zts-20151012/memcached.so

安装apcu扩展

1
2
3
4
5
6
7
8
9
10
11
12
13

$ wget https://github.com/krakjoe/apcu/archive/v5.1.4.zip -O apcu-v5.1.4.zip&&unzip apcu-v5.1.4.zip&& cd apcu-5.1.4/
$ php phpize&& ./configure
$ make&&&&sudo make install
$ cd /usr/local/php7/etc/conf.d&&sudo cp redis.ini apcu.ini
$ sudo vim  apcu.ini
加入：
extension=/usr/local/php7/lib/php/extensions/no-debug-non-zts-20151012/apcu.so
[apcu]
apc.enabled=1
apc.shm_segments=1
apc.shm_size=64M
apc.ttl=0
apc.enable_cli=1apcu.so

1
2
3

SELECT * FROM table WHERE YEAR(d) > 2011;
优化为：
SELECT * FROM table WHERE d > '2011-01-01';

原则2.使用JOIN联表时，应用最小结果集驱动最大结果集。同时把复杂的JOIN查询拆分为多个Query。因为JOIN多张表时，可能会导致更多的锁表和堵塞。

1
2
3
4

SELECT   *  FROM  a  JOIN  b  ON  a.id  = b.id
LEFT JOIN  c  ON  c.time  =  d.date
LEFT JOIN  d  ON  c.pid  =  b.aid
LEFT JOIN  e  ON  e.cid  =  a.did;

原则3.注意LIKE模糊查询的使用，避免使用 %..% 。

1
2
3

SELECT  *  FROM table  WHERE  name  LIKE  %de%;
优化为：
SELECT  *  FROM  table  WHERE   name >=  'de'   AND  name  < 'df';

//局限性很大[慎重]

原则4.仅列出需要查询的字段，这对速度不会有明显的影响，主要考虑节省内存。

1
2
3
4

SELECT  *  FROM  tabel;
(据说有公司见遇到一个 * 号 扣10块钱~~~ :(  )
优化为：
SELECT  id,name,age   FROM  table;

(需要多少取多少，是 * 的话，如果无用字段数据过大则内存消耗比较大)

原则5.使用批量插入语句节省数据库交互。

1
2
3
4
5
6

INSERT  INTO  table  (id,name)  VALUES(1,'sunphp');
INSERT  INTO  table  (id,name)  VALUES(2,'mysql');
INSERT  INTO  table  (id,name)  VALUES(3,'优化');
优化为：
INSERT INTO table (id,name) VALUES(1,'sunphp'),
VALUES(2,'mysql'),VALUES(3,'优化');

原则6.Limit的基数比较大时使用between。

1
2
3

SELECT  *  FROM  article  ORDER BY  id  LIMIT  1000000, 10;
优化为：
SELECT  * FROM  article  WHERE  id BETWEEN  1000000  AND  1000010  ORDER  BY  id;

Between 限定比Limit快，所以在海量数据访问时，建议用Between 或是 where 替换掉 limit。
但是between 也有缺陷，如果id中间有断行或是中间部分id不读取的情况，总读取量可能小于预计读取量(有损服务)。
在去比较靠后的数据时，通过 desc 方式吧数据反向查找，以减少对前面数据的扫描，让 limit 得基数越小越好。

原则7.不要使用 rand 函数获得随机多条记录。

1
2
3
4
5
6
7

SELECT  *  FROM  table  ORDER BY  rand()  LIMIT  20;
使用下面的语句代替：
SELECT  * FROM  table  AS t1
JOIN  (
SELECT  ROUND(  RAND()  *   (  SELECT  MAX(id)  FROM table  ) - (  SELECT MIN(id)  FROM table  )  )  + (SELECT  MIN(id) FROM  table )
)  AS  id
)  AS  t2  WHERE  t1.id  >=  t2.id  ORDER BY  t1.id   LIMIT  t1;

这是获得一条随机记录，这样即使执行20次，也比原来的语句效率高。或者先用PHP产生随机数，把这些字符传给MySQL，MySQL 里面使用 in 查询。

原则8.避免使用 null。

原则9.不要使用 count(id)，而应该使用 count(*)。

原则10.不要做无谓的排序操作，而应该尽可能在索引中完成排序。

统一中文文案、排版的相关用法，降低团队成员之间的沟通成本，增强网站气质。

目录

• 空格
  • 中英文之间需要增加空格
  • 中文与数字之间需要增加空格
  • 数字与单位之间需要增加空格
  • 全角标点与其他字符之间不加空格
  • -ms-text-autospace to the rescue?
• 标点符号
  • 不重复使用标点符号
• 全角和半角
  • 使用全角中文标点
  • 数字使用半角字符
  • 遇到完整的英文整句、特殊名词，其內容使用半角标点
• 名词
  • 专有名词使用正确的大小写
  • 不要使用不地道的缩写
• 争议
  • 链接之间增加空格
  • 简体中文使用直角引号
• 工具
• 谁在这样做？
• 参考文献

空格

「有研究显示，打字的时候不喜欢在中文和英文之间加空格的人，感情路都走得很辛苦，有七成的比例会在 34 岁的时候跟自己不爱的人结婚，而其余三成的人最后只能把遗产留给自己的猫。毕竟爱情跟书写都需要适时地留白。

与大家共勉之。」——vinta/paranoid-auto-spacing

中英文之间需要增加空格

正确：

在 LeanCloud 上，数据存储是围绕 AVObject 进行的。

错误：

在LeanCloud上，数据存储是围绕AVObject进行的。

在 LeanCloud上，数据存储是围绕AVObject 进行的。

完整的正确用法：

在 LeanCloud 上，数据存储是围绕 AVObject 进行的。每个 AVObject 都包含了与 JSON 兼容的 key-value 对应的数据。数据是 schema-free 的，你不需要在每个 AVObject 上提前指定存在哪些键，只要直接设定对应的 key-value 即可。

例外：「豆瓣FM」等产品名词，按照官方所定义的格式书写。

中文与数字之间需要增加空格

正确：

今天出去买菜花了 5000 元。

错误：

今天出去买菜花了 5000元。

今天出去买菜花了5000元。

数字与单位之间需要增加空格

正确：

我家的光纤入户宽带有 10 Gbps，SSD 一共有 20 TB。

错误：

我家的光纤入户宽带有 10Gbps，SSD 一共有 10TB。

例外：度／百分比与数字之间不需要增加空格：

正确：

今天是 233° 的高温。

新 MacBook Pro 有 15% 的 CPU 性能提升。

错误：

今天是 233 ° 的高温。

新 MacBook Pro 有 15 % 的 CPU 性能提升。

全角标点与其他字符之间不加空格

正确：

刚刚买了一部 iPhone，好开心！

错误：

刚刚买了一部 iPhone ，好开心！

-ms-text-autospace to the rescue?

Microsoft 有个 -ms-text-autospace 的 CSS 属性可以实现自动为中英文之间增加空白。不过目前并未普及，另外在其他应用场景，例如 OS X、iOS 的用户界面目前并不存在这个特性，所以请继续保持随手加空格的习惯。

标点符号

不重复使用标点符号

正确：

德国队竟然战胜了巴西队！

她竟然对你说「喵」？！

错误：

德国队竟然战胜了巴西队！！

德国队竟然战胜了巴西队！！！！！！！！

她竟然对你说「喵」？？！！

她竟然对你说「喵」？！？！？？！！

全角和半角

不明白什么是全角（全形）与半角（半形）符号？请查看维基百科词条『全角和半角』。

使用全角中文标点

正确：

嗨！你知道嘛？今天前台的小妹跟我说「喵」了哎！

核磁共振成像（NMRI）是什么原理都不知道？JFGI！

错误：

嗨! 你知道嘛? 今天前台的小妹跟我说 “喵” 了哎!

嗨!你知道嘛?今天前台的小妹跟我说”喵”了哎!

核磁共振成像 (NMRI) 是什么原理都不知道? JFGI!

核磁共振成像(NMRI)是什么原理都不知道?JFGI!

数字使用半角字符

正确：

这件蛋糕只卖 1000 元。

错误：

这件蛋糕只卖 １０００ 元。

例外：在设计稿、宣传海报中如出现极少量数字的情形时，为方便文字对齐，是可以使用全角数字的。

遇到完整的英文整句、特殊名词，其內容使用半角标点

正确：

乔布斯那句话是怎么说的？「Stay hungry, stay foolish.」

推荐你阅读《Hackers & Painters: Big Ideas from the Computer Age》，非常的有趣。

错误：

乔布斯那句话是怎么说的？「Stay hungry，stay foolish。」

推荐你阅读《Hackers＆Painters：Big Ideas from the Computer Age》，非常的有趣。

名词

专有名词使用正确的大小写

大小写相关用法原属于英文书写范畴，不属于本 wiki 讨论內容，在这里只对部分易错用法进行简述。

正确：

使用 GitHub 登录

我们的客户有 GitHub、Foursquare、Microsoft Corporation、Google、Facebook, Inc.。

错误：

使用 github 登录

使用 GITHUB 登录

使用 Github 登录

使用 gitHub 登录

使用 gｲんĤЦ8 登录

我们的客户有 github、foursquare、microsoft corporation、google、facebook, inc.。

我们的客户有 GITHUB、FOURSQUARE、MICROSOFT CORPORATION、GOOGLE、FACEBOOK, INC.。

我们的客户有 Github、FourSquare、MicroSoft Corporation、Google、FaceBook, Inc.。

我们的客户有 gitHub、fourSquare、microSoft Corporation、google、faceBook, Inc.。

我们的客户有 gｲんĤЦ8、ｷouЯƧquﾑгє、๓เςг๏ร๏Ŧt ς๏гק๏гคtเ๏ภn、900913、ƒ4ᄃëв๏๏к, IПᄃ.。

注意：当网页中需要配合整体视觉风格而出现全部大写／小写的情形，HTML 中请使用标准的大小写规范进行书写；并通过 text-transform: uppercase;／text-transform: lowercase; 对表现形式进行定义。

不要使用不地道的缩写

正确：

我们需要一位熟悉 JavaScript、HTML5，至少理解一种框架（如 Backbone.js、AngularJS、React 等）的前端开发者。

错误：

我们需要一位熟悉 Js、h5，至少理解一种框架（如 backbone、angular、RJS 等）的 FED。

争议

以下用法略带有个人色彩，既：无论是否遵循下述规则，从语法的角度来讲都是正确的。

链接之间增加空格

用法：

请 提交一个 issue 并分配给相关同事。

访问我们网站的最新动态，请 点击这里 进行订阅！

对比用法：

请提交一个 issue 并分配给相关同事。

访问我们网站的最新动态，请点击这里进行订阅！

简体中文使用直角引号

用法：

「老师，『有条不紊』的『紊』是什么意思？」

对比用法：

“老师，‘有条不紊’的‘紊’是什么意思？”

工具

谁在这样做？

参考文献

• Guidelines for Using Capital Letters
• Letter case - Wikipedia
• Punctuation - Oxford Dictionaries
• Punctuation - The Purdue OWL
• How to Use English Punctuation Corrently - wikiHow
• 格式 - openSUSE
• 全角和半角 - 维基百科
• 引号 - 维基百科
• 疑问惊叹号 - 维基百科

通用注释写法

一、文件的注释通用样例（普通程序文件，类文件，函数文件，变量定义文件）

1
2
3
4
5
6
7
8
9
10
11
12

/**
 * XXXXX的文件
 * 
 * 功能1： xxx
 * 功能2： xxx
 *
 * @file        $Source: /home/doc/php开发注释规范.md  $
 * @package     core
 * @author      Joy <anzhengchao@gmail.com>
 * @version     $Id: php开发注释规范.txt,v 1.1 2014/03/04 20:37:46 Joy Exp $
 * @link        http://www.joychao.cc
 */

• @file 行在提交了svn之后，会自动被补充为如下样式：

  1	* @file $Source: /home/doc/php开发注释规范.md $

• @version 行在提交了svn之后，会自动被补充为如下样式：

  1	* @version $Id: php开发注释规范.txt,v 1.1 2014/03/04 20:37:46 Joy Exp $

• @package 是团队事先定义好的，在phpdocumentor里同一package的文件可以给出跟踪的链接。项目开发前需要对其定义。

• @link 行后面接的地址是程序开发文档的地址，因为我们目前没有在线的程序开发文档库，所以可不加。
  注意注释的排版，左端保持对齐。

说明：以上自动更新版本及文件名需要配置svn，具体请自行google ‘SVN自动版本号’

二、类的注释，使用如下几个tag

1
2
3
4
5
6
7
8
9
10
11
12
13

/**
 * xxxxx类
 * 
 * 功能1：完成xxxx
 * 功能2：完成xxxxx
 *
 * @author      Joy <anzhengchao@gmail.com>
 * @access      public
 * @abstract 
 */
public class DemoClass {
//code...
}

• @access (public|private) 标记类是私有的还是公用的。
• @abstract标记该类是个抽象类
  虽然我们使用的是php5，但目前程序类的编写仍然沿用的php4，因此@access和@abstract两项可加可不加。

三、类的属性定义

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

public class DemoClass {

   /**
    * 当前页码
    *
    * @var integer 
    */
    public $currentPageNumber;
   
   /**
    * 私有变量使用下划线开头
    *
    * @var string
    */
    private $_instance;
}

四、普通函数和类中的函数注释

1
2
3
4
5
6
7
8
9
10
11
12
13

/**
 * 获取头像地址
 *
 * 
 * @param string  $imageName  图片文件名
 * @param integer $size    大小
 *
 * @return string
 */
function getAvatarUrl($imageName, $size = 80)
{
    return sprintf(SITE_URL . '/service/images/cropped_%s/'.$imageName, $size);
}

顺序按照author、param、return来放，区块间空行。

五、程序段落注释

段落注释和逻辑注释使用如下方式

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

/**
 * 1 如果$_GET['do']等于buy,则购买条码
 */
if($_GET['do'] == 'buy')
{
    // 1.1 验证用户提交变量是否合法
    if($_POST['strCodeNum'])
    {
        
    }
    // 1.2 验证用户提交的码是否可以购买
    
    // 1.3 ..................
} // end if

/**
 * 2 如果$_GET['do']等于list,显示用户选择的条码
 */
if($_GET['do'] == 'list')
{
    // 2.1 验证用户提交变量是否合法
    if($_POST['strCodeNum'])
    {
        
    }
    // 2.2 验证用户提交的码是否可以购买
    
    // 2.3 ..................
} // end if

PHPdoc规范

文档注释，无非“//”和“/**/”两种 ，自己写代码，就那么点，适当写几句就好了；但是一个人总有融入团队的一天，团队的交流不是那几句注释和一张嘴能解决的，还需要通用的注释标准。

PHPDoc是PHP文档注释的一个标准，可以帮助我们在注释文档时有规范，查看别人的代码时更方便。下面的表格是我翻译的WIKI上的PHPDoc，个人英文水平有限，可以参照原文。

文档翻译自：http://en.wikipedia.org/wiki/Phpdoc

标记|用途|描述
-|-
@abstract| |抽象类的变量和方法
@access|public, private or protected|文档的访问、使用权限. @access private 表明这个文档是被保护的。
@author|张三 zhangsan@163.com|文档作者
@copyright|名称 时间|文档版权信息
@deprecated|version|文档中被废除的方法
@deprec| |同 @deprecated
@example|/path/to/example|文档的外部保存的示例文件的位置。
@exception| |文档中方法抛出的异常，也可参照 @throws.
@global|类型：$globalvarname|文档中的全局变量及有关的方法和函数
@ignore| |忽略文档中指定的关键字
@internal| |开发团队内部信息
@link|URL|类似于license 但还可以通过link找到文档中的更多个详细的信息
@name|变量别名|为某个变量指定别名
@magic| |phpdoc.de compatibility
@package|封装包的名称|一组相关类、函数封装的包名称
@param|如 $username 用户名|变量含义注释
@return|如 返回bool|函数返回结果描述，一般不用在void（空返回结果的）的函数中
@see|如 Class Login()|文件关联的任何元素（全局变量，包括，页面，类，函数，定义，方法，变量）。
@since|version|记录什么时候对文档的哪些部分进行了更改
@static| |记录静态类、方法
@staticvar| |在类、函数中使用的静态变量
@subpackage| |子版本
@throws| |某一方法抛出的异常
@todo| |表示文件未完成或者要完善的地方
@var|type|文档中的变量及其类型
@version| |文档、类、函数的版本信息

PHPDoc注释实例：

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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139