为什么要代码静态扫描

什么是静态扫描

如下图所示，其实静态扫描的名称非常多，这里统一称之为静态扫描。静态扫描是指在不运行代码的方式下，通过词法分析、语法分析、抽象语法树分析等技术对程序代码进行扫描，验证代码是否满⾜规范性、安全性、可靠性、可维护性等指标的一种代码分析技术。

PHP项目为什么需要做静态扫描,这里主要有三点原因：

弱类型与无类型声明，PHP7引入了类型声明
解释性语言实时编译
丰富的包、递归依赖

「弱类型(泛型返回值)错把数组当对象」

「返回值⽆无类型声明错把对象当数组」

「类继承成员变量量访问级别覆盖」

版本兼容性问题

还有一些版本兼容性问题也需要通过静态扫描来解决，对于一些“历史悠久”的公司而言，一定会有一些“老”代码，虽然这些项目都是使用PHP进行开发，但是有的可能使用了老的版本，而一些工程师在进行开发的时候可能将一些新版本语法的语法糖写到了老的版本，可能在本地运行没有任何问题，但是一旦到了线上就会出故障了。还有比如老项目使用的PHP版本中一些函数不存在或者有一些语法不支持等，这些都是兼容性的问题。

「PHP的运行时编译优势与隐患」

一些特别小的PHP项目修改完之后直接上传上去覆盖即可，其他语言的项目可能无法这样做，必须要整体打包，因此这既是PHP的一个优势，但也是一个隐患。

PHP可以说是一个风一样的美男子，代码写的快，但是类型约束差、风险高，数组使用比较多就可能因为模糊KV多而影响语义，并且整体代码缺失面向对象的思想；PHP编译快并且部署快，因此也导致上下文解析存在一些隐患。

PHP7 新特性参数类型、返回值类型声明。PHP也在不断地发展和改进，比如PHP 7就提供了参数类型、返回值类型声明等新特性。

「PHP7.4 类成员变量类型声明」

「PHP解析小互动」如下图所示的三段代码中，为什么a.php看不到错误b.php却可以？大家可以仔细思考下这部分问题。

PHP包管理工具的发展

PHP项目的管理越来越复杂，到了2012年之后，Composer变得非常流行，成为了主流的包管理工具。

PHP项⽬发展背后的潜在风险

使用laravel来新建一个博客，其生成的PHP文件数是5927个，代码行数达到了47万行，很难保证其没有错误。因此必须要有自动的语法检测、类型推断等，仅依靠人工检查肯定是心有余而力不足的。

怎么去做代码静态扫描

工具选择-PHPStan

PHPStan是一种PHP代码静态扫描的工具，并且有VS Code的插件，但是似乎有点卡顿。

工具选择-PHPSA

PHPSA与PHPStan比较类似，Fork数和Follow都比较多。

工具选择-Phan

Phan的Follow数量最多，并且也有VS Code的插件。其原理在于解析AST，也就是在分析PHP在执行词法分析和语法分析之后生成的抽象语法树AST。

依托PHP-Parser自己造轮子

Phan的作者也写了一个PHP-Parser，其主要就是将PHP语法树以数组的方式生成出来。

使用Phan

首先，Phan是基于抽象语法树的，其需要依赖于php-ast扩展，安装完扩展之后就可以安装工具。

使用Phan简单扫描

如下图所示的就是使用Phan进行简单PHP项目扫描脚本。

使用Phan扫描项目

如今，大家的项目都是基于Composer进行自动加载或者包依赖的。前面的例子只是测试几个脚本，如果想要将其应用到生产中，前面的方式肯定不足够，因此Phan也支持项目级别的扫描，使用下面的命令就可以扫描和分析出一些错误并形成错误报告。

项目发布实践

项目发布的流程可以主要分为两个方面，包含了预发和正式发布。预发部分包含了项目构建、预发准入、预发部署、集成测试以及预发验证五个部分，在预发准入部分严格上会有一些审批进行拦截，静态扫描就放在集成测试这部分中。在正式发布部分，也包含了项目构建、正式准入、正式部署、合并到master以及线上测试等五个部分。

「集成测试主要包含了单元测试、接口测试、代码静态扫描、安全测试以及性能测试等。」

在将代码同步到预发服务器的同时，可以将代码同步到专门做静态扫描服务器的集群上去，这是因为如果公司项目较少，那么预发服务器可以作为静态扫描服务器，不然同步两次也会浪费时间

但是如果公司有很多类似项目都需要扫描，那么就无法在每个预发服务器上都将静态扫描的扩展都安装一遍，也无法让每个预发服务器都来汇报整个编译流程是否OK，应该是与预发部署服务器隔离开的，预发服务器只汇报是否发布成功。这样的好处就是静态代码扫描的扩展只安装在集群里面，所有人的项目都是可以共用的，而且与整个构建系统相关，通过整体流程保证项目稳定性。

PHP是一门艺术

其实，PHP在我们的项目里面更像是一门艺术，在早期，PHP较为简单易用，但是与此同时，因为其不稳定性以及一些潜在隐患问题，也被很多人所诟病。可能在很多人眼里，PHP还是十几年前的一个玩具，但是玩具也可以不断升级，正如乐高也可以做一个真正能够跑起来的跑车。因此，如果能够让PHP发挥更大的作用，更是一门艺术。